# Bagaimana Amazon Bedrock AgentCore bekerja dengan IAM
<a name="security_iam_service-with-iam"></a>

Sebelum Anda menggunakan IAM untuk mengelola akses AgentCore, pelajari fitur IAM yang tersedia untuk digunakan. AgentCore


| Fitur IAM | AgentCore dukungan | 
| --- | --- | 
|  [Identity-based kebijakan](#security_iam_service-with-iam-id-based-policies)  | Ya | 
|  [Resource-based kebijakan](#security_iam_service-with-iam-resource-based-policies)  | Parsial | 
|  [Tindakan kebijakan](#security_iam_service-with-iam-id-based-policies-actions)  | Ya | 
|  [Sumber daya kebijakan](#security_iam_service-with-iam-id-based-policies-resources)  | Ya | 
|  [Kunci kondisi kebijakan](#security_iam_service-with-iam-id-based-policies-conditionkeys)  | Ya | 
|  [ACL](#security_iam_service-with-iam-acls)  | Tidak | 
|  [ABAC (tanda dalam kebijakan)](#security_iam_service-with-iam-tags)  | Parsial | 
|  [Kredensial sementara](#security_iam_service-with-iam-roles-tempcreds)  | Ya | 
|  [Izin principal](#security_iam_service-with-iam-principal-permissions)  | Ya | 
|  [Peran layanan](#security_iam_service-with-iam-roles-service)  | Ya | 
|  [Service-linked peran](#security_iam_service-with-iam-roles-service-linked)  | 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*](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html).

## Identity-based kebijakan untuk AgentCore
<a name="security_iam_service-with-iam-id-based-policies"></a>

 **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](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements.html) dalam *Panduan Pengguna IAM*.

### Identity-based contoh kebijakan untuk AgentCore
<a name="security_iam_service-with-iam-id-based-policies-examples"></a>

Untuk melihat contoh kebijakan AgentCore berbasis identitas, lihat contoh [Identity-based kebijakan untuk Amazon](security_iam_id-based-policy-examples.md) Bedrock. AgentCore

## Resource-based kebijakan dalam AgentCore
<a name="security_iam_service-with-iam-resource-based-policies"></a>

 **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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_principal.html) 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies-cross-account-resource-access.html) 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.

[Untuk mempelajari cara membuat dan mengelola kebijakan berbasis sumber daya untuk sumber daya Amazon Bedrock, lihat kebijakan Resource-based untuk Amazon Bedrock AgentCore . AgentCore](resource-based-policies.md)

### Resource-based contoh kebijakan dalam AgentCore
<a name="security_iam_service-with-iam-resource-based-policies-examples"></a>

Untuk melihat contoh kebijakan AgentCore berbasis sumber daya, lihat Kasus dan contoh [penggunaan umum](resource-based-policies.md#resource-based-policies-examples).

## Tindakan kebijakan untuk AgentCore
<a name="security_iam_service-with-iam-id-based-policies-actions"></a>

 **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](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonbedrockagentcore.html#amazonbedrockagentcore-actions-as-permissions) 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](security_iam_id-based-policy-examples.md) Bedrock. AgentCore

## Sumber daya kebijakan untuk AgentCore
<a name="security_iam_service-with-iam-id-based-policies-resources"></a>

 **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)](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference-arns.html). 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonbedrockagentcore.html#amazonbedrockagentcore-resources-for-iam-policies) di Referensi *Otorisasi Layanan*. Untuk mempelajari tindakan mana yang dapat Anda tentukan ARN dari setiap sumber daya, lihat [Tindakan yang Ditentukan oleh Amazon Bedrock](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonbedrockagentcore.html#amazonbedrockagentcore-actions-as-permissions). AgentCore

Untuk melihat contoh kebijakan AgentCore berbasis identitas, lihat contoh [Identity-based kebijakan untuk Amazon](security_iam_id-based-policy-examples.md) Bedrock. AgentCore

## Kunci kondisi kebijakan untuk AgentCore
<a name="security_iam_service-with-iam-id-based-policies-conditionkeys"></a>

 **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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition_operators.html), 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html) di *Panduan Pengguna IAM*.

Untuk melihat daftar kunci kondisi, lihat [Kunci AgentCore Kondisi untuk Amazon Bedrock AgentCore](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonbedrockagentcore.html#amazonbedrockagentcore-policy-keys) di Referensi *Otorisasi Layanan*. Untuk mempelajari tindakan dan sumber daya yang dapat Anda gunakan kunci kondisi, lihat [Tindakan yang Ditentukan oleh Amazon Bedrock AgentCore](https://docs.aws.amazon.com/IAM/latest/UserGuide/list_amazonbedrockagentcore.html#amazonbedrockagentcore-actions-as-permissions).

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 ke `GetWorkloadAccessTokenForJwt` dan `CompleteResourceTokenAuth` operasi.
+  `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 ke `GetWorkloadAccessTokenForJwt` dan `CompleteResourceTokenAuth` operasi.
+  `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 ke `GetWorkloadAccessTokenForJwt` dan `CompleteResourceTokenAuth` operasi.
+  `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 ke `GetWorkloadAccessTokenForUserId` dan `CompleteResourceTokenAuth` operasi.
+  `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 nilai `client_id` klaim tertentu yang ada di JWT yang diteruskan dalam permintaan. Kunci ini hanya tersedia ketika JWT memiliki `client_id` klaim dengan tepat dan tidak tersedia ketika informasi dikomunikasikan dalam klaim serupa lainnya. Anda dapat menerapkan kunci kondisi ini ke `GetWorkloadAccessTokenForJwt` dan `CompleteResourceTokenAuth` operasi.

Untuk melihat contoh kebijakan AgentCore berbasis identitas, lihat contoh [Identity-based kebijakan untuk Amazon](security_iam_id-based-policy-examples.md) Bedrock. AgentCore

Untuk informasi rinci tentang kunci kondisi untuk AgentCore kemampuan tertentu, lihat topik berikut:
+  [Gunakan kunci kondisi IAM dengan Amazon Bedrock AgentCore Gateway](security-gateway-condition-keys.md) — Kunci kondisi untuk operasi`CreateGateway`, `UpdateGateway``CreateGatewayTarget`, dan `UpdateGatewayTarget` API.
+  [Gunakan tombol kondisi IAM dengan pengaturan AgentCore VPC](security-vpc-condition.md) VPC-related — tombol kondisi AgentCore untuk runtime, alat bawaan, dan target gateway.

## ACL di AgentCore
<a name="security_iam_service-with-iam-acls"></a>

 **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
<a name="security_iam_service-with-iam-tags"></a>

 **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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_elements_condition.html) kebijakan menggunakan`aws: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](https://docs.aws.amazon.com/IAM/latest/UserGuide/introduction_attribute-based-access-control.html) dalam *Panduan Pengguna IAM.* Untuk melihat tutorial yang menguraikan langkah-langkah pengaturan ABAC, lihat [Menggunakan kontrol akses berbasis atribut (ABAC)](https://docs.aws.amazon.com/IAM/latest/UserGuide/tutorial_attribute-based-access-control.html) dalam *Panduan Pengguna IAM*.

## Menggunakan kredensyal sementara dengan AgentCore
<a name="security_iam_service-with-iam-roles-tempcreds"></a>

 **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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp.html) dan [AWS layanan yang bekerja dengan IAM di Panduan Pengguna IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html).*

## Cross-service izin utama untuk AgentCore
<a name="security_iam_service-with-iam-principal-permissions"></a>

 **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](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_forward_access_sessions.html).

## Peran layanan untuk AgentCore
<a name="security_iam_service-with-iam-roles-service"></a>

 **Mendukung peran layanan:** Ya

Peran layanan adalah [peran IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html) 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](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html) 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
<a name="security_iam_service-with-iam-roles-service-linked"></a>

 **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](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html). Temukan layanan dalam tabel yang `Yes` menyertakan kolom **Service-linked peran**. Pilih tautan **Ya** untuk melihat dokumentasi peran terkait layanan untuk layanan tersebut.