
AWS RAM で AWS KMS キーの Organization 共有を試してみた
はじめに
2026-11-16 に、AWS KMS が AWS RAM によるキー共有に対応しました。
RAM の resource share にキーを加えると、キーポリシーを手で編集せずに他のアカウントへキーを共有できます。この記事では、同じ Organization のメンバーアカウント2つを使い、所有者アカウントの対称暗号化キーを Organization 宛てに共有して、受け側アカウントで暗号化と復号を試しました。
前提
アカウントと環境
- リージョンは ap-northeast-1、aws-cli は 2.40.3 です
- 所有者アカウント(111122223333)と受け側アカウント(444455556666)は、同じ Organization(機能セット ALL)のメンバーです
- 共有するキーは、対称暗号化のカスタマー管理キー(KeySpec は SYMMETRIC_DEFAULT)です
- 管理アカウント(123456789012)は、Organization 共有の有効化に使います
- 受け側のロールには AdministratorAccess を付けています
RAM の Organization 共有の有効化
Organization 宛ての resource share を作る前に、管理アカウントで RAM の Organization 共有を有効にします。有効にしたあと、信頼されたアクセスが有効なサービスの一覧に ram.amazonaws.com が含まれることを確認しました。
aws ram enable-sharing-with-aws-organization
{
"returnValue": true
}
aws organizations list-aws-service-access-for-organization \
--query "EnabledServicePrincipals[?ServicePrincipal=='ram.amazonaws.com']"
[
{
"ServicePrincipal": "ram.amazonaws.com",
"DateEnabled": "2026-11-18T01:49:02.549000+09:00"
}
]
共有に必要な権限
KMS Developer Guide によると、共有を実行するプリンシパルには、RAM の権限として ram:CreateResourceShare が必要です。既存の resource share にキーを追加する場合は ram:AssociateResourceShare が必要です。加えて、対象キーへの kms:PutKeyPolicy が必要で、RAM はこの権限を使って AWS_RAM キーポリシーを作成・更新します。
キーの共有
管理権限の選択
resource share には、キーに対する管理権限(RAM の managed permission)を1つ指定します。kms:Key 向けの管理権限は次のコマンドで一覧できます。
aws ram list-permissions --resource-type kms:Key
一覧には管理権限が2つ表示されます。それぞれの中身は get-permission で取得できます。
aws ram get-permission \
--permission-arn arn:aws:ram::aws:permission/AWSRAMPermissionKMSKeySymmetricEncryption
aws ram get-permission \
--permission-arn arn:aws:ram::aws:permission/AWSRAMPermissionKMSKeyLockoutResistant
2つの管理権限が許可する内容は次のとおりです。
| 管理権限 | 許可するアクション | 条件 |
|---|---|---|
| AWSRAMPermissionKMSKeySymmetricEncryption(kms:Key の既定) | kms:Encrypt、kms:Decrypt、kms:ReEncrypt*、kms:GenerateDataKey*、kms:DescribeKey、kms:ListGrants、kms:CreateGrant |
kms:CreateGrant のみ、kms:GrantIsForAWSResource が true のとき |
| AWSRAMPermissionKMSKeyLockoutResistant | kms:DescribeKey、kms:GetKeyPolicy、kms:List*、kms:PutKeyPolicy |
呼び出し元が所有者アカウントの root のとき |
受け側で暗号化と復号を行うため、既定の AWSRAMPermissionKMSKeySymmetricEncryption を使います。
resource share の作成
所有者アカウントで、共有するキーをキー ARN で、共有先を Organization の ARN で指定します。resource share はキーと同じリージョンに作ります。
aws ram create-resource-share \
--name devio-kms-share-verify-1118 \
--resource-arns arn:aws:kms:ap-northeast-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab \
--principals arn:aws:organizations::123456789012:organization/o-exampleorgid \
--permission-arns arn:aws:ram::aws:permission/AWSRAMPermissionKMSKeySymmetricEncryption
{
"resourceShare": {
"resourceShareArn": "arn:aws:ram:ap-northeast-1:111122223333:resource-share/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"name": "devio-kms-share-verify-1118",
"owningAccountId": "111122223333",
"allowExternalPrincipals": true,
"status": "ACTIVE",
"tags": [],
"creationTime": "2026-11-18T01:49:15.260000+09:00",
"lastUpdatedTime": "2026-11-18T01:49:15.260000+09:00",
"resourceShareConfiguration": {
"retainSharingOnAccountLeaveOrganization": false
}
}
}
共有後のキーポリシー
キーポリシーの一覧
共有の前後に所有者アカウントで list-key-policies を実行したところ、共有後は AWS_RAM というキーポリシーが加わっていました。
aws kms list-key-policies --key-id 1234abcd-12ab-34cd-56ef-1234567890ab
共有前の出力です。
{
"PolicyNames": [
"default"
]
}
共有後の出力です。
{
"PolicyNames": [
"AWS_RAM",
"default"
]
}
default キーポリシー
共有前の default キーポリシーは次のとおりです。get-key-policy は Policy を文字列で返すので、ここでは整形して載せています。
aws kms get-key-policy \
--key-id 1234abcd-12ab-34cd-56ef-1234567890ab \
--policy-name default \
--output json
{
"Version": "2012-10-17",
"Id": "key-default-1",
"Statement": [
{
"Sid": "Enable IAM User Permissions",
"Effect": "Allow",
"Principal": {
"AWS": "arn:aws:iam::111122223333:root"
},
"Action": "kms:*",
"Resource": "*"
}
]
}
共有後に同じコマンドで取得した出力を、共有前の出力と diff で比べたところ、差分はありませんでした。
AWS_RAM キーポリシー
共有後に増えた AWS_RAM キーポリシーを取得します。
aws kms get-key-policy \
--key-id 1234abcd-12ab-34cd-56ef-1234567890ab \
--policy-name AWS_RAM \
--output json
Policy を整形すると次のとおりです。
{
"Version": "2012-10-17",
"Id": "a1b2c3d4-5678-90ab-cdef-EXAMPLE22222",
"Statement": [
{
"Sid": "AWSRAMPermissionKMSKeySymmetricEncryption-org",
"Effect": "Allow",
"Principal": "*",
"Action": [
"kms:Encrypt",
"kms:Decrypt",
"kms:ReEncrypt*",
"kms:GenerateDataKey*",
"kms:DescribeKey",
"kms:ListGrants"
],
"Resource": "arn:aws:kms:ap-northeast-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
"Condition": {
"StringEquals": {
"aws:PrincipalOrgID": "o-exampleorgid"
},
"StringNotEquals": {
"aws:PrincipalAccount": "111122223333"
}
}
},
{
"Sid": "AWSRAMPermissionKMSKeySymmetricEncryption-org",
"Effect": "Allow",
"Principal": "*",
"Action": "kms:CreateGrant",
"Resource": "arn:aws:kms:ap-northeast-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
"Condition": {
"StringEquals": {
"aws:PrincipalOrgID": "o-exampleorgid"
},
"Bool": {
"kms:GrantIsForAWSResource": "true"
},
"StringNotEquals": {
"aws:PrincipalAccount": "111122223333"
}
}
}
]
}
Principal は * ですが、条件により、許可の対象は Organization 内の所有者アカウント以外のアカウントです。
AWS_RAM キーポリシーは RAM が管理し、利用者は作成・変更・削除できないため、キーを使える範囲は resource share の変更で調整します。
受け側での利用
招待の有無
受け側アカウントで resource share の招待を確認すると、0件でした。承諾の操作をしないまま、次の節の Encrypt と Decrypt は成功しました。
aws ram get-resource-share-invitations --output json
{
"resourceShareInvitations": []
}
Encrypt と Decrypt
受け側アカウントのロールから、キー ARN を指定して Encrypt と Decrypt を実行しました。平文には、hello from receiver を改行なしで書き込んだ plaintext.txt を使いました。
aws kms encrypt \
--key-id arn:aws:kms:ap-northeast-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab \
--plaintext fileb://plaintext.txt \
--output json
CiphertextBlob の行は、実行のたびに値が変わるので省いています。
{
"KeyId": "arn:aws:kms:ap-northeast-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
"EncryptionAlgorithm": "SYMMETRIC_DEFAULT"
}
Decrypt には、Encrypt が返した CiphertextBlob(Base64)を base64 -d でデコードし、バイナリのファイル ct.bin に保存して渡します。fileb:// を指定すると、AWS CLI はファイルの内容をバイナリのまま読み込みます。
aws kms decrypt \
--ciphertext-blob fileb://ct.bin \
--key-id arn:aws:kms:ap-northeast-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab \
--output json
KeyMaterialId の行は環境固有の識別子なので省いています。
{
"KeyId": "arn:aws:kms:ap-northeast-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
"Plaintext": "aGVsbG8gZnJvbSByZWNlaXZlcg==",
"EncryptionAlgorithm": "SYMMETRIC_DEFAULT"
}
Plaintext の Base64 をデコードすると hello from receiver になり、Encrypt に渡した平文と一致しました。
受け側がキーを使うには、キーポリシーの許可に加えて、受け側アカウントの IAM ポリシーで、使うユーザーやロールに許可を与える必要があります。IAM ポリシーの Resource には、キー ARN を指定します。
共有の作成から約18秒後に実行した最初の Encrypt が成功しました。共有の作成・変更・削除は結果整合性のため、反映に少し時間がかかる場合があります。
共有の解除
共有中のキーの削除をスケジュールする前には、キーを resource share から外すよう案内されています。キーだけを外すには、disassociate-resource-share でキー ARN を指定します。resource share 自体は残るので、同じ resource share に含まれる他のリソースや共有先には影響しません。
aws ram disassociate-resource-share \
--resource-share-arn arn:aws:ram:ap-northeast-1:111122223333:resource-share/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111 \
--resource-arns arn:aws:kms:ap-northeast-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
{
"resourceShareAssociations": [
{
"resourceShareArn": "arn:aws:ram:ap-northeast-1:111122223333:resource-share/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"associatedEntity": "arn:aws:kms:ap-northeast-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
"associationType": "RESOURCE",
"status": "DISASSOCIATING",
"external": false
}
]
}
外す処理は非同期で、直後の status は DISASSOCIATING です。get-resource-share-associations で、DISASSOCIATED になったことを確認します。resourceShareName、creationTime、lastUpdatedTime の行は省いています。
aws ram get-resource-share-associations \
--association-type RESOURCE \
--resource-share-arns arn:aws:ram:ap-northeast-1:111122223333:resource-share/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111
{
"resourceShareAssociations": [
{
"resourceShareArn": "arn:aws:ram:ap-northeast-1:111122223333:resource-share/a1b2c3d4-5678-90ab-cdef-EXAMPLE11111",
"associatedEntity": "arn:aws:kms:ap-northeast-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab",
"associationType": "RESOURCE",
"status": "DISASSOCIATED",
"external": false
}
]
}
外した後のキーポリシーは default だけで、AWS_RAM は消えていました。
aws kms list-key-policies --key-id 1234abcd-12ab-34cd-56ef-1234567890ab
{
"PolicyNames": [
"default"
]
}
まとめ
AWS KMS が AWS RAM によるキー共有に対応し、異なるアカウント間でカスタマー管理キーを共有できることを確認しました。
キーポリシーでは共有先のステートメントを書く必要がありましたが、RAM では resource share で管理権限と共有先を指定するだけで共有できるため、権限の管理を省力化できます。
複数のアカウントで同じカスタマー管理キーを使う場合や、レプリケーション対象のリソースを共通のカスタマー管理キーで暗号化する場合に、キーポリシーを編集する以外の方法として、RAM 経由の共有をお試しください。











