Passer au contenu principal
Nous vous guiderons dans les premières étapes de prise en main d’Auth0 afin de vous familiariser avec les concepts clés du service Auth0. Nous prendrons l’entreprise Example-Co comme exemple pour illustrer certaines des étapes.

Créer un compte Auth0

Si ce n’est pas déjà fait, inscrivez-vous pour créer un compte Auth0 (c’est gratuit). Vous pouvez utiliser un nom d’utilisateur, un courriel ou un téléphone avec un mot de passe, ou vous connecter avec un fournisseur social (comme LinkedIn, Microsoft, GitHub ou Google).

Créer un locataire et un domaine

Une fois votre compte créé, vous serez invité à créer un locataire. Tout commence par un locataire Auth0. C’est là que vous configurez votre utilisation d’Auth0, et c’est aussi là que les ressources Auth0 — comme les applications, les connexions et les profils utilisateur — sont définies, gérées et stockées. Vous accédez à un locataire Auth0 à partir de l’Auth0 Dashboard, où vous pouvez également créer d’autres locataires associés. Vous pouvez créer plusieurs locataires Auth0 afin de les organiser de façon à isoler différents domaines d’utilisateurs et à prendre en charge votre cycle de vie du développement logiciel (SDLC). Les noms de locataire ne peuvent pas être modifiés ni réutilisés après leur suppression. Assurez-vous donc d’être satisfait du ou des noms avant de créer vos locataires Auth0. Déterminer le niveau d’isolation requis pour vos domaines d’utilisateurs est une étape importante et, combiné à vos exigences en matière d’image de marque, cela vous aide à déterminer le nombre de locataires Auth0 nécessaires dans votre environnement. Le nombre de locataires Auth0 à gérer peut augmenter rapidement; réfléchissez donc bien avant de créer plusieurs locataires Auth0 pour la production. Caractéristiques du locataire :
  • Le nom du locataire doit être unique. Il servira à créer votre domaine personnel.
  • Le nom du locataire ne peut contenir que des caractères alphanumériques minuscules et des traits d’union (« - »). Il ne peut pas commencer ni se terminer par un trait d’union.
  • Le nom du locataire doit comporter au minimum 3 caractères et au maximum 63 caractères.
  • Le nom du locataire ne peut pas être modifié après sa création.
  • Vous pouvez créer plusieurs locataires; en fait, il est recommandé de le faire pour chacun de vos environnements, comme le développement, la préproduction ou la production. Pour en savoir plus, consultez Set Up Multiple Environments.
Le nom de votre locataire fait partie de votre domaine Auth0. Vous pouvez le personnaliser en utilisant un . Ce domaine est l’URL de base utilisée pour accéder à l’API Auth0 et l’URL à laquelle vos utilisateurs s’authentifient.

Région, localité et sous-localité

Le nom de domaine est aussi constitué de la valeur de localité d’une région. Nous prenons en charge les valeurs de localité suivantes pour l’option de déploiement en nuage public :
RégionLocalitéSous-localités
AustralieAUAU
CanadaCACA
EuropeEUEU, EU-2
JaponJPJP
Royaume-UniUKUK
États-Unis d’AmériqueUSUS, US-3, US-4, US-5
Chacune de ces localités est subdivisée en une sous-localité (ou environnement de locataire) indiquée par un chiffre après la localité, par ex. EU-2. Les environnements de locataire ne peuvent pas être choisis manuellement, mais vous pouvez préciser des localités en fonction de la région sélectionnée, ce qui détermine le domaine attribué au locataire et la région où vos données seront hébergées. Dans notre exemple, Example-Co a choisi le nom example-co et AU comme région. Son domaine est donc example-co.au.auth0.com.

Domaines personnalisés

Nous recommandons d’utiliser des domaines personnalisés, comme example-co.com, dans les environnements de production afin d’offrir à vos utilisateurs l’expérience la plus sécuritaire et la plus fluide possible. Les certificats de domaines personnalisés peuvent être gérés par Auth0 ou par vous-même. Pour en savoir plus, consultez Domaines personnalisés.

Prochaines étapes

  • Créer et enregistrer des applications : Maintenant que vous avez un compte et un domaine, vous devez enregistrer chaque application qui utilisera nos services dans le Auth0 Dashboard. Pour en savoir plus, consultez Les applications dans Auth0 et Créer des applications.
  • Configurer les connexions : Ensuite, vous devez configurer la façon dont vos utilisateurs s’authentifieront au moment de se connecter. Auth0 se trouve entre votre application et le qui authentifie vos utilisateurs (comme Google ou Facebook). La relation entre Auth0 et le fournisseur d’identité est appelée une connexion. Grâce à cette couche de connexion, Auth0 protège votre application des changements apportés à l’implémentation du fournisseur d’identité. Pour en savoir plus, consultez Authentification et autorisation et Connexions.

Étendre les fonctionnalités d’Auth0

Auth0 offre plusieurs façons d’étendre les capacités de la plateforme :
  • Actions : les Actions sont des fonctions sécurisées, propres à chaque locataire et versionnées, écrites en Node.js, qui s’exécutent à certains endroits de la plateforme Auth0. Utilisez les Actions pour personnaliser et étendre les capacités d’Auth0 au moyen d’une expérience de connexion personnalisée.
  • Rules : les Rules sont des fonctions écrites en JavaScript ou en C# qui s’exécutent dans Auth0 juste après une authentification réussie et avant de rendre le contrôle à votre application. Les Rules peuvent être chaînées pour modulariser le code et activées ou désactivées individuellement. Vous pouvez utiliser les Rules pour :
    • Contrôle d’accès
    • Webhooks
    • Enrichissement du profil
    • authentification multifacteur (MFA)
  • Hooks : les Hooks vous permettent de personnaliser le comportement d’Auth0 à l’aide de code Node.js exécuté à des points d’extensibilité (comparables à des webhooks intégrés à un serveur). Ce sont des fonctions sécurisées et autonomes associées à des points d’extensibilité précis de la plateforme Auth0. Auth0 invoque les Hooks au moment de l’exécution pour appliquer votre logique personnalisée.
  • Extensions : les extensions d’Auth0 vous permettent d’installer des applications ou d’exécuter des commandes/scripts qui étendent les fonctionnalités du produit Auth0 de base. Vous pouvez utiliser l’une des extensions prédéfinies fournies par Auth0 ou créer la vôtre. Voici quelques exemples d’actions que vous pouvez effectuer avec des extensions :
    • Gérer les autorisations des utilisateurs (à l’aide de groupes, de rôles et d’autorisations)
    • Importer/exporter des utilisateurs
    • Exporter des logs vers d’autres services
    • Déployer des scripts à partir de référentiels externes

En savoir plus