Passer au contenu principal
La fonctionnalité Auth for UCP est en accès anticipé.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é.
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 de votre locataire.

Informations requises

  • Une API 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) 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.
  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.

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