Skip to main content
Le composant 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.

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 fournisseur pour charger et modifier le bon fournisseur.
PropriétéTypeDescription
providerIdstringObligatoire. 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éTypeDescription
hideHeaderbooleanMasque la section d’en-tête. Par défaut : false
hideProvisioningTabbooleanMasque l’onglet Fourniture (SCIM). Par défaut : false
hideDeleteProviderbooleanMasque l’action de suppression du fournisseur. Par défaut : false
hideRemoveFromOrganizationbooleanMasque l’action de retrait de l’organisation. Par défaut : false
hideAttributeMappingsbooleanMasque 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).
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 des 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 du tenant.
deleteFromOrganizationActionComponentAction<IdentityProvider>Retirer le fournisseur de l’organisation sans le supprimer du tenant.
sso.updateActionType : 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 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 après la mise à jour réussie du fournisseur. Utilisez cette fonction pour afficher une notification ou suivre l’événement.
Exemple :

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 prop provisioning configure les actions de l’onglet de provisionnement SCIM. Cet onglet gère le provisionnement automatisé des utilisateurs au moyen du protocole SCIM.
ActionTypeDescription
createActionComponentAction<IdentityProvider, CreateIdPProvisioningConfigResponseContent>Activer le provisionnement SCIM.
deleteActionComponentAction<IdentityProvider>Désactiver le provisionnement SCIM.
createScimTokenActionComponentAction<IdentityProvider, CreateIdpProvisioningScimTokenResponseContent>Générer un jeton SCIM.
deleteScimTokenActionComponentAction<IdentityProvider>Révoquer le jeton SCIM.
provisioning.createActionType : 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 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>Ajouter un domaine.
verifyActionComponentAction<Domain>Vérifier la propriété du domaine.
deleteActionComponentAction<Domain>Supprimer un domaine.
associateToProviderActionComponentAction<Domain, IdentityProvider | null>Associer le domaine au fournisseur.
deleteFromProviderActionComponentAction<Domain, IdentityProvider | null>Retirer le domaine du fournisseur.
domains.createActionType : 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éTypeDescription
schemaSsoProviderEditSchemaRègles de validation des champs.
customMessagesPartial<SsoProviderEditMessages>Surcharges de texte i18n.
stylingComponentStyling<SsoProviderEditClasses>Variables CSS et surcharges de classes.
schemaDéfinissez des règles de validation personnalisées pour les champs fournisseur et domaine.
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)
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 et contenu des onglets
  • tabs.sso.name—Libellé de l’onglet SSO
  • tabs.sso.content—Messages de l’onglet SSO
    • details.third_party_accesstitle, label, helper_text
    • details.cross_app_accesstitle, label, helper_text, domain_verification_text, saml_description, saml_discovery_url_label, saml_discovery_url_placeholder, saml_discovery_url_helper
    • 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.*
  • tabs.provisioning.name—Libellé de l’onglet Provisioning
  • tabs.domains.name—Libellé de l’onglet Domaines
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 des 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 surcharges de classes. Prend en charge le style adapté au thème.
Variables—propriétés CSS personnalisées
  • common—S’applique à tous les thèmes
  • light—Thème clair uniquement
  • dark—Thème sombre uniquement
Classes—surcharges de classes de composants
  • SsoProviderEdit-header
  • SsoProviderEdit-tabs
  • ProviderConfigure-ThirdPartyAccess
  • ProviderConfigure-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.
HookDescription
useSsoProviderEditLogique de chargement et de mise à jour du fournisseur
useSsoDomainTabGestion des associations de domaines