SsoProviderEdit offre une interface unifiée pour modifier les fournisseurs d’authentification unique (SSO).
- React
- Next.js
- shadcn
Exigences de configuration
Configuration Auth0 requise - Assurez-vous que votre locataire est configuré pour utiliser
l’API My Organization. Voir le guide de configuration
→
Installation
L’exécution de l’une ou l’autre de ces commandes installe également la dépendance @auth0/universal-components-core
pour les utilitaires partagés et l’intégration avec Auth0.
Démarrage
Exemple complet d’intégration
Exemple complet d’intégration
Props
Props obligatoires
Les props obligatoires sont fondamentales au fonctionnement du composant.SsoProviderEdit requiert l’ID du fournisseur pour charger et modifier le fournisseur approprié.| Propriété | Type | Description |
|---|---|---|
providerId | string | Obligatoire. L’identifiant du fournisseur SSO à modifier. |
Propriétés d’affichage
Les propriétés d’affichage contrôlent la façon dont le composant s’affiche sans en modifier le comportement.| Propriété | Type | Description |
|---|---|---|
hideHeader | boolean | Masque la section d’en-tête. Valeur par défaut : false |
Propriétés d’Action
Les interactions des utilisateurs dans les trois onglets sont gérées par plusieurs props d’action organisées sous le nom de l’onglet correspondant (sso, provisioning et domains).| Propriété | Type | Description |
|---|---|---|
backButton | Object | Configuration du bouton Retour. |
sso | SsoProviderTabEditProps | Actions de l’onglet SSO. Détails |
provisioning | SsoProvisioningTabEditProps | Actions de l’onglet de provisionnement. Détails |
domains | SsoDomainsTabEditProps | Actions de l’onglet des 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, valeur par défaut : ArrowLeft)onClick- Gestionnaire de clics pour la navigation
Actions de l’onglet SSO
La propriétésso configure les actions pour l’onglet des 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 d’identité. |
deleteAction | ComponentAction<IdentityProvider> | Supprimer définitivement le fournisseur d’identité. |
removeFromOrganizationAction | ComponentAction<IdentityProvider> | Retirer le fournisseur de l’organisation. |
ComponentAction<IdentityProvider, IdentityProvider>Contrôle l’enregistrement des modifications apportées à la configuration du fournisseur (ID client, secrets, certificats, etc.).Propriétés :disabled- Désactive le bouton EnregistreronBefore(provider)- S’exécute avant la mise à jour. Renvoyezfalsepour empêcher la sauvegarde (p. ex., pour afficher une boîte de dialogue de confirmation).onAfter(provider, result)- S’exécute après la mise à jour réussie du fournisseur. Utilisez cette fonction pour afficher une notification ou assurer le suivi de l’événement.
sso.deleteActionType:
ComponentAction<IdentityProvider>Contrôle la suppression définitive du fournisseur de votre locataire Auth0.Exemple :sso.removeFromOrganizationActionType:
ComponentAction<IdentityProvider>Contrôle la suppression du fournisseur de l’organisation sans le supprimer définitivement. Le fournisseur reste disponible pour être rajouté ultérieurement.Exemple :Actions de l’onglet Provisionnement
La propprovisioning configure les actions pour l’onglet de provisionnement SCIM. Cet onglet gère le provisionnement automatisé des utilisateurs via le protocole SCIM.| Action | Type | Description |
|---|---|---|
createAction | ComponentAction<IdentityProvider,
CreateIdPProvisioningConfigResponseContent> | Activer le provisionnement SCIM. |
deleteAction | ComponentAction<IdentityProvider> | Désactiver le provisionnement SCIM. |
createScimTokenAction | ComponentAction<IdentityProvider,
CreateIdpProvisioningScimTokenResponseContent> | Générer le jeton SCIM. |
deleteScimTokenAction | ComponentAction<IdentityProvider> | Révoquer le jeton SCIM. |
ComponentAction<IdentityProvider, CreateIdPProvisioningConfigResponseContent>Active le provisionnement SCIM pour le fournisseur. Une fois activé, vous pouvez générer un jeton SCIM que votre fournisseur d’identité pourra utiliser.Exemple :provisioning.deleteActionType:
ComponentAction<IdentityProvider>Désactive le provisionnement SCIM et supprime toute la configuration de provisionnement pour ce fournisseur d’identité.Exemple :provisioning.createScimTokenActionType:
ComponentAction<IdentityProvider, CreateIdpProvisioningScimTokenResponseContent>Génère un nouveau jeton bearer SCIM permettant à votre fournisseur d’identité de s’authentifier auprès d’Auth0.Exemple :provisioning.deleteScimTokenActionType:
ComponentAction<IdentityProvider>Révoque le jeton SCIM. Le fournisseur d’identité ne pourra plus synchroniser les utilisateurs tant qu’un nouveau jeton n’aura pas été généré.Exemple :Actions de l’onglet Domaines
La propriétédomains configure les Actions pour l’onglet des domaines. Cet onglet gère les domaines associés au fournisseur pour le routage automatique des utilisateurs.| Action | Type | Description |
|---|---|---|
createAction | ComponentAction<Domain> | Ajouter un domaine. |
verifyAction | ComponentAction<Domain> | Vérifier la propriété d’un domaine. |
deleteAction | ComponentAction<Domain> | Supprimer un domaine. |
associateToProviderAction | ComponentAction<Domain, IdentityProvider | null> | Associer un domaine au fournisseur. |
deleteFromProviderAction | ComponentAction<Domain, IdentityProvider | null> | Retirer un domaine du fournisseur. |
ComponentAction<Domain>Contrôle l’ajout de nouveaux domaines à l’organisation depuis l’interface de modification du fournisseur.Exemple :domains.verifyActionType:
ComponentAction<Domain>Contrôle la vérification du domaine via un enregistrement TXT DNS.Exemple :domains.deleteActionType:
ComponentAction<Domain>Contrôle la suppression du domaine.Exemple :domains.associateToProviderActionType:
ComponentAction<Domain, IdentityProvider | null>Associe un domaine vérifié à ce fournisseur SSO pour le routage automatique des utilisateurs.Exemple :domains.deleteFromProviderActionType:
ComponentAction<Domain, IdentityProvider | null>Supprime l’association d’un domaine avec ce fournisseur.Propriétés de personnalisation
Les props de personnalisation vous permettent d’adapter le composant à votre 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> | Surcharges de texte pour l’i18n. |
styling | ComponentStyling<SsoProviderEditClasses> | Variables CSS et surcharges de classes. |
Champs du schéma disponibles
Champs du schéma disponibles
Tous les champs du schéma acceptent :
regex, errorMessage, minLength, maxLength, requiredprovider.* - Champs de configuration du fournisseur par stratégie- Champs communs :
name,displayName - Champs propres à la stratégie (identiques à SsoProviderCreate)
customMessagesPersonnalisez tous les textes et traductions. Tous les champs sont facultatifs et utilisent les valeurs par défaut si aucune n’est fournie.
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
stylePersonnalisez l’apparence à l’aide de variables CSS et de substitutions de classes. Prend en charge le style adapté aux thèmes.
Options de style disponibles
Options de style disponibles
Variables - Propriétés CSS personnalisées
common- Appliqué à tous les thèmeslight- Thème clair uniquementdark- Thème sombre uniquement
SsoProviderEdit-headerSsoProviderEdit-tabsSsoProviderEdit-ssoTabSsoProviderEdit-provisioningTabSsoProviderEdit-domainsTab
Personnalisation avancée
Le composantSsoProviderEdit est composé de sous-composants et de hooks plus petits. Vous pouvez les importer individuellement pour créer des flux de modification de fournisseur personnalisés si vous utilisez shadcn.Sous-composants disponibles
Pour les cas d’utilisation avancés, vous pouvez importer des sous-composants individuels afin d’intégrer des onglets ou des sections spécifiques dans différents contextes.| Composant | Description |
|---|---|
SsoProviderSsoTab | Formulaire de configuration du SSO |
SsoProviderProvisioningTab | Gestion du provisionnement SCIM |
SsoProviderDomainsTab | Gestion des associations de domaine |
ProviderConfigureFields | Champs de formulaire dynamiques selon la stratégie |
ScimTokenDisplay | Affichage du jeton SCIM avec fonction de copie |
Hooks disponibles
Ces hooks fournissent la logique sous-jacente sans interface utilisateur. Utilisez-les pour créer des interfaces entièrement personnalisées tout en tirant parti de l’intégration à l’API Auth0.| Hook | Description |
|---|---|
useSsoProviderEdit | Chargement et mise à jour du fournisseur |
useSsoProviderProvisioning | Gestion du provisionnement SCIM |
useSsoProviderDomains | Gestion de l’association de domaines |