View a markdown version of this page

FusionAuth - Batuan Dasar Amazon AgentCore
Ke luar

FusionAuth

FusionAuth dapat dikonfigurasi sebagai penyedia kredensi sumber daya keluar untuk AgentCore Identity. Ini memungkinkan agen Anda untuk mengautentikasi pengguna melalui layanan FusionAuth OAuth2 dan mendapatkan token akses untuk FusionAuth sumber daya 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 FusionAuth OAuth2 Anda terlebih dahulu, lalu kembali ke konsol FusionAuth pengembang untuk mendaftarkan URL panggilan balik setelah AgentCore Identity mengeluarkannya.

Langkah 1: Buat klien FusionAuth OAuth2

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

Untuk mengkonfigurasi aplikasi FusionAuth OAuth2

  1. Buka konsol pengembang untuk FusionAuth.

  2. Di bilah navigasi utama, pilih Aplikasi.

  3. Pilih Tambah untuk membuat aplikasi baru.

  4. Masukkan nama untuk aplikasi Anda.

  5. Dalam formulir tandai yang berikut ini sesuai kebutuhan: Otentikasi Klien, PKCE.

  6. Biarkan daftar URL pengalihan resmi kosong untuk saat ini - Anda akan menambahkan URL panggilan balik unik di Langkah 3.

  7. Tambahkan cakupan yang diperlukan untuk aplikasi Anda.

  8. Catat ID klien dan rahasia klien. Anda memerlukan informasi ini untuk mengonfigurasi penyedia FusionAuth sumber daya di AgentCore Identity.

Untuk detail selengkapnya, lihat FusionAuthdokumentasi OAuth.

Langkah 2: Buat penyedia kredensi AgentCore Identitas

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

{
  "name": "FusionAuth",
  "credentialProviderVendor": "FusionAuthOauth2",
  "oauth2ProviderConfigInput" : {
    "includedOauth2ProviderConfig": {
      "clientId": "your-client-id",
      "clientSecret": "your-client-secret",
      "authorizationEndpoint": "https://your-tenant-authorization-url",
      "tokenEndpoint": "https://your-tenant-token-endpoint",
      "issuer": "https://your-tenant-token-issuer"
    }
  }
}

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 FusionAuth

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

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