Passer au contenu principal

​
Composants disponibles

OrganizationDetailsEdit

Modifier les parmètres de l’organization, incluant le nom, le nom d’affichage, les couleurs de l’image de marque et le logo avec une validation intégrée et une intégration API.

SsoProviderTable

Afficher et gérer vos fournisseurs d’identité (IdP) SSO grâce à une interface de tableau complète, incluant les fonctionnalités de création, de modification, de suppression, d’activation/désactivation et de retrait de l’organization. .

SsoProviderCreate

Assistant multi-étapes pour la création de fournisseurs SSO : sélection du fournisseur, configuration des détails et de l’authentification pour Okta, ADFS, SAML, OIDC, Google Workspace, Microsoft Entra ID, et PingFederate.

SsoProviderEdit

Gestion complète des fournisseurs SSO avec interface à onglets pour la configuration de l’authentification, l’activation de la fourniture par jetons SCIM et la gestion des associations de domaines.

DomainTable

Gérer les domaines de l’organization avec les fonctionnalités de création, de vérification, de suppression et d’association de fournisseur d’identité dans une interface de tableau unifiée.

​
Configuration requise

Avant d’utiliser les composants My Organization, vous devez configurer Auth0 avec les API, les applications et les autorisations appropriées. Suivez ces étapes pour configurer votre environnement :
Configuration d’Auth0 Dashboard – Veuillez suivre toutes les étapes ci-dessous avant d’utiliser les composantsMy Organization.
1

Activer l’API

Naviguez vers API → My Organization API et assurez-vous qu’elle est activée pour votre locataire.
2

Créer une application à page unique

Naviguez vers Applications → Créer une application:– Sélectionner « Applications à page Web unique » – Pour le mode développement, ajoutez http://localhost:5173 à : – URL de rappel autorisées – URL de déconnexion autorisées – Définir l’expérience utilisateur : – Utilisateurs commerciaux – Invite pour l’organization (facultative)Cet exemple utilise une application à page Web unique, mais vous pouvez également configurer une application Web régulière (RWA) en suivant des étapes similaires.
3

Paramétrer la configuration client

Dans Applications → Votre App → Paramètres, configurez les éléments suivants :Section des paramètres avancés : – Types d’autorisation: assurez-vous que « Code d’autorisation » et « Jeton d’actualisation » sont activés. – Méthode d’authentification par jeton au terminal: définir « Aucun » pour SPA (ou « Secret client post » pour une application Web régulière)
Ces paramètres sont requis afin que les composants My Organization fonctionnent adéquatement. Le flux « Invite après connexion » permet aux utilisateurs de sélectionner l’organization à laquelle ils souhaitent accéder.
4

Configuration de la base de données et de l’utilisateur

– Créez une connexion par base de données – Dans l’onglet Applications, activez votre nouvelle application à page unique. – Créez un utilisateur dans cette base de données (à des fins d’essai)
5

Configuration du rôle

Créez un rôle ou utilisez le rôle existant (p. ex., « administrateur de l’organization ») et ajouter les autorisations requises :
read:my_org:details
update:my_org:details
create:my_org:identity_providers
read:my_org:identity_providers
update:my_org:identity_providers
delete:my_org:identity_providers
update:my_org:identity_providers_detach
create:my_org:identity_providers_domains
delete:my_org:identity_providers_domains
read:my_org:domains
delete:my_org:domains
create:my_org:domains
update:my_org:domains
read:my_org:identity_providers_scim_tokens
create:my_org:identity_providers_scim_tokens
delete:my_org:identity_providers_scim_tokens
create:my_org:identity_providers_provisioning
read:my_org:identity_providers_provisioning
delete:my_org:identity_providers_provisioning
read:my_org:configuration
6

Créer une organization

Rendez-vous à Organizations → Créer une Organization :– Dans Membres : ajoutez votre utilisateur et attribuer son rôle – Dans Connexions : activez une base de données.
7

Créer une autorisation client

Créez une autorisation pour la paire utilisateur-client afin de configurer le contrôle d’accès :
POST https://{{auth0_domain}}/api/v2/client-grants
{
  "scope": [
    "read:my_org:details",
    "update:my_org:details",
    "create:my_org:identity_providers",
    "read:my_org:identity_providers",
    "update:my_org:identity_providers",
    "delete:my_org:identity_providers",
    "update:my_org:identity_providers_detach",
    "create:my_org:identity_providers_domains",
    "delete:my_org:identity_providers_domains",
    "read:my_org:domains",
    "delete:my_org:domains",
    "create:my_org:domains",
    "update:my_org:domains",
    "read:my_org:identity_providers_scim_tokens",
    "create:my_org:identity_providers_scim_tokens",
    "delete:my_org:identity_providers_scim_tokens",
    "create:my_org:identity_providers_provisioning",
    "read:my_org:identity_providers_provisioning",
    "delete:my_org:identity_providers_provisioning",
    "read:my_org:configuration"
  ],
  "client_id": "{{auth0_client_id}}",
  "audience": "https://{{auth0_domain}}/my-organization/",
  "subject_type": "user"
}
Vous devez avoir un jeton de Management API pour effectuer cette requête . Obtenez-en un en naviguant vers Applications → API → Auth0 Management API → API Explorer.
8

Configurer les variables d’environnement

Créez un fichier .env dans votre projet avec la configuration Auth0. La nature exacte des variables dépend de votre type d’application
VITE_AUTH0_DOMAIN=your-domain.auth0.com
VITE_AUTH0_CLIENT_ID=your-spa-client-id
Les configurations des variables d’environnement varient selon le cadre d’applications et l’installation. Consultez le répertoire examples/ du dépôt pour obtenir des exemples de mise en œuvre précis.
Il vous incombe de veiller à ce que votre utilisation de l’API My Organization et des composants d’interface utilisateur intégrables respecte vos politiques de sécurité et les lois applicables, y compris toute autorisation accordée à vos utilisateurs finaux.

​
Remarques rapides

L’utilisateur doit être authentifié et être un membre de l’organization – Les composants chargent automatiquement les données de l’organization à partir du contexte de l’utilisateur actuel – Tous les composants partagent les mêmes exigences de configuration de base – Consultez Aperçu pour l’installation et la configuration Auth0ComponentProvide