Amazon Simple Storage Service
개발자 안내서 (API 버전 2006-03-01)

예제 4: 암호화된 객체 복제

기본적으로 Amazon S3는 AWS KMS 관리형 키를 사용하는 서버 측 암호화를 사용하여 저장된 객체를 복제하지 않습니다. 암호화된 객체를 복제하려면 버킷 복제 구성을 수정하여 Amazon S3에 이러한 객체를 복제하도록 지시해야 합니다. 이 예제에서는 Amazon S3 콘솔 및 AWS Command Line Interface(AWS CLI)를 사용해 암호화된 객체 복제를 활성화하도록 버킷 복제 구성을 변경하는 방법을 설명합니다. 자세한 내용은 CRR 추가 구성: AWS KMS 관리형 암호화 키를 사용하는 서버 측 암호화(SSE)로 생성된 객체 복제 단원을 참조하십시오.

항목

    암호화된 객체 복제(콘솔)

    단계별 지침은 Amazon Simple Storage Service 콘솔 사용 설명서S3 버킷에 교차 리전 복제(CRR) 규칙을 추가하려면? 단원을 참조하십시오. 이 주제에서는 버킷을 동일한 AWS 계정이 소유한 경우와 서로 다른 AWS 계정이 소유한 경우에 복제 구성을 설정하는 지침을 제공합니다.

    암호화된 객체 복제(AWS CLI)

    AWS CLI를 사용하여 암호화된 객체를 복제하려면 버킷을 생성하고, 버킷에서 버전 관리를 활성화하고, Amazon S3에 객체를 복제할 권한을 부여하는 IAM 역할을 생성하고, 복제 구성을 원본 버킷에 추가합니다. 복제 구성이 KMS 키를 사용하여 암호화된 객체를 복제하는 데 관련된 정보를 제공합니다. IAM 역할 권한은 암호화된 객체를 복제하는 데 필요한 권한을 포함합니다. 또한 다음 설정을 테스트합니다.

    암호화된 객체를 복제하려면(AWS CLI)

    1. 이 예제에서는 동일한 AWS 계정에서 원본 버킷과 대상 버킷을 모두 생성합니다. AWS CLI 자격 증명 프로필을 설정합니다. 이 예제에서는 프로필 이름 acctA를 사용합니다. 자격 증명 프로필 설정에 대한 자세한 내용은 AWS Command Line Interface 사용 설명서의 명명된 프로필 단원을 참조하십시오.

    2. 원본 버킷을 생성하고 버킷에서 버전 관리를 활성화합니다. 이 예제에서는 원본 버킷을 미국 동부(버지니아 북부)(us-east-1) 리전에서 생성합니다.

      aws s3api create-bucket \ --bucket source \ --region us-east-1 \ --profile acctA
      aws s3api put-bucket-versioning \ --bucket source \ --versioning-configuration Status=Enabled \ --profile acctA
    3. 대상 버킷을 생성하고 버킷에서 버전 관리를 활성화합니다. 이 예제에서는 대상 버킷을 미국 서부(오레곤)(us-west-2) 리전에서 생성합니다.

      참고

      원본 버킷과 대상 버킷이 모두 동일한 AWS 계정에 있을 때 복제 구성을 설정하려면 동일한 프로필을 사용합니다. 이 예제에서는 [acctA]을 사용합니다. 두 버킷을 서로 다른 AWS 계정에서 소유한 경우의 복제 구성을 테스트하려면 각각 다른 프로필을 지정합니다. 이 예제에서는 대상 버킷에 대한 acctB 프로필을 사용합니다.

      aws s3api create-bucket \ --bucket destination \ --region us-west-2 \ --create-bucket-configuration LocationConstraint=us-west-2 \ --profile acctA
      aws s3api put-bucket-versioning \ --bucket destination \ --versioning-configuration Status=Enabled \ --profile acctA
    4. IAM 역할을 생성합니다. 나중에 원본 버킷에 추가하는 복제 구성에서 이 역할을 지정합니다. Amazon S3가 사용자 대신 객체를 복제하기 위해 이 역할을 맡습니다. IAM 역할을 두 단계로 생성합니다.

      • 역할 생성

      • 역할에 권한 정책 연결

      1. IAM 역할 생성.

        1. 다음 신뢰 정책을 복사하여 로컬 컴퓨터의 현재 디렉터리에 s3-role-trust-policy-kmsobj.json 파일로 저장합니다. 이 정책은 Amazon S3가 사용자 대신 작업을 수행할 수 있도록 Amazon S3 서비스 보안 주체에 역할을 맡을 권한을 부여합니다.

          { "Version":"2012-10-17", "Statement":[ { "Effect":"Allow", "Principal":{ "Service":"s3.amazonaws.com" }, "Action":"sts:AssumeRole" } ] }
        2. 역할을 생성합니다.

          $ aws iam create-role \ --role-name crrRolekmsobj \ --assume-role-policy-document file://s3-role-trust-policy-kmsobj.json \ --profile acctA
      2. 역할에 권한 정책을 연결합니다. 이 정책은 다양한 Amazon S3 버킷 및 객체 작업에 대한 권한을 부여합니다.

        1. 다음 권한 정책을 복사하여 로컬 컴퓨터의 현재 디렉터리에 s3-role-permissions-policykmsobj.json 파일로 저장합니다. IAM 역할을 생성하여 나중에 정책을 여기에 연결합니다.

          { "Version":"2012-10-17", "Statement":[ { "Action":[ "s3:ListBucket", "s3:GetReplicationConfiguration", "s3:GetObjectVersionForReplication", "s3:GetObjectVersionAcl" ], "Effect":"Allow", "Resource":[ "arn:aws:s3:::source", "arn:aws:s3:::source/*" ] }, { "Action":[ "s3:ReplicateObject", "s3:ReplicateDelete", "s3:ReplicateTags", "s3:GetObjectVersionTagging" ], "Effect":"Allow", "Condition":{ "StringLikeIfExists":{ "s3:x-amz-server-side-encryption":[ "aws:kms", "AES256" ], "s3:x-amz-server-side-encryption-aws-kms-key-id":[ "AWS KMS key IDs to use for encrypting object replicas" ] } }, "Resource":"arn:aws:s3:::destination/*" }, { "Action":[ "kms:Decrypt" ], "Effect":"Allow", "Condition":{ "StringLike":{ "kms:ViaService":"s3.us-east-1.amazonaws.com", "kms:EncryptionContext:aws:s3:arn":[ "arn:aws:s3:::source/*" ] } }, "Resource":[ "AWS KMS key IDs used to encrypt source objects." ] }, { "Action":[ "kms:Encrypt" ], "Effect":"Allow", "Condition":{ "StringLike":{ "kms:ViaService":"s3.us-west-2.amazonaws.com", "kms:EncryptionContext:aws:s3:arn":[ "arn:aws:s3:::destination/*" ] } }, "Resource":[ "AWS KMS key IDs to use for encrypting object replicas" ] } ] }
        2. 정책을 생성하여 역할에 연결합니다.

          $ aws iam put-role-policy \ --role-name crrRolekmsobj \ --policy-document file://s3-role-permissions-policykmsobj.json \ --policy-name crrRolechangeownerPolicy \ --profile acctA
    5. 다음 복제 구성을 원본 버킷에 추가합니다. 이 구성은 Amazon S3에 Tax/ 접두사가 있는 객체를 대상 버킷으로 복제하도록 지시합니다.

      중요

      복제 구성에서 Amazon S3가 맡을 수 있는 IAM 역할을 지정할 수 있습니다. iam:PassRole 권한이 있을 경우 이 권한만 사용할 수 있습니다. CLI 명령에서 지정한 프로필에 권한이 있어야 합니다. 자세한 내용은 IAM 사용 설명서사용자에게 AWS 서비스에 역할을 전달할 수 있는 권한 부여 단원을 참조하십시오.

      <ReplicationConfiguration> <Role>IAM-Role-ARN</Role> <Rule> <Status>Enabled</Status> <Priority>1</Priority> <DeleteMarkerReplication> <Status>Disabled</Status> </DeleteMarkerReplication> <Filter> <Prefix>Tax</Prefix> </Filter> <Status>Enabled</Status> <SourceSelectionCriteria> <SseKmsEncryptedObjects> <Status>Enabled</Status> </SseKmsEncryptedObjects> </SourceSelectionCriteria> <Destination> <Bucket>arn:aws:s3:::dest-bucket-name</Bucket> <EncryptionConfiguration> <ReplicaKmsKeyID>AWS KMS key IDs to use for encrypting object replicas</ReplicaKmsKeyID> </EncryptionConfiguration> </Destination> </Rule> </ReplicationConfiguration>

      원본 버킷에 복제 구성을 추가하려면 다음을 수행합니다.

      1. AWS CLI를 사용하려면 복제 구성을 JSON으로 지정해야 합니다. 다음 JSON을 로컬 컴퓨터의 현재 디렉터리에 파일(replication.json)로 저장합니다.

        { "Role":"IAM-Role-ARN", "Rules":[ { "Status":"Enabled", "Priority":"1", "DeleteMarkerReplication":{ "Status":"Disabled" }, "Filter":{ "Prefix":"Tax" }, "Destination":{ "Bucket":"arn:aws:s3:::destination", "EncryptionConfiguration":{ "ReplicaKmsKeyID":"AWS KMS key IDs to use for encrypting object replicas" } }, "SourceSelectionCriteria":{ "SseKmsEncryptedObjects":{ "Status":"Enabled" } }, "Status":"Enabled" } ] }
      2. JSON을 편집하여 대상 버킷 및 IAM-role-ARN에 값을 입력합니다. 변경 사항을 저장합니다.

      3. 원본 버킷에 복제 구성을 추가합니다. 반드시 원본 버킷 이름을 제공해야 합니다.

        $ aws s3api put-bucket-replication \ --replication-configuration file://replicationkmsobj.json \ --bucket source \ --profile acctA
    6. 설정을 테스트하여 암호화된 객체가 복제되는지 확인합니다. Amazon S3 콘솔에서

      1. AWS Management Console에 로그인하고 https://console.aws.amazon.com/s3/에서 Amazon S3 콘솔을 엽니다.

      2. 원본 버킷에서 Tax 폴더를 생성합니다.

      3. 폴더에 샘플 객체를 추가합니다. 반드시 암호화 옵션을 선택하고 객체를 암호화할 KMS 키를 지정해야 합니다.

      4. 대상 버킷에 객체 복제본이 저장되었는지, 해당 복제본이 복제 구성에 지정된 KMS 암호화 키를 사용하여 암호화되었는지 확인합니다.

    암호화된 객체 복제(AWS SDK)

    복제 구성을 추가하는 코드 예제는 원본 버킷과 대상 버킷을 동일한 AWS 계정에서 소유한 경우 CRR 구성(AWS SDK) 단원을 참조하십시오. 복제 구성을 적절히 수정해야 합니다. 개념적 정보는 CRR 추가 구성: AWS KMS 관리형 암호화 키를 사용하는 서버 측 암호화(SSE)로 생성된 객체 복제 단원을 참조하십시오.