View a markdown version of this page

Tambahkan kunci API - Batu Dasar Amazon AgentCore

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

Tambahkan kunci API

Kunci API menyediakan otentikasi berbasis kunci untuk layanan yang memerlukan akses kunci langsung dengan kemampuan penyimpanan aman. Kunci API adalah pengidentifikasi unik yang digunakan untuk mengotentikasi dan mengotorisasi akses ke sumber daya, memungkinkan agen Anda mengakses layanan eksternal tanpa menyematkan kredentif sensitif secara langsung dalam kode aplikasi Anda.

Untuk menambahkan kunci API

  1. Buka konsol AgentCore Identity.

  2. Di bagian Outbound Auth, pilih Tambahkan klien/kunci API OAuth, lalu pilih Tambahkan kunci API.

  3. Untuk Nama, Anda dapat menggunakan nama yang dibuat secara otomatis atau memasukkan nama deskriptif Anda sendiri untuk membantu mengidentifikasi kunci API ini di akun Anda. Gunakan karakter alfanumerik, tanda hubung, dan garis bawah saja, dengan panjang maksimum 50 karakter.

  4. Untuk metode pemilihan kunci API, pilih salah satu opsi berikut:

    1. Menyediakan kunci API — Masukkan nilai kunci API secara langsung.

      1. Untuk kunci API, masukkan nilai kunci yang disediakan oleh layanan eksternal Anda. AgentCore Identity menyimpan nilai ini dengan aman dan membuatnya tersedia untuk agen Anda saat runtime.

    2. Berikan kunci API melalui Secrets Manager — Referensikan rahasia yang disimpan di AWS Secrets Manager alih-alih memasukkan nilai secara langsung.

      1. Untuk Manajer Rahasia, masukkan atau pilih ARN rahasia Manajer Rahasia yang berisi kunci API Anda.

      2. Untuk kunci JSON, masukkan kunci JSON di rahasia Manajer Rahasia Anda yang berisi nilai kunci API.

  5. Pilih Tambahkan.

Setelah membuat kunci API, AgentCore Identity menyediakan ARN yang dapat Anda rujuk dalam kode agen Anda untuk mengakses kunci yang disimpan tanpa mengekspos informasi sensitif dalam aplikasi Anda. Anda dapat menemukan ARN ini di halaman properti kunci API (Pilih nama kunci API di bagian Outbound Auth).