View a markdown version of this page

Auth0 oleh Okta - Batu Dasar Amazon AgentCore
Ke dalamKe luar

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Auth0 oleh Okta

Auth0 dapat dikonfigurasi sebagai penyedia identitas untuk mengakses AgentCore Gateway dan Runtime, atau penyedia kreden AgentCore sia Identity untuk akses sumber daya keluar. Hal ini memungkinkan agen Anda untuk mengotentikasi dan mengotorisasi pengguna agen dengan Auth0 sebagai penyedia identitas dan server otorisasi, atau agen Anda untuk mendapatkan kredenSIAL untuk mengakses sumber daya yang disahkan 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 Identitas 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 mengatur Auth0 dan mendapatkan nilai konfigurasi yang diperlukan untuk otentikasi Gateway.

Untuk mengkonfigurasi 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 (misalnya, “gateway-api”).

    4. Pilih algoritma penandatanganan (RS256 disarankan).

    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 pada 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 your-domain mana domain penyewa Auth0 Anda (misalnya, “dev-example.us.auth0.com”).

  6. Konfigurasikan Inbound Auth dengan nilai-nilai berikut:

    1. URL Penemuan: URL yang dibuat pada langkah sebelumnya

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

Ke luar

catatan

AgentCore Identity mengeluarkan URL callback OAuth2 unik untuk setiap penyedia kredensia 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 kredensia tertentu yang memulainya. Karena URL-nya 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 mengatur aplikasi Auth0 OAuth2 dan mendapatkan kredenSIAL klien yang diperlukan untuk Identitas. 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 Reg uler sebagai jenis aplikasi.

  4. Pilih Buat.

  5. Pada tab Peng aturan aplikasi, biarkan URL Panggilan Balik yang Di izinkan 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 membuat aplikasi.

Langkah 2: Buat penyedia kreden AgentCore sia Identitas

Untuk mengkonfigurasi 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"
    }
  }
}

Jaw CreateOauth2CredentialProvider abannya termasuk 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 berikutnya.

Langkah 3: Daftarkan URL callback 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 Peng aturan, tempel callbackUrl nilai yang dikembalikan oleh CreateOauth2CredentialProvider ke URL Panggilan Bal ik yang Diizinkan.

  3. Pilih Simpan Perubahan.