View a markdown version of this page

Yandex - Batuan Dasar Amazon AgentCore
Ke luar

Yandex

Yandex dapat dikonfigurasi sebagai penyedia kredensi AgentCore Identitas untuk akses sumber daya keluar. Ini memungkinkan agen Anda untuk mengautentikasi pengguna melalui layanan OAuth2 Yandex dan mendapatkan token akses untuk sumber daya API Yandex.

Ke luar

catatan

AgentCore Identitas mengeluarkan URL callback OAuth2 unik untuk setiap penyedia kredensi yang Anda buat. URL panggilan balik unik memungkinkan pengikatan sesi, yang melindungi pertukaran kode otorisasi OAuth2 terhadap pemutaran ulang dan CSRF-style serangan lintas penyedia dengan memastikan respons otorisasi hanya dapat ditukarkan terhadap penyedia kredensi tertentu yang memulainya. Karena URL unik per penyedia, Anda tidak akan mengetahuinya sampai setelah Anda meneleponCreateOauth2CredentialProvider. Buat klien Yandex OAuth2 Anda terlebih dahulu, lalu kembali ke konsol pengembang Yandex untuk mendaftarkan URL panggilan balik setelah AgentCore Identity mengeluarkannya.

Langkah 1: Buat klien Yandex OAuth2

Gunakan prosedur berikut untuk menyiapkan aplikasi Yandex OAuth2 dan dapatkan kredensi klien yang diperlukan untuk Identity. AgentCore Anda akan mendaftarkan URI pengalihan di Langkah 3, setelah AgentCore Identity mengeluarkan URL callback unik.

Untuk mengkonfigurasi aplikasi Yandex OAuth2

  1. Buka konsol pengembang untuk Yandex dihttps://oauth.yandex.com/.

  2. Pilih Buat aplikasi.

  3. Berikan nama untuk aplikasi Anda.

  4. Untuk platform, pilih Layanan Web.

  5. Pilih Simpan dan Lanjutkan.

  6. Pilih izin yang diperlukan untuk aplikasi Anda dan kemudian pilih Simpan dan Lanjutkan.

  7. Biarkan bidang URI pengalihan kosong untuk saat ini - Anda akan menambahkan URL panggilan balik unik di Langkah 3.

  8. Pilih Simpan dan Lanjutkan.

  9. Setelah klien dibuat, perhatikan ID klien dan rahasia klien yang ditetapkan ke aplikasi Anda karena Anda akan memerlukannya untuk mengonfigurasi penyedia Yandex di AgentCore Identity.

Untuk lebih jelasnya, lihat dokumentasi OAuth Yandex.

Langkah 2: Buat penyedia kredensi AgentCore Identitas

Untuk mengkonfigurasi Yandex sebagai penyedia sumber daya keluar, gunakan yang berikut ini:

{
  "name": "Yandex",
  "credentialProviderVendor": "YandexOauth2",
  "oauth2ProviderConfigInput" : {
    "includedOauth2ProviderConfig": {
      "clientId": "your-client-id",
      "clientSecret": "your-client-secret"
    }
  }
}

CreateOauth2CredentialProviderResponsnya mencakup callbackUrl bidang. URL ini unik untuk penyedia kredensi ini dan terlihat seperti:https://bedrock-agentcore.us-east-1.amazonaws.com/identities/oauth2/callback/XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX. Simpan nilai ini untuk langkah selanjutnya.

Langkah 3: Daftarkan URL panggilan balik unik dengan Yandex

Kembali ke konsol pengembang Yandex dan tambahkan URL panggilan balik unik ke daftar URI pengalihan aplikasi OAuth2 Anda.

  1. Masuk ke konsol pengembang Yandex dan buka aplikasi OAuth2 yang Anda buat di Langkah 1.

  2. Tambahkan callbackUrl nilai yang dikembalikan oleh CreateOauth2CredentialProvider ke konfigurasi URI pengalihan aplikasi.

  3. Simpan perubahan Anda.