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

# Configurer votre serveur de ressources UCP

> Configurez une API en tant que serveur UCP et publiez ses permissions dans les métadonnées de découverte de votre locataire.

> [!WARNING]
>
> **La fonctionnalité Auth for UCP est en [accès anticipé](https://auth0.com/docs/fr-ca/troubleshoot/product-lifecycle/product-release-stages.md).**
>
> En utilisant cette fonctionnalité, vous acceptez les conditions applicables à l’essai gratuit énoncées dans le Contrat d’abonnement principal d’Okta. Si vous souhaitez y participer, veuillez manifester votre intérêt en remplissant le [formulaire du programme de partenariat d’accès anticipé limité](https://forms.gle/7qjaSh4ZQSqrysf27).

Les plateformes d'agents comme Gemini génèrent leur écran de consentement à partir des permissions annoncées par votre serveur d'autorisation. Pour que vos permissions UCP puissent être découvertes, configurez votre API en tant que serveur de ressources UCP. Auth0 publie alors ces permissions dans les [métadonnées de découverte](https://auth0.com/docs/fr-ca/ai-agents-mcp/auth-for-ucp/scope-discovery-metadata.md) de votre locataire.

## Informations requises

* Une [API](https://auth0.com/docs/fr-ca/get-started/apis) qui représente votre serveur UCP.
* Profil de compatibilité du paramètre resource (facultatif) : pour les clients MCP, nous vous recommandons d'activer ce profil dans les paramètres de votre locataire. Le serveur d'autorisation peut ainsi traiter les requêtes propres à une ressource ([RFC 8707](https://www.rfc-editor.org/rfc/rfc8707.html#name-resource-parameter)) en vérifiant le paramètre resource lorsque le public n'est pas fourni.

## Configurer le serveur de ressources UCP

Vous ne pouvez configurer qu'une seule API par locataire comme serveur de ressources UCP.

> [tab] Auth0 Dashboard
>
> 1. Accédez à **Dashboard > Applications > APIs** et sélectionnez votre API.
> 2. Dans l'onglet **Settings (Paramètres)**, repérez la section **Universal Commerce Protocol**.
> 3. Activez **UCP Resource Server (Serveur de ressources UCP)**.
> 4. Sélectionnez **Sauvegarder**.
>
> Si ce paramètre est déjà activé pour une autre API de votre locataire, la sauvegarde génère une erreur indiquant le nom de l'API en conflit.
>
> Une fois UCP configuré pour l'API, ajoutez vos permissions UCP :
>
> 1. Sélectionnez l'onglet **Permissions (Autorisations)**.
> 2. Ajoutez chaque permission prise en charge par votre serveur UCP. Les permissions UCP commencent par `dev.ucp`, par exemple `dev.ucp.shopping.order:read`, `dev.ucp.shopping.cart:manage` et `dev.ucp.shopping.checkout:manage`. Saisissez une description pour chaque permission.

> [tab] Management API
>
> Assurez-vous que votre jeton d'accès Management API dispose de l'autorisation `create:resource_servers` ou `update:resource_servers`.
>
> Pour créer un nouveau serveur de ressources UCP, effectuez une requête `POST` vers `/api/v2/resource-servers` :
>
> ```bash theme={null}
> curl --request POST \
>   --url 'https://YOUR_AUTH0_DOMAIN/api/v2/resource-servers' \
>   --header 'Content-Type: application/json' \
>   --header 'Authorization: Bearer YOUR_MGMT_API_TOKEN' \
>   --data '{
>     "name": "Acme UCP Server",
>     "identifier": "https://ucp.acme.example.com",
>     "type": "universal_commerce_protocol_server",
>     "scopes": [
>       { "value": "dev.ucp.shopping.order:read", "description": "Read orders" },
>       { "value": "dev.ucp.shopping.cart:manage", "description": "Manage carts" },
>       { "value": "dev.ucp.shopping.checkout:manage", "description": "Manage checkout" }
>     ]
>   }'
> ```
>
> Pour configurer une API existante comme serveur UCP, effectuez une requête `PATCH` vers `/api/v2/resource-servers/{id}` avec `"type": "universal_commerce_protocol_server"`. Définissez le type avant d'ajouter les permissions `dev.ucp.*`, ou dans la même requête. Toute requête qui ajoute ces permissions UCP à une API standard est rejetée.

## Définir un public par défaut

Les plateformes d'agents comme Gemini envoient le paramètre `scope`, mais pas de paramètre `audience`. Sans public, Auth0 ne peut pas déterminer pour quelle API émettre un jeton. Pendant la période d'accès anticipé, Auth0 résout cette valeur à partir du public par défaut de votre locataire.

Définissez l'identifiant de votre serveur de ressources UCP comme public par défaut du locataire :

1. Accédez à **Dashboard > Settings > General**.
2. Sous **API Authorization Settings**, définissez **Default Audience** sur l'identifiant de votre serveur de ressources UCP.
3. Sélectionnez **Sauvegarder**.

Un public par défaut propre à chaque application est prévu dans une version ultérieure.

## Prochaines étapes

* [Configurer la liaison de comptes standard](https://auth0.com/docs/fr-ca/ai-agents-mcp/auth-for-ucp/set-up-standard-account-linking.md)