AWS RAM で AWS KMS キーの Organization 共有を試してみた

AWS RAM で AWS KMS キーの Organization 共有を試してみた

AWS KMS のキーを AWS RAM で共有できるようになりました。対称暗号化キーを Organization 宛てに共有し、default キーポリシーを変更しないまま、Organization 内の受け側アカウントから Encrypt と Decrypt ができることを確認しました。
2026.11.18

はじめに

2026-11-16 に、AWS KMS が AWS RAM によるキー共有に対応しました。

https://aws.amazon.com/jp/about-aws/whats-new/2026/11/kms-key-sharing-resource-access-manager/

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 キーポリシーを作成・更新します。

https://docs.aws.amazon.com/kms/latest/developerguide/key-sharing-ram.html

キーの共有

管理権限の選択

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 経由の共有をお試しください。

この記事をシェアする

AWSのお困り事はクラスメソッドへ

関連記事