AWS KMS의 정책 조건 사용 - AWS Key Management Service

AWS KMS의 정책 조건 사용

AWS KMS 리소스에 대한 액세스를 제어하는 ​​키 정책 및 AWS Identity and Access Management 정책(IAM 정책)에서 조건을 지정할 수 있습니다. 이 정책문은 조건이 true일 때만 유효합니다. 예를 들어, 특정 날짜 이후에만 정책문이 적용되기를 원할 수 있습니다. 또는 API 요청에 특정 값이 있는 경우에만 정책문이 액세스를 제어하기를 원할 수 있습니다.

조건을 지정하려면 IAM 조건 정책 연산자와 함께 정책문의 Condition 요소에서 미리 정의된 조건 키를 사용합니다. 일부 조건 키는AWS에 전체적으로 적용되고 일부는 AWS KMS에만 적용됩니다.

AWS 전역 조건 키

AWS는 액세스 제어를 위해 IAM을 사용하는 모든 AWS 서비스에 대한 정책 조건 키 집합인 전역 조건 키를 정의합니다. AWS KMS 키 정책 및 IAM 정책에서 전역 조건 키를 사용할 수 있습니다.

예를 들어 요청의 보안 주체가 조건 키 값에 Amazon 리소스 이름(ARN)으로 표시되는 경우에만 aws:PrincipalArn 전역 조건 키를 사용하여 AWS KMS key(KMS 키)에 대한 액세스를 허용할 수 있습니다. AWS KMS에서 속성 기반 액세스 제어(ABAC)를 지원하려면 IAM 정책에서 aws:ResourceTag/tag-key 전역 조건 키를 사용하여 특정 태그가 있는 KMS 키에 대한 액세스를 허용할 수 있습니다.

AWS KMS는 다음을 제외한 모든 AWS 전역 조건 키를 지원합니다.

사용 가능한 요청 유형을 포함하여 AWS 전역 조건 키에 대한 자세한 내용은 IAM 사용 설명서AWS 전역 조건 컨텍스트 키를 참조하세요. IAM 정책에서 전역 조건 키를 사용하는 예는 IAM 사용 설명서요청에 대한 액세스 제어태그 키 제어를 참조하세요.

다음 주제에서는 IP 주소 및 VPC 엔드포인트를 기반으로 조건 키를 사용하기 위한 특별한 지침을 제공합니다.

AWS KMS 권한으로 정책에서 IP 주소 조건 사용

AWS KMS를 사용하여 통합 AWS 서비스에서 데이터를 보호할 수 있습니다. 그러나 AWS KMS에 대한 액세스를 허용하거나 거부하는 동일한 정책문에서 IP 주소 조건 연산자 또는 aws:SourceIp 조건 키를 지정할 때는 주의해야 합니다 예를 들어 AWS: 소스 IP를 바탕으로 AWS에 대한 액세스 거부의 정책은 AWS 작업을 지정된 IP 범위의 요청으로 제한합니다.

다음 시나리오를 고려하십시오.

  1. AWS: 소스 IP를 바탕으로 AWS에 대한 액세스 거부에 표시된 정책과 같은 정책을 IAM 사용자에게 연결합니다. aws:SourceIp 조건 키의 값을 사용자 회사의 IP 주소 범위로 설정합니다. 이 IAM 사용자에게는 Amazon EBS, Amazon EC2 및 AWS KMS 사용을 허용하는 다른 정책이 연결되어 있습니다.

  2. 사용자가 암호화된 EBS 볼륨을 EC2 인스턴스에 연결하려고 합니다. 사용자가 모든 관련 서비스를 이용할 권한을 가지고 있음에도 인증 오류로 인해 이 작업은 실패합니다.

볼륨의 암호화된 데이터 키를 복호화하라는 AWS KMS에 대한 요청이 Amazon EC2 인프라와 연결된 IP 주소에서 이루어지기 때문에 2단계는 실패합니다. 요청이 성공하려면 원래 사용자의 IP 주소에서 이루어져야 합니다. 1단계의 정책은 지정된 IP 주소 이외에서 이루어진 모든 요청을 명시적으로 거부하기 때문에, EBS 볼륨의 암호화된 데이터 키를 복호화할 수 있는 권한이 Amazon EC2에 부여되지 않습니다.

또한 요청이 Amazon VPC 엔드포인트에서 이루어지는 경우 aws:sourceIP 조건 키는 유효하지 않습니다. AWS KMS VPC 엔드포인트를 포함해 VPC 엔드포인트로 요청을 제한하려면 aws:sourceVpce 또는 aws:sourceVpc 조건 키를 사용합니다. 자세한 정보는 Amazon VPC 사용 설명서VPC 엔드포인트 - 엔드포인트 사용 제어를 참조하세요.

AWS KMS 권한으로 정책에서 VPC 엔드포인트 조건 사용

AWS KMS는 Amazon Virtual Private Cloud(Amazon VPC) 엔드포인트를 지원하며, 이 엔드포인트는 AWS PrivateLink에 의해 구동됩니다. 요청이 VPC에서 오거나 VPC 엔드포인트를 사용할 때 키 정책 및 IAM 정책에서 다음 전역 조건 키를 사용하여 AWS KMS 리소스에 대한 액세스를 제어할 수 있습니다. 자세한 내용은 정책 설명에 VPC 엔드포인트 사용 단원을 참조하세요.

  • aws:SourceVpc는 지정된 VPC의 요청으로 액세스를 제한합니다.

  • aws:SourceVpce는 지정된 VPC 엔드포인트의 요청으로 액세스를 제한합니다.

이러한 조건 키를 사용하여 KMS 키에 대한 액세스를 제어하는 ​​경우 사용자를 대신하여 AWS KMS를 사용하는 AWS 서비스에 대한 액세스를 실수로 거부할 수 있습니다.

IP 주소 조건 키 예제와 같은 상황을 피하도록 주의하십시오. KMS 키에 대한 요청을 VPC 또는 VPC 엔드포인트로 제한하면 Amazon S3 또는 Amazon EBS, 등의 통합 서비스에서 AWS KMS 호출에 실패할 수 있습니다. 원본 요청이 궁극적으로 VPC 또는 VPC 엔드포인트에서 시작된 경우에도 이러한 상황이 발생할 수 있습니다.

AWS KMS 조건 키

AWS KMS는 키 정책과 IAM 정책에 사용할 수 있는 사전 정의된 조건 키 집합을 추가 제공합니다. AWS KMS에만 해당되는 특정한 조건 키입니다. 예를 들어 대칭 KMS 키에 대한 액세스를 제어할 때 kms:EncryptionContext:context-key 조건 키를 사용해 특정한 암호화 컨텍스트를 요구할 수 있습니다.

API 작업 요청에 대한 조건

대부분의 AWS KMS 조건 키는 AWS KMS 작업 요청의 파라미터 값을 기준으로 KMS 키에 대한 액세스를 제어합니다. 예를 들어 IAM 정책에서 kms:KeySpec 조건 키를 사용하여 CreateKey 요청의 KeySpec 파라미터 값이 RSA_4096인 경우에만 CreateKey 작업의 사용을 허용할 수 있습니다.

이 유형의 조건은 파라미터의 기본값을 사용하는 경우와 같이 요청에 파라미터가 나타나지 않는 경우에도 작동합니다. 예를 들어 kms:KeySpec 조건 키를 사용하여 사용자가 KeySpec 파라미터 값이 기본값 SYMMETRIC_DEFAULT인 경우에만 CreateKey 작업을 사용하도록 허용할 수 있습니다. 이 조건은 KeySpec 파라미터 값이 SYMMETRIC_DEFAULT인 요청과 KeySpec 파라미터가 없는 요청을 허용합니다.

API 작업에 사용되는 KMS 키에 대한 조건

일부 AWS KMS 조건 키는 작업에 사용되는 KMS 키의 속성을 기반으로 작업에 대한 액세스를 제어할 수 있습니다. 예를 들어 kms:KeyOrigin 조건을 사용하여 KMS 키의 OriginAWS_KMS인 경우에만 보안 주체가 KMS 키에서 GenerateDataKey를 호출하도록 할 수 있습니다. 이러한 방식으로 조건 키를 사용할 수 있는지 확인하려면 조건 키의 설명을 참조하십시오.

작업은 특정 KMS 키에 대해 권한이 부여된 KMS 키 리소스 작업이어야 합니다. KMS 키 리소스 작업을 식별하려면 작업 및 리소스 테이블에서, 해당 작업에 대한 Resources 열에서 KMS key 값을 찾습니다. ListKeys와 같이 특정 KMS 키 리소스에 대해 권한이 부여되지 않은 작업과 함께 이 유형의 조건 키를 사용하면 조건을 만족시킬 수 없으므로 권한이 적용되지 않습니다. ListKeys 작업 권한 부여와 관련된 KMS 키 리소스가 없고 KeySpec 속성이 없기 때문입니다.

다음 주제는 각 AWS KMS 조건 키를 설명하고, 정책 구문을 보여주는 정책문 예제를 포함합니다.

조건 키와 함께 집합 연산자 사용

정책 조건이 요청의 태그 집합과 정책의 태그 집합과 같은 두 가지 값 세트를 비교할 때 AWS에 집합을 비교하는 방법을 알려야 합니다. IAM은 이를 위해 두 개의 세트 연산자 ForAnyValueForAllValues를 정의합니다. 세트 연산자는 세트 연산자를 필요로 하는 다중값 조건 키(multi-valued condition keys)에만 사용합니다. 단일 값 조건 키(single-valued condition keys)에는 집합 연산자를 사용하지 마세요. 항상 정책문을 프로덕션 환경에서 사용하기 전에 철저히 테스트합니다.

조건 키는 단일 값이거나 다중 값입니다. AWS KMS 조건 키가 단일값인지 다중값인지 판별하려면 조건 키 설명의 값 유형 열을 참조하세요.

  • 단일 값 조건 키는 권한 부여 컨텍스트(요청 또는 리소스)에서 최대 하나의 값을 갖습니다. 예를 들어 각 API 호출은 하나의 AWS 계정 에서만 시작될 수 있으므로 kms:CallerAccount는 단일 값 조건 키입니다. 단일 값 조건 키(single-valued condition keys)에는 집합 연산자를 사용하지 마세요.

  • 다중 값 조건 키는 권한 부여 컨텍스트(요청 또는 리소스)에서 여러 값을 갖습니다. 예를 들어, 각 KMS 키에는 여러 개의 별칭이 있을 수 있으므로 kms:ResourceAliases에는 여러 개의 값이 있을 수 있습니다. 다중값 조건 키에는 집합 연산자가 필요합니다.

단일 값 조건 키와 다중값 조건 키의 차이는 정책 조건의 값 수가 아니라 권한 부여 컨텍스트의 값 수에 따라 달라집니다.

주의

단일 값 조건 키와 함께 집합 연산자를 사용하면 지나치게 허용 (또는 지나치게 제한적인) 정책문을 만들 수 있습니다. 집합 연산자는 다중값 조건 키(multi-valued condition keys)에만 사용합니다.

kms:EncryptionContext:context-key 또는 aws:RequestTag/tag-key 조건 키를 사용하여 ForAllValues 집합 연산자를 포함하는 정책을 생성하거나 업데이트하면 AWS KMS에서 다음 오류 메시지를 반환합니다.

OverlyPermissiveCondition: Using the ForAllValues set operator with a single-valued condition key matches requests without the specified [encryption context or tag] or with an unspecified [encryption context or tag]. To fix, remove ForAllValues.

ForAnyValueForAllValues 집합 연산자에 대한 자세한 내용은 IAM 사용 설명서여러 키 및 값 사용을 참조하세요. 단일 값 조건에서 ForAllValues 집합 연산자를 사용할 때의 위험에 대한 자세한 내용은 IAM 사용 설명서보안 경고 – 단일 값 키가 있는 ForAllValues 단원을 참조하세요.

kms:BypassPolicyLockoutSafetyCheck

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:BypassPolicyLockoutSafetyCheck

부울

단일 값

CreateKey

PutKeyPolicy

IAM 정책만

키 정책 및 IAM 정책

kms:BypassPolicyLockoutSafetyCheck 조건 키는 요청의 BypassPolicyLockoutSafetyCheck 파라미터 값을 기반으로 CreateKeyPutKeyPolicy 작업에 대한 액세스를 제어합니다.

다음 예제 IAM 정책문은 CreateKey 요청의 BypassPolicyLockoutSafetyCheck 파라미터 값이 true.일 때 사용자의 KMS 키 생성 권한을 거부하여 사용자가 정책 잠금 안전 점검을 우회하지 못하도록 합니다.

{ "Version": "2012-10-17", "Statement": { "Effect": "Deny", "Action": "kms:CreateKey", "Resource": "*", "Condition": { "Bool": { "kms:BypassPolicyLockoutSafetyCheck": true } } } }

또한 IAM 정책 또는 키 정책의 kms:BypassPolicyLockoutSafetyCheck 조건 키를 사용하여 PutKeyPolicy 작업에 대한 액세스를 제어할 수도 있습니다. 키 정책에 들어 있는 다음 예제 정책문은 KMS 키의 정책을 변경할 때 사용자가 정책 잠금 안전 점검을 우회하지 못하도록 합니다.

명시적 Deny를 사용하는 대신에, 이 정책문에서는 Null 조건 연산자Allow를 함께 사용하여 요청에 BypassPolicyLockoutSafetyCheck 파라미터가 포함되지 않을 때만 액세스를 허용합니다. 이 파라미터를 사용하지 않는 경우 기본값은 false입니다. 이와 같이 강도가 조금 낮은 정책문은 극히 드문 경우지만 우회가 필요할 경우 재정의할 수 있습니다.

{ "Version": "2012-10-17", "Statement": { "Effect": "Allow", "Action": "kms:PutKeyPolicy", "Resource": "*", "Condition": { "Null": { "kms:BypassPolicyLockoutSafetyCheck": true } } } }

다음 사항도 참조하세요.

kms:CallerAccount

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:CallerAccount

문자열

단일 값

KMS 키 리소스 작업

사용자 지정 키 스토어 작업

키 정책 및 IAM 정책

이 조건 키를 사용해 AWS 계정 의 모든 자격 증명(IAM 사용자와 역할)에 대한 액세스를 허용하거나 거부할 수 있습니다. 키 정책에서 Principal 요소를 이용해 정책문이 적용될 자격 증명을 지정합니다. Principal 요소에 대한 구문은 AWS 계정 의 모든 자격 증명을 지정하는 방법을 제공하지 않지만, 모든 Principal 자격 증명을 지정하는 AWS 요소와 이 조건 키를 결합하여 이러한 효과를 얻을 수 있습니다.

이를 사용하여 모든 KMS 키 리소스 작업, 즉 특정 KMS 키를 사용하는 모든 AWS KMS 작업에 대한 액세스를 제어할 수 있습니다. KMS 키 리소스 작업을 식별하려면 작업 및 리소스 테이블에서, 해당 작업에 대해 Resources 열에서 KMS key 값을 찾습니다. 사용자 지정 키 스토어를 관리하는 작업에도 유효합니다.

예를 들어 다음 키 정책문은 kms:CallerAccount 조건 키를 사용하는 방법을 보여줍니다. 이 정책문은 Amazon EBS를 위한 AWS 관리형 키 의 키 정책에 있습니다. 이 문은 모든 AWS 자격 증명을 지정하는 Principal 요소와 kms:CallerAccount 조건 키를 결합해 AWS 계정 111122223333에서 모든 자격 증명에 액세스하도록 효과적으로 허용합니다. 여기에 추가 AWS KMS 조건 키(kms:ViaService)가 포함되어 있어, Amazon EBS를 통해 수신되는 요청만 허용하여 권한을 더욱 제한합니다. 자세한 정보는 kms:ViaService 단원을 참조하세요.

{ "Sid": "Allow access through EBS for all principals in the account that are authorized to use EBS", "Effect": "Allow", "Principal": {"AWS": "*"}, "Condition": { "StringEquals": { "kms:CallerAccount": "111122223333", "kms:ViaService": "ec2.us-west-2.amazonaws.com" } }, "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:ReEncrypt*", "kms:GenerateDataKey*", "kms:CreateGrant", "kms:DescribeKey" ], "Resource": "*" }

kms:CustomerMasterKeySpec(사용되지 않음)

kms:CustomerMasterKeySpec 조건 키는 더 이상 사용되지 않습니다. 대신 kms:KeySpec 조건 키를 사용합니다.

kms:CustomerMasterKeySpeckms:KeySpec 조건 키는 같은 방식으로 작동하며, 이름만 다릅니다. kms:KeySpec을 사용할 것을 권장합니다. 그러나 변경 사항을 피하기 위해 AWS KMS는 두 조건 키를 모두 지원합니다.

kms:CustomerMasterKeyUsage(사용되지 않음)

kms:CustomerMasterKeyUsage 조건 키는 더 이상 사용되지 않습니다. 대신 kms:KeyUsage 조건 키를 사용합니다.

kms:CustomerMasterKeyUsagekms:KeyUsage 조건 키는 같은 방식으로 작동하며, 이름만 다릅니다. kms:KeyUsage을 사용할 것을 권장합니다. 그러나 변경 사항을 피하기 위해 AWS KMS는 두 조건 키를 모두 지원합니다.

kms:DataKeyPairSpec

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:DataKeyPairSpec

문자열

단일 값

GenerateDataKeyPair

GenerateDataKeyPairWithoutPlaintext

키 정책 및 IAM 정책

이 조건 키를 사용하여 요청의 KeyPairSpec 파라미터 값을 기반으로 GenerateDataKeyPairGenerateDataKeyPairWithoutPlaintext 작업에 대한 액세스를 제어할 수 있습니다. 예를 들어 사용자가 특정 유형의 데이터 키 페어만 생성하도록 허용할 수 있습니다.

다음 예제 키 정책 문은 kms:DataKeyPairSpec 조건 키를 사용하여 사용자가 KMS 키를 사용하여 RSA 데이터 키 페어만 생성하도록 허용합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": [ "kms:GenerateDataKeyPair", "kms:GenerateDataKeyPairWithoutPlaintext" ], "Resource": "*", "Condition": { "StringLike": { "kms:DataKeyPairSpec": "RSA*" } } }

다음 사항도 참조하세요.

kms:EncryptionAlgorithm

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:EncryptionAlgorithm

문자열

단일 값

Decrypt

Encrypt

GenerateDataKey

GenerateDataKeyPair

GenerateDataKeyPairWithoutPlaintext

GenerateDataKeyWithoutPlaintext

ReEncrypt

키 정책 및 IAM 정책

kms:EncryptionAlgorithm 조건 키를 사용하여 작업에 사용되는 암호화 알고리즘을 기반으로 암호화 작업에 대한 액세스를 제어할 수 있습니다. Encrypt, DecryptReEncrypt 작업의 경우 요청의 EncryptionAlgorithm 파라미터 값에 따라 액세스를 제어합니다. 데이터 키 및 데이터 키 페어를 생성하는 작업의 경우 데이터 키를 암호화하는 데 사용되는 암호화 알고리즘을 기반으로 액세스를 제어합니다.

이 조건 키는 AWS KMS 외부에서 비대칭 KMS 키 페어의 퍼블릭 키를 사용하여 암호화하는 경우와 같이 AWS KMS 외부에서 수행되는 작업에는 영향을 주지 않습니다.

요청의 EncryptionAlgorithm 파라미터

사용자가 KMS 키에 특정 암호화 알고리즘만 사용하도록 하려면 Deny 효과 및 StringNotEquals 조건 연산자가 포함된 정책문을 사용합니다. 예를 들어, 다음 예제 키 정책문에서는 요청의 암호화 알고리즘이 RSAES_OAEP_SHA_256이 아닐 경우 ExampleRole 역할을 수임할 수 있는 보안 주체가 지정된 암호화 작업에서 이 대칭 KMS 키를 사용할 수 없습니다.

사용자가 특정 암호화 알고리즘을 사용하도록 허용하는 정책 문과 달리, 이와 같은 이중 부정을 가진 정책 문은 이 KMS 키의 다른 정책 및 권한 부여가 이 역할이 다른 암호화 알고리즘을 사용하도록 허용하는 것을 금지합니다. 이 키 정책문의 DenyAllow 효과가 있는 모든 키 정책 또는 IAM 정책에 우선하며 KMS 키 및 해당 보안 주체에 대한 모든 권한 부여에 우선합니다.

{ "Sid": "Allow only one encryption algorithm with this asymmetric KMS key", "Effect": "Deny", "Principal": { "AWS": "arn:aws:iam::111122223333:role/ExampleRole" }, "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:ReEncrypt*" ], "Resource": "*", "Condition": { "StringNotEquals": { "kms:EncryptionAlgorithm": "RSAES_OAEP_SHA_256" } } }

작업에 사용되는 암호화 알고리즘

또한 kms:EncryptionAlgorithm 조건 키를 사용하여 알고리즘이 요청에 지정되지 않은 경우에도 작업에 사용된 암호화 알고리즘을 기반으로 작업에 대한 액세스를 제어할 수 있습니다. 이를 통해 SYMMETRIC_DEFAULT 알고리즘을 요구하거나 금지할 수 있습니다. 이 알고리즘은 기본값이기 때문에 요청에 지정되지 않을 수 있습니다.

kms:EncryptionAlgorithm 조건 키를 사용하여 데이터 키 및 데이터 키 페어를 생성하는 작업에 대한 액세스도 제어할 수 있습니다. 이러한 작업은 대칭 KMS 키와 SYMMETRIC_DEFAULT 알고리즘만 사용합니다.

예를 들어 다음 IAM 정책은 보안 주체를 대칭 암호화로 제한합니다. 요청에 지정되거나 작업에 사용된 암호화 알고리즘이 SYMMETRIC_DEFAULT가 아닐 경우 예제 계정에서 암호화 작업을 위한 KMS 키에 대한 액세스를 모두 거부합니다. GenerateDataKey*를 포함하면 권한에 GenerateDataKey, GenerateDataKeyWithoutPlaintext, GenerateDataKeyPairGenerateDataKeyPairWithoutPlaintext가 추가됩니다. 조건은 항상 대칭 암호화 알고리즘을 사용하기 때문에 이러한 작업에 영향을 주지 않습니다.

{ "Sid": "AllowOnlySymmetricAlgorithm", "Effect": "Deny", "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:ReEncrypt*", "kms:GenerateDataKey*" ], "Resource": "arn:aws:kms:us-west-2:111122223333:key/*", "Condition": { "StringNotEquals": { "kms:EncryptionAlgorithm": "SYMMETRIC_DEFAULT" } } }

다음 사항도 참조하세요.

kms:EncryptionContext:context-key

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:EncryptionContext:context-key

문자열

단일 값

CreateGrant

Encrypt

Decrypt

GenerateDataKey

GenerateDataKeyPair

GenerateDataKeyPairWithoutPlaintext

GenerateDataKeyWithoutPlaintext

ReEncrypt

키 정책 및 IAM 정책

kms:EncryptionContext:context-key 조건 키를 사용하여 암호화 작업 요청의 암호화 컨텍스트를 기반으로 대칭 KMS 키에 대한 액세스를 제어할 수 있습니다. 이 조건 키를 사용하여 암호화 컨텍스트 페어의 키와 값을 평가합니다. 키 또는 값에 관계없이 암호화 컨텍스트 키만 평가하거나 암호화 컨텍스트를 요구하려면 kms:EncryptionContextKeys 조건 키를 사용합니다.

비대칭 KMS 키를 사용하여 암호화 작업에서 암호화 컨텍스트를 지정할 수 없습니다. AWS KMS에서 사용하는 표준 비대칭 암호화 알고리즘은 암호화 컨텍스트를 지원하지 않습니다.

kms:EncryptionContext:context-key 조건 키를 사용하려면 context-key 자리 표시자를 암호화 컨텍스트 키로 바꿉니다. context-value 자리 표시자를 암호화 컨텍스트 값으로 바꿉니다.

"kms:EncryptionContext:context-key": "context-value"

예를 들어, 다음 조건 키는 키가 AppName이고 값이 ExampleApp (AppName = ExampleApp)인 암호화 컨텍스트를 지정합니다.

"kms:EncryptionContext:AppName": "ExampleApp"

이것은 단일 값 조건 키입니다. 조건 키의 키는 특정 암호화 컨텍스트 키(context-key)입니다. 각 API 요청에 여러 암호화 컨텍스트 페어를 포함할 수 있지만 지정된 context-key가 있는 암호화 컨텍스트 쌍은 하나의 값만 가질 수 있습니다. 예를 들어, kms:EncryptionContext:Department 조건 키는 Department 키가 있는 암호화 컨텍스트 페어에만 적용되며 Department 키가 있는 지정된 암호화 컨텍스트 페어에는 하나의 값만 있을 수 있습니다.

kms:EncryptionContext:context-key 조건 키와 함께 집합 연산자를 사용하지 마십시오. Allow 작업, kms:EncryptionContext:context-key 조건 키 및 ForAllValues 집합 연산자를 사용하여 정책문을 생성하는 경우 조건은 암호화 컨텍스트가 없는 요청과 정책 조건에 지정되지 않은 암호화 컨텍스트 페어가 있는 요청을 허용합니다.

주의

단일 값 조건 키(single-valued condition keys)에는 ForAnyValue 또는 ForAllValues 집합 연산자를 사용하지 마세요. 이러한 집합 연산자는 필요한 값을 요구하지 않고 금지하려는 값을 허용하는 정책 조건을 만들 수 있습니다.

kms:EncryptionContext:context-key를 사용하여 ForAllValues 집합 연산자를 포함하는 정책을 생성하거나 업데이트하면 AWS KMS에서 다음 오류 메시지를 반환합니다.

OverlyPermissiveCondition:EncryptionContext: Using the ForAllValues set operator with a single-valued condition key matches requests without the specified encryption context or with an unspecified encryption context. To fix, remove ForAllValues.

특정 암호화 컨텍스트 페어를 요구하려면 StringEquals 연산자와 함께 kms:EncryptionContext:context-key 조건 키를 사용하세요.

다음 예제 키 정책문은 요청의 암호화 컨텍스트에 AppName:ExampleApp 페어가 포함된 경우에만 역할을 맡을 수 있는 보안 주체가 GenerateDataKey 요청에서 KMS 키를 사용할 수 있도록 허용합니다. 다른 암호화 컨텍스트 페어가 허용됩니다.

키 이름은 대/소문자를 구분하지 않습니다. 값의 대소문자 구분은 StringEquals와 같은 조건 연산자에 의해 결정됩니다. 자세한 내용은 암호화 컨텍스트 조건의 대/소문자 구분 단원을 참조하세요.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/RoleForExampleApp" }, "Action": "kms:GenerateDataKey", "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:AppName": "ExampleApp" } } }

암호화 컨텍스트 페어를 요구하고 다른 모든 암호화 컨텍스트 페어를 금지하려면 정책문에서 kms:EncryptionContext:context-keykms:EncryptionContextKeys를 모두 사용하세요. 다음 키 정책문은 kms:EncryptionContext:AppName 조건을 사용하여 요청에 AppName=ExampleApp 암호화 컨텍스트 페어를 요구합니다. 또한 ForAllValues 집합 연산자와 함께 kms:EncryptionContextKeys 조건 키를 사용하여 AppName 암호화 컨텍스트 키만 허용합니다.

ForAllValues 집합 연산자는 요청의 암호화 컨텍스트 키를 AppName으로 제한합니다. ForAllValues 집합 연산자가 있는 kms:EncryptionContextKeys 조건이 정책문에서 단독으로 사용된 경우 이 집합 연산자는 암호화 컨텍스트가 없는 요청을 허용합니다. 그러나 요청에 암호화 컨텍스트가 없으면 kms:EncryptionContext:AppName 조건이 실패합니다. ForAllValues 집합 연산자에 대한 자세한 내용은 IAM 사용 설명서여러 키 및 값 사용을 참조하세요.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::712816755609:user/alice" }, "Action": "kms:GenerateDataKey", "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:AppName": "ExampleApp" }, "ForAllValues:StringEquals": { "kms:EncryptionContextKeys": [ "AppName" ] } } }

이 조건 키를 사용하여 특정 작업에 대한 KMS 키에 대한 액세스를 거부할 수도 있습니다. 다음 예제 키 정책문은 Deny 효과를 사용하여 요청의 암호화 컨텍스트에 Stage=Restricted 암호화 컨텍스트 페어가 포함된 경우 보안 주체가 KMS 키를 사용하는 것을 금지합니다. 이 조건은 Stage 키 및 Stage=Test와 같은 기타 값이 있는 암호화 컨텍스트 페어를 포함하여 다른 암호화 컨텍스트 페어로 요청을 허용합니다.

{ "Effect": "Deny", "Principal": { "AWS": "arn:aws:iam::111122223333:role/RoleForExampleApp" }, "Action": "kms:GenerateDataKey", "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:Stage": "Restricted" } } }

여러 암호화 컨텍스트 페어 사용

여러 암호화 컨텍스트 페어를 요구하거나 금지할 수 있습니다. 여러 암호화 컨텍스트 페어 중 하나를 요구할 수도 있습니다. 이러한 조건을 해석하는 데 사용되는 논리에 대한 자세한 내용은 IAM 사용 설명서의 여러 키 또는 값으로 조건 만들기 단원을 참조하세요.

참고

이 항목의 이전 버전에서는 kms:EncryptionContext:context-key 조건 키와 함께 ForAnyValueForAllValues 집합 연산자를 사용한 정책문을 표시했습니다. 단일 값 조건 키와 함께 집합 연산자를 사용하면 암호화 컨텍스트가 없고 지정되지 않은 암호화 컨텍스트 페어가 없는 요청을 허용하는 정책이 생성될 수 있습니다.

예를 들어, Allow 효과가 있는 정책 조건, ForAllValues 집합 연산자 및 "kms:EncryptionContext:Department": "IT" 조건 키가 암호화 컨텍스트를 "Department=IT" 페어로 제한하지 않습니다. 암호화 컨텍스트가없는 요청과 지정되지 않은 암호화 컨텍스트 쌍을 사용하는 요청(예: Stage=Restricted)을 허용합니다.

정책을 검토하고 kms:EncryptionContext:context-key를 사용하여 모든 조건에서 집합 연산자를 제거하십시오. 이 형식의 정책을 생성하거나 업데이트하려는 시도는 OverlyPermissiveCondition 예외와 함께 실패합니다. 오류를 해결하려면 집합 연산자를 삭제합니다.

여러 암호화 컨텍스트 쌍을 요구하려면 동일한 조건의 쌍을 나열합니다. 다음 예제 키 정책문에는 두 개의 암호화 컨텍스트 쌍인 Department=ITProject=Alpha가 필요합니다. 조건이 다른 키(kms:EncryptionContext:Departmentkms:EncryptionContext:Project)를 가지고 있기 때문에 AND 연산자에 의해 암시적으로 연결됩니다. 다른 암호화 컨텍스트 쌍은 허용되지만 필수는 아닙니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/RoleForExampleApp" }, "Action": "kms:Decrypt", "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:Department": "IT", "kms:EncryptionContext:Project": "Alpha" } } }

하나의 암호화 컨텍스트 쌍 또는 다른 쌍을 요구하려면 각 조건 키를 별도의 정책문에 배치합니다. 다음 예제 키 정책은 Department=IT 또는 Project=Alpha 쌍이나 둘 다 사용할 수 있습니다. 다른 암호화 컨텍스트 쌍은 허용되지만 필수는 아닙니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/RoleForExampleApp" }, "Action": "kms:GenerateDataKey", "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:Department": "IT" } } }, { "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/RoleForExampleApp" }, "Action": "kms:GenerateDataKey", "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:Project": "Alpha" } } }

특정 암호화 쌍을 요구하고 다른 모든 암호화 컨텍스트 쌍을 실행하려면 정책문에서 kms:EncryptionContext:context-keykms:EncryptionContextKeys를 모두 사용하십시오. 다음 키 정책문은 kms:EncryptionContext:context-key 컨디션을 사용하여 Department=IT Project=Alpha 페어 모두가 있는 암호화 컨텍스트를 요구합니다. ForAllValues 집합 연산자와 함께 kms:EncryptionContextKeys 조건 키를 사용하여 DepartmentProject 암호화 컨텍스트 키만 허용합니다.

ForAllValues 집합 연산자는 요청의 암호화 컨텍스트 키를 DepartmentProject으로 제한합니다. 조건에 단독으로 사용된 경우 이 집합 연산자는 암호화 컨텍스트가 없는 요청을 허용하지만 이 구성에서는 이 조건의 kms:EncryptionContext:context-key가 실패합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::712816755609:user/alice" }, "Action": "kms:GenerateDataKey", "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:Department": "IT", "kms:EncryptionContext:Project": "Alpha" }, "ForAllValues:StringEquals": { "kms:EncryptionContextKeys": [ "Department", "Project" ] } } }

여러 암호화 컨텍스트 쌍을 금지할 수도 있습니다. 다음 예제 키 정책문은 Deny 효과를 사용하여 요청의 암호화 컨텍스트에 Stage=Restricted 또는 Stage=Production 페어가 포함된 경우 보안 주체가 KMS 키를 사용하는 것을 금지합니다.

동일한 키(kms:EncryptionContext:Stage)에 대한 여러 값(RestrictedProduction)은 암시적으로 OR에 의해 연결됩니다. 자세한 내용은 IAM 사용 설명서여러 키 또는 값이 있는 조건에 대한 평가 논리 단원을 참조하세요.

{ "Effect": "Deny", "Principal": { "AWS": "arn:aws:iam::111122223333:role/RoleForExampleApp" }, "Action": "kms:GenerateDataKey", "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:Stage": [ "Restricted", "Production" ] } } }

암호화 컨텍스트 조건의 대/소문자 구분

복호화 작업에 지정된 암호화 컨텍스트는 암호화 작업에 지정된 암호화 컨텍스트에 대해 대소문자가 정확히 일치해야 합니다. 여러 쌍이 있는 암호화 컨텍스트에서 쌍의 순서만 다를 수 있습니다.

그러나 정책 조건에서 조건 키는 대소문자를 구분하지 않습니다. 조건 값의 대소문자 구분은 StringEquals 또는 StringEqualsIgnoreCase와 같이 사용하는 정책 조건 연산자에 의해 결정됩니다.

이와 같이 kms:EncryptionContext: 접두사와 context-key 대체로 구성된 조건 키는 대소문자를 구분하지 않습니다. 이 조건을 사용하는 정책은 조건 키의 두 요소의 대소문자를 검사하지 않습니다. 대소문자 구분, 즉 context-value 대체는 정책 조건 연산자에 의해 결정됩니다.

예를 들어 다음 정책 명령문은 대문자 사용에 관계없이 암호화 컨텍스트에 Appname키가 포함 된 경우 작업을 허용합니다. 예를 들어 다음 정책 명령문은 대문자 사용에 관계없이 암호화 컨텍스트에 StringEquals 키가 포함 된 경우 작업을 허용합니다ExampleApp.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/RoleForExampleApp" }, "Action": "kms:Decrypt", "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:Appname": "ExampleApp" } } }

대소문자를 구분하는 암호화 컨텍스트 키를 요구하려면 kms: EncryptionContextKeys 정책 조건을 대소문자를 구분하는 조건 연산자 (예: StringEquals)와 함께 사용하십시오. 이 정책 조건에서는 암호화 컨텍스트 키가 이 정책 조건의 값이기 때문에 대소문자 구분은 조건 연산자에 의해 결정됩니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/RoleForExampleApp" }, "Action": "kms:GenerateDataKey", "Resource": "*", "Condition": { "ForAnyValue:StringEquals": { "kms:EncryptionContextKeys": "AppName" } } }

암호화 컨텍스트 키와 값 모두에 대해 대소문자가 구분된 평가가 필요하면 kms:EncryptionContextKeys 및 kms:EncryptionContext:context-key 정책 조건을 동일한 정책문에 함께 사용하십시오. 대소문자를 구분하는 조건 연산자(예: StringEquals)는 항상 조건의 값에 적용됩니다. 암호화 컨텍스트 키(예: AppName)는 kms:EncryptionContextKeys 조건의 값입니다. 암호화 컨텍스트 값(예: ExampleApp)은 kms:EncryptionContext:context-key 조건의 의 값입니다.

예를 들어, StringEquals 연산자는 대소문자를 구분하기 때문에 다음 예제 키 정책문에서는 암호화 컨텍스트 키와 암호화 컨텍스트 값 모두 대소문자를 구분합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/RoleForExampleApp" }, "Action": "kms:GenerateDataKey", "Resource": "*", "Condition": { "ForAnyValue:StringEquals": { "kms:EncryptionContextKeys": "AppName" }, "StringEquals": { "kms:EncryptionContext:AppName": "ExampleApp" } } }

암호화 컨텍스트 조건에 변수 사용

암호화 컨텍스트 쌍의 키와 값은 단순 리터럴 문자열이어야 합니다. 정수나 객체, 또는 완전히 해결되지 않는 어떤 형식도 사용할 수 없습니다. 정수 또는 부동 소수점과 같은 다른 형식을 사용할 경우 AWS KMS는 이를 리터럴 문자열로 해석합니다.

"encryptionContext": { "department": "10103.0" }

그러나 kms:EncryptionContext:context-key 조건 키의 값은 IAM 정책 변수일 수 있습니다. 이러한 정책 변수는 런타임에 요청에 포함된 값을 기반으로 확인됩니다. 예를 들어 aws:CurrentTime 은 요청의 시간으로 확인되고 aws:username은 호출자의 표시 이름으로 확인됩니다.

이러한 정책 변수를 사용하여 암호화 컨텍스트에서 매우 구체적인 정보(예: 호출자의 사용자 이름)를 요구하는 조건을 포함하는 정책 문을 생성할 수 있습니다. 변수를 포함하기 때문에 특정 역할을 수임할 수 있는 모든 사용자에 동일한 정책 문을 사용할 수 있습니다. 사용자마다 따로 정책 문을 작성할 필요가 없습니다.

예를 들어 모든 사용자가 동일한 KMS 키를 사용하여 데이터를 암호화 및 복호화하는 역할을 수임할 수 있게 하려고 합니다. 그러나 모든 사용자가 직접 암호화한 데이터만 암호화를 해제하도록 허용하려고 합니다. 먼저 AWS KMS에 대한 모든 요청이 키가 user이고 값이 다음과 같은 호출자의 AWS 사용자 이름을 포함하도록 요구하는 것으로 시작합니다.

"encryptionContext": { "user": "bob" }

그런 다음 이 요구 사항을 시행하려면 다음 예제와 같은 정책 문을 사용할 수 있습니다. 이 정책문은 TestTeam 역할에 KMS 키를 사용하여 데이터를 암호화 및 복호화할 권한을 부여합니다. 그러나 이 권한은 요청의 암호화 컨텍스트가 "user": "<username>" 쌍을 포함하는 경우에만 유효합니다. 사용자 이름을 표현하기 위해 조건이 aws:username 정책 변수를 사용합니다.

요청이 평가될 때 호출자의 사용자 이름이 조건의 변수를 대체합니다. 따라서 조건은 "bob"에 대해서는 암호화 컨텍스트 "user": "bob"을 요구하고 "alice"에 대해서는 "user": "alice"를 요구합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/TestTeam" }, "Action": [ "kms:Decrypt", "kms:Encrypt" ], "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:user": "${aws:username}" } } }

IAM 정책 변수는 kms:EncryptionContext:context-key 조건 키의 값에만 사용할 수 있습니다. 키에는 변수를 사용할 수 없습니다.

또한 변수에 공급자별 컨텍스트 키를 사용할 수도 있습니다. 이러한 컨텍스트 키는 웹 자격 증명 연동을 사용하여 AWS에 로그인한 사용자를 고유하게 식별합니다.

다른 모든 변수와 마찬가지로 이러한 변수도 실제 암호화 컨텍스트가 아니라 kms:EncryptionContext:context-key 정책 조건에서만 사용할 수 있습니다. 또한 키가 아니라 조건의 값에만 사용할 수 있습니다.

예를 들어 다음 키 정책 문은 이전 것과 비슷합니다. 그러나 조건은 키가 sub이고 값이 Amazon Cognito 사용자 풀에 로그인한 사용자를 고유하게 식별하는 암호화 컨텍스트를 요구합니다. Amazon Cognito에서 사용자 및 역할을 식별하는 방법에 대한 자세한 내용은 Amazon Cognito 개발자 안내서IAM 역할을 참조하세요.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/TestTeam" }, "Action": [ "kms:Decrypt", "kms:Encrypt" ], "Resource": "*", "Condition": { "StringEquals": { "kms:EncryptionContext:sub": "${cognito-identity.amazonaws.com:sub}" } } }

다음 사항도 참조하세요.

kms:EncryptionContextKeys

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:EncryptionContextKeys

문자열(목록)

다중 값

CreateGrant

Decrypt

Encrypt

GenerateDataKey

GenerateDataKeyPair

GenerateDataKeyPairWithoutPlaintext

GenerateDataKeyWithoutPlaintext

ReEncrypt

키 정책 및 IAM 정책

kms:EncryptionContextKeys 조건 키를 사용하여 암호화 작업 요청의 암호화 컨텍스트를 기반으로 대칭 KMS 키에 대한 액세스를 제어할 수 있습니다. 이 조건 키를 사용하여 각 암호화 컨텍스트 페어의 키만 평가하십시오. 암호화 컨텍스트의 키와 값을 평가하려면 이 kms:EncryptionContext:context-key 조건 키를 사용합니다.

비대칭 KMS 키를 사용하여 암호화 작업에서 암호화 컨텍스트를 지정할 수 없습니다. AWS KMS에서 사용하는 표준 비대칭 암호화 알고리즘은 암호화 컨텍스트를 지원하지 않습니다.

이는 다중 값 조건 키입니다. 각 API 요청에서 여러 암호화 컨텍스트 페어를 지정할 수 있습니다. kms:EncryptionContextKeys는 요청의 암호화 컨텍스트 키를 정책의 암호화 컨텍스트 키 집합과 비교합니다. 이러한 집합이 비교되는 방법을 확인하려면 정책 조건에서 ForAnyValue 또는 ForAllValues 연산자를 제공해야 합니다. 집합 연산자에 대한 자세한 내용은 IAM 사용 설명서의 여러 키 및 값 사용을 참조하세요.

  • ForAnyValue: 요청에 있는 하나 이상의 암호화 컨텍스트 키가 정책 조건의 암호화 컨텍스트 키와 일치해야 합니다. 다른 암호화 컨텍스트 키가 허용됩니다. 요청에 암호화 컨텍스트가 없는 경우 조건이 충족되지 않습니다.

  • ForAllValues: 요청의 모든 암호화 컨텍스트 키는 정책 조건의 암호화 컨텍스트 키와 일치해야 합니다. 이 집합 연산자는 암호화 컨텍스트 키를 정책 조건의 컨텍스트 키로 제한합니다. 암호화 컨텍스트 키는 필요하지 않지만 지정되지 않은 암호화 컨텍스트 키는 금지됩니다.

다음 예제 키 정책 명령문에서 kms:EncryptionContextKeys 조건 키를 ForAnyValue 집합 연산자와 함께 사용합니다. 이 정책문은 지정된 작업에 대해 KMS 키를 사용할 수 있도록 허용하지만 값에 관계없이 요청의 암호화 컨텍스트 페어 중 하나 이상이 AppName 키를 포함하는 경우에만 가능합니다.

예를 들어, 이 키 정책문은 첫 번째 암호화 컨텍스트 페어가 조건을 충족하기 때문에 두 개의 암호화 컨텍스트 페어(AppName=HelperProject=Alpha)가 있는 GenerateDataKey 요청을 허용합니다. Project=Alpha만 있거나 암호화 컨텍스트가 없는 요청은 실패합니다.

StringEquals 조건 연산은 대소문자를 구별하므로 정책문에는 암호화 컨텍스트 키의 철자와 대소 문자가 필요합니다. 그러나 StringEqualsIgnoreCase과 같은 키 대소문자를 무시하는 조건 연산자를 사용할 수 있습니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/RoleForExampleApp" }, "Action": [ "kms:Encrypt", "kms:GenerateDataKey*" ], "Resource": "*", "Condition": { "ForAnyValue:StringEquals": { "kms:EncryptionContextKeys": "AppName" } } }

또한 kms:EncryptionContextKeys 조건 키를 사용하여 KMS 키를 사용하는 암호화 작업에서 암호화 컨텍스트(모든 암호화 컨텍스트)를 요구할 수도 있습니다.

다음의 키 정책문 예제는 kms:EncryptionContextKeys 조건 키와 함께 를 사용하여 조건 키에서 API 요청에 존재할 때만(null 아님) CMK에 대한 액세스를 허용합니다. 이 조건은 암호화 컨텍스트의 키나 값을 확인하지 않습니다. 암호화 컨텍스트가 존재하는지 확인합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/RoleForExampleApp" }, "Action": [ "kms:Encrypt", "kms:GenerateDataKey*" ], "Resource": "*", "Condition": { "Null": { "kms:EncryptionContextKeys": false } } }

다음 사항도 참조하세요.

kms:ExpirationModel

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:ExpirationModel

문자열

단일 값

ImportKeyMaterial

키 정책 및 IAM 정책

kms:ExpirationModel 조건 키는 요청의 ExpirationModel 파라미터 값을 기반으로 ImportKeyMaterial 작업에 대한 액세스를 제어합니다.

ExpirationModel은 가져온 키 자료가 만료되는지 여부를 결정하는 선택적 파라미터입니다. 유효한 값은 KEY_MATERIAL_EXPIRESKEY_MATERIAL_DOES_NOT_EXPIRE이며, 기본값은 KEY_MATERIAL_EXPIRES입니다.

만료 날짜 및 시간은 ValidTo 파라미터의 값에 따라 결정됩니다. ValidTo 파라미터의 값이 ExpirationModel가 아닌 경우에는 KEY_MATERIAL_DOES_NOT_EXPIRE 파라미터가 필요합니다. 또한 kms:ValidTo 조건 키를 사용하여 특정 만료 날짜를 액세스 조건으로 요구할 수도 있습니다.

다음 예제 정책문은 kms:ExpirationModel 조건 키를 사용하여 요청에 ExpirationModel 파라미터가 포함되고 해당 값이 KEY_MATERIAL_DOES_NOT_EXPIRE일 때만 사용자가 키 구성 요소를 KMS 키로 가져올 수 있도록 합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": "kms:ImportKeyMaterial", "Resource": "*", "Condition": { "StringEquals": { "kms:ExpirationModel": "KEY_MATERIAL_DOES_NOT_EXPIRE" } } }

또한 kms:ExpirationModel 조건 키를 사용하여 사용자가 키 구성 요소가 만료된 경우에만 키 구성 요소를 가져오도록 할 수 있습니다. 다음다음 예제 키 정책문은 Null 조건 연산자와 함께 kms:ExpirationModel 조건 키를 사용하여 요청에 ExpirationModel 파라미터가 없는 경우에만 사용자가 키 구성 요소를 가져올 수 있도록 합니다. ExpirationModel의 기본값은 KEY_MATERIAL_EXPIRES입니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": "kms:ImportKeyMaterial", "Resource": "*", "Condition": { "Null": { "kms:ExpirationModel": true } } }

다음 사항도 참조하세요.

kms:GrantConstraintType

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:GrantConstraintType

문자열

단일 값

CreateGrant

키 정책 및 IAM 정책

이 조건 키를 사용하여 요청의 권한 부여 제약 조건 유형에 따라 CreateGrant 작업에 대한 액세스를 제어할 수 있습니다.

권한 부여를 생성하면 선택적으로 권한 부여 제약을 지정해 특정 암호화 컨텍스트가 있는 경우에만 권한 부여에 의해 허용된 작업을 허용할 수 있습니다. 권한 부여 제약은 EncryptionContextEquals 또는 EncryptionContextSubset, 두 유형 중 하나일 수 있습니다. 이 조건 키를 사용해 요청 제약에 어떤 유형이 포함되었는지 확인할 수 있습니다.

다음 예제 키 정책 설명은 kms:GrantConstraintType 조건 키를 사용해 요청에 EncryptionContextEquals 권한 부여 제약이 포함된 경우에만 사용자가 권한 부여를 생성하도록 허용합니다. 이 예제는 키 정책의 정책 설명을 보여줍니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": "kms:CreateGrant", "Resource": "*", "Condition": { "StringEquals": { "kms:GrantConstraintType": "EncryptionContextEquals" } } }

다음 사항도 참조하세요.

kms:GrantIsForAWSResource

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:GrantIsForAWSResource

부울

단일 값

CreateGrant

ListGrants

RevokeGrant

키 정책 및 IAM 정책

AWS KMS와 통합된 AWS 서비스가 사용자를 대신하여 작업을 호출하는 경우에만 CreateGrant, ListGrants 또는 RevokeGrant 작업에 대한 권한을 허용하거나 거부합니다. 이 정책 조건은 사용자가 이러한 권한 부여 작업을 직접 호출하도록 허용하지 않습니다.

다음 예제 키 정책 문은 kms:GrantIsForAWSResource 조건 키를 사용합니다. 이를 통해 Amazon EBS와 같이 AWS KMS와 통합된 AWS 서비스가 지정된 보안 주체를 대신하여 이 KMS 키에 대한 권한 부여를 생성할 수 있습니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": "kms:CreateGrant", "Resource": "*", "Condition": { "Bool": { "kms:GrantIsForAWSResource": true } } }

다음 사항도 참조하세요.

kms:GrantOperations

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:GrantOperations

문자열

다중 값

CreateGrant

키 정책 및 IAM 정책

이 조건 키를 사용해 요청에서 권한 부여 작업을 기반으로 CreateGrant 작업에 대한 액세스를 제어할 수 있습니다. 예를 들어, 사용자가 암호화할 권한은 위임하지만 복호화할 권한은 위임하지 않는 권한 부여를 생성하도록 허용할 수 있습니다. 권한 부여에 대한 자세한 내용은 권한 부여 사용을 참조하세요.

이는 다중 값 조건 키입니다. kms:GrantOperationsCreateGrant 요청의 승인 작업 세트를 정책의 승인 작업 세트와 비교합니다. 이러한 집합이 비교되는 방법을 확인하려면 정책 조건에서 ForAnyValue 또는 ForAllValues 연산자를 제공해야 합니다. 집합 연산자에 대한 자세한 내용은 IAM 사용 설명서의 여러 키 및 값 사용을 참조하세요.

  • ForAnyValue: 요청의 모든 권한 부여 작업은 정책 조건의 부여 작업과 일치해야 합니다. 기타 권한 부여 작업이 허용됩니다.

  • ForAllValues: 요청의 모든 권한 부여 작업은 정책 조건의 부여 작업과 일치해야 합니다. 이 집합 연산자는 권한 부여 작업을 정책 조건에 지정된 작업으로 제한합니다. 어떠한 권한 부여 작업도 필요하지 않지만 지정되지 않은 권한 부여 작업은 금지합니다.

    ForAllValues는 요청에 권한 부여 작업이 없을 때 true를 반환하지만 CreateGrant는 허용하지 않습니다. 만약 Operations 파라미터가 없거나 null 값을 갖는 경우 CreateGrant 요청이 실패합니다.

다음 예제 키 정책문은 kms:GrantOperations 조건 키를 사용하여 권한 부여 작업이 Encrypt, ReEncryptTo 또는 둘 다인 경우에만 사용자가 권한 부여를 생성할 수 있도록 합니다. 권한 부여에 다른 작업이 포함된 경우 CreateGrant 요청이 실패합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": "kms:CreateGrant", "Resource": "*", "Condition": { "ForAllValues:StringEquals": { "kms:GrantOperations": [ "Encrypt", "ReEncryptTo" ] } } }

정책 조건의 집합 연산자를 ForAnyValue로 변경하면 정책문에서 권한 부여의 권한 부여 작업 중 하나 이상이 Encrypt 또는 ReEncryptTo여야 하지만 Decrypt 또는 ReEncryptFrom과 같은 다른 권한 부여 작업은 허용합니다.

다음 사항도 참조하세요.

kms:GranteePrincipal

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:GranteePrincipal

문자열

단일 값

CreateGrant

IAM 및 키 정책

이 조건 키를 사용하여 요청의 GranteePrincipal 파라미터 값을 기반으로 CreateGrant 작업에 대한 액세스를 제어할 수 있습니다. 예를 들면 CreateGrant 요청의 피부여자 보안 주체가 조건문에 지정된 보안 주체와 일치할 때만 사용자에게 KMS 키 사용 권한을 생성하도록 허용할 수 있습니다.

다음 예제 키 정책문은 kms:GranteePrincipal 조건 키를 사용하여 권한의 피부여자 보안 주체가 LimitedAdminRole일 때만 사용자에게 KMS 키 권한을 생성하도록 허용합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": "kms:CreateGrant", "Resource": "*", "Condition": { "StringEquals": { "kms:GranteePrincipal": "arn:aws:iam::111122223333:role/LimitedAdminRole" } } }

다음 사항도 참조하세요.

kms:KeyOrigin

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:KeyOrigin

문자열

단일 값

CreateKey

KMS 키 리소스 작업

IAM 정책

키 정책 및 IAM 정책

kms:KeyOrigin 조건 키는 작업에 의해 작성되거나 작업에 사용된 KMS 키의 Origin 속성 값에 따라 작업에 대한 액세스를 제어합니다. 그것은 리소스 조건 또는 요청 조건으로 작동합니다.

이 조건 키를 사용하여 요청의 Origin 파라미터 값을 기반으로 CreateKey 작업에 대한 액세스를 제어할 수 있습니다. Origin의 유효한 값은 AWS_KMS, AWS_CLOUDHSMEXTERNAL입니다.

예를 들어 AWS KMS(AWS_KMS)에서 키 구성 요소가 생성된 경우에만, 사용자 지정 키 스토어(AWS_CLOUDHSM)와 연결된 AWS CloudHSM 클러스터에서 키 자료가 생성된 경우에만 또는 외부 소스(EXTERNAL)에서 키 구성 요소를 가져온 경우에만 사용자가 KMS 키를 생성하도록 허용할 수 있습니다.

다음 예제 키 정책문은 kms:KeyOrigin 조건 키를 사용하여 AWS KMS가 키 구성 요소를 생성하는 경우에만 사용자가 KMS 키를 생성하도록 허용합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": "kms:CreateKey", "Resource": "*", "Condition": { "StringEquals": { "kms:KeyOrigin": "AWS_KMS" } } }

또한 kms:KeyOrigin 조건 키를 사용하여 작업에 사용되는 KMS 키의 Origin 속성을 기반으로 KMS 키를 사용 또는 관리하는 작업에 대한 액세스를 제어할 수도 있습니다. 작업은 특정 KMS 키에 대해 권한이 부여된 KMS 키 리소스 작업이어야 합니다. KMS 키 리소스 작업을 식별하려면 작업 및 리소스 테이블에서, 해당 작업에 대해 Resources 열에서 KMS key 값을 찾습니다.

예를 들어 다음 IAM 정책에서는 보안 주체가 지정된 KMS 키 리소스 작업을 수행하도록 허용하지만 계정의 사용자 지정 키 스토어에서 생성된 KMS 키에 대해서만 허용합니다.

{ "Effect": "Allow", "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:GenerateDataKey", "kms:GenerateDataKeyWithoutPlaintext", "kms:GenerateDataKeyPair", "kms:GenerateDataKeyPairWithoutPlaintext", "kms:ReEncrypt*" ], "Resource": "arn:aws:kms:us-west-2:111122223333:key/*", "Condition": { "StringEquals": { "kms:KeyOrigin": "AWS_CLOUDHSM" } } }

다음 사항도 참조하세요.

kms:KeySpec

AWS KMS 조건 키 조건 유형 API 작업 정책 유형

kms:KeySpec

문자열

CreateKey

KMS 키 리소스 작업

IAM 정책

키 정책 및 IAM 정책

kms:KeySpec 조건 키는 작업에 의해 작성되거나 작업에 사용된 KMS 키의 KeySpec 속성 값에 따라 작업에 대한 액세스를 제어합니다.

IAM 정책에서 이 조건 키를 사용하여 CreateKey 요청의 KeySpec 파라미터 값을 기반으로 CreateKey 작업에 대한 액세스를 제어할 수 있습니다. 예를 들어 이 조건을 사용하여 사용자가 대칭 KMS 키만 생성하거나 RSA 키가 있는 KMS 키만 생성하도록 허용할 수 있습니다.

다음 예제 IAM 정책문은 kms:KeySpec 조건 키를 사용하여 요청의 KeySpecRSA_4096인 경우에만 보안 주체가 KMS 키를 생성하도록 허용합니다.

{ "Effect": "Allow", "Action": "kms:CreateKey", "Resource": "*", "Condition": { "StringEquals": { "kms:KeySpec": "RSA_4096" } } }

또한 kms:KeySpec 조건 키를 사용하여 작업에 사용되는 KMS 키의 KeySpec 속성을 기반으로 KMS 키를 사용 또는 관리하는 작업에 대한 액세스를 제어할 수도 있습니다. 작업은 특정 KMS 키에 대해 권한이 부여된 KMS 키 리소스 작업이어야 합니다. KMS 키 리소스 작업을 식별하려면 작업 및 리소스 테이블에서, 해당 작업에 대해 Resources 열에서 KMS key 값을 찾습니다.

예를 들어 다음 IAM 정책에서는 보안 주체가 지정된 KMS 키 리소스 작업을 수행하도록 허용하지만 계정의 대칭 KMS 키에 대해서만 허용합니다.

{ "Effect": "Allow", "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:ReEncrypt*", "kms:DescribeKey" ], "Resource": { "arn:aws:kms:us-west-2:111122223333:key/*" }, "Condition": { "StringEquals": { "kms:KeySpec": "SYMMETRIC_DEFAULT" } } }

다음 사항도 참조하세요.

kms:KeyUsage

AWS KMS 조건 키 조건 유형 API 작업 정책 유형

kms:KeyUsage

문자열

CreateKey

KMS 키 리소스 작업

IAM 정책

키 정책 및 IAM 정책

kms:KeyUsage 조건 키는 작업에 의해 작성되거나 작업에 사용된 KMS 키의 KeyUsage 속성 값에 따라 작업에 대한 액세스를 제어합니다.

이 조건 키를 사용하여 요청의 KeyUsage 파라미터 값을 기반으로 CreateKey 작업에 대한 액세스를 제어할 수 있습니다. KeyUsage 유효값은 ENCRYPT_DECRYPTSIGN_VERIFY입니다.

예를 들어, KeyUsageENCRYPT_DECRYPT인 경우에만 사용자가 KMS 키를 생성하도록 허용하고 KeyUsageSIGN_VERIFY인 경우에는 사용자 권한을 거부할 수 있습니다.

다음 예제 IAM 정책 문은 kms:KeyUsage 조건 키를 사용하여 KeyUsageENCRYPT_DECRYPT인 경우에만 사용자가 KMS 키를 생성하도록 허용합니다.

{ "Effect": "Allow", "Action": "kms:CreateKey", "Resource": "*", "Condition": { "StringEquals": { "kms:KeyUsage": "ENCRYPT_DECRYPT" } } }

또한 kms:KeyUsage 조건 키를 사용하여 작업에 사용되는 KMS 키의 KeyUsage 속성을 기반으로 KMS 키를 사용 또는 관리하는 작업에 대한 액세스를 제어할 수도 있습니다. 작업은 특정 KMS 키에 대해 권한이 부여된 KMS 키 리소스 작업이어야 합니다. KMS 키 리소스 작업을 식별하려면 작업 및 리소스 테이블에서, 해당 작업에 대해 Resources 열에서 KMS key 값을 찾습니다.

예를 들어 다음 IAM 정책에서는 보안 주체가 지정된 KMS 키 리소스 작업을 수행하도록 허용하지만 계정에서 서명 및 확인에 사용되는 KMS 키에 대해서만 허용합니다.

{ "Effect": "Allow", "Action": [ "kms:CreateGrant", "kms:DescribeKey", "kms:GetPublicKey", "kms:ScheduleKeyDeletion" ], "Resource": { "arn:aws:kms:us-west-2:111122223333:key/*" }, "Condition": { "StringEquals": { "kms:KeyUsage": "SIGN_VERIFY" } } }

다음 사항도 참조하세요.

kms:MessageType

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:MessageType

문자열

단일 값

Sign

Verify

키 정책 및 IAM 정책

kms:MessageType 조건 키는 요청의 MessageType 파라미터 값을 기반으로 서명확인 작업에 대한 액세스를 제어합니다. MessageType 유효값은 RAWDIGEST입니다.

예를 들어 다음 키 정책 문은 kms:MessageType 조건 키를 사용하여 사용자가 비대칭 KMS 키를 사용하여 메시지에 서명하도록 허용하지만 메시지 다이제스트는 허용하지 않습니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": "kms:Sign", "Resource": "*", "Condition": { "StringEquals": { "kms:MessageType": "RAW" } } }

다음 사항도 참조하세요.

kms:MultiRegion

AWS KMS 조건 키 조건 유형 API 작업 정책 유형

kms:MultiRegion

부울

CreateKey

KMS 키 리소스 작업

키 정책 및 IAM 정책

이 조건 키를 사용하여 단일 리전 키 또는 다중 리전 키에서만 작업을 허용할 수 있습니다. kms:MultiRegion 조건 키는 KMS 키의 AWS KMS 작업 및 KMS 키의 MultiRegion 속성 값을 기반으로 하는 CreateKey 작업에 대한 액세스를 제어합니다. 유효 값은 true(다중 리전) 및 false(단일 리전)입니다. 모든 KMS 키에는 MultiRegion 속성입니다.

예를 들어 다음 IAM 정책문은 kms:MultiRegion 조건 키를 사용하여 보안 주체가 단일 리전 키를 생성하도록 허용합니다.

{ "Effect": "Allow", "Action": "kms:CreateKey", "Resource": { "*" }, "Condition": { "Bool": "kms:MultiRegion": false } }

kms:MultiRegionKeyType

AWS KMS 조건 키 조건 유형 API 작업 정책 유형

kms:MultiRegionKeyType

문자열

CreateKey

KMS 키 리소스 작업

키 정책 및 IAM 정책

이 조건 키를 사용하여 다중 리전 기본 키 또는 다중 리전 복제본 키에서만 작업을 허용할 수 있습니다. kms:MultiRegionKeyType 조건 키는 KMS 키의 AWS KMS 작업 및 KMS 키의 MultiRegionKeyType 속성을 기반으로 하는 CreateKey 작업에 대한 액세스를 제어합니다. 유효 값은 PRIMARYREPLICA입니다. 다중 리전 키에만 MultiRegionKeyType 속성이 있습니다.

일반적으로 IAM 정책에서 kms:MultiRegionKeyType 조건 키를 사용하여 여러 KMS 키에 대한 액세스를 제어합니다. 그러나 지정된 다중 리전 키가 기본 또는 복제본으로 변경될 수 있으므로 특정 다중 리전 키가 기본 또는 복제본 키인 경우에만 작업을 허용하려면 키 정책에서 이 조건을 사용할 수 있습니다.

예를 들어 다음 IAM 정책 설명은 kms:MultiRegionKeyType 조건 키를 사용하여 보안 주체가 지정된 AWS 계정 의 다중 리전 복제본 키에서만 키 삭제를 예약하고 취소할 수 있도록 합니다.

{ "Effect": "Allow", "Action": [ "kms:ScheduleKeyDeletion", "kms:CancelKeyDeletion" ], "Resource": { "arn:aws:kms:*:111122223333:key/*" }, "Condition": { "StringEquals": "kms:MultiRegionKeyType": "REPLICA" } }

모든 다중 지역 키에 대한 액세스를 허용하거나 거부하려면 kms:MultiRegionKeyType와 함께 두 값 또는 null 값을 모두 사용할 수 있습니다. 그러나, kms:MultiRegion 조건 키를 사용하는 것이 좋습니다.

kms:PrimaryRegion

AWS KMS 조건 키 조건 유형 API 작업 정책 유형

kms:PrimaryRegion

문자열(목록)

UpdatePrimaryRegion

키 정책 및 IAM 정책

이 조건 키를 사용하여 UpdatePrimaryRegion 작업에서 대상 리전을 제한할 수 있습니다. 이는 다중 리전 기본 키를 호스팅할 수 있는 AWS 리전 입니다.

kms:PrimaryRegion 조건 키는 PrimaryRegion 파라미터 변수의 값을 기반으로 UpdatePrimaryRegion 작업에 대한 액세스를 제어합니다. PrimaryRegion 파라미터는 기본으로 승격되는 다중 리전 복제본 키의 AWS 리전 을 지정합니다. 조건의 값은 하나 이상의 AWS 리전 이름(예: us-east-1 또는 ap-southeast-2)이거나 리전 이름 패턴(예: eu-*)입니다.

예를 들어 다음 키 정책 문은 kms:PrimaryRegion 조건 키를 사용하여 보안 주체가 다중 리전 키의 기본 리전을 지정된 4개의 리전 중 하나로 업데이트할 수 있습니다.

{ "Effect": "Allow", "Action": "kms:UpdatePrimaryRegion", "Principal": { "AWS": "arn:aws:iam::111122223333:role/Developer" }, "Resource": "*", "Condition": { "StringEquals": { "kms:PrimaryRegion": [ "us-east-1", "us-west-2", "eu-west-3", "ap-southeast-2" ] } } }

kms:ReEncryptOnSameKey

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:ReEncryptOnSameKey

부울

단일 값

ReEncrypt

키 정책 및 IAM 정책

이 조건 키를 사용해 요청이 원래 암호화에 사용된 것과 동일한 대상 KMS 키를 지정하는지 여부에 따라 ReEncrypt 작업에 대한 액세스를 제어할 수 있습니다.

예를 들어 다음 키 정책문은 kms:ReEncryptOnSameKey 조건 키를 사용해 대상 KMS 키가 원래 암호화에 사용된 것과 동일한 경우에만 사용자가 다시 암호화하도록 허용합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": "kms:ReEncrypt*", "Resource": "*", "Condition": { "Bool": { "kms:ReEncryptOnSameKey": true } } }

kms:RequestAlias

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:RequestAlias

문자열(목록)

단일 값

암호화 작업

DescribeKey

GetPublicKey

키 정책 및 IAM 정책

이 조건 키를 사용하여 요청이 KMS 키를 식별하는 데 특정 별칭을 사용하는 경우에만 작업을 허용할 수 있습니다. 이 kms:RequestAlias 조건 키는 요청에서 해당 KMS 키를 식별하는 별칭을 기반으로 암호화 작업에 사용되는 KMS 키 GetPublicKey 또는 DescribeKey에 대한 액세스를 제어합니다. (이 정책 조건은 GenerateRandom 작업이 KMS 키 또는 별칭을 사용하지 않기 때문에 영향을 미치지 않습니다.)

이 조건은 AWS KMS에서 속성 기반 액세스 제어(ABAC)를 지원하므로 KMS 키의 태그 및 별칭을 기반으로 KMS 키에 대한 액세스를 제어할 수 있습니다. 정책 또는 권한 부여를 변경하지 않고 태그 및 별칭을 사용하여 KMS 키에 대한 액세스를 허용할 수 있습니다. 자세한 내용은 AWS KMS에 ABAC 사용 단원을 참조하세요.

이 정책 조건에서 별칭을 지정하려면 별칭 이름(예: alias/project-alpha) 또는 별칭 이름 패턴(예: alias/*test*)을 사용합니다. 이 조건 키의 값에 별칭 ARN을 지정할 수 없습니다.

이 조건을 만족시키기 위해 요청의 KeyId 파라미터 값은 일치하는 별칭 이름 또는 별칭 ARN이어야 합니다. 요청이 다른 키 식별자를 사용하면 동일한 KMS 키를 식별하더라도 조건을 충족하지 못합니다.

예를 들어 다음 키 정책문은 보안 주체가 KMS 키에서 GenerateDataKey 작업을 호출하도록 허용합니다. 그러나 이는 요청의 KeyId 파라미터 값이 alias/finance-key이거나 해당 별칭 이름(예: arn:aws:kms:us-west-2:111122223333:alias/finance-key)이 있는 별칭 ARN인 경우에만 허용됩니다.

{ "Sid": "Key policy using a request alias condition", "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/developer" }, "Action": "kms:GenerateDataKey", "Resource": "*", "Condition": { "StringEquals": { "kms:RequestAlias": "alias/finance-key" } } }

이 조건 키를 사용하여 CreateAlias 또는 DeleteAlias와 같은 별칭 작업에 대한 액세스를 제어할 수 없습니다. 별칭 작업에 대한 액세스 제어와 관련된 자세한 내용은 별칭에 대한 액세스 제어 단원을 참조하세요.

kms:ResourceAliases

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:ResourceAliases

문자열(목록)

다중 값 KMS 키 리소스 작업

IAM 정책만

이 조건 키를 사용하여 KMS 키와 연결된 별칭을 기반으로 KMS 키에 대한 액세스를 제어합니다. 작업은 특정 KMS 키에 대해 권한이 부여된 KMS 키 리소스 작업이어야 합니다. KMS 키 리소스 작업을 식별하려면 작업 및 리소스 테이블에서, 해당 작업에 대해 Resources 열에서 KMS key 값을 찾습니다.

이 조건은 AWS KMS의 속성 기반 액세스 제어(ABAC)를 지원합니다. ABAC를 사용하면 KMS 키에 할당된 태그 및 KMS 키와 연결된 별칭을 기반으로 KMS 키에 대한 액세스를 제어할 수 있습니다. 정책 또는 권한 부여를 변경하지 않고 태그 및 별칭을 사용하여 KMS 키에 대한 액세스를 허용할 수 있습니다. 자세한 내용은 AWS KMS에 ABAC 사용 단원을 참조하세요.

별칭은 AWS 계정 및 리전에서 고유해야 하지만 이 조건을 사용하면 동일한 리전에 있는 여러 KMS 키(StringLike 비교 연산자 사용) 또는 각 계정의 다른 AWS 리전 에 있는 여러 KMS 키에 대한 액세스를 제어할 수 있습니다.

참고

kms:ResourceAliases 조건은 KMS 키가 KMS 키당 별칭 할당량을 준수하는 경우에만 유효합니다. KMS 키가 이 할당량을 초과하면 kms:ResourceAliases 조건에 따라 KMS 키를 사용할 권한이 있는 보안 주체는 KMS 키에 대한 액세스가 거부됩니다.

이 정책 조건에서 별칭을 지정하려면 별칭 이름(예: alias/project-alpha) 또는 별칭 이름 패턴(예: alias/*test*)을 사용합니다. 이 조건 키의 값에 별칭 ARN을 지정할 수 없습니다. 조건을 충족하려면 작업에 사용된 KMS 키에 지정된 별칭이 있어야 합니다. 작업 요청에서 KMS 키가 식별되는지 여부와 방법은 중요하지 않습니다.

KMS 키와 연결된 별칭 집합을 정책의 별칭 집합과 비교하는 다중값 조건 키입니다. 이러한 집합이 비교되는 방법을 확인하려면 정책 조건에서 ForAnyValue 또는 ForAllValues 연산자를 제공해야 합니다. 집합 연산자에 대한 자세한 내용은 IAM 사용 설명서의 여러 키 및 값 사용을 참조하세요.

  • ForAnyValue: KMS 키와 연결된 별칭이 하나 이상 정책 조건의 별칭과 일치해야 합니다. 다른 별칭은 허용됩니다. KMS 키에 별칭이 없으면 조건이 충족되지 않습니다.

  • ForAllValues: KMS 키와 연결된 모든 별칭은 정책의 별칭과 일치해야 합니다. 이 집합 연산자는 KMS 키와 연결된 별칭을 정책 조건의 별칭으로 제한합니다. 별칭은 필요하지 않지만 지정되지 않은 별칭을 금지합니다.

예를 들어 다음 IAM 정책 설명은 보안 주체가 finance-key 별칭과 연결된 지정된 AWS 계정 의 모든 KMS 키에 대해 GenerateDataKey 작업을 호출하도록 허용합니다. (영향을 받는 KMS 키의 키 정책도 보안 주체의 계정에서 이 작업에 사용할 수 있도록 허용해야 합니다.) KMS 키와 연결될 수 있는 여러 별칭 중 하나가alias/finance-key인 경우 조건이 충족되었음을 나타내기 위해 조건은 ForAnyValue 집합 연산자를 사용합니다.

kms:ResourceAliases 조건은 요청이 아닌 리소스를 기반으로하기 때문에 요청이 키 ID 또는 키 ARN을 사용하여 KMS 키를 식별하는 경우에도 finance-key 별칭과 연결된 KMS 키에 대해 GenerateDataKey 호출이 성공합니다.

{ "Sid": "AliasBasedIAMPolicy", "Effect": "Allow", "Action": "kms:GenerateDataKey", "Resource": [ "arn:aws:kms:*:111122223333:key/*", "arn:aws:kms:*:444455556666:key/*", ], "Condition": { "ForAnyValue:StringEquals": { "kms:ResourceAliases": "alias/finance-key" } } }

다음 예제 IAM 정책 설명은 보안 주체가 KMS 키를 활성화 및 비활성화하도록 허용하지만 KMS 키의 모든 별칭에 "Test"가 포함된 경우에만 가능합니다. 이 정책 설명은 두 가지 조건을 사용합니다. ForAllValues 집합 연산자가 있는 조건에서는 KMS 키와 연결된 모든 별칭에 "Test"가 포함되어야 합니다. ForAnyValue 집합 연산자가 있는 조건에서는 KMS 키에 "Test"라는 별칭이 하나 이상 있어야 합니다. ForAnyValue 조건이 없었다면 이 정책문은 보안 주체가 별칭이 없는 KMS 키를 사용하도록 허용했을 것입니다.

{ "Sid": "AliasBasedIAMPolicy", "Effect": "Allow", "Action": [ "kms:EnableKey", "kms:DisableKey" ], "Resource": "arn:aws:kms:*:111122223333:key/*", "Condition": [ { "ForAllValues:StringLike": { "kms:ResourceAliases": "alias/*Test*" } }, { "ForAnyValue:StringLike": { "kms:ResourceAliases": "alias/*Test*" } } ] }

kms:ReplicaRegion

AWS KMS 조건 키 조건 유형 API 작업 정책 유형

kms:ReplicaRegion

문자열(목록)

ReplicateKey

키 정책 및 IAM 정책

이 조건 키를 사용하여 보안 주체가 다중 리전 키를 복제할 수 있는 AWS 리전 을 제한할 수 있습니다. kms:ReplicaRegion 조건 키는 요청의 ReplicaRegion 파라미터 값을 기반으로 ReplicateKey 작업에 대한 액세스를 제어합니다. 이 파라미터는 새 복제본 키에 대한 AWS 리전 을 지정합니다.

조건의 값은 하나 이상의 AWS 리전 이름(예: us-east-1 또는 ap-southeast-2)이거나 이름 패턴(예: eu-*)입니다. AWS KMS가 지원하는 AWS 리전 이름 목록은 AWS 일반 참조서의 AWS Key Management Service 엔드포인트 및 할당량을 참조하세요.

예를 들어 다음 키 정책 문은 kms:ReplicaRegion조건 키를 사용하여 ReplicaRegion 파라미터의 값이 지정된 리전 중 하나인 경우에만 보안 주체가 ReplicateKey 작업을 호출하도록 허용합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/Administrator" }, "Action": "kms:ReplicateKey" "Resource": "*", "Condition": { "StringEquals": { "kms:ReplicaRegion": { "us-east-1", "eu-west-3", "ap-southeast-2" } } } }

이 조건 키는 ReplicateKey 작업에 대한 액세스만 제어합니다. UpdatePrimaryRegion 작업에 대한 액세스를 제어하려면kms:PrimaryRegion 조건 키를 사용합니다.

kms:RetiringPrincipal

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:RetiringPrincipal

문자열(목록)

단일 값

CreateGrant

키 정책 및 IAM 정책

이 조건 키를 사용하여 요청의 RetiringPrincipal 파라미터 값을 기반으로 CreateGrant 작업에 대한 액세스를 제어할 수 있습니다. 예를 들면 CreateGrant 요청의 RetiringPrincipal이 조건문의 RetiringPrincipal과 일치할 때만 사용자에게 KMS 키 사용 권한을 생성하도록 허용할 수 있습니다.

다음 예제 키 정책문은 사용자가 KMS 키에 대한 권한을 생성하도록 허용합니다. kms:RetiringPrincipal 조건 키는 권한 사용 중지 중인 보안 주체가 LimitedAdminRole 또는 OpsAdmin 사용자인 CreateGrant 요청으로 권한을 제한합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": "kms:CreateGrant", "Resource": "*", "Condition": { "StringEquals": { "kms:RetiringPrincipal": [ "arn:aws:iam::111122223333:role/LimitedAdminRole", "arn:aws:iam::111122223333:user/OpsAdmin" ] } } }

다음 사항도 참조하세요.

kms:SigningAlgorithm

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:SigningAlgorithm

문자열

단일 값

Sign

Verify

키 정책 및 IAM 정책

kms:SigningAlgorithm 조건 키를 사용해 요청의 SigningAlgorithm 파라미터 값을 기반으로 서명확인 작업에 대한 액세스를 제어합니다. 이 조건 키는 AWS KMS 외부에서 비대칭 KMS 키 페어의 퍼블릭 키를 사용하여 서명을 확인하는 경우와 같이 AWS KMS 외부에서 수행되는 작업에는 영향을 주지 않습니다.

다음 예제 키 정책은 요청에 사용된 서명 알고리즘이 RSASSA_PSS_SHA512 같은 RSASSA_PSS 알고리즘인 경우에만 testers 역할을 수임할 수 있는 사용자가 KMS 키를 사용하여 메시지에 서명하도록 허용합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:role/testers" }, "Action": "kms:Sign", "Resource": "*", "Condition": { "StringLike": { "kms:SigningAlgorithm": "RSASSA_PSS*" } } }

다음 사항도 참조하세요.

kms:ValidTo

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:ValidTo

타임스탬프

단일 값

ImportKeyMaterial

키 정책 및 IAM 정책

kms:ValidTo 조건 키는 가져온 키 자료가 만료되는 시기를 결정하는 요청의 ValidTo 파라미터 값을 기반으로 ImportKeyMaterial 작업에 대한 액세스를 제어합니다. 이 값은 Unix 시간으로 표현됩니다.

기본적으로 ValidTo 파라미터는 ImportKeyMaterial 요청에서 필요합니다. 하지만 ExpirationModel 파라미터의 값이 KEY_MATERIAL_DOES_NOT_EXPIRE이면 ValidTo 파라미터가 유효하지 않습니다. 또한 kms:ExpirationModel 조건 키를 사용하여 ExpirationModel 파라미터 또는 특정 파라미터 값을 요구할 수도 있습니다.

다음 예제 정책 문을 사용하면 키 재료를 KMS 키로 가져올 수 있습니다. kms:ValidTo 조건 키는 ImportKeyMaterial 값이 ValidTo (2018년 12월 31일 11:59:59 PM)보다 작거나 같은 1546257599.0 요청에 대한 권한을 제한합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": "kms:ImportKeyMaterial", "Resource": "*", "Condition": { "NumericLessThanEquals": { "kms:ValidTo": "1546257599.0" } } }

다음 사항도 참조하세요.

kms:ViaService

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:ViaService

문자열

단일 값

KMS 키 리소스 작업

키 정책 및 IAM 정책

kms:ViaService 조건 키는 AWS KMS AWS KMS key(KMS 키)의 사용을 지정된 AWS 서비스로부터의 요청으로 제한합니다. 각 kms:ViaService 조건 키에 하나 이상의 서비스를 지정할 수 있습니다. 작업은 특정 KMS 키에 대해 권한이 부여된 KMS 키 리소스 작업이어야 합니다. KMS 키 리소스 작업을 식별하려면 작업 및 리소스 테이블에서, 해당 작업에 대해 Resources 열에서 KMS key 값을 찾습니다.

예를 들어 다음 키 정책 설명은 kms:ViaService 조건 키를 사용하여 ExampleUser를 대신하여 미국 서부(오레곤) 리전의 Amazon EC2 또는 Amazon RDS에서 요청이 오는 경우에만 고객 관리형 키를 지정된 작업에 사용할 수 있도록 허용합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": [ "kms:Encrypt", "kms:Decrypt", "kms:ReEncrypt*", "kms:GenerateDataKey*", "kms:CreateGrant", "kms:ListGrants", "kms:DescribeKey" ], "Resource": "*", "Condition": { "StringEquals": { "kms:ViaService": [ "ec2.us-west-2.amazonaws.com", "rds.us-west-2.amazonaws.com" ] } } }

또한 kms:ViaService 조건 키를 사용하여 요청이 특정 서비스에서 이루어지는 경우 KMS 키를 사용할 권한을 거부할 수도 있습니다. 예를 들어 키 정책에서 다음 정책 문은 kms:ViaService 조건 키를 사용하여 요청이 AWS Lambda에서 ExampleUser 대신 이루어지는 경우 고객 관리형 키를 Encrypt 작업에 대해 사용하는 것을 금지합니다.

{ "Effect": "Deny", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": [ "kms:Encrypt" ], "Resource": "*", "Condition": { "StringEquals": { "kms:ViaService": [ "lambda.us-west-2.amazonaws.com" ] } } }
중요

kms:ViaService 조건 키를 사용할 경우 서비스가 AWS 계정 의 보안 주체 대신 요청을 생성합니다. 이러한 보안 주체는 다음 권한을 가져야 합니다.

  • KMS 키를 사용할 수 있는 권한입니다. 보안 주체는 서비스가 보안 주체 대신 고객 관리형 키를 사용할 수 있도록 이러한 권한을 통합 서비스에 부여해야 합니다. 자세한 정보는 AWS 서비스의 AWS KMS 활용 방식 단원을 참조하세요.

  • 통합 서비스 사용 권한. 사용자에게 AWS와 통합된 AWS KMS 서비스에 액세스할 수 있는 권한을 부여하는 방법에 대한 세부 정보는 통합 서비스의 설명서를 참조하십시오.

모든 AWS 관리형 키 는 키 정책 문서에서 kms:ViaService 조건 키를 사용합니다. 이 조건은 KMS 키가 생성된 서비스에서 이루어지는 요청에만 KMS 키를 사용하도록 허용합니다. AWS 관리형 키 에 대한 키 정책을 보려면 GetKeyPolicy 작업을 사용합니다.

kms:ViaService 조건 키는 IAM 및 키 정책 설명에서 유효합니다. 사용자가 지정한 서비스가 AWS KMS와 통합되고 kms:ViaService 조건 키를 지원해야 합니다.

kms:ViaService 조건 키를 지원하는 서비스

다음 표에는 AWS KMS와 통합되고 고객 관리 키에서 kms:ViaService 조건 키 사용을 지원하는 AWS 서비스가 나열되어 있습니다. 이 표의 서비스는 일부 지역에서 사용하지 못할 수도 있습니다. 모든 AWS 파티션에서 AWS KMS ViaService 이름의 .amazonaws.com 접미사를 사용합니다.

참고

이 테이블의 모든 데이터를 보려면 가로 또는 세로로 스크롤해야 할 수도 있습니다.

서비스 이름 AWS KMS ViaService 이름
AWS App Runner apprunner.AWS_region.amazonaws.com
Amazon AppFlow appflow.AWS_region.amazonaws.com
Amazon Application Migration 서비스 mgn.AWS_region.amazonaws.com
Amazon Athena athena.AWS_region.amazonaws.com
AWS Audit Manager auditmanager.AWS_region.amazonaws.com
Amazon Aurora rds.AWS_region.amazonaws.com
AWS Backup backup.AWS_region.amazonaws.com
AWS CodeArtifact codeartifact.AWS_region.amazonaws.com
Amazon CodeGuru Reviewer codeguru-reviewer.AWS_region.amazonaws.com
Amazon Comprehend comprehend.AWS_region.amazonaws.com
Amazon Connect connect.AWS_region.amazonaws.com
AWS Database Migration Service (AWS DMS) dms.AWS_region.amazonaws.com
AWS Directory Service directoryservice.AWS_region.amazonaws.com
Amazon DynamoDB dynamodb.AWS_region.amazonaws.com
Amazon EC2 Systems Manager(SSM) ssm.AWS_region.amazonaws.com
Amazon Elastic Block Store(Amazon EBS) ec2.AWS_region.amazonaws.com (EBS only)
Amazon Elastic Container Registry (Amazon ECR) ecr.AWS_region.amazonaws.com
Amazon Elastic File System (Amazon EFS) elasticfilesystem.AWS_region.amazonaws.com
Amazon Elastic Kubernetes Service (Amazon EKS) eks.AWS_region.amazonaws.com
Amazon ElastiCache

조건 키 값에 ViaService 이름을 모두 포함합니다.

  • elasticache.AWS_region.amazonaws.com

  • dax.AWS_region.amazonaws.com

Amazon OpenSearch Service(OpenSearch Service) es.AWS_region.amazonaws.com
AWS Elemental MediaTailor mediatailor.AWS_region.amazonaws.com
Amazon FinSpace finspace.AWS_region.amazonaws.com
Amazon Forecast forecast.AWS_region.amazonaws.com
Amazon FSx fsx.AWS_region.amazonaws.com
AWS Glue glue.AWS_region.amazonaws.com
Amazon HealthLake healthlake.AWS_region.amazonaws.com
AWS IoT SiteWise iotsitewise.AWS_region.amazonaws.com
Amazon Kendra kendra.AWS_region.amazonaws.com
Amazon Kinesis kinesis.AWS_region.amazonaws.com
Amazon Kinesis Data Firehose firehose.AWS_region.amazonaws.com
Amazon Kinesis Video Streams kinesisvideo.AWS_region.amazonaws.com
AWS Lambda lambda.AWS_region.amazonaws.com
Amazon Lex lex.AWS_region.amazonaws.com
AWS License Manager license-manager.AWS_region.amazonaws.com
Amazon Lookout for Equipment lookoutequipment.AWS_region.amazonaws.com
Amazon Lookout for Metrics lookoutmetrics.AWS_region.amazonaws.com
Amazon Lookout for Vision lookoutvision.AWS_region.amazonaws.com
Amazon Managed Blockchain managedblockchain.AWS_region.amazonaws.com
Amazon Managed Streaming for Apache Kafka(Amazon MSK) kafka.AWS_region.amazonaws.com
Amazon Managed Workflows for Apache Airflow(MWAA) airflow.AWS_region.amazonaws.com
Amazon Monitron monitron.AWS_region.amazonaws.com
Amazon MQ mq.AWS_region.amazonaws.com
Amazon Neptune rds.AWS_region.amazonaws.com
Amazon Nimble Studio nimble.AWS_region.amazonaws.com
AWS Proton proton.AWS_region.amazonaws.com
Amazon Quantum Ledger Database(Amazon QLDB) qldb.AWS_region.amazonaws.com
Amazon RDS 성능 개선 도우미 rds.AWS_region.amazonaws.com
Amazon Redshift redshift.AWS_region.amazonaws.com
Amazon Rekognition rekognition.AWS_region.amazonaws.com
Amazon Relational Database Service (Amazon RDS) rds.AWS_region.amazonaws.com
AWS Secrets Manager secretsmanager.AWS_region.amazonaws.com
Amazon Simple Email Service(Amazon SES) ses.AWS_region.amazonaws.com
Amazon Simple Notification Service (Amazon SNS) sns.AWS_region.amazonaws.com
Amazon Simple Queue Service(Amazon SQS) sqs.AWS_region.amazonaws.com
Amazon Simple Storage Service (Amazon S3) s3.AWS_region.amazonaws.com
AWS Snowball importexport.AWS_region.amazonaws.com
AWS Storage Gateway storagegateway.AWS_region.amazonaws.com
AWS Systems Manager Incident Manager ssm-incidents.AWS_region.amazonaws.com
AWS Systems Manager Incident Manager 연락처 ssm-contacts.AWS_region.amazonaws.com
Amazon Timestream timestream.AWS_region.amazonaws.com
Amazon WorkMail workmail.AWS_region.amazonaws.com
Amazon WorkSpaces workspaces.AWS_region.amazonaws.com
AWS X-Ray xray.AWS_region.amazonaws.com

kms:WrappingAlgorithm

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:WrappingAlgorithm

문자열

단일 값

GetParametersForImport

키 정책 및 IAM 정책

이 조건 키는 요청의 WrappingAlgorithm 파라미터 값에 따라 GetParametersForImport 작업에 대한 액세스를 제어합니다. 이 조건을 사용하여 보안 주체가 가져오기 프로세스 중에 특정 알고리즘을 사용하여 키 자료를 암호화하도록 요구할 수 있습니다. 다른 래핑 알고리즘을 지정하면 필수 퍼블릭 키 및 가져오기 토큰에 대한 요청이 실패합니다.

다음 예제 키 정책문에서는 kms:WrappingAlgorithm 조건 키를 사용하여 GetParametersForImport 작업을 호출할 수 있는 사용자 권한을 부여하지만, RSAES_OAEP_SHA_1 래핑 알고리즘을 사용하지 못하도록 합니다. WrappingAlgorithm 요청의 GetParametersForImportRSAES_OAEP_SHA_1이면 작업이 실패합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": "kms:GetParametersForImport", "Resource": "*", "Condition": { "StringNotEquals": { "kms:WrappingAlgorithm": "RSAES_OAEP_SHA_1" } } }

다음 사항도 참조하세요.

kms:WrappingKeySpec

AWS KMS 조건 키 조건 유형 값 유형 API 작업 정책 유형

kms:WrappingKeySpec

문자열

단일 값

GetParametersForImport

키 정책 및 IAM 정책

이 조건 키는 요청의 WrappingKeySpec 파라미터 값에 따라 GetParametersForImport 작업에 대한 액세스를 제어합니다. 가져 오기 프로세스 중에 공개 키의 특정 유형을 사용하는 사용자를 요구하는 이 조건을 사용할 수 있습니다. 요청에서 다른 키 유형을 지정하면 실패합니다.

WrappingKeySpec 파라미터 값에 사용할 수 있는 값은 RSA_2048뿐이므로 실제로 사용자에게 이 값을 실제로 사용하지 못하도록 할 경우 사용자가 GetParametersForImport 작업을 사용할 수 없게 됩니다.

다음 예제 정책 설명은 kms:WrappingAlgorithm 조건 키를 사용하여 요청의 WrappingKeySpecRSA_2048이 되도록 요구합니다.

{ "Effect": "Allow", "Principal": { "AWS": "arn:aws:iam::111122223333:user/ExampleUser" }, "Action": "kms:GetParametersForImport", "Resource": "*", "Condition": { "StringEquals": { "kms:WrappingKeySpec": "RSA_2048" } } }

다음 사항도 참조하세요.

AWS Nitro Enclaves에 대한 AWS KMS 조건 키

AWS Nitro Enclaves는 Amazon EC2 기능으로, 엔클레이브라는 격리된 컴퓨팅 환경을 생성해 매우 민감한 데이터를 보호하고 처리할 수 있습니다. AWS KMS는 AWS Nitro Enclaves를 지원하는 조건 키를 제공합니다. 이러한 조건 키는 AWS KMS 작업에 대한 요청이 엔클레이브에서 시작된 경우에만 작동합니다.

엔클레이브에서 kms-decrypt, kms-generate-data-key 또는 kms-generate-random AWS Nitro Enclaves SDK API를 호출하면 이러한 API는 엔클레이브의 서명된 증명 문서를 포함하는 파라미터를 사용하여 해당 AWS KMS 작업을 호출합니다. 서명된 증명 문서는 AWS KMS에 대한 엔클레이브의 신원을 증명합니다.

다음 조건 키를 사용하면 서명된 증명 문서의 내용에 따라 이러한 작업에 대한 사용 권한을 제한할 수 있습니다. 작업을 허용하기 전에 AWS KMS는 엔클레이브의 증명 문서를 이러한 AWS KMS 조건 키의 값과 비교합니다.

kms:RecipientAttestation:ImageSha384

AWS KMS 조건 키 조건 유형 값 유형 API 연산 정책 유형

kms:RecipientAttestation:ImageSha384

문자열

단일 값

Decrypt

GenerateDataKey

GenerateRandom

키 정책 및 IAM 정책

kms:RecipientAttestation:ImageSha384 조건 키는 요청의 서명된 증명 문서의 이미지 해시가 조건 키의 값과 일치하는 경우에만 엔클레이브의 kms-decrypt, kms-generate-data-keykms-generate-random 요청을 허용합니다. ImageSha384 값은 증명 문서의 PCR[0]에 해당합니다. 이 조건 키는 엔클라이브에서 AWS Nitro Enclaves SDK API를 호출할 때만 유효합니다.

예를 들어 다음 키 정책문은 data-processing 역할이 kms-decrypt(Decrypt), kms-generate-data-key(GenerateDataKey) 및 kms-generate-random(GenerateRandom) 작업에 KMS 키를 사용하도록 허용합니다. kms:RecipientAttestation:ImageSha384 조건 키는 요청에 있는 증명 문서의 이미지 해시 값(PCR[0])이 조건의 이미지 해시 값과 일치하는 경우에만 작업을 허용합니다.

요청에 증명 문서가 포함되어 있지 않으면 이 조건이 충족되지 않으므로 사용 권한이 거부됩니다.

{ "Sid" : "Enable enclave data processing", "Effect" : "Allow", "Principal" : { "AWS" : "arn:aws:iam::111122223333:role/data-processing" }, "Action": [ "kms:Decrypt", "kms:GenerateDataKey", "kms:GenerateRandom" ], "Resource" : "*", "Condition": { "StringEqualsIgnoreCase": { "kms:RecipientAttestation:ImageSha384": "9fedcba8abcdef7abcdef6abcdef5abcdef4abcdef3abcdef2abcdef1abcdef1abcdef0abcdef1abcdef2abcdef3abcdef4abcdef5abcdef6abcdef7abcdef99" } } }

kms:RecipientAttestation:PCR<PCR_ID>

AWS KMS 조건 키 조건 유형 값 유형 API 연산 정책 유형

kms:RecipientAttestation:PCR

문자열

단일 값

Decrypt

GenerateDataKey

GenerateRandom

키 정책 및 IAM 정책

kms:RecipientAttestation:PCR<PCR_ID> 조건 키는 요청의 서명된 증명 문서의 플랫폼 구성 레지스터(PCR)가 조건 키의 PCR과 일치하는 경우에만 엔클레이브의 kms-decrypt, kms-generate-data-keykms-generate-random 요청을 허용합니다. 이 조건 키는 엔클라이브에서 AWS Nitro Enclaves SDK API를 호출할 때만 유효합니다.

PCR 값을 지정하려면 다음 형식을 사용합니다. PCR ID를 조건 키 이름에 연결합니다. PCR 값은 최대 96바이트의 소문자 16진수 문자열이어야 합니다.

"kms:RecipientAttestation:PCRPCR_ID": "PCR_value"

예를 들어, 다음 조건 키는 PCR[1]의 특정 값을 지정합니다. 이 값은 엔클레이브 및 부트스트랩 프로세스에 사용되는 커널의 해시에 해당합니다.

kms:RecipientAttestation:PCR1: "0x1abcdef2abcdef3abcdef4abcdef5abcdef6abcdef7abcdef8abcdef9abcdef8abcdef7abcdef6abcdef5abcdef4abcdef3abcdef2abcdef1abcdef0abcde"

다음 예제 키 정책문은 data-processing 역할이 kms-decrypt(Decrypt) 작업에 KMS 키를 사용하도록 허용합니다.

이 명령문의 kms:RecipientAttestation:PCR 조건 키는 요청의 서명된 증명 문서의 PCR1 값이 조건의 kms:RecipientAttestation:PCR1 값과 일치하는 경우에만 작업을 허용합니다. StringEqualsIgnoreCase 정책 연산자를 사용하여 PCR 값의 대소문자를 구분하지 않는 비교를 요구합니다.

요청에 증명 문서가 포함되어 있지 않으면 이 조건이 충족되지 않으므로 사용 권한이 거부됩니다.

{ "Sid" : "Enable enclave data processing", "Effect" : "Allow", "Principal" : { "AWS" : "arn:aws:iam::111122223333:role/data-processing" }, "Action": "kms:Decrypt", "Resource" : "*", "Condition": { "StringEqualsIgnoreCase": { "kms:RecipientAttestation:PCR1": "0x1de4f2dcf774f6e3b679f62e5f120065b2e408dcea327bd1c9dddaea6664e7af7935581474844767453082c6f1586116376cede396a30a39a611b9aad7966c87" } } }