SsoProviderEdit offre une interface unifiée permettant de modifier les fournisseurs de Single Sign-On.
- React
- Next.js
- shadcn
Exigences de configuration
Configuration d’Auth0 requise — Assurez-vous que votre tenant est configuré avec l’API My Organization. Consulter le guide de configuration
→
Installation
L’exécution de l’une ou l’autre commande installe également la dépendance @auth0/universal-components-core
qui fournit des utilitaires partagés et l’intégration à Auth0.
Pour commencer
Exemple complet d’intégration
Exemple complet d’intégration
Props
Props requis
Les props requises sont essentielles au fonctionnement du composant.SsoProviderEdit nécessite l’ID du Provider pour charger et modifier le bon Provider.| Propriété | Type | Description |
|---|---|---|
providerId | string | Obligatoire. L’ID du Provider SSO à modifier. |
Props d’affichage
Les props d’affichage déterminent la façon dont le composant est rendu, sans en modifier le comportement.| Propriété | Type | Description |
|---|---|---|
hideHeader | boolean | Masque la section d’en-tête. Par défaut : false |
Propriétés de l’Action
Les interactions des utilisateurs dans les trois onglets sont gérées par plusieurs props d’action, regroupées sous le nom de l’onglet correspondant (sso, provisioning et domains).| Props | Type | Description |
|---|---|---|
backButton | Object | Configuration du bouton Retour. |
sso | SsoProviderTabEditProps | Actions de l’onglet SSO. Détails |
provisioning | SsoProvisioningTabEditProps | Actions de l’onglet Provisioning. Détails |
domains | SsoDomainsTabEditProps | Actions de l’onglet Domaines. Détails |
{ icon?: LucideIcon; onClick: (e: MouseEvent) => void }Configure le bouton Retour dans l’en-tête du composant. Utilisez-le pour revenir à votre liste de fournisseurs.Propriétés :icon—Composant d’icône Lucide personnalisé (facultatif; ArrowLeft par défaut)onClick—Gestionnaire de clic pour la navigation
Actions de l’onglet SSO
La propriétésso configure les actions de l’onglet Paramètres SSO. Cet onglet gère la configuration d’authentification du fournisseur.| Action | Type | Description |
|---|---|---|
updateAction | ComponentAction<IdentityProvider, IdentityProvider> | Mettre à jour les paramètres du fournisseur. |
deleteAction | ComponentAction<IdentityProvider> | Supprimer définitivement le fournisseur. |
removeFromOrganizationAction | ComponentAction<IdentityProvider> | Retirer de l’organisation. |
ComponentAction<IdentityProvider, IdentityProvider>Contrôle l’enregistrement des modifications apportées à la configuration du fournisseur (client ID, secrets, certificats, etc.).Propriétés :disabled—Désactive le bouton EnregistreronBefore(provider)—S’exécute avant la mise à jour. Retournezfalsepour empêcher l’enregistrement (par exemple, afin d’afficher une boîte de dialogue de confirmation).onAfter(provider, result)—S’exécute une fois le fournisseur mis à jour. Utilisez cette fonction pour afficher une notification ou suivre l’événement.
sso.deleteActionType :
ComponentAction<IdentityProvider>Permet de contrôler la suppression définitive du fournisseur de votre tenant Auth0.Exemple :sso.removeFromOrganizationActionType :
ComponentAction<IdentityProvider> ComponentAction<IdentityProvider>Contrôle le retrait du provider de l’organization sans le supprimer. Le provider demeure disponible et peut être ajouté de nouveau plus tard.Exemple :Actions de l’onglet Provisioning
La propprovisioning configure les actions de l’onglet d’approvisionnement SCIM. Cet onglet gère l’approvisionnement automatisé des utilisateurs au moyen du protocole SCIM.| Action | Type | Description |
|---|---|---|
createAction | ComponentAction<IdentityProvider,
CreateIdPProvisioningConfigResponseContent> | Activer le SCIM provisioning. |
deleteAction | ComponentAction<IdentityProvider> | Désactiver le SCIM provisioning. |
createScimTokenAction | ComponentAction<IdentityProvider,
CreateIdpProvisioningScimTokenResponseContent> | Générer un jeton SCIM. |
deleteScimTokenAction | ComponentAction<IdentityProvider> | Révoquer le jeton SCIM. |
ComponentAction<IdentityProvider, CreateIdPProvisioningConfigResponseContent>Active le SCIM provisioning pour le Provider. Une fois l’option activée, vous pouvez générer un SCIM token que votre identity provider pourra utiliser.Exemple :provisioning.deleteActionType :
ComponentAction<IdentityProvider>Désactive l’approvisionnement SCIM et supprime toute la configuration d’approvisionnement associée à ce fournisseur d’identité.Exemple :provisioning.createScimTokenActionType :
ComponentAction<IdentityProvider, CreateIdpProvisioningScimTokenResponseContent>Génère un nouveau jeton porteur SCIM pour permettre à votre fournisseur d’identité de s’authentifier auprès d’Auth0.Exemple :provisioning.deleteScimTokenActionType :
ComponentAction<IdentityProvider> ComponentAction<IdentityProvider>Révoque le SCIM token. L’identity provider ne pourra plus synchroniser les utilisateurs tant qu’un nouveau token n’aura pas été généré.Exemple :Actions de l’onglet Domaines
La propdomains configure les actions de l’onglet Domaines. Cet onglet gère les domaines associés au fournisseur afin d’acheminer automatiquement les utilisateurs.| Action | Type | Description |
|---|---|---|
createAction | ComponentAction<Domain> | Ajoute un domaine. |
verifyAction | ComponentAction<Domain> | Vérifie la propriété du domaine. |
deleteAction | ComponentAction<Domain> | Supprime un domaine. |
associateToProviderAction | ComponentAction<Domain, IdentityProvider | null> | Associe un domaine à un fournisseur. |
deleteFromProviderAction | ComponentAction<Domain, IdentityProvider | null> | Retire un domaine d’un fournisseur. |
ComponentAction<Domain> ComponentAction<Domain>Permet de contrôler l’ajout de nouveaux domaines à l’organisation depuis l’interface de modification du fournisseur.Exemple :domains.verifyActionType :
ComponentAction<Domain> ComponentAction<Domain>Contrôle la vérification du domaine au moyen d’un enregistrement TXT DNS.Exemple :domains.deleteActionType :
ComponentAction<Domain>Contrôle la suppression du domaine.Exemple :domains.associateToProviderActionType :
ComponentAction<Domain, IdentityProvider | null> ComponentAction<Domain, IdentityProvider | null>Associe un domaine vérifié à ce fournisseur SSO afin d’acheminer automatiquement les utilisateurs.Exemple :domains.deleteFromProviderActionType :
ComponentAction<Domain, IdentityProvider | null>Supprime l’association d’un domaine avec ce fournisseur.Propriétés de personnalisation
Les propriétés de personnalisation vous permettent d’adapter le composant à votre image de marque, à vos paramètres régionaux et à vos exigences de validation sans modifier le code source.| Propriété | Type | Description |
|---|---|---|
schema | SsoProviderEditSchema | Règles de validation des champs. |
customMessages | Partial<SsoProviderEditMessages> | Remplacements de texte i18n. |
styling | ComponentStyling<SsoProviderEditClasses> | Variables CSS et remplacements de classes. |
Champs du schéma disponibles
Champs du schéma disponibles
Tous les champs du schéma prennent en charge :
regex, errorMessage, minLength, maxLength, requiredprovider.*—Champs de configuration du fournisseur selon la stratégie- Communs :
name,displayName - Champs propres à chaque stratégie (identiques à SsoProviderCreate)
customMessagesPersonnalisez tous les textes et toutes les traductions. Tous les champs sont facultatifs et utilisent les valeurs par défaut s’ils ne sont pas renseignés.
Messages disponibles
Messages disponibles
header—En-tête du composant
title,back_button_text
sso,provisioning,domains
title,descriptionfields.*—Libellés des champs du formulaire selon la stratégieactions.save_button_text,actions.delete_button_textdelete_modal.*,remove_modal.*
title,descriptionscim_endpoint.label,scim_token.labelactions.enable_button_text,actions.disable_button_textactions.generate_token_button_text,actions.revoke_token_button_text
title,description- Même structure que les messages de DomainTable
provider_update_success,provider_delete_successprovisioning_enable_success,provisioning_disable_successscim_token_create_success,scim_token_delete_success- Notifications liées aux domaines
mise en formePersonnalisez l’apparence à l’aide de variables CSS et de remplacements de classes. Prend en charge un style adapté au thème.
Options de style offertes
Options de style offertes
Variables—propriétés CSS personnalisées
common—Appliquées à tous les thèmeslight—Thème clair uniquementdark—Thème sombre uniquement
SsoProviderEdit-headerSsoProviderEdit-tabsSsoProviderEdit-ssoTabSsoProviderEdit-provisioningTabSsoProviderEdit-domainsTab
Personnalisation avancée
Le composantSsoProviderEdit est constitué de sous-composants et de hooks plus petits. Vous pouvez les importer individuellement pour créer des workflows personnalisés de modification de fournisseurs si vous utilisez shadcn.Sous-composants disponibles
Pour des cas d’utilisation avancés, vous pouvez importer chaque sous-composant individuellement afin d’intégrer des onglets ou des sections précises dans différents contextes.| Composant | Description |
|---|---|
SsoProviderSsoTab | Formulaire de configuration SSO |
SsoProviderProvisioningTab | Gestion de l’approvisionnement SCIM |
SsoProviderDomainsTab | Gestion des associations de domaines |
ProviderConfigureFields | Champs de formulaire dynamiques selon la stratégie |
ScimTokenDisplay | Affichage du token SCIM avec fonction de copie |
Hooks disponibles
Ces hooks fournissent la logique sous-jacente, sans aucune UI. Utilisez-les pour créer des interfaces entièrement personnalisées tout en tirant parti de l’intégration au niveau de l’API Auth0.| Hook | Description |
|---|---|
useSsoProviderEdit | Logique de chargement et de mise à jour du fournisseur |
useSsoProviderProvisioning | Gestion du SCIM provisioning |
useSsoProviderDomains | Gestion des associations de domaines |