Entenda as conexões OAuth

OAuth é um padrão de autenticação compatível, mas cada fluxo de consentimento deve ser configurado e testado para o destino exato. Um teste de chave de API bem-sucedido não estabelece a prontidão do OAuth para um cliente de IA específico.

Identifique as duas relações de consentimento#

Um cliente de IA pode se autenticar em uma instalação ou em seu gateway usando um fluxo de login primário compatível. Separadamente, um servidor pode precisar de credenciais OAuth para chamar um serviço upstream em nome de uma conta comercial.

Eles não são intercambiáveis. Um corretor OAuth upstream pode precisar de autorização do provedor e terminais de token, detalhes e escopos de registro do cliente. Não alterne uma conexão de chave de API existente para OAuth apenas porque o cliente oferece um botão OAuth.

Siga o fluxo de conexão acordado#

Use o endereço exato do servidor ou gateway na transferência. Quando uma tela de consentimento do navegador for aberta, verifique o domínio, a conta e o acesso solicitado. Autorize apenas o público e o escopo pretendidos usando o processo normal do provedor.

Não envie um URL de retorno de chamada contendo um código de autorização para suporte ou cole-o em uma conversa de IA. Mantenha tokens e segredos do cliente na rota de configuração criptografada suportada.

Verifique após consentimento#

Confirme se o cliente de IA retorna a um estado conectado, descobre apenas as ferramentas pretendidas e conclui a ação somente leitura acordada na conta correta. Onde a atualização fizer parte do fluxo configurado, verifique-a em vez de assumir que a conexão inicial durará indefinidamente.

Quando o consentimento falha#

Registre o estágio e o erro redigido. Um endereço de redirecionamento incompatível, fluxo de registro sem suporte, conta errada, escopo ausente ou concessão upstream expirada podem exigir correções diferentes. Não desabilite a autenticação, aceite um aviso de certificado ou reutilize o token de outra pessoa como solução alternativa.