Référence Auth0.js v9

Auth0.js est une bibliothèque du côté client d’Auth0. Il est recommandé de l’utiliser en conjonction avec la connexion universelle, qui devrait être utilisée chaque fois que possible. Utiliser auth0.js dans votre SPA rend plus facile l’authentification et l’autorisation avec Auth0. La documentation complète API pour la bibliothèque est accessible ici.

La connexion intégrée pour le web utilise la Cross Origin Authentication (Authentification d’origine croisée). Dans certains navigateurs cela peut s’avérer peu fiable si vous ne configurez pas un domaine personnaliséet n’hébergez pas votre application dans le même domaine. Si vous ne pouvez pas utiliser des domaines personnalisés, envisagez de migrer vers la Universal Login (Connexion universelle).

Exemple prêt à être utilisé

Le répertoire d’exemples de la bibliothèque auth0.js est une application prête à l’utilisation qui peut vous aider à essayer auth0.js efficacement et facilement. Pour l’exécuter, suivez ces étapes simples :

Si vous n’avez pas installé node, faites-le maintenant
Téléchargez les dépendances en exécutant npm install à partir de la racine de ce projet.
Enfin, exécutez npm start à partir du répertoire racine de ce projet, et naviguez vers votre application, sur le node server, par exemple http://localhost:3000/example.

Configuration et initialisation

Maintenant, débutons en intégrant auth0.js dans votre projet. Nous couvrirons les méthodes d’installation, l’initialisation de auth0.js, l’inscription, la connexion, la déconnexion, et plus encore!

Configurez votre application Auth0 pour une connexion intégrée

Lors de la mise en œuvre de la connexion intégrée, la bibliothèque utilisera des appels entre origines à l’intérieur d’iframes cachés pour effectuer l’authentification. Pour garantir que cela peut être réalisé en toute sécurité, Auth0 a besoin de connaître les domaines où vous hébergerez vos applications. Ajoutez le domaine au champ Origines Web autorisées. Vous pouvez trouver ce champ dans la zone Application Settings (Paramètres de l’application) de votre Dashboard (Tableau de bord).

Options d’installation

Vous avez quelques options pour utiliser auth0.js dans vos projets. Choisissez l’une des options suivantes, selon vos besoins : Installation via npm ou yarn :

npm install auth0-js

yarn add auth0-js

Après avoir installé le module auth0-js, vous devrez le regrouper avec toutes ses dépendances, ou l’importer à l’aide de :

import auth0 from 'auth0-js';

Alternativemet, incluez le script via notre CDN :

<script src="https://cdn.auth0.com/js/auth0/9.18/auth0.min.js"></script>

Initialisation

initialisez une nouvelle requête de l’application Auth0, tel que suit :

Paramètres disponibles

Deux paramètres obligatoires doivent être transmis dans l’objet options lors de l’instanciation de webAuth, tandis que d’autres sont facultatifs.

Paramètre	Obligatoire	Description
	`domain`	obligatoire
`clientID`	obligatoire	(Chaîne) Votre ID client Auth0
`redirectUri`	optional*	(Chaîne) Le `redirectUri` par défaut utilisé. La valeur par défaut est une chaîne vide (aucune). *Si vous ne fournissez pas une valeur`redirectUri` globale ici, vous devrez fournir une valeur `redirectUri` pour chaque* méthode que vous utilisez.**
`scope`	facultatif	(Chaîne) La valeur par défaut de/des permission(s) utilisé(es) par l’application. L’utilisation de permissions peut vous permettre de renvoyer des réclamations spécifiques pour des champs spécifiques de votre demande. Pour plus de détails, veuillez consulter notre [documentation sur les permissions] (/scopes).
`audience`	facultatif	(Chaîne) L’audience par défaut à utiliser pour demander l’accès à l’API.
`responseType`	facultatif*	(Chaîne) La valeur par défaut de `responseType` est utilisée. Il peut s’agir de n’importe quelle liste de valeurs séparées par des espaces `code`, `token`, `id_token`. La valeur par défaut est `'token'`, à moins qu’un `redirectUri` ne soit fourni, auquel cas la valeur par défaut est `'code'`. *Si vous ne fournissez pas une valeur `responseType` globale, vous devrez fournir une valeur `responseType` pour chaque* méthode que vous utilisez.**
`responseMode`	facultatif	(Chaîne) Cette option est omise par défaut. Peut être définie sur `'form_post'` afin d’envoyer le jeton ou le code au `'redirectUri'` via POST. Les valeurs prises en charge sont `query`, `fragment` et `form_post`.
`leeway`	facultatif	(Entier) Une valeur en secondes; une marge de tolérance pour compenser les écarts d’horloge en ce qui concerne les temps d’expiration des jetons d’ID (ID Token).
`_disableDeprecationWarnings`	facultatif	(Booléen) Désactive les avertissements d’obsolescence, la valeur par défaut est `false`.

En raison de problèmes de décalage d’horloge, le message d’erreur suivant peut parfois être affiché The token was issued in the future. Le paramètre leeway peut être utilisé pour accorder quelques secondes de marge aux délais d’expiration des jetons d’ID, afin d’éviter que cela ne se produise.

Permission

Dans auth0.js v9, la valeur par défaut de scope est openid profile email.

Exécuter Auth0.js localement

Si vous ne spécifiez pas au moins la permission ci-dessus lors de l’initialisation de auth0.js et que vous exécutez votre site Web à partir de http://localhost ou http://127.0.0.1, l’utilisation de la méthode getSSOData() donnera lieu à l’erreur suivante dans la console de votre navigateur :

Consent required. Lorsque vous utilisez la méthode getSSOData, l’utilisateur doit être authentifié avec la permission suivante : openid profile email

Cela ne se produira pas si vous exécutez votre application en production ou si vous spécifiez la permission openid profile email. Vous pouvez en lire davantage à ce sujet dans le document Consentement de l’utilisateur et applications tierces.

Connexion

Vous pouvez choisir une méthode de connexion fondée sur le type d’auth dont vous avez besoin dans votre application.

webAuth.authorize()

La méthode authorize() peut être utilisée pour connecter les utilisateurs au moyen de la connexion universelle, ou à l’aide des connexions par réseau social, tel que montré dans les exemples ci-dessous. Cette méthode invoque le point de terminaison /authorize d’Authentication API et peut accepter un certain nombre de paramètres via l’objet options.

Paramètre	Requis	Description
`audience`	facultatif	(Chaîne) Le public par défaut à utiliser pour demander l’accès à l’API.
`connection`	facultatif	(Chaîne) Spécifie la connexion à utiliser plutôt que de présenter toutes les connexions disponibles pour l’application.
`scope`	facultatif	(Chaîne) Les permissions pour lesquels vous voulez demander l’autorisation. Ces valeurs doivent être séparées par un espace. Vous pouvez demander n’importe quelle permission standard d’OIDC sur les utilisateurs, comme `profile` et `email`, les demandes personnalisées qui doivent être conforme à un format d’espace de noms, ou toute permission prise en charge par l’API cible (par exemple, `read:contacts`). Inclure `offline_access` pour obtenir un jeton d’actualisation.
`responseType`	facultatif	(Chaîne) Il peut s’agir de n’importe quelle liste de valeur séparée par des espaces `code`, `token`, `id_token`. Il est défini par défaut sur `’token’`, à moins qu’un `redirectUri` ne soit fourni, alors il est défini par défaut sur `’code’`.
`clientID`	facultatif	(Chaîne) Votre ID client Auth0.
`redirectUri`	facultatif	(Chaîne) L’URL vers laquelle Auth0 redirigera le navigateur après que l’autorisation a été accordée à l’utilisateur.
`state`	facultatif	(Chaîne) Une valeur arbitraire qui devrait être maintenue dans les redirections. Il est utile pour atténuer les attaques CSRF et pour toute information contextuelle (par exemple, une URL de retour) dont vous pourriez avoir besoin après le processus d’authentification. Pour plus d’informations, consultez Paramètres d’état. auth0.js, lorsqu’il est utilisé dans les applications à page unique, gère la génération et la validation d’état automatiquement si elle n’est pas spécifiée.
`prompt`	facultatif	(Chaîne) Une valeur de `login` forcera l’affichage de la page de connexion, quelle que soit la session en cours. Une valeur de `none` tentera de contourner les invites de connexion si une session existe déjà (voir la documentation sur l’authentification silencieuse pour plus de détails).

Pour une connexion hébergée, vous devez appeler la méthode /authorize(). webAuth.authorize({ //Any additional options can go here }); Pour les connexions par réseau social, le paramètre connection devra être indiqué : webAuth.authorize({ connection: ’twitter’ }); Pour l’authentification par fenêtre contextuelle, la méthode popup.authorize peut être utilisée. L’authentification par fenêtre contextuelle ne peut être utilisée dans les pages de connexion avec hôte. Typiquement, l’authentification par fenêtre contextuelle est utilisée par les applications avec une simple page, de manière à ce que l’état actuel ne soit pas perdu en effectuant une redirection de la page entière. Autorisation par défaut avec fenêtre contextuelle (les utilisateurs voient la Connexion universelle Auth0) :

webAuth.popup.authorize({
  responseType: 'token'
  redirectUri: 'https://{yourApp}/popup_response_handler.html'
  //Any additional options can go here
}, function(err, authResult) {
  //do something
});

Et pour les connexions par réseau social avec fenêtre contextuelle utilisant authorize :

webAuth.popup.authorize({
  responseType: 'token'
  redirectUri: 'https://{yourApp}/popup_response_handler.html',
  connection: 'twitter'
}, function(err, authResult) {
  //do something
});

Lorsque vous utilisez l’authentification par fenêtre contextuelle, vous devez fournir un redirectUri où la page de destination communique les résultats de l’autorisation au rappel en utilisant la méthode webAuth.popup.callback. Une simple mise en oeuvre ressemblerait à ceci :

<!-- popup_response_handler.html -->
<html>
  <body>
    <script src="https://cdn.auth0.com/js/auth0/9.18/auth0.min.js"></script>
    <script type="text/javascript">
      var webAuth = new auth0.WebAuth({
        domain:       'YOUR_AUTH0_DOMAIN',
        clientID:     'YOUR_CLIENT_ID'
      });
      webAuth.popup.callback();
    </script>
  </body>
</html>

Un gestionnaire idéal ne comprendrait que cette fonctionalité minimale (c.-à-d. évitant de recharger l’application entière seulement pour gérer la réponse). Vous devrez ajouter le redirectUri à la liste des URL de rappel autorisées de l’application dans la page de configuration de l’application sur le tableau de bord.

La méthode login permet une authentification cross-origin pour les connexions par base de données, en utilisant /co/authenticate.

Paramètre	Requis	Description
`username`	optionnel	(Chaîne) Le nom d’utilisateur à présenter pour l’authentification. Le `username` ou `email` doit être présent.
`email`	optionnel	(Chaîne) Le courriel à présenter pour authentification. Le `username` ou `email` doit être présent.
`password`	requis	(Chaîne) Le mot de passe à présenter pour l’authentification.
`realm`	requis	(Chaîne) Le nom de la connexion à la base de données dans laquelle l’authentification est effectuée.

webAuth.login({
  realm: 'tests',
  username: 'testuser',
  password: 'testpass',
});

webAuth.crossOriginVerification()

La méthode crossOriginVerification() peut être utilisée pour aider à fournir une authentification cross-origin aux clients dont les témoins de tierce-partie ont été désactivés dans leur navigateur. Pour de plus amples détails concernant spn utilisation, consultez le document authentification cross-origin.

buildAuthorizeUrl(options)

La méthode buildAuthorizeUrl peut être utilisée pour créer l’URL /authorize, afin d’initialiser une nouvelle transaction. Utilisez cette méthode si vous souhaitez mettre en place l’authentification (passive) sur navigateur. Le paramètre state est une valeur opaque qu’Auth0 vous renverra. Cette méthode aide à prévenir les attaques CSRF, et elle doit être indiquée si vous redirigez vous-mêmes vers l’URL plutôt que d’appeler webAuth.authorize(). Pour plus d’informations, consultez la section Paramètre state.

Authentification unique avec authentification intégrée

Les applications avec connexion intégrée doivent remplir deux critères afin de bénéficier de l’Authentification unique ().

Les deux applications tentant d’utiliser la SSO doivent être des applications de première partie. La SSO avec des applications tierces ne fonctionnera pas.
Elles doivent utiliser des domaines personnalisés et avoir à la fois les applications qui souhaitent bénéficier de la SSO et le locataire Auth0 sur le même domaine. Traditionnellement, les domaines Auth0 sont au format foo.auth0.com, mais les domaines personnalisés vous permettent d’utiliser le même domaine pour chacune des applications en question, ainsi que pour votre client Auth0, ce qui évite le risque d’attaques CSRF (Cross-Site Request Forgery).

Nous recommandons d’utiliser une connexion universelle au lieu de configurer la SSO dans des scénarios de connexion intégrée. La connexion universelle est la manière la plus fiable et stable de mettre en place la SSO, et c’est la seule option si vous devez utiliser plusieurs domaines pour vos applications, ou si vous utilisez des applications tiers.

Connexion sans mot de passe

L’authentification sans mot de passe permet aux utilisateurs de se connecter en recevant un mot de passe à usage unique (OTP) par courriel ou SMS. Ce processus demande que vous lanciez le processus , produisant et envoyant un code à l’utilisateur, (ou un code avec un lien), suivi en acceptant les authentifiants par la méthode de vérification. Ce pourrait survenir sous la forme d’une écran de connexion qui demande leur (courriel ou numéro de téléphone) et le code que vous venez de leur envoyer. Ce pourrait également être mis en place sous la forme d’un lien Sans mot de passe avec un code envoyé à l’utilisateur. Ils n’auraient qu’à cliquer sur le lien dans leur couriel et ils atteindraient votre point de terminaison, pour alors vérifier ces données automatiquement à l’aide la même méthode de vérification (sans entrée manuelle de code de la part de l’utilisateur). De manière à pouvoir utiliser l’authentification sans mot de passe, vous devrez initialiser auth0.js avec un redirectUri et définir le responseType : ’token’.

Débuter l’authentification sans mot de passe

La première étape de l’authentification sans mot de passe avec auth0.js est la méthode passwordlessStart, qui a plusieurs paramètres qui peuvent être transmis dans son objet options :

Paramètre	Requis	Description
`connection`	requis	(Chaîne) Spécifie comment envoyer le code/lien à l’utilisateur. La valeur doit être soit `email` ou `sms`.
`send`	requis	(Chaîne) La valeur doit être soit `code`, ou `link`. Si `null`, un lien sera envoyé.
`phoneNumber`	optionnel	(Chaîne) Le numéro de téléphone de l’utilisateur pour l’envoi d’un code ou d’un lien par SMS.
`email`	optionnel	(Chaîne) Le courriel de l’utilisateur pour l’envoi d’un code ou d’un lien par courriel.

Notez qu’un seul des paramètres facultatifs phoneNumber et email doit être envoyé pour lancer la transaction sans mot de passe.

webAuth.passwordlessStart({
    connection: 'email',
    send: 'code',
    email: 'foo@bar.com'
  }, function (err,res) {
    // handle errors or continue
  }
);

Compléter l’authentification sans mot de passe

Si vous envoyez un code, vous devrez alors envoyer une demande à l’utilisateur d’entrer ce code. Vous traiterez le code et authentifierez l’utilisateur à l’aide de la méthode passwordlessLogin, qui possède plusieurs paramètres pouvant être envoyés dans son objet options :

Paramètres	Requis	Description
`connection`	requis	(Chaîne) Spécifie comment envoyer le code/lien à l’utilisateur. La valeur doit être soit `email` soit `sms` et identique à la valeur transmise à `passwordlessStart`.
`verificationCode`	requis	(Chaîne) Le code envoyé à l’utilisateur, soit sous forme de code, soit intégré dans un lien.
`phoneNumber`	facultatif	(Chaîne) Le numéro de téléphone de l’utilisateur auquel le code ou le lien a été envoyé par SMS.
`email`	facultatif	(Chaîne) Le courriel de l’utilisateur auquel le code ou le lien a été envoyé par courriel.

Comme pour passwordlessStart, un seul des paramètres facultatifs phoneNumber et email doit être envoyé afin de vérifier la transaction sans mot de passe. Pour pouvoir utiliser la méthode passwordlessLogin, les options redirectUri et responseType doivent être précisées au moment d’initialiser WebAuth.

webAuth.passwordlessLogin({
    connection: 'email',
    email: 'foo@bar.com',
    verificationCode: '389945'
  }, function (err,res) {
    // handle errors or continue
  }
);

Effectuez une extraction de authResult et obtenez les informations utilisateur

Après l’authentification, vous pouvez utiliser la méthode parseHash pour analyser le fragment de hashage URL lorsque l’utilisateur est redirigé vers l’application pour extraire le résultat d’une réponse d’authentification Auth0. Vous pouvez choisir de gérer cette page de rappel, laquelle vous redirigera vers l’application principale ou au sein de la même page, selon les circonstances de la situation. La méthode parseHash accepte un objet options qui contient les paramètres suivants :

Paramètre	Requis	Description
`state`	optionnel	(Chaîne) Une valeur opaque que l’application ajoute à la requête initiale que Auth0 inclut lors de la redirection vers l’application. Cette valeur est utilisée par auth0.js pour empêcher les attaques CSRF.
`nonce`	optionnel	(Chaîne) Utilisé pour vérifier le jeton d’ID
`hash`	optionnel	(Chaîne) L’URL de hachage (si non fourni, `window.location.hash` sera utilisé par défaut)

Le contenu de l’objet authResult renvoyé par la méthode parseHash dépend des paramètres d’authentification utilisés. Ce peut comprendre :

Élément	Description
`accessToken`	Un jeton d’accès pour l’API, spécifié par `audience`
`expiresIn`	Chaîne contenant le délai d’expiration (en secondes) du `accessToken`
`idToken`	Un jeton d’ID JWT contenant des informations du profil utilisateur

webAuth.parseHash({ hash: window.location.hash }, function(err, authResult) {
  if (err) {
    return console.log(err);
  }

  webAuth.client.userInfo(authResult.accessToken, function(err, user) {
    // Now you have the user's information
  });
});

Comme indiqué ci-dessus, la méthode client.userInfo peut être appelée en transmettant l’accessToken renvoyé. Elle fera une requête au point de terminaison /userinfo et retournera l’objet user, qui contient les informations de l’utilisateur, au format similaire à celui de l’exemple ci-dessous.

{
    "sub": "auth0|123456789012345678901234",
    "nickname": "johnfoo",
    "name": "johnfoo@gmail.com",
    "picture": "https://gravatar.com/avatar/example.png",
    "updated_at": "2018-05-07T14:16:52.013Z",
    "email": "johnfoo@gmail.com",
    "email_verified": "false"
}

Vous pouvez maintenant faire quelque chose d’autre avec cette information, selon les besoins de votre application, tel que d’acquérir l’ensemble des informations de profil de l’utilisateur dans , tel que décrit ci-dessous.

Utilisation des nombres aléatoires

Par défaut (et si responseType contient id_token), auth0.js génère un nonce aléatoire lorsque vous appelez webAuth.authorize, le stocke localement, et l’extrait dans webAuth.parseHash. Le comportement par défaut devrait fonctionner dans la majorité des cas, mains certains cas exigent au développeur de contrôler le nonce. Si vous souhaitez utiliser un nonce généré par le développeur, vous devez le fournir en tant qu’option à webAuth.authorize et webAuth.parseHash.

webAuth.authorize({<Tooltip href="/docs/docs/fr-ca/glossary?term=nonce" tip="Nombre aléatoire Nombre arbitraire émis une fois dans un protocole d’authentification pour détecter et prévenir les attaques par réinsertion." cta="Voir le glossaire">nonce</Tooltip>: ’1234’, responseType: ’token id_token’}); webAuth.parseHash({nonce: ’1234’}, callback);

Si vous appelez webAuth.checkSession au lieu de webAuth.authorize, il vous suffit de définir votre nonce personnalisé en tant qu’option de checkSession :

webAuth.checkSession({
  nonce: '1234',
}, function (err, authResult) {
    ...
});

La méthode webAuth.checkSession vérifiera automatiquement que la demande nonce du jeton d’ID renvoyé est la même que celle de l’option.

Codes d’erreur et descriptions

Lorsque Auth0.js est employé pour une connexion intégrée, le point de terminaison /co/authenticate est utilisé, ce qui peut produire les erreurs suivantes :

Les descriptions d’erreur sont destinées à être lues par un être humain. La description ne doit pas être analysée par un code et peut changer à tout moment.

Statut	Code	Description
400	invalid_request	Corps de la requête non valide. Tous et seulement client_id, credential_type, username, otp, realm sont requis.
401	unauthorized_client	La connexion interorigine n’est pas autorisée.
400	unsupported_credential_type	Paramètre de type d’identifiant inconnu.
400	invalid_request	Domaine inconnu, connexion inexistante.
403	access_denied	Courriel ou mot de passe erroné.
403	access_denied	Erreur d’authentification
403	blocked_user	Utilisateur bloqué
401	password_leaked	Cette tentative de connexion a été bloquée parce que le mot de passe que vous utilisez a déjà été divulgué dans le cadre d’une violation de données (pas dans cette application).
429	too_many_attempts	Votre compte a été bloqué après plusieurs tentatives de connexion consécutives. Nous vous avons envoyé une notification via votre méthode de contact préférée avec des instructions sur la façon de le débloquer.
429	too_many_attempts	Nous avons détecté un comportement de connexion suspect et les tentatives suivantes seront bloquées. Veuillez contacter l’administrateur.

De plus, vous pouvez également obtenir un code d’erreur 403 générique sans propriété error ou error_description. Le corps de la réponse n’incluera que quelque chose comme ceci : Origin https://test.app is not allowed.

Déconnexion

Pour déconnecter un utilisateur, utilisez la méthode logout(). Cette méthode accepte l’objet options, lequel peut inclure les paramètres suivants : Si le paramètre clientID est inclus, l’URL returnTo qui est fournie doit être listée dans les URL de déconnexion autorisées de l’application dans Auth0 Dashboard. Toutefois, si le paramètre clientID n’est pas inclus, l’URL returnTo doit figurer dans les URL de déconnexion autorisées.

webAuth.logout({
  returnTo: 'some url here',
  clientID: 'some client ID here'
});

Inscription

Pour enregistrer un utilisateur, utilisez la méthode signup. Cette méthode accepte l’objet options, lequel peut inclure les paramètres suivants :

Paramètre	requis	Description
`email`	requis	(Chaîne) Adresse courriel utilisateur
`password`	requis	(Chaîne) Mot de passe souhaité par l’utilisateur
`username`	required*	(Chaîne) Mot de passe souhaité par l’utilisateur. Requis si vous utilisez une connexion vers une base de données et vous avez activéRequiert un mot de passe*
`connection`	requis	(Chaîne) Le nom de connexion de base de données dans votre application au moment de tenter la création du compte utilisateur
`user_metadata`	optionnel	(objet JSON) Attributs additionnels utilisés pour les informations de l’utilisateur. Ils seront stockés dans user_metadata

Les enregistrements devraient être pour les connexions de bases de données. Voici un exemple de la méthode signup et un exemple de code pour un formulaire.

<h2>Signup Database Connection</h2>
<input class="signup-email" />
<input type="password" class="signup-password" />
<input type="button" class="signup-db" value="Signup!" />
<script type="text/javascript">
    $('.signup-db').click(function (e) {
        e.preventDefault();
        webAuth.signup({
            connection: 'Username-Password-Authentication',
            email: $('.signup-email').val(),
            password: $('.signup-password').val(),
            user_metadata: { plan: 'silver', team_id: 'a111' }
        }, function (err) {
            if (err) return alert('Something went wrong: ' + err.message);
            return alert('success signup without login!')
        });
    });
</script>

En utilisant checkSession pour obtenir de nouveaux jetons

La méthode checkSession vous permet d’acquérir un nouveau jeton auprès d’Auth0 pour un utilisateur qui est déjà authentifié auprès d’Auth0 pour votre domaine. La méthode accepte tous paramètres OAuth2 qui seraient normalement envoyés à authorize. Si vous les oubliez, les paramètres utilisés seront ceux fournis au moment de l’initialisation d’Auth0. L’appel à checkSession peut être utilisé pour obtenir un nouveau jeton pour l’API définie en tant qu’ lors de l’initialisation de webAuth :

webAuth.checkSession({}, function (err, authResult) {
  // err if automatic parseHash fails
  ...
});

Consultez Effectuer une extraction de AuthResult et obtenir des informations utilisateur pour connaître le format de authResult. Sinon, le jeton peut être acquis pour une API différente que celle utilisée au moment d’initialiser webAuth en précisant un audience et une scope :

webAuth.checkSession(
  {
    audience: `https://mydomain/another-api/˜`,
    scope: 'read:messages'
  }, function (err, authResult) {
  // err if automatic parseHash fails
  ...
});

Notez que checkSession() déclenche toutes les règles que vous avez définies, vous devez donc vérifier vos règles dans le Dashboard avant de l’utiliser. La redirection vers /authorize est effectuée dans unºiframe, et ainsi votre application ne sera pas chargée de nouveau et on ne vous redirigera pas ailleurs. Cependant, le navigateur doit avoir activé les témoins de tierce-partie. Sinon, checkSession() est incapable d’accéder à la session courante de l’utilisateur (rendant impossible d’obtenir un nouveau jeton sans afficher quelque chose à l’utilisateur). La même chose se produira si les utilisateurs ont activé l’ITP de Safari. N’oubliez pas d’ajouter l’URL d’où provient la demande d’autorisation à la liste des Origines Web autorisées de votre application Auth0 dans le Dashboard sous les Settings (Paramètres) de votre application.

Si la connexion est une connexion sociale et que vous utilisez les clés de développeur Auth0, l’appel checkSession renverra toujours login_required.

Effectuer un sondage avec checkSessions()

Dans certains scénarios multi-applications où la déconnexion unique est souhaitée (c’est-à-dire qu’un utilisateur se déconnectant d’une application doit également être déconnecté des autres applications), une application peut être configurée pour interroger périodiquement Auth0 en utilisant checkSession() pour voir si une session existe. Si la session n’existe pas, vous pouvez alors déconnecter l’utilisateur de l’application. La même méthode d’interrogation peut être mise en place pour une authentification silencieuse dans un scénario d’authentification unique (SSO). L’intervalle d’interrogation entre les vérifications de checkSession() devrait être d’au moins 15 minutes entre chaque appel pour éviter tout problème ultérieur lié à la limite anti-attaques de cet appel.

Requêtes de réinitialisation de mot de passe

Si vous essayez de mettre en place une fonctionnalité de réinitialisation du mot de passe, vous utiliserez la méthode changePassword et transmettrez un objet « options », avec un paramètre « connexion » et un paramètre « courriel ».

$('.change_password').click(function () {
    webAuth.changePassword({
      connection: 'db-conn',
      email:   'foo@bar.com'
    }, function (err, resp) {
      if(err){
        console.log(err.message);
      }else{
        console.log(resp);
      }
    });
  });

L’utilisateur recevra un courriel contenant un lien à cliquer pour réinitialiser leur mot de passe.

Gestion utilisateur

Management API offre une fonctionnalité qui vous permet de lier et de dissocier des comptes utilisateurs distincts provenant de différents fournisseurs, en les liant à un profil unique (consultez Association de comptes d’utilisateur pour plus de renseignements). Ceci vous permet aussi de mettre à jour les métadonnées utilisateur. Pour débuter, vous avez d’abord besoin d’un Jeton d’accès à utiliser avec Management API. Pour ce faire, vous pouvez préciser l’audiencehttps://{yourDomain}/api/v2/ lorsque vous initialisez auth0.js, ce qui vous permettra d’obtenir le jeton d’accès du flux d’authentification. Si vous utilisez des domaines personnalisés, vous devrez instancier une nouvelle copie de webAuth en utilisant votre domaine Auth0 plutôt que votre domaine personnalisé, pour l’utiliser avec les appels de Management API, car elle ne fonctionne qu’avec les domaines Auth0. Vous pouvez également le faire à l’aide de checkSession() : Vous devez spécifier les permissions qui vous sont nécessaires. Vous pouvez demander de suivre les permissions suivantes :

read:current_user
update:current_user_identities
create:current_user_metadata
update:current_user_metadata
delete:current_user_metadata
create:current_user_device_credentials
delete:current_user_device_credentials

Une fois que vous avez le jeton d’accès, vous pouvez créer une nouvelle instance auth0.Management en le passant par le domaine Auth0 du compte et le jeton d’accès.

Obtention du profil utilisateur

Pour obtenir les données du profil utilisateur, utilisez la méthode getUser(), avec le userId et un rappel comme paramètres. La méthode retourne vers le profil utilisateur. Notez que le userID requis ici sera le même que celui récupéré par la méthode client.userInfo. auth0Manage.getUser(userId, cb);

Mise à jour du profil utilisateur

Pour mettre à jour les métadonnées d’un utilisateur, vous devez d’abord créer un objet userMetadata, puis appeler la méthode patchUserMetadata en lui transmettant l’identifiant de l’utilisateur et l’objet userMetadata que vous avez créé. Les valeurs de cet objet vont remplacer les valeurs de la même clé, et en ajouter de nouvelles pour la même clé, encore en ajouter qui n’existent pas encore pour les métadonnées utilisateur. Consultez la documentation sur les métadonnées pour plus de détails sur les métadonnées utilisateur. auth0Manage.patchUserMetadata(userId, userMetadata, cb);

Association des utilisateurs

Associer les comptes utilisateur permettra à l’utilisateur de communiquer avec ses comptes et, peu importe lequel ils utilisent, toujours être devant le même profil après connexion. Auth0 traite ces comptes de manière séparée par défaut; si vous souhaitez que les comptes d’un utilisateur soient associées, c’est la seule façon. La méthode linkUser accepte deux paramètres,userId principal et le jeton d’ID de l’utilisateur secondaire (le jeton obtenu après la connexion avec cette identité). L’ID utilisateur en question est un identifiant unique pour le compte utilisateur primaire. Si vous utilisez cette méthode, l’identifiant doit être transmis avec le préfixe du fournisseur, par exemple auth0|1234567890 ou facebook|1234567890. Consultez Association de comptes d’utilisateur pour plus de renseignements. auth0Manage.linkUser(userId, secondaryUserToken, cb); Après avoir associé les comptes, un second compte n’existera plus en tant qu’entité séparée au niveau de la base de données utilisateur; il ne sera accessible qu’en tant que partie du compte primaire. Lorsque des comptes sont associés, les métadonnées du compte secondaire ne sont pas fusionnées avec celles du compte principal et, s’ils sont dissociés, le compte secondaire ne conservera pas non plus les métadonnées du compte principal.

​Exemple prêt à être utilisé

​Configuration et initialisation

​Configurez votre application Auth0 pour une connexion intégrée

​Options d’installation

​Initialisation

​Paramètres disponibles

Permission

Exécuter Auth0.js localement

​Connexion

​webAuth.authorize()

​webAuth.popup.authorize()

​Gestion des résultats d’authentifications par fenêtre contextuelle popup

​webAuth.login()

​webAuth.crossOriginVerification()

​buildAuthorizeUrl(options)

​Authentification unique avec authentification intégrée

​Connexion sans mot de passe

​Débuter l’authentification sans mot de passe

​Compléter l’authentification sans mot de passe

​Effectuez une extraction de authResult et obtenez les informations utilisateur

​Utilisation des nombres aléatoires

​Codes d’erreur et descriptions

​Déconnexion

​Inscription

​En utilisant checkSession pour obtenir de nouveaux jetons

​Effectuer un sondage avec checkSessions()

​Requêtes de réinitialisation de mot de passe

​Gestion utilisateur

​Obtention du profil utilisateur

​Mise à jour du profil utilisateur

​Association des utilisateurs

Exemple prêt à être utilisé

Configuration et initialisation

Configurez votre application Auth0 pour une connexion intégrée

Options d’installation

Initialisation

Paramètres disponibles

Connexion

webAuth.authorize()

webAuth.popup.authorize()

Gestion des résultats d’authentifications par fenêtre contextuelle popup

webAuth.login()

webAuth.crossOriginVerification()

buildAuthorizeUrl(options)

Authentification unique avec authentification intégrée

Connexion sans mot de passe

Débuter l’authentification sans mot de passe

Compléter l’authentification sans mot de passe

Effectuez une extraction de authResult et obtenez les informations utilisateur

Utilisation des nombres aléatoires

Codes d’erreur et descriptions

Déconnexion

Inscription

En utilisant checkSession pour obtenir de nouveaux jetons

Effectuer un sondage avec checkSessions()

Requêtes de réinitialisation de mot de passe

Gestion utilisateur

Obtention du profil utilisateur

Mise à jour du profil utilisateur

Association des utilisateurs