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

> Découvrez l’objet event du déclencheur Actions credentials-exchange, qui fournit des renseignements contextuels sur son exécution.

# Objet Event

L’objet `event` du déclencheur Actions credentials-exchange fournit des renseignements contextuels sur son exécution.

```json Event Object theme={null}
{
  "secrets": {},
  "accessToken": {
    "customClaims": {},
    "scope": []
  },
  "client": {
    "client_id": "string",
    "metadata": {},
    "name": "string"
  },
  "request": {
    "body": {},
    "geoip": {},
    "ip": "string",
    "method": "string"
  },
  "resource_server": {
    "identifier": "string"
  },
  "tenant": {
    "id": "string"
  },
  "transaction": {
    "requested_scopes": []
  }
}
```

<div id="eventaccesstoken">
  ## `event.accessToken`
</div>

<ResponseField name="event.accessToken" type="object">
  Renseignements sur le jeton d’accès à émettre.

  <Expandable title="propriétés de event.accessToken" defaultOpen>
    <ResponseField name="customClaims" type="dictionary" />

    <ResponseField name="scope" type="array of string" />
  </Expandable>
</ResponseField>

<div id="eventagent">
  ## `event.agent`
</div>

<ResponseField name="event.agent" type="object" post={["optional"]}>
  \[Accès anticipé] Informations sur l’agent intervenant dans ce flux. Défini lorsque le client qui demande le jeton est lié à un agent et que les agents en tant que principaux sont activés dans le tenant; sinon, `undefined`.

  <Expandable title="propriétés de event.agent" defaultOpen>
    <ResponseField name="agent_id" type="string">
      \[Accès anticipé] L’identifiant stable de l’agent, précédé de `agt_` (par exemple, `agt_2hVk6JxPxbRgNZDKfJQqmn`).
    </ResponseField>

    <ResponseField name="agent_metadata" type="dictionary">
      \[Accès anticipé] Métadonnées libres sous forme de paires clé-valeur associées à l’agent. Toujours définies lorsque `agent` est présent; objet vide lorsque l’agent n’a pas de métadonnées.
    </ResponseField>

    <ResponseField name="name" type="string">
      \[Accès anticipé] Le nom de l’agent lisible par l’humain.
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="eventclient">
  ## `event.client`
</div>

<ResponseField name="event.client" type="object">
  Informations sur le client utilisé lors de cet échange de jetons.

  <Expandable title="propriétés de event.client" defaultOpen>
    <ResponseField name="client_id" type="string">
      L’ID client de l’application à laquelle l’utilisateur se connecte.
    </ResponseField>

    <ResponseField name="metadata" type="dictionary">
      Objet permettant de stocker d’autres propriétés de l’application.
    </ResponseField>

    <ResponseField name="name" type="string">
      Le nom de l’application (tel que défini dans le Dashboard).
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="eventcustom_domain">
  ## `event.custom_domain`
</div>

<ResponseField name="event.custom_domain" type="object" post={["optional"]}>
  Détails sur le domaine personnalisé associé à la transaction en cours.

  <Expandable title="Propriétés de event.custom_domain" defaultOpen>
    <ResponseField name="domain" type="string">
      Le nom du domaine personnalisé.
    </ResponseField>

    <ResponseField name="domain_metadata" type="dictionary">
      Métadonnées du domaine personnalisé sous forme de paires clé-valeur.
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="eventorganization">
  ## `event.organization`
</div>

<ResponseField name="event.organization" type="dictionary" post={["optional"]}>
  Détails sur l’organisation associée à la transaction en cours.

  <Expandable title="propriétés de event.organization" defaultOpen>
    <ResponseField name="id" type="string">
      L’identifiant de l’organisation.
    </ResponseField>

    <ResponseField name="display_name" type="string">
      Le nom convivial de l’organisation.
    </ResponseField>

    <ResponseField name="metadata" type="dictionary">
      Les métadonnées associées à l’organisation.
    </ResponseField>

    <ResponseField name="name" type="string">
      Le nom de l’organisation.
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="eventrequest">
  ## `event.request`
</div>

<ResponseField name="event.request" type="object">
  Détails sur la requête à l’origine de la transaction.

  <Expandable title="propriétés de la requête" defaultOpen>
    <ResponseField name="body" type="dictionary">
      Le corps de la requête POST. Ces données ne sont disponibles que lors des flux de jeton d’actualisation, d’échange d’identifiants client et de l’Action PreUserRegistration.
    </ResponseField>

    <ResponseField name="geoip" type="dictionary">
      <Expandable title="propriétés de geoip" defaultOpen>
        <ResponseField name="cityName" type="string" post={["optional"]} />

        <ResponseField name="continentCode" type="string" post={["optional"]} />

        <ResponseField name="countryCode" type="string" post={["optional"]} />

        <ResponseField name="countryCode3" type="string" post={["optional"]} />

        <ResponseField name="countryName" type="string" post={["optional"]} />

        <ResponseField name="latitude" type="number" post={["optional"]} />

        <ResponseField name="longitude" type="number" post={["optional"]} />

        <ResponseField name="subdivisionCode" type="string" post={["optional"]} />

        <ResponseField name="subdivisionName" type="string" post={["optional"]} />

        <ResponseField name="timeZone" type="string" post={["optional"]} />
      </Expandable>
    </ResponseField>

    <ResponseField name="hostname" type="string" post={["optional"]}>
      Le nom d’hôte utilisé pour le flux d’authentification.
    </ResponseField>

    <ResponseField name="ip" type="string">
      L’adresse IP source de la requête.
    </ResponseField>

    <ResponseField name="language" type="string" post={["optional"]}>
      La langue demandée par le navigateur.
    </ResponseField>

    <ResponseField name="method" type="string">
      La méthode HTTP utilisée pour la requête
    </ResponseField>

    <ResponseField name="user_agent" type="string" post={["optional"]}>
      La valeur de l’en-tête `User-Agent` reçue lors de l’initialisation de la transaction.
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="eventresource_server">
  ## `event.resource_server`
</div>

<ResponseField name="event.resource_server" type="object">
  Renseignements sur le serveur de ressources qui émet le jeton d’accès.

  <Expandable title="propriétés de event.resource_server" defaultOpen>
    <ResponseField name="identifier" type="string">
      L’identifiant du serveur de ressources. Par exemple : `https://your-api.example.com`.
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="eventsecrets">
  ## `event.secrets`
</div>

<ResponseField name="event.secrets" type="secrets">
  Valeurs secrètes associées de façon sécurisée à cette Action.
</ResponseField>

<div id="eventtenant">
  ## `event.tenant`
</div>

<ResponseField name="event.tenant" type="object">
  Renseignements sur le tenant utilisé lors de cet échange de jetons.

  <Expandable title="Propriétés de event.tenant" defaultOpen>
    <ResponseField name="id" type="string">
      Le nom du tenant.
    </ResponseField>
  </Expandable>
</ResponseField>

<div id="eventtransaction">
  ## `event.transaction`
</div>

<ResponseField name="event.transaction" type="object">
  Renseignements sur la transaction d’échange d’identifiants.

  <Expandable title="propriétés de event.transaction" defaultOpen>
    <ResponseField name="correlation_id" type="string" post={["optional"]}>
      L’ID de corrélation peut être fourni dans la requête d’authentification initiale lorsque l’application redirige vers Universal Login. Vous pouvez utiliser cette valeur pour corréler les logs et les requêtes de votre code Action avec le parcours utilisateur.
    </ResponseField>

    <ResponseField name="requested_scopes" type="array of string">
      Les portées précisées, le cas échéant, lors de la demande du jeton d’accès.
    </ResponseField>

    <ResponseField name="target_scopes" type="array of string" post={["optional"]}>
      \[Accès anticipé] L’ensemble dynamique des portées cibles du jeton d’accès. Il est initialisé à partir des autorisations client et immédiatement mis à jour par les méthodes de portée cible d’api.transaction dans l’Action en cours et les Actions suivantes. Une fois toutes les Actions terminées, ces portées sont intersectées avec l’autorisation client. Les portées qui ne figurent pas dans l’autorisation sont silencieusement exclues du jeton d’accès final.
    </ResponseField>
  </Expandable>
</ResponseField>