View a markdown version of this page

Auth0 oleh Okta - Batuan Dasar Amazon AgentCore
Ke dalamKe luar

Auth0 oleh Okta

Auth0 dapat dikonfigurasi sebagai penyedia identitas untuk mengakses AgentCore Gateway dan Runtime, atau penyedia kredensi AgentCore Identitas untuk akses sumber daya keluar. Ini memungkinkan agen Anda untuk mengautentikasi dan mengotorisasi pengguna agen dengan Auth0 sebagai penyedia identitas dan server otorisasi, atau agen Anda untuk mendapatkan kredensyal untuk mengakses sumber daya yang diotorisasi oleh Auth0.

Ke dalam

Untuk menambahkan Auth0 sebagai penyedia identitas dan server otorisasi untuk mengakses AgentCore Gateway dan Runtime, Anda harus:

  • Konfigurasikan URL penemuan dari direktori IDP Anda. Ini membantu AgentCore Identity mendapatkan metadata yang terkait dengan server otorisasi OAuth dan kunci verifikasi token Anda.

  • Masukkan aud klaim yang valid untuk token. Ini membantu memvalidasi token yang berasal dari IDP Anda dan memungkinkan akses untuk token yang berisi klaim yang diharapkan.

Gunakan prosedur berikut untuk menyiapkan Auth0 dan mendapatkan nilai konfigurasi yang diperlukan untuk otentikasi Gateway.

Untuk mengonfigurasi Auth0 untuk otentikasi masuk

  1. Buat API di Auth0:

    1. Masuk ke dasbor Auth0 Anda.

    2. Buka API dan pilih Buat API.

    3. Masukkan nama dan pengenal untuk API Anda (mis., “gateway-api”).

    4. Pilih algoritma penandatanganan (disarankan RS256).

    5. Pilih Buat.

  2. Konfigurasikan cakupan API:

    1. Di pengaturan API, buka tab Scopes.

    2. Tambahkan cakupan seperti “invoke:gateway” dan “read:gateway”.

  3. Buat aplikasi:

    1. Buka Aplikasi dan pilih Buat Aplikasi.

    2. Pilih Aplikasi Mesin ke Mesin.

    3. Pilih API yang Anda buat di langkah 1.

    4. Otorisasi aplikasi untuk cakupan yang Anda buat.

    5. Pilih Buat.

  4. Rekam ID klien dan rahasia klien dari pengaturan aplikasi. Anda memerlukan nilai-nilai ini untuk mengonfigurasi penyedia Auth0 di AgentCore Identity.

  5. Buat URL penemuan untuk penyewa Auth0 Anda:

    https://your-domain/.well-known/openid-configuration

    Di mana your-domain domain penyewa Auth0 Anda (misalnya, “dev-example.us.auth0.com”).

  6. Konfigurasikan Inbound Auth dengan nilai-nilai berikut:

    1. URL Discovery: URL yang dibangun pada langkah sebelumnya

    2. Audiens yang diizinkan: Pengenal API yang Anda buat di langkah 1

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 aplikasi Auth0 Anda terlebih dahulu, lalu kembali ke dasbor Auth0 untuk mendaftarkan URL callback setelah AgentCore Identity mengeluarkannya.

Langkah 1: Buat aplikasi Auth0

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

  1. Masuk ke dasbor Auth0 Anda.

  2. Buka Aplikasi dan pilih Buat Aplikasi.

  3. Masukkan nama untuk aplikasi Anda dan pilih Aplikasi Web Reguler sebagai jenis aplikasi.

  4. Pilih Buat.

  5. Pada tab Pengaturan aplikasi, biarkan URL Callback Diizinkan kosong untuk saat ini - Anda akan menambahkan URL panggilan balik unik di Langkah 3.

  6. Konfigurasikan koneksi, cakupan, dan izin apa pun yang diperlukan untuk aplikasi Anda.

  7. Rekam ID Klien dan Rahasia Klien dari pengaturan aplikasi. Anda memerlukan nilai-nilai ini untuk mengonfigurasi penyedia Auth0 di AgentCore Identity.

  8. Perhatikan domain penyewa Auth0 Anda (misalnya,dev-example.us.auth0.com). Anda akan menggunakan ini untuk membangun titik akhir otorisasi, token, dan penerbit di Langkah 2.

Untuk detail selengkapnya, lihat dokumentasi Auth0 tentang pembuatan aplikasi.

Langkah 2: Buat penyedia kredensi AgentCore Identitas

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

{
  "name": "NAME",
  "credentialProviderVendor": "Auth0Oauth2",
  "oauth2ProviderConfigInput" : {
    "includedOauth2ProviderConfig": {
      "clientId": "your-client-id",
      "clientSecret": "your-client-secret",
      "authorizationEndpoint": "https://your-auth0-tenant.auth0.com/authorize",
      "tokenEndpoint": "https://your-auth0-tenant.auth0.com/oauth/token",
      "issuer": "https://your-auth0-tenant.auth0.com"
    }
  }
}

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 Auth0

Kembali ke dasbor Auth0 dan tambahkan URL callback unik ke callback yang diizinkan aplikasi Anda.

  1. Masuk ke dasbor Auth0 Anda dan buka aplikasi yang Anda buat di Langkah 1.

  2. Pada tab Pengaturan, tempel callbackUrl nilai yang dikembalikan ke URL Panggilan CreateOauth2CredentialProvider Balik yang Diizinkan.

  3. Pilih Simpan Perubahan.