> ## Documentation Index
> Fetch the complete documentation index at: https://auth0-automated-translations-update.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Configurer les Anonymous Sessions

> Découvrez comment configurer des Anonymous Sessions à l’aide du Auth0 Dashboard ou de la Management API.

export const ReleaseStageNotice = ({feature, stage, plans, contact, terms}) => {
  const stageTextMap = {
    "beta": "bêta",
    "ea": "Accès anticipé"
  };
  const stageText = stageTextMap[stage] || "une phase de lancement du produit";
  const prsLink = "/docs/troubleshoot/product-lifecycle/product-release-stages";
  const linkify = (text, url) => {
    return <a href={url} target="_blank" rel="noreferrer" class="link">{text}</a>;
  };
  const includeDetails = (plans, contact, terms) => {
    const hasDetails = terms || plans || contact;
    if (!hasDetails) return null;
    return <span data-as="p">
            {plans && <>Cette fonctionnalité est offerte avec les forfaits {linkify(`${plans}`, "https://auth0.com/pricing")}. </>}
            {contact && "Pour y participer, communiquez avec " + contact + ". "}
            {terms && <>En utilisant cette fonctionnalité, vous acceptez les conditions applicables de l’essai gratuit énoncées dans le {linkify("Master Subscription Agreement", "https://www.okta.com/legal")} d’Okta.</>}
        </span>;
  };
  return <Warning>
            <span data-as="p">
                <strong>La fonctionnalité {feature} est en {linkify(stageText, prsLink)}.</strong>
            </span>

            {includeDetails(plans, contact, terms)}
        </Warning>;
};

<ReleaseStageNotice feature="Anonymous Sessions" stage="ea" plans="Entreprise" contact="votre chargé de compte" />

Pour configurer les Anonymous Sessions, vous pouvez utiliser le [Auth0 Dashboard](/docs/fr-ca/get-started/auth0-overview/dashboard) ou la [Management API](/docs/fr-ca/api/management/v2).

<h2 id="prerequisites">
  Prérequis
</h2>

Pour utiliser les sessions anonymes :

* Vous devez [avoir un compte Auth0](https://auth0.com/).
* [Enregistrez votre application Auth0](/docs/fr-ca/get-started/auth0-overview/create-applications). Si vous n’avez pas d’application Auth0, consultez les [Quickstarts](https://auth0.com/docs/quickstart/spa/react) Auth0 pour React ou Next.js.
* [Enregistrez une API (serveur de ressources)](/docs/fr-ca/get-started/auth0-overview/set-up-apis).

<h2 id="configure-anonymous-sessions">
  Configurer les sessions anonymes
</h2>

<Tabs>
  <Tab title="Auth0 Dashboard">
    1. Accédez à [**Dashboard > Tenant Settings > Advanced**](https://manage.auth0.com/#/tenant/advanced), puis faites défiler jusqu'aux paramètres de session.

           <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-automated-translations-update/docs/images/sessions/anonymous_sessions/anonymous_sessions.png" alt="La page des paramètres du locataire dans le Auth0 Dashboard" />

    2. Saisissez une valeur en minutes pour **Anonymous Session Lifetime**.

    3. Activez ou désactivez l'interrupteur **Anonymous Session Cookie** pour déterminer si les requêtes de session anonyme renvoient le témoin `auth0_anon`.
  </Tab>

  <Tab title="Management API">
    Pour configurer la durée de vie de la session anonyme et le comportement du témoin, envoyez une requête `PATCH` au terminal [`/api/v2/tenants/settings`](/docs/fr-ca/api/management/v2/tenants/patch-settings) :

    ```json theme={null}
    {
      "sessions": {
        "anonymous": {
          "lifetime_in_minutes": 144000,
          "activate_cookie": true
        }
      }
    }
    ```

    * `lifetime_in_minutes` définit la durée de validité d'une session.
    * `activate_cookie` détermine si le témoin `auth0_anon` est émis dans les flux anonymes. Réglez ce paramètre à `false` si vous prévoyez plutôt utiliser le [mécanisme de billet de transfert sans témoin](/docs/fr-ca/manage-users/sessions/anonymous-sessions#transfer-a-session-through-a-transfer-ticket).
  </Tab>
</Tabs>

<h2 id="enable-anonymous-sessions-in-your-application">
  Activer les sessions anonymes dans votre application
</h2>

<Tabs>
  <Tab title="Auth0 Dashboard">
    1. Accédez à [**Dashboard > Applications > Applications**](https://manage.auth0.com/#/applications), puis sélectionnez l'application que vous souhaitez configurer.

    2. Faites défiler jusqu'aux paramètres **Anonymous Sessions**.

           <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-automated-translations-update/docs/images/sessions/anonymous_sessions/anonymous_sessions_application.png" alt="La page des paramètres des applications dans le Auth0 Dashboard" />

    3. Activez l'interrupteur **Allow Anonymous Sessions**.
  </Tab>

  <Tab title="Management API">
    Pour activer les sessions anonymes dans votre application Auth0, envoyez une requête `PATCH` au terminal [`/api/v2/clients/{id}`](/docs/fr-ca/api/management/v2/clients/patch-clients-by-id) :

    ```json theme={null}
    {
      "anonymous_sessions": {
        "active": true
      }
    }
    ```
  </Tab>
</Tabs>

<h2 id="enable-anonymous-access-in-your-api">
  Activer l'accès anonyme dans votre API
</h2>

<Tabs>
  <Tab title="Auth0 Dashboard">
    1. Accédez à [**Dashboard > Applications > APIs**](https://manage.auth0.com/#/apis), puis sélectionnez l'API que vous souhaitez configurer.

    2. Dans la section **Access token expiration**, définissez la valeur **Anonymous Access Token Lifetime** en secondes. Le minimum est d'une journée (86400 secondes) et le maximum, de 30 jours (2592000 secondes).

           <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-automated-translations-update/docs/images/sessions/anonymous_sessions/anonymous_sessions_api.png" alt="La page des paramètres de l'API dans le Auth0 Dashboard" />

    3. Sous **Application Access Policy**, réglez la politique **Anonymous Access** à **Per-app authorization** afin d'activer les sessions anonymes qui utilisent ce public pour leurs jetons d'accès.

           <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-automated-translations-update/docs/images/sessions/anonymous_sessions/anonymous_sessions_api_policy.png" alt="La page des paramètres de la politique d'accès des applications dans le Auth0 Dashboard" />
  </Tab>

  <Tab title="Management API">
    Pour activer les sessions anonymes dans votre API, envoyez une requête `PATCH` au terminal [`/api/v2/resource-servers/{id}`](/docs/fr-ca/api/management/v2/resource-servers/patch-resource-servers-by-id) :

    ```json theme={null}
    {
      "token_lifetime_for_anonymous_access_tokens": 86400,
      "subject_type_authorization": {
        "user":           { "policy": "allow_all" },
        "client":         { "policy": "deny_all" },
        "anonymous_user": { "policy": "require_client_grant" }
      }
    }
    ```

    * `token_lifetime_for_anonymous_access_tokens` définit le délai d'expiration, en secondes, des jetons d'accès que cette API émet dans un contexte de session anonyme.
    * `subject_type_authorization.anonymous_user` détermine si certaines applications peuvent utiliser cette API dans des sessions anonymes (selon les politiques) ou si cette API interdit totalement l'émission de jetons d'accès anonymes.
  </Tab>
</Tabs>

<h2 id="create-an-api-access-policy-for-anonymous-users">
  Créer une politique d'accès à l'API pour les utilisateurs anonymes
</h2>

<Tabs>
  <Tab title="Auth0 Dashboard">
    1. Accédez à [**Dashboard > Applications > APIs**](https://manage.auth0.com/#/apis), puis sélectionnez l'API à configurer.

    2. Sélectionnez l'onglet **Application Access**.

    3. Pour chaque application à laquelle cette API doit émettre des jetons d'accès dans un contexte anonyme, sélectionnez **Edit**.

           <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-automated-translations-update/docs/images/sessions/anonymous_sessions/anonymous_sessions_api_application_access.png" alt="La page des paramètres d'accès des applications à l'API dans le Auth0 Dashboard" />

    4. Sélectionnez **Anonymous Access**, puis cliquez sur **Configure** pour définir les permissions à accorder aux utilisateurs anonymes qui utilisent cette application.

           <img src="https://mintlify.s3.us-west-1.amazonaws.com/auth0-automated-translations-update/docs/images/sessions/anonymous_sessions/anonymous_sessions_api_anonymous_access_drawer.png" alt="La page des paramètres des applications dans le Auth0 Dashboard" />

    5. Sélectionnez **Save**.
  </Tab>

  <Tab title="Management API">
    Une fois les sessions anonymes activées dans votre API, envoyez une requête `POST` au terminal [`/api/v2/client-grants`](/docs/fr-ca/api/management/v2/client-grants/post-client-grants) :

    ```json theme={null}
    {
      "audience": "YOUR_AUDIENCE",
      "client_id": "YOUR_CLIENT_ID",
      "scope": [ "read", "write", "delete" ],
      "subject_type": "anonymous_user"
    }
    ```
  </Tab>
</Tabs>

<h2 id="create-an-anonymous-session">
  Créer une session anonyme
</h2>

Une fois les Anonymous Sessions configurées dans votre locataire, votre application et votre API, vous pouvez créer une session anonyme en envoyant une requête `POST` au terminal `/anonymous/token` :

```json theme={null}
{
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET", // pour les clients confidentiels
  "audience": "YOUR_AUDIENCE",
  "scope": "anon"
}
```

La réponse contient un `session_token` et un `access_token` :

```json theme={null}
{
  "session_token": "eyJhbGciOiJkaXIiLCJlbmMiOiJBMjU2R0NNIn0...",
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 86400
}
```

<h2 id="configure-custom-claims">
  Configurer des demandes personnalisées
</h2>

Vous pouvez configurer des demandes personnalisées afin d'associer les métadonnées de session anonyme directement aux jetons d'accès émis pour un public donné.

Cela s'avère utile, car aucune Action [`post-login`](/docs/fr-ca/customize/actions/explore-triggers/post-login) ne s'exécute avec les sessions anonymes : `api.accessToken.setCustomClaim()` n'est donc pas disponible pour enrichir les jetons d'accès anonymes, comme c'est le cas pour les jetons authentifiés. Pour en savoir plus, lisez [Configurer des demandes personnalisées pour Anonymous Sessions](/docs/fr-ca/manage-users/sessions/anonymous-sessions/configure-custom-claims-for-anonymous-sessions).

<h2 id="next-steps">
  Prochaines étapes
</h2>

<Card title="Cas d’utilisation des sessions anonymes" icon="lightbulb" href="/docs/fr-ca/manage-users/sessions/anonymous-sessions/anonymous-sessions-use-cases" horizontal>
  Découvrez les cas d’utilisation des sessions anonymes.
</Card>