OAuth接続を理解する

OAuth はサポートされている認証パターンですが、各同意フローは正確な宛先に対して構成およびテストする必要があります。 API キー テストが成功しても、特定の AI クライアントに対する OAuth の準備が確立されるわけではありません。

2 つの同意関係を特定する#

AI クライアントは、サポートされているファーストパーティのサインイン フローを使用して、インストールまたはそのゲートウェイに対して認証を行うことができます。これとは別に、サーバーはビジネス アカウントに代わってアップストリーム サービスを呼び出すために OAuth 資格情報を必要とする場合があります。

これらは交換可能ではありません。アップストリーム OAuth ブローカーには、プロバイダーの承認とトークン エンドポイント、クライアント登録の詳細とスコープが必要な場合があります。クライアントが OAuth ボタンを提供するという理由だけで、既存の API キー接続を OAuth に切り替えないでください。

合意された接続フローに従ってください#

ハンドオフでは正確なサーバーまたはゲートウェイのアドレスを使用します。ブラウザの同意画面が開いたら、ドメイン、アカウント、要求されたアクセスを確認します。プロバイダーの通常のプロセスを使用して、対象となる対象者とスコープのみを承認します。

AI 会話をサポートするための認証コードを含むコールバック URL を送信したり、AI 会話に貼り付けたりしないでください。サポートされている暗号化された構成ルートにトークンとクライアント シークレットを保持します。

同意後の確認#

AI クライアントが接続状態に戻り、目的のツールのみを検出し、正しいアカウントで合意された読み取り専用アクションを完了することを確認します。更新が構成されたフローの一部である場合は、最初の接続が無期限に続くと想定するのではなく、検証してください。

同意が得られない場合#

ステージと編集されたエラーを記録します。リダイレクト アドレスの不一致、サポートされていない登録フロー、間違ったアカウント、スコープの欠落、アップストリーム許可の期限切れなどにより、別の修正が必要になる場合があります。回避策として、認証を無効にしたり、証明書の警告を受け入れたり、他の人のトークンを再利用したりしないでください。