Configurer des demandes personnalisées pour les sessions anonymes

Lorsque vos serveurs de ressources ont besoin de renseignements supplémentaires sur un utilisateur, mais que vous ne transmettez qu’un jeton d’accès, vous pouvez enrichir celui-ci de demandes personnalisées afin d’y stocker des données additionnelles. Une façon courante de définir une demande personnalisée consiste à appeler api.accessToken.setCustomClaim() dans une Action post-login. Toutefois, dans un contexte de sessions anonymes, il n’y a pas de connexion, et donc aucune exécution d’Action post-login. Il devient alors impossible d’ajouter des demandes personnalisées au jeton d’accès de la manière habituelle, et les API qui s’attendent à ces demandes ne peuvent pas les lire. Pour pallier ce problème, Auth0 propose le mappage des demandes, soit une correspondance directe entre les métadonnées d’une session anonyme et les jetons d’accès émis pour celle-ci. Par exemple, pour une session qui contient ceci :

{
  "user_id": "anon@1234-5678-90",
  "session_id": "sess_456",
  "metadata": {
    "language": "EN",
    "country": "US",
    "purchase": "P0123"
  }
}

Vous pouvez configurer votre API pour qu’elle lise la valeur language de chaque nouveau jeton d’accès anonyme qu’elle crée et qu’elle l’inclue sous forme de demande personnalisée nommée lang.

Configurer le mappage des demandes

Pour configurer le mappage des demandes des sessions anonymes, vous pouvez utiliser le Auth0 Dashboard ou la Management API.

Auth0 Dashboard
Management API

Accédez à Dashboard > Applications > APIs, puis sélectionnez l’API dont vous voulez configurer les demandes.
Sélectionnez l’onglet Claim Mapping.
Sous Add a claim, saisissez un Name de demande (par exemple, lang) et une Expression qui renvoie à une valeur sous anonymous_session.metadata.* (par exemple, anonymous_session.metadata.language), puis sélectionnez Add.
Pour modifier une demande existante, sélectionnez l’icône de crayon à côté de celle-ci. Pour en supprimer une, sélectionnez l’icône de corbeille.

Pour configurer le mappage des demandes de votre API, envoyez une requête PATCH au terminal /api/v2/resource-servers/{id} :

{
  "access_token": {
    "claims_mapping": {
      "custom_claims": [
        {
          "name": "tier",
          "expression": "anonymous_session.metadata.tier"
        },
        {
          "name": "lang",
          "expression": "anonymous_session.metadata.language"
        }
      ]
    }
  }
}

Chaque entrée de custom_claims associe le name d’une demande du jeton d’accès émis à une expression qui lit une valeur de la session anonyme, comme anonymous_session.metadata.<key>.

La requête PATCH remplace la liste custom_claims au complet; vous devez donc y inclure toutes les demandes que vous voulez conserver. Faites précéder votre PATCH d’une requête GET pour récupérer les demandes existantes, apportez les modifications voulues, puis renvoyez l’objet complet dans la requête PATCH.

Prochaines étapes

Cas d'utilisation des sessions anonymes

Apprenez-en plus sur les cas d’utilisation des sessions anonymes.

Concepts

Procédures

Cas d’utilisation

Configurer des demandes personnalisées pour les sessions anonymes

Configurer le mappage des demandes

Prochaines étapes

Cas d'utilisation des sessions anonymes

​Configurer le mappage des demandes

​Prochaines étapes

Cas d'utilisation des sessions anonymes

Configurer le mappage des demandes

Prochaines étapes