Comprendre les connexions OAuth

OAuth est un modèle d'authentification pris en charge, mais chaque flux de consentement doit être configuré et testé pour la destination exacte. Un test de clé API réussi n'établit pas la préparation à OAuth pour un client IA particulier.

Identifier les deux relations de consentement#

Un client AI peut s'authentifier auprès d'une installation ou de sa passerelle à l'aide d'un flux de connexion propriétaire pris en charge. Par ailleurs, un serveur peut avoir besoin d'informations d'identification OAuth pour appeler un service en amont au nom d'un compte professionnel.

Ceux-ci ne sont pas interchangeables. Un courtier OAuth en amont peut avoir besoin de l'autorisation du fournisseur et des points de terminaison du jeton, des détails et des étendues de l'enregistrement du client. Ne basculez pas une connexion de clé API existante vers OAuth simplement parce que le client propose un bouton OAuth.

Suivez le flux de connexion convenu#

Utilisez l’adresse exacte du serveur ou de la passerelle lors du transfert. Lorsqu'un écran de consentement du navigateur s'ouvre, vérifiez le domaine, le compte et l'accès demandé. Autorisez uniquement le public et la portée prévus en utilisant le processus normal du fournisseur.

N'envoyez pas d'URL de rappel contenant un code d'autorisation pour le prendre en charge ou ne le collez pas dans une conversation AI. Conservez les jetons et les secrets client dans la route de configuration chiffrée prise en charge.

Vérifier après consentement#

Confirmez que le client AI revient à un état connecté, découvre uniquement les outils prévus et effectue l'action en lecture seule convenue dans le compte approprié. Lorsque l’actualisation fait partie du flux configuré, vérifiez-la plutôt que de supposer que la connexion initiale durera indéfiniment.

Lorsque le consentement échoue#

Enregistrez la scène et l’erreur expurgée. Une adresse de redirection incompatible, un flux d'enregistrement non pris en charge, un compte incorrect, une portée manquante ou une subvention en amont expirée peuvent nécessiter différents correctifs. Ne désactivez pas l'authentification, n'acceptez pas un avertissement de certificat ou ne réutilisez pas le jeton d'une autre personne comme solution de contournement.