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

# Associer un agent à un client

> Associez un ou plusieurs clients à un agent afin que les jetons émis à ces clients portent l'identité de l'agent, à des fins d'attribution et de traçabilité.

> [!WARNING]
>
> **La fonctionnalité Agent as Principal est en .**

Une fois l’agent [enregistré comme identité de premier ordre dans Auth0](https://auth0.com/docs/fr-ca/ai-agents-mcp/agent-as-principal/register-an-agent.md), vous pouvez l’associer à n’importe quel client OAuth. Un agent peut être associé à plusieurs clients. C’est utile lorsque vous souhaitez une seule identité logique d’agent, avec un `agent_id` unique visible dans les jetons et les journaux de plusieurs clients, par exemple des clients distincts par environnement ou par région.

L’`agent_id` est stocké dans l’objet client, et les associations sont gérées de façon dynamique.

Dès que vous associez un agent à un client, les jetons émis à ce client portent l’identité de l’agent comme sujet (`sub`) dans le cas des octrois par information d’identification client, ou comme acteur (`act`) dans le cas de l’échange de jetons et des flux de connexion standards. Pour en savoir plus, consultez [Identité de l’agent dans les jetons](https://auth0.com/docs/fr-ca/ai-agents-mcp/agent-as-principal/agent-identity-in-tokens.md).

L’`agent_id` interne demeure l’identifiant utilisé pour gérer l’agent au moyen de la Management API, que vous ayez défini un `external_agent_id` ou non.

## Associer un client à la création

Définissez le paramètre `agent_id` au moment de créer un client avec `POST /api/v2/clients` :

**Auth0 CLI**

Vous utilisez l'interface de ligne de commande Auth0? Si ce n'est pas déjà fait, [configurez et authentifiez votre session CLI](https://auth0.com/docs/fr-ca/deploy-monitor/auth0-cli.md) avant d'exécuter cette commande.

```bash theme={null}
auth0 api post "clients" \
  --data '{
    "name": "My AI Client",
    "agent_id": "YOUR_AGENT_ID"
  }'
```

**cURL**

```bash theme={null}
curl --request POST \
  --url 'https://YOUR_AUTH0_DOMAIN/api/v2/clients' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN' \
  --data '{
    "name": "My AI Client",
    "agent_id": "YOUR_AGENT_ID"
  }'
```

Si l'opération réussit, Auth0 retourne l'objet client avec l'`agent_id` que vous avez défini.

## Récupérer le client associé à l'agent

Une fois que vous avez associé un `agent_id` à un client, envoyez une requête `GET` à `/api/v2/clients/{id}` pour obtenir l'objet client :

**Auth0 CLI**

```bash theme={null}
auth0 api get "clients/YOUR_CLIENT_ID"
```

**cURL**

```bash theme={null}
curl --request GET \
  --url 'https://YOUR_AUTH0_DOMAIN/api/v2/clients/YOUR_CLIENT_ID' \
  --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN'
```

Si la requête réussit, Auth0 renvoie l'objet client avec l'`agent_id` que vous avez défini.

## Associer un client existant

Vous pouvez associer un client existant à l'aide du Auth0 Dashboard ou de la Management API.

**Auth0 Dashboard**

1. Accédez à **Dashboard > Agents**, sélectionnez l'agent, puis ouvrez son onglet **Applications**.
2. Sélectionnez **Add Application**, puis choisissez les applications à associer à l'agent dans la fenêtre modale. Vous pouvez en sélectionner plusieurs.
3. Sélectionnez **Add Applications**.

Une fois l'ajout réussi, les applications s'affichent sous l'onglet **Applications** de l'agent.

**Management API**

Associez un client existant à un agent au moyen de `PATCH /api/v2/clients/{id}` :

**Auth0 CLI**

```bash theme={null}
auth0 api patch "clients/YOUR_CLIENT_ID" \
  --data '{
    "agent_id": "YOUR_AGENT_ID"
  }'
```

**cURL**

```bash theme={null}
curl --request PATCH \
  --url 'https://YOUR_AUTH0_DOMAIN/api/v2/clients/YOUR_CLIENT_ID' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN' \
  --data '{
    "agent_id": "YOUR_AGENT_ID"
  }'
```

En cas de succès, Auth0 renvoie l'objet client mis à jour avec l'`agent_id` que vous avez défini.

## Supprimer l'association à l'agent

Pour dissocier un client de son agent, définissez `agent_id` à `null` au moyen de `PATCH /api/v2/clients/{id}` :

**Auth0 CLI**

```bash theme={null}
auth0 api patch "clients/YOUR_CLIENT_ID" \
  --data '{
    "agent_id": null
  }'
```

**cURL**

```bash theme={null}
curl --request PATCH \
  --url 'https://YOUR_AUTH0_DOMAIN/api/v2/clients/YOUR_CLIENT_ID' \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN' \
  --data '{
    "agent_id": null
  }'
```

Après la dissociation, les nouveaux jetons émis au client ne portent plus l'identité de l'agent. Les jetons existants demeurent valides jusqu'à leur expiration.

## Prochaines étapes

* Apprendre comment Auth0 intègre l'[identité de l'agent dans les jetons](https://auth0.com/docs/fr-ca/ai-agents-mcp/agent-as-principal/agent-identity-in-tokens.md)