Enkripsi mesin AgentCore kebijakan Anda dengan kunci KMS yang dikelola pelanggan

Kebijakan dalam AgentCore menyediakan enkripsi secara default untuk melindungi data pelanggan sensitif saat istirahat menggunakan kunci enkripsi yang AWS dimiliki. Sebagai lapisan perlindungan tambahan, Policy in AgentCore memungkinkan Anda untuk mengenkripsi mesin kebijakan Anda menggunakan AWS Key Management Service (AWS KMS) customer managed keys (CMK). Fungsionalitas ini memastikan perlindungan data sensitif melalui enkripsi saat istirahat, yang membantu Anda:

Bagian berikut menjelaskan cara mengonfigurasi enkripsi untuk mesin kebijakan baru dan mengelola kunci enkripsi Anda.

AWS Jenis kunci KMS untuk Kebijakan di AgentCore

Kebijakan AgentCore terintegrasi dengan AWS KMS untuk mengelola kunci enkripsi yang digunakan untuk mengenkripsi dan mendekripsi data pelanggan. Untuk mempelajari lebih lanjut tentang jenis dan status kunci, lihat Konsep Layanan Manajemen AWS Kunci di Panduan Pengembang AWS KMS. Saat membuat mesin kebijakan baru, Anda dapat memilih dari jenis kunci AWS KMS berikut untuk mengenkripsi data Anda:

AWS kunci yang dimiliki

Jenis enkripsi default. Policy in AgentCore memiliki kunci tanpa biaya tambahan kepada Anda dan mengenkripsi data sumber daya saat pembuatan. Tidak diperlukan konfigurasi tambahan dalam kode atau aplikasi Anda untuk mengenkripsi atau mendekripsi data Anda menggunakan kunci yang dimiliki oleh Policy di. AgentCore Anda tidak perlu melihat, mengelola, menggunakan, atau mengaudit kunci ini. Untuk informasi selengkapnya, lihat kunci yang AWS dimiliki di Panduan Pengembang AWS KMS.

Kunci yang dikelola pelanggan

Anda membuat, memiliki, dan mengelola kunci di AWS akun Anda. Anda memiliki kontrol penuh atas tombol KMS. AWS Biaya KMS berlaku untuk kunci yang dikelola pelanggan. Untuk informasi selengkapnya, lihat halaman Harga AWS KMS. Untuk informasi selengkapnya tentang jenis kunci, lihat Kunci terkelola pelanggan di Panduan Pengembang AWS KMS.

Saat Anda menentukan kunci terkelola pelanggan untuk enkripsi mesin kebijakan, Kebijakan dalam AgentCore mengenkripsi mesin kebijakan dan semua sumber daya turunannya (kebijakan, pembuatan kebijakan) dengan kunci tersebut. Untuk mengenkripsi mesin kebijakan menggunakan kunci terkelola pelanggan, Anda harus memberikan akses ke Kebijakan AgentCore dalam kebijakan kunci Anda. Kebijakan utama adalah kebijakan berbasis sumber daya yang Anda lampirkan ke kunci yang dikelola pelanggan untuk mengontrol akses ke sana. Lihat Mengotorisasi penggunaan kunci AWS KMS Anda untuk Kebijakan di AgentCore untuk detail selengkapnya.

Selain itu, untuk membuat mesin kebijakan terenkripsi dengan kunci yang dikelola pelanggan, atau untuk melakukan panggilan API ke mesin kebijakan yang dienkripsi oleh kunci yang dikelola pelanggan, pengguna atau peran IAM yang membuat panggilan juga harus memiliki akses ke kunci tersebut. Jika Policy in AgentCore tidak dapat mengakses kunci, keputusan otorisasi apa pun yang melibatkan sumber daya yang dienkripsi oleh kunci tersebut akan ditolak. Ketika Anda tidak memiliki akses ke kunci, Anda tidak akan dapat membaca, memperbarui, atau menghapus sumber daya yang dienkripsi oleh kunci itu, dan setiap panggilan buat untuk memanfaatkan kunci untuk enkripsi akan gagal.

Penggunaan AWS KMS dan kunci data dengan Kebijakan di AgentCore

Fitur Kebijakan dalam AgentCore enkripsi saat istirahat menggunakan kunci KMS dan hierarki kunci data untuk melindungi data sumber daya Anda.

Kebijakan dalam AgentCore menggunakan model berbasis hibah untuk mengakses kunci yang dikelola pelanggan Anda. Saat Anda membuat mesin kebijakan dengan kunci yang dikelola pelanggan, Kebijakan dalam AgentCore melakukan langkah-langkah berikut:

Kedua hibah tersebut melayani tujuan yang berbeda:

Kedua hibah dibatasi oleh konteks enkripsi menggunakan kunciaws:bedrock-agentcore-policy:policy-engine-arn, yang mengikat hibah ke sumber daya mesin kebijakan tertentu.

Saat Anda menghapus mesin kebijakan dengan kunci yang dikelola pelanggan, Policy in AgentCore secara otomatis menghentikan kedua hibah tersebut.

Otorisasi penggunaan Anda AWS Kunci KMS untuk Kebijakan di AgentCore

Untuk menggunakan kunci yang dikelola pelanggan dengan Kebijakan di AgentCore, kebijakan kunci AWS KMS Anda harus memberikan izin ke akun Anda AWS . Saat membuat mesin kebijakan, Kebijakan dalam AgentCore panggilan kms:CreateGrant menggunakan identitas Anda melalui Sesi Akses Teruskan (FAS). Akibatnya, kebijakan utama harus memberikan kms:CreateGrant dan izin lain yang diperlukan untuk prinsipal akun Anda (bukan untuk prinsipal layanan) dan menggunakan kms:ViaService kondisi untuk memastikan kunci hanya digunakan melalui Kebijakan di AgentCore.

Minimal, Policy in AgentCore memerlukan izin berikut pada kunci yang dikelola pelanggan:

Memahami konteks sumber

Konteks sumber memberikan informasi tentang pemanggil sumber yang mencoba membuat tindakan AWS KMS terhadap kunci yang diberikan. Ini mencegah kebingungan atau penyalahgunaan data terenkripsi dengan mengikat konteks ke sumber data.

Ketika Kebijakan dalam AgentCore menjalankan operasi AWS KMS melalui hibah atas nama Anda, konteks sumber mengidentifikasi Kebijakan dalam AgentCore sumber daya yang memulai permintaan. Anda dapat menggunakan konteks sumber sebagai kondisi tambahan pada operasi berbasis hibah dalam kebijakan utama Anda untuk membatasi penggunaan kunci pada permintaan yang berasal dari akun atau sumber daya tertentu.

Misalnya, Anda dapat menambahkan aws:SourceAccount dan aws:SourceArn mengkondisikan operasi KMS dan pernyataan validasi dalam kebijakan utama Anda untuk memastikan bahwa operasi ini hanya berhasil ketika permintaan berasal dari akun Anda dan sumber daya mesin kebijakan Anda:

{
  "Sid": "Allow Policy for KMS operations with source context",
  "Effect": "Allow",
  "Principal": {
    "AWS": "arn:aws:iam::111122223333:root"
  },
  "Action": [
    "kms:Decrypt",
    "kms:GenerateDataKey"
  ],
  "Resource": "*",
  "Condition": {
    "StringEquals": {
      "kms:ViaService": "bedrock-agentcore.us-east-1.amazonaws.com",
      "aws:SourceAccount": "111122223333"
    },
    "StringLike": {
      "aws:SourceArn": "arn:aws:bedrock-agentcore:us-east-1:111122223333:policy-engine/*",
      "kms:EncryptionContext:aws:bedrock-agentcore-policy:policy-engine-arn": "arn:aws*:bedrock-agentcore:*:*:policy-engine/*"
    }
  }
}

Kebijakan utama ini memungkinkan Kebijakan AgentCore untuk melakukan panggilan AWS KMS atas nama Anda melalui hibah, jika akun sumber sama dengan akun tempat kunci KMS ini berada. Nilai-nilai ini harus dapat diverifikasi saat memeriksa log CloudTrail audit untuk kunci KMS. Untuk informasi selengkapnya tentang kunci AWS kondisi global, lihat Menggunakan kunci SourceAccount kondisi aws: SourceArn atau aws: di Panduan Pengembang AWS KMS.

Memahami kms: ViaService

Kunci kms:ViaService kondisi membatasi penggunaan kunci KMS untuk permintaan dari AWS layanan tertentu. Kunci kondisi ini berlaku untuk Sesi Akses Teruskan (FAS). Untuk informasi selengkapnyakms:ViaService, lihat kms: ViaService di Panduan Pengembang AWS KMS.

Dalam kebijakan kunci, kms:ViaService nilai mengikuti formatbedrock-agentcore.REGION.amazonaws.com, di mana REGION adalah AWS Wilayah tempat mesin kebijakan Anda dibuat (misalnya,bedrock-agentcore.us-east-1.amazonaws.com).

Memahami konteks enkripsi

Konteks enkripsi adalah sekumpulan pasangan nilai kunci yang berisi data tambahan yang diautentikasi untuk pemeriksaan integritas enkripsi. Ketika Anda menyertakan konteks enkripsi dalam permintaan untuk mengenkripsi data, AWS KMS secara kriptografis mengikat konteks enkripsi ke data terenkripsi. Untuk mendekripsi data, Anda harus melewati konteks enkripsi yang sama. Untuk informasi selengkapnya, lihat Konteks enkripsi di Panduan Pengembang AWS KMS.

Kebijakan AgentCore menggunakan konteks enkripsi berikut di semua operasi kriptografi AWS KMS dan dapat diverifikasi dalam CloudTrail log saat Kebijakan AgentCore membuat panggilan AWS KMS atas nama Anda untuk proses enkripsi dan dekripsi:

{
  "aws:bedrock-agentcore-policy:policy-engine-arn": "arn:aws:bedrock-agentcore:REGION:ACCOUNT_ID:policy-engine/POLICY_ENGINE_ID"
}

Anda dapat menggunakan konteks enkripsi ini dalam kondisi kebijakan utama Anda untuk membatasi mesin kebijakan mana yang dapat menggunakan kunci tersebut. Misalnya, kebijakan kunci di bagian berikut menggunakan kms:EncryptionContext kondisi untuk mengizinkan kunci hanya digunakan untuk sumber daya mesin kebijakan.

Selesai AWS Kebijakan kunci KMS

Berdasarkan konsep di bagian sebelumnya, contoh kebijakan kunci berikut memberikan izin yang diperlukan untuk mengenkripsi mesin kebijakan dan menggunakan mesin kebijakan terenkripsi. Kebijakan ini berisi kunci kondisi agar sesuai dengan praktik terbaik keamanan.

{
"Version": "2012-10-17",
  "Statement": [
    {
      "Sid": "Allow Policy to create grants",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::111122223333:role/ExampleRole"
      },
      "Action": "kms:CreateGrant",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "kms:ViaService": "bedrock-agentcore.us-east-1.amazonaws.com",
          "kms:GrantConstraintType": "EncryptionContextSubset"
        },
        "StringLike": {
          "kms:EncryptionContext:aws:bedrock-agentcore-policy:policy-engine-arn": "arn:aws*:bedrock-agentcore:*:*:policy-engine/*"
        },
        "ForAllValues:StringEquals": {
          "kms:GrantOperations": [
            "Encrypt",
            "Decrypt",
            "GenerateDataKey",
            "GenerateDataKeyWithoutPlaintext",
            "ReEncryptFrom",
            "ReEncryptTo"
          ]
        }
      }
    },
    {
      "Sid": "Allow Policy for KMS operations",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::111122223333:role/ExampleRole"
      },
      "Action": [
        "kms:Decrypt",
        "kms:GenerateDataKey"
      ],
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "kms:ViaService": "bedrock-agentcore.us-east-1.amazonaws.com"
        },
        "StringLike": {
          "kms:EncryptionContext:aws:bedrock-agentcore-policy:policy-engine-arn": "arn:aws*:bedrock-agentcore:*:*:policy-engine/*"
        }
      }
    },
    {
      "Sid": "Allow Policy for KMS validation",
      "Effect": "Allow",
      "Principal": {
        "AWS": "arn:aws:iam::111122223333:role/ExampleRole"
      },
      "Action": "kms:DescribeKey",
      "Resource": "*",
      "Condition": {
        "StringEquals": {
          "kms:ViaService": "bedrock-agentcore.us-east-1.amazonaws.com"
        }
      }
    }
  ]
}

Kebijakan tersebut berisi pernyataan berikut:

Prasyarat untuk mengenkripsi mesin kebijakan Anda

Sebelum mengenkripsi mesin polis Anda, pastikan Anda telah memenuhi prasyarat berikut:

Untuk informasi selengkapnya tentang mengendalikan izin IAM untuk kunci KMS, lihat akses kunci KMS dan izin di Panduan Pengembang KMS. AWS

Membuat mesin kebijakan terenkripsi

Sebelum membuat mesin kebijakan terenkripsi, pastikan bahwa kunci terkelola pelanggan yang Anda gunakan memiliki pernyataan kebijakan kunci yang tepat yang ditetapkan untuk Kebijakan untuk menggunakan kunci AgentCore untuk enkripsi dan dekripsi. Lihat Mengotorisasi penggunaan kunci AWS KMS Anda untuk Kebijakan di AgentCore untuk izin yang diperlukan.

Untuk mengenkripsi mesin kebijakan Anda menggunakan AWS CLI, sertakan --encryption-key-arn parameter saat mengirim create-policy-engine permintaan:

aws bedrock-agentcore-control create-policy-engine \
  --name "MyPolicyEngine" \
  --description "Policy engine with customer-managed encryption" \
  --encryption-key-arn "arn:aws:kms:us-east-1:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab"

Tanggapan tersebut meliputi mesin kebijakan ARN dan status:

{
  "policyEngineId": "MyPolicyEngine-abc123",
  "name": "MyPolicyEngine",
  "description": "Policy engine with customer-managed encryption",
  "policyEngineArn": "arn:aws:bedrock-agentcore:us-east-1:123456789012:policy-engine/MyPolicyEngine-abc123",
  "status": "CREATING",
  "statusReasons": [],
  "encryptionKeyArn": "arn:aws:kms:us-east-1:123456789012:key/1234abcd-12ab-34cd-56ef-1234567890ab",
  "createdAt": "2026-02-24T12:00:00Z",
  "updatedAt": "2026-02-24T12:00:00Z"
}

Batasan

Batasan berikut berlaku untuk enkripsi kunci yang dikelola pelanggan untuk mesin kebijakan:

Pemecahan masalah

Bagian ini menjelaskan kesalahan umum terkait kunci terkelola pelanggan yang mungkin Anda temui saat menggunakan Kebijakan AgentCore dan menyediakan langkah-langkah pemecahan masalah untuk mengatasinya.

Akses ditolak: AWS Masalah izin KMS

Kesalahan: “Akses ditolak untuk kunci KMS yang ditentukan. Verifikasi kebijakan utama memberikan izin yang diperlukan.

Ini bisa berarti bahwa pemanggil tidak memiliki izin tindakan kms: * yang diperlukan dalam kebijakan IAM atau kebijakan kunci AWS KMS mereka, atau bahwa kunci yang direferensikan tidak ada atau tidak ada lagi.

Untuk mengatasi masalah ini:

Pengecualian validasi: AWS Konfigurasi kunci KMS

Kesalahan: “Kunci KMS yang ditentukan tidak dalam keadaan yang dapat digunakan. Verifikasi kunci diaktifkan dan tidak tertunda penghapusan.

Ini berarti bahwa kunci yang direferensikan tidak dapat digunakan untuk enkripsi kunci yang dikelola pelanggan karena konfigurasi saat ini. Alasan yang mungkin termasuk:

Untuk mengatasi masalah ini: Verifikasi bahwa kunci memenuhi prasyarat yang dijelaskan dalam Prasyarat untuk mengenkripsi mesin kebijakan Anda.