View a markdown version of this page

X - Batuan Dasar Amazon AgentCore
Ke luar

X

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

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 X OAuth2 Anda terlebih dahulu, lalu kembali ke konsol pengembang X untuk mendaftarkan URL panggilan balik setelah AgentCore Identity mengeluarkannya.

Langkah 1: Buat klien X OAuth2

Gunakan prosedur berikut untuk menyiapkan aplikasi X OAuth2 dan mendapatkan 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 X OAuth2

  1. Buka portal pengembang X.

  2. Di bilah navigasi kiri, pilih Project & Apps.

  3. Pilih pada proyek X yang telah Anda buat untuk aplikasi.

  4. Di bawah header Aplikasi pilih Tambahkan Aplikasi.

  5. Pilih Buat baru.

  6. Berikan nama dan deskripsi untuk aplikasi Anda.

  7. Di bilah navigasi kiri, pilih aplikasi yang baru saja dibuat.

  8. Pada halaman detail aplikasi untuk aplikasi baru Anda, pilih Edit di setelan Autentikasi Pengguna.

  9. Pilih izin Aplikasi yang diperlukan untuk aplikasi Anda.

  10. Untuk Jenis Aplikasi pilih Aplikasi Web, Aplikasi Otomatis, atau Bot.

  11. Di bawah Info Aplikasi, biarkan bidang URL callback kosong untuk saat ini — Anda akan menambahkan URL panggilan balik unik di Langkah 3.

  12. Untuk URL Situs Web, masukkan URL untuk aplikasi Anda.

  13. Pilih Simpan.

  14. Di bawah tab Kunci dan token untuk aplikasi Anda, buka ID Klien OAuth 2.0 dan Rahasia Klien.

  15. Pilih Hasilkan dan catat ID klien dan rahasia yang dihasilkan karena Anda memerlukan informasi ini untuk mengonfigurasi penyedia sumber daya X di AgentCore Identity.

catatan

X hanya menampilkan rahasia klien lengkap saat dihasilkan, jika Anda kehilangan informasi ini, Anda harus membuat kembali rahasia klien di portal pengembang X.

Untuk detail selengkapnya, lihat dokumentasi OAuth 2.0 X.

Langkah 2: Buat penyedia kredensi AgentCore Identitas

Untuk mengonfigurasi X sebagai penyedia sumber daya keluar, gunakan yang berikut ini:

{
  "name": "X",
  "credentialProviderVendor": "XOauth2",
  "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 callback unik dengan X

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

  1. Masuk ke konsol pengembang X 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.