View a markdown version of this page

Contoh: Otentikasi dengan pemberian kode otorisasi saat memanggil gateway - Batu Dasar Amazon AgentCore

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

Contoh: Otentikasi dengan pemberian kode otorisasi saat memanggil gateway

Jika Anda mengatur target gateway dengan pemberian kode otorisasi (untuk informasi selengkapnya, lihat otorisasi OAuth), defaultReturnUrl yang Anda tentukan saat membuat gateway akan menjadi tautan yang dialihkan browser pengguna setelah otentikasi.

Anda dapat menggunakan _meta bidang di params objek badan permintaan untuk memodifikasi konfigurasi default. Dengan otentikasi 3LO, Anda memet _meta akan bidang ke objek berikut:

{
    "aws.bedrock-agentcore.gateway/credentialProviderConfiguration": {
        "oauthCredentialProvider": {
            "returnUrl": "string",
            "forceAuthentication": bool
        }
    }
}

Anda dapat melakukan tindakan berikut:

  • Untuk mengganti URL pengembalian default dengan URL yang berbeda, tentukan yang barureturnUrl.

  • Untuk menghapus otentikasi sebelumnya dari brankas token dan mengembalikan URL otorisasi baru saat permintaan dibuat, atur nil forceAuthentication ainya ketrue.

Misalnya, permintaan berikut akan memanggil LinkedIn3LO___gateUserInfo alat melalui target gateway, memaksa pengguna untuk mengotentikasi dengan URL otorisasi baru, dan mengarahkan pengguna ke https://your-public-domain.com/callback setelah otentikasi:

{
  "jsonrpc": "2.0",
  "id": 24,
  "method": "tools/call",
  "params": {
    "name": "LinkedIn3LO___getUserInfo",
    "arguments": {},
    "_meta": {
        "aws.bedrock-agentcore.gateway/credentialProviderConfiguration": {
            "oauthCredentialProvider": {
                "returnUrl": "https://your-public-domain.com/callback",
                "forceAuthentication": true
            }
        }
    }
  }
}