Bagaimana Amazon Bedrock AgentCore bekerja dengan IAM
Sebelum Anda menggunakan IAM untuk mengelola akses AgentCore, pelajari fitur IAM yang tersedia untuk digunakan. AgentCore
| Fitur IAM | AgentCore dukungan |
|---|---|
|
Ya |
|
|
Parsial |
|
|
Ya |
|
|
Ya |
|
|
Ya |
|
|
Tidak |
|
|
Parsial |
|
|
Ya |
|
|
Ya |
|
|
Ya |
|
|
Ya |
Untuk mendapatkan tampilan tingkat tinggi tentang cara AgentCore dan AWS layanan lain bekerja dengan sebagian besar fitur IAM, lihat AWS layanan yang bekerja dengan IAM di Panduan Pengguna IAM.
Identity-based kebijakan untuk AgentCore
Mendukung kebijakan berbasis identitas: Ya
Identity-based kebijakan adalah dokumen kebijakan izin JSON yang dapat Anda lampirkan ke identitas, seperti pengguna IAM, grup pengguna, atau peran. Kebijakan ini mengontrol jenis tindakan yang dapat dilakukan oleh pengguna dan peran, di sumber daya mana, dan berdasarkan kondisi seperti apa. Untuk mempelajari cara membuat kebijakan berbasis identitas, lihat Tentukan izin IAM kustom dengan kebijakan terkelola pelanggan dalam Panduan Pengguna IAM.
Dengan kebijakan berbasis identitas IAM, Anda dapat menentukan secara spesifik apakah tindakan dan sumber daya diizinkan atau ditolak, serta kondisi yang menjadi dasar dikabulkan atau ditolaknya tindakan tersebut. Untuk mempelajari semua elemen yang dapat Anda gunakan dalam kebijakan JSON, lihat Referensi elemen kebijakan JSON IAM dalam Panduan Pengguna IAM.
Identity-based contoh kebijakan untuk AgentCore
Untuk melihat contoh kebijakan AgentCore berbasis identitas, lihat contoh Identity-based kebijakan untuk Amazon Bedrock. AgentCore
Resource-based kebijakan dalam AgentCore
Mendukung kebijakan berbasis sumber daya: Sebagian
Resource-based kebijakan adalah dokumen kebijakan JSON yang Anda lampirkan ke sumber daya. Contoh kebijakan berbasis sumber daya adalah kebijakan kepercayaan peran IAM dan kebijakan bucket Amazon S3. Dalam layanan yang mendukung kebijakan berbasis sumber daya, administrator layanan dapat menggunakannya untuk mengontrol akses ke sumber daya tertentu. Untuk sumber daya tempat kebijakan dilampirkan, kebijakan menentukan tindakan apa yang dapat dilakukan oleh principal tertentu pada sumber daya tersebut dan dalam kondisi apa. Anda harus menentukan principal dalam kebijakan berbasis sumber daya. Prinsipal dapat mencakup akun, pengguna, peran, pengguna federasi, atau layanan. AWS
Untuk mengaktifkan akses lintas akun, Anda dapat menentukan secara spesifik seluruh akun atau entitas IAM di akun lain sebagai principal dalam kebijakan berbasis sumber daya. Untuk informasi selengkapnya, lihat Akses sumber daya lintas akun di IAM dalam Panduan Pengguna IAM.
Amazon Bedrock AgentCore mendukung kebijakan berbasis sumber daya untuk sumber daya Agent Runtime dan Gateway. Kebijakan ini dilampirkan langsung ke sumber daya Anda dan menentukan prinsip mana yang dapat melakukan tindakan terhadapnya.
Resource-based contoh kebijakan dalam AgentCore
Untuk melihat contoh kebijakan AgentCore berbasis sumber daya, lihat Kasus dan contoh penggunaan umum.
Tindakan kebijakan untuk AgentCore
Mendukung tindakan kebijakan: Ya
Administrator dapat menggunakan kebijakan AWS JSON untuk menentukan siapa yang memiliki akses ke apa. Artinya, prinsipal mana yang dapat melakukan tindakan pada sumber daya apa, dan dalam kondisi apa.
Elemen Action dari kebijakan JSON menjelaskan tindakan yang dapat Anda gunakan untuk mengizinkan atau menolak akses dalam sebuah kebijakan. Sertakan tindakan dalam kebijakan untuk memberikan izin untuk melakukan operasi terkait.
Untuk melihat daftar AgentCore tindakan, lihat Tindakan yang Ditentukan oleh Amazon Bedrock AgentCore di Referensi Otorisasi Layanan.
Tindakan kebijakan AgentCore menggunakan awalan berikut sebelum tindakan:
bedrock-agentcore
Untuk menetapkan secara spesifik beberapa tindakan dalam satu pernyataan, pisahkan tindakan tersebut dengan koma.
"Action": [ "bedrock-agentcore:action1", "bedrock-agentcore:action2" ]
Untuk melihat contoh kebijakan AgentCore berbasis identitas, lihat contoh Identity-based kebijakan untuk Amazon Bedrock. AgentCore
Sumber daya kebijakan untuk AgentCore
Mendukung sumber daya kebijakan: Ya
Administrator dapat menggunakan kebijakan AWS JSON untuk menentukan siapa yang memiliki akses ke apa. Artinya, prinsipal mana yang dapat melakukan tindakan pada sumber daya apa, dan dalam kondisi apa.
Elemen kebijakan JSON Resource menentukan objek yang menjadi target penerapan tindakan. Praktik terbaiknya, tentukan sumber daya menggunakan Amazon Resource Name (ARN). Untuk tindakan yang tidak mendukung izin tingkat sumber daya, gunakan wildcard (*) untuk menunjukkan bahwa pernyataan tersebut berlaku untuk semua sumber daya.
"Resource": "*"
Untuk melihat daftar jenis AgentCore sumber daya dan ARNnya, lihat Sumber Daya yang Ditentukan oleh Amazon Bedrock AgentCore di Referensi Otorisasi Layanan. Untuk mempelajari tindakan mana yang dapat Anda tentukan ARN dari setiap sumber daya, lihat Tindakan yang Ditentukan oleh Amazon Bedrock. AgentCore
Untuk melihat contoh kebijakan AgentCore berbasis identitas, lihat contoh Identity-based kebijakan untuk Amazon Bedrock. AgentCore
Kunci kondisi kebijakan untuk AgentCore
Mendukung kunci kondisi kebijakan khusus layanan: Yes
Administrator dapat menggunakan kebijakan AWS JSON untuk menentukan siapa yang memiliki akses ke apa. Artinya, prinsipal mana yang dapat melakukan tindakan pada sumber daya apa, dan dalam kondisi apa.
Elemen Condition menentukan ketika pernyataan dieksekusi berdasarkan kriteria yang ditetapkan. Anda dapat membuat ekspresi bersyarat yang menggunakan operator kondisi, seperti sama atau kurang dari, untuk mencocokkan kondisi dalam kebijakan dengan nilai dalam permintaan. Untuk melihat semua kunci kondisi AWS global, lihat kunci konteks kondisi AWS global di Panduan Pengguna IAM.
Untuk melihat daftar kunci kondisi, lihat Kunci AgentCore Kondisi untuk Amazon Bedrock AgentCore di Referensi Otorisasi Layanan. Untuk mempelajari tindakan dan sumber daya yang dapat Anda gunakan kunci kondisi, lihat Tindakan yang Ditentukan oleh Amazon Bedrock AgentCore.
Kunci kondisi berikut sangat berguna saat bekerja dengan Amazon Bedrock AgentCore:
-
bedrock-agentcore:InboundJwtClaim/iss- Anda dapat menggunakan kunci kondisi ini untuk membatasi akses ke API yang menerima JWT yang mewakili enduser untuk bekerja dengan nilai klaim penerbit (iss) tertentu yang ada di JWT yang diteruskan dalam permintaan. Anda dapat menerapkan kunci kondisi ini keGetWorkloadAccessTokenForJwtdanCompleteResourceTokenAuthoperasi. -
bedrock-agentcore:InboundJwtClaim/sub- Anda dapat menggunakan kunci kondisi ini untuk membatasi akses ke API yang menerima JWT untuk bekerja dengan nilai klaim subjek (sub) tertentu yang ada di JWT yang diteruskan dalam permintaan. Anda dapat menerapkan kunci kondisi ini keGetWorkloadAccessTokenForJwtdanCompleteResourceTokenAuthoperasi. -
bedrock-agentcore:InboundJwtClaim/aud- Anda dapat menggunakan kunci kondisi ini untuk membatasi akses ke API yang menerima JWT untuk bekerja dengan nilai klaim audiens tertentu (aud) yang ada di JWT yang diteruskan dalam permintaan. Anda dapat menerapkan kunci kondisi ini keGetWorkloadAccessTokenForJwtdanCompleteResourceTokenAuthoperasi. -
bedrock-agentcore:userid- Anda dapat menggunakan kunci kondisi ini untuk membatasi akses ke API yang menerima ID pengguna statis agar hanya berfungsi dengan nilai ID pengguna yang ditentukan dalam pernyataan kebijakan Anda. Anda dapat menerapkan kunci kondisi ini keGetWorkloadAccessTokenForUserIddanCompleteResourceTokenAuthoperasi. -
bedrock-agentcore:InboundJwtClaim/scope- Anda dapat menggunakan kunci kondisi ini untuk membatasi akses berdasarkan klaim cakupan di JWT yang diteruskan dalam permintaan. -
bedrock-agentcore:InboundJwtClaim/client_id- Anda dapat menggunakan kunci kondisi ini untuk membatasi akses ke API yang menerima JWT untuk bekerja dengan nilaiclient_idklaim tertentu yang ada di JWT yang diteruskan dalam permintaan. Kunci ini hanya tersedia ketika JWT memilikiclient_idklaim dengan tepat dan tidak tersedia ketika informasi dikomunikasikan dalam klaim serupa lainnya. Anda dapat menerapkan kunci kondisi ini keGetWorkloadAccessTokenForJwtdanCompleteResourceTokenAuthoperasi.
Untuk melihat contoh kebijakan AgentCore berbasis identitas, lihat contoh Identity-based kebijakan untuk Amazon Bedrock. AgentCore
Untuk informasi rinci tentang kunci kondisi untuk AgentCore kemampuan tertentu, lihat topik berikut:
-
Gunakan kunci kondisi IAM dengan Amazon Bedrock AgentCore Gateway — Kunci kondisi untuk operasi
CreateGateway,UpdateGatewayCreateGatewayTarget, danUpdateGatewayTargetAPI. -
Gunakan tombol kondisi IAM dengan pengaturan AgentCore VPC VPC-related — tombol kondisi AgentCore untuk runtime, alat bawaan, dan target gateway.
ACL di AgentCore
Mendukung ACL: Tidak
Daftar kontrol akses (ACL) mengendalikan principal mana (anggota akun, pengguna, atau peran) yang memiliki izin untuk mengakses sumber daya. ACL serupa dengan kebijakan berbasis sumber daya, meskipun kebijakan tersebut tidak menggunakan format dokumen kebijakan JSON.
ABAC dengan AgentCore
Mendukung ABAC (tag dalam kebijakan): Sebagian
Attribute-based Access Control (ABAC) adalah strategi otorisasi yang mendefinisikan izin berdasarkan atribut yang disebut tag. Anda dapat melampirkan tag ke entitas dan AWS sumber daya IAM, lalu merancang kebijakan ABAC untuk mengizinkan operasi saat tag prinsipal cocok dengan tag pada sumber daya.
Untuk mengontrol akses berdasarkan tag, Anda memberikan informasi tag dalam elemen kondisi kebijakan menggunakanaws:ResourceTag/key-name,aws:RequestTag/key-name, atau kunci aws:TagKeys kondisi.
Jika sebuah layanan mendukung ketiga kunci kondisi untuk setiap jenis sumber daya, nilainya adalah Ya untuk layanan tersebut. Jika suatu layanan mendukung ketiga kunci kondisi untuk hanya beberapa jenis sumber daya, nilainya adalah Parsial.
Untuk informasi selengkapnya tentang ABAC, lihat Tentukan izin dengan otorisasi ABAC dalam Panduan Pengguna IAM. Untuk melihat tutorial yang menguraikan langkah-langkah pengaturan ABAC, lihat Menggunakan kontrol akses berbasis atribut (ABAC) dalam Panduan Pengguna IAM.
Menggunakan kredensyal sementara dengan AgentCore
Mendukung kredensial sementara: Ya
Kredensyal sementara menyediakan akses jangka pendek ke AWS sumber daya dan secara otomatis dibuat saat Anda menggunakan federasi atau beralih peran. AWS merekomendasikan agar Anda menghasilkan kredensyal sementara secara dinamis alih-alih menggunakan kunci akses jangka panjang. Untuk informasi selengkapnya, lihat Kredensi keamanan sementara di IAM dan AWS layanan yang bekerja dengan IAM di Panduan Pengguna IAM.
Cross-service izin utama untuk AgentCore
Mendukung sesi akses terusan (FAS): Ya
Sesi akses teruskan (FAS) menggunakan izin dari prinsipal yang memanggil AWS layanan, dikombinasikan dengan layanan yang meminta untuk membuat permintaan ke AWS layanan hilir. Untuk detail kebijakan ketika mengajukan permintaan FAS, lihat Sesi akses terusan.
Peran layanan untuk AgentCore
Mendukung peran layanan: Ya
Peran layanan adalah peran IAM yang diambil oleh sebuah layanan untuk melakukan tindakan atas nama Anda. Administrator IAM dapat membuat, mengubah, dan menghapus peran layanan dari dalam IAM. Untuk informasi selengkapnya, lihat Membuat peran untuk mendelegasikan izin ke AWS layanan di Panduan Pengguna IAM.
Awas
Mengubah izin untuk peran layanan dapat merusak AgentCore fungsionalitas. Edit peran layanan hanya jika AgentCore memberikan panduan untuk melakukannya.
Service-linked peran untuk AgentCore
Mendukung peran terkait layanan: Ya
Peran terkait layanan adalah jenis peran layanan yang ditautkan ke layanan. AWS Layanan dapat mengambil peran untuk melakukan tindakan atas nama Anda. Service-linked peran muncul di AWS akun Anda dan dimiliki oleh layanan. Administrator IAM dapat melihat, tetapi tidak dapat mengedit izin untuk peran terkait layanan.
Untuk detail tentang pembuatan atau manajemen peran terkait layanan, lihat Layanan AWS yang berfungsi dengan IAM. Temukan layanan dalam tabel yang Yes menyertakan kolom Service-linked peran. Pilih tautan Ya untuk melihat dokumentasi peran terkait layanan untuk layanan tersebut.