SsoProviderEdit offre une interface unifiée permettant de modifier les fournisseurs de Single Sign-On.
Accès des applications tierces et accès interapplications
Ces contrôles s’affichent uniquement lorsque l’organisation dispose d’un accès complet à la connexion SSO. Pour les connexions dont l’accès est restreint, les deux champs sont masqués.use_for_third_party_client_access permet aux applications tierces d’utiliser la connexion. Lorsque la politique third_party_client_access de l’organisation est définie sur "block", cette case à cocher demeure visible, mais est désactivée — un message explicatif invite l’administrateur à d’abord activer l’accès des tiers au niveau de l’organisation.
cross_app_access_resource_app configure l’accès interapplications (XAA). Il est disponible directement pour les connexions OIDC et Okta, et pour les connexions SAML au moyen d’une URL de découverte OIDC qui doit d’abord être fournie. Sa disponibilité est déterminée par GET /my-org/config/identity-providers — lorsque la configuration cross_app_access_resource_app de la stratégie est absente, la section ne s’affiche pas.
XAA constitue une voie d’autorisation distincte et contourne les deux contrôles d’accès des tiers : la politique third_party_client_access au niveau de l’organisation et le paramètre use_for_third_party_client_access au niveau de la connexion.
- 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 fournisseur pour charger et modifier le bon fournisseur.| Propriété | Type | Description |
|---|---|---|
providerId | string | Obligatoire. L’ID du fournisseur SSO à modifier. |
Propriétés 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 |
hideProvisioningTab | boolean | Masque l’onglet Fourniture (SCIM). Par défaut : false |
hideDeleteProvider | boolean | Masque l’action de suppression du fournisseur. Par défaut : false |
hideRemoveFromOrganization | boolean | Masque l’action de retrait de l’organisation. Par défaut : false |
hideAttributeMappings | boolean | Masque la section de mappage des attributs. Par défaut : false |
Props d’action
Les interactions de l’utilisateur 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 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. |
deleteAction | ComponentAction<IdentityProvider> | Supprimer définitivement le fournisseur du tenant. |
deleteFromOrganizationAction | ComponentAction<IdentityProvider> | Retirer le fournisseur de l’organisation sans le supprimer du tenant. |
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. Retournezfalsepour empêcher l’enregistrement (par exemple, afin d’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 suivre l’événement.
sso.deleteActionType :
ComponentAction<IdentityProvider>Contrôle la suppression définitive du fournisseur de votre tenant Auth0. Cette action est irréversible.Exemple :sso.deleteFromOrganizationActionType :
ComponentAction<IdentityProvider>Contrôle la suppression du fournisseur de l’organisation. Le fournisseur est détaché de l’organisation mais reste présent dans le locataire et peut être réajouté ultérieurement.Exemple :Actions de l’onglet Provisioning
La propprovisioning configure les actions de l’onglet de provisionnement SCIM. Cet onglet gère le provisionnement automatisé des utilisateurs au moyen du 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 un 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 associée à ce fournisseur d’identité.Exemple :provisioning.createScimTokenActionType :
ComponentAction<IdentityProvider, CreateIdpProvisioningScimTokenResponseContent>Génère un nouveau jeton porteur 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 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> | Ajouter un domaine. |
verifyAction | ComponentAction<Domain> | Vérifier la propriété du domaine. |
deleteAction | ComponentAction<Domain> | Supprimer un domaine. |
associateToProviderAction | ComponentAction<Domain, IdentityProvider | null> | Associer le domaine au fournisseur. |
deleteFromProviderAction | ComponentAction<Domain, IdentityProvider | null> | Retirer le domaine du fournisseur. |
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>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>Associe un domaine vérifié à ce fournisseur SSO afin d’acheminer automatiquement les utilisateurs.Exemple :domains.deleteFromProviderActionType :
ComponentAction<Domain, IdentityProvider | null>Supprime l’association entre un domaine et ce fournisseur.Propriétés de personnalisation
Les props 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> | Surcharges de texte i18n. |
styling | ComponentStyling<SsoProviderEditClasses> | Variables CSS et surcharges de classes. |
Champs de schéma disponibles
Champs de schéma disponibles
Tous les champs du schéma prennent en charge :
regex, errorMessage, minLength, maxLength, requiredprovider.*—Champs de configuration du fournisseur par stratégie- Communs :
name,displayName - Champs propres à la stratégie (identiques à ceux de 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
tabs.sso.name—Libellé de l’onglet SSOtabs.sso.content—Messages de l’onglet SSOdetails.third_party_access—title,label,helper_textdetails.cross_app_access—title,label,helper_text,domain_verification_text,saml_description,saml_discovery_url_label,saml_discovery_url_placeholder,saml_discovery_url_helpertitle,descriptionfields.*—Libellés des champs du formulaire selon la stratégieactions.save_button_text,actions.delete_button_textdelete_modal.*,remove_modal.*
tabs.provisioning.name—Libellé de l’onglet Provisioningtabs.domains.name—Libellé de l’onglet Domaines
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 surcharges de classes. Prend en charge le style adapté au thème.
Options de mise en forme offertes
Options de mise en forme offertes
Variables—propriétés CSS personnalisées
common—S’applique à tous les thèmeslight—Thème clair uniquementdark—Thème sombre uniquement
SsoProviderEdit-headerSsoProviderEdit-tabsProviderConfigure-ThirdPartyAccessProviderConfigure-CrossAppAccess
Personnalisation avancée
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 au niveau de l’API Auth0.| Hook | Description |
|---|---|
useSsoProviderEdit | Logique de chargement et de mise à jour du fournisseur |
useSsoDomainTab | Gestion des associations de domaines |