Mengerti sambungan OAuth

OAuth adalah pola otentikasi yang didukung, tetapi setiap aliran persetujuan harus dikonfigurasi dan diuji untuk tujuan yang tepat. Tes kunci API yang berhasil tidak menentukan ketersediaan OAuth untuk klien AI tertentu.

Identifikasi dua hubungan persetujuan#

Sebuah klien AI dapat melakukan otentikasi ke sebuah instalasi atau gatewaynya menggunakan aliran masuk pihak pertama yang didukung. Terpisah, sebuah server mungkin membutuhkan kredensial OAuth untuk memanggil layanan upstream atas nama akun bisnis.

Ini tidak dapat ditukar. Sebuah broker OAuth upstream mungkin membutuhkan otorisasi provider dan titik akhir token, rincian pendaftaran klien dan scope. Jangan tukarkan sambungan kunci API yang ada ke OAuth hanya karena klien menawarkan tombol OAuth.

Ikuti aliran sambungan yang disepakati#

Gunakan alamat server atau gateway yang tepat dalam handoff. Ketika layar persetujuan peramban terbuka, periksa domain, akun dan akses yang diminta. Hanya otorisasi penonton dan cakupan yang diinginkan menggunakan proses normal penyedia.

Jangan kirim URL callback yang berisi kode otorisasi untuk mendukung atau tempelkannya ke dalam percakapan AI. Simpan token dan rahasia klien pada rute konfigurasi terenkripsi yang didukung.

Verifikasi setelah persetujuan#

Konfirmasikan bahwa klien AI kembali ke keadaan terhubung, hanya menemukan alat yang diinginkan dan menyelesaikan aksi hanya baca yang disepakati dalam akun yang benar. Dimana refresh adalah bagian dari aliran yang dikonfigurasi, verifikasikannya daripada mengasumsikan bahwa sambungan awal akan berlangsung tanpa batas.

Ketika persetujuan gagal#

Catat tahapan dan kesalahan yang diedit. Alamat redirect yang tidak cocok, aliran pendaftaran yang tidak didukung, akun yang salah, skop yang hilang atau upstream grant yang telah habis dapat memerlukan perbaikan yang berbeda. Jangan matikan otentikasi, terima peringatan sertifikat atau gunakan kembali token orang lain sebagai solusi.