Skip to main content
Le composant SsoProviderEdit offre une interface unifiée permettant de modifier les fournisseurs de Single Sign-On.

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

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éTypeDescription
providerIdstringObligatoire. 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éTypeDescription
hideHeaderbooleanMasque 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).
PropsTypeDescription
backButtonObjectConfiguration du bouton Retour.
ssoSsoProviderTabEditPropsActions de l’onglet SSO. Détails
provisioningSsoProvisioningTabEditPropsActions de l’onglet Provisioning. Détails
domainsSsoDomainsTabEditPropsActions de l’onglet Domaines. Détails
backButtonType : { 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
Exemple :

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.
ActionTypeDescription
updateActionComponentAction<IdentityProvider, IdentityProvider>Mettre à jour les paramètres du fournisseur.
deleteActionComponentAction<IdentityProvider>Supprimer définitivement le fournisseur.
removeFromOrganizationActionComponentAction<IdentityProvider>Retirer de l’organisation.
sso.updateActionType : 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 Enregistrer
  • onBefore(provider)—S’exécute avant la mise à jour. Retournez false pour 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.
Exemple :

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 prop provisioning configure les actions de l’onglet d’approvisionnement SCIM. Cet onglet gère l’approvisionnement automatisé des utilisateurs au moyen du protocole SCIM.
ActionTypeDescription
createActionComponentAction<IdentityProvider, CreateIdPProvisioningConfigResponseContent>Activer le SCIM provisioning.
deleteActionComponentAction<IdentityProvider>Désactiver le SCIM provisioning.
createScimTokenActionComponentAction<IdentityProvider, CreateIdpProvisioningScimTokenResponseContent>Générer un jeton SCIM.
deleteScimTokenActionComponentAction<IdentityProvider>Révoquer le jeton SCIM.
provisioning.createActionType : 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 prop domains configure les actions de l’onglet Domaines. Cet onglet gère les domaines associés au fournisseur afin d’acheminer automatiquement les utilisateurs.
ActionTypeDescription
createActionComponentAction<Domain>Ajoute un domaine.
verifyActionComponentAction<Domain>Vérifie la propriété du domaine.
deleteActionComponentAction<Domain>Supprime un domaine.
associateToProviderActionComponentAction<Domain, IdentityProvider | null>Associe un domaine à un fournisseur.
deleteFromProviderActionComponentAction<Domain, IdentityProvider | null>Retire un domaine d’un fournisseur.
domains.createActionType : 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éTypeDescription
schemaSsoProviderEditSchemaRègles de validation des champs.
customMessagesPartial<SsoProviderEditMessages>Remplacements de texte i18n.
stylingComponentStyling<SsoProviderEditClasses>Variables CSS et remplacements de classes.
schémaDéfinissez des règles de validation personnalisées pour les champs provider et domain.
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)
domains.create.domainUrl—Validation de l’URL du domaine

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.
header—En-tête du composant
  • title, back_button_text
tabs—Libellés des onglets
  • sso, provisioning, domains
sso_tab—Onglet des paramètres SSO
  • title, description
  • fields.*—Libellés des champs du formulaire selon la stratégie
  • actions.save_button_text, actions.delete_button_text
  • delete_modal.*, remove_modal.*
provisioning_tab—Onglet Provisioning
  • title, description
  • scim_endpoint.label, scim_token.label
  • actions.enable_button_text, actions.disable_button_text
  • actions.generate_token_button_text, actions.revoke_token_button_text
domains_tab—Onglet Domaines
  • title, description
  • Même structure que les messages de DomainTable
notifications—Réponses de l’API
  • provider_update_success, provider_delete_success
  • provisioning_enable_success, provisioning_disable_success
  • scim_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.
Variables—propriétés CSS personnalisées
  • common—Appliquées à tous les thèmes
  • light—Thème clair uniquement
  • dark—Thème sombre uniquement
Classes—surcharges de classes de composants
  • SsoProviderEdit-header
  • SsoProviderEdit-tabs
  • SsoProviderEdit-ssoTab
  • SsoProviderEdit-provisioningTab
  • SsoProviderEdit-domainsTab

Personnalisation avancée

Le composant SsoProviderEdit 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.
ComposantDescription
SsoProviderSsoTabFormulaire de configuration SSO
SsoProviderProvisioningTabGestion de l’approvisionnement SCIM
SsoProviderDomainsTabGestion des associations de domaines
ProviderConfigureFieldsChamps de formulaire dynamiques selon la stratégie
ScimTokenDisplayAffichage 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.
HookDescription
useSsoProviderEditLogique de chargement et de mise à jour du fournisseur
useSsoProviderProvisioningGestion du SCIM provisioning
useSsoProviderDomainsGestion des associations de domaines