자체 Amazon S3 버킷 사용

기본적으로 AWS 변환은 서비스 관리형 Amazon S3 버킷을 사용하여 변환 아티팩트를 저장합니다. 데이터 스토리지, 암호화 및 액세스 정책을 더 잘 제어하기 위해 대신 자체 Amazon S3 버킷을 사용하도록 선택할 수 있습니다.

사전 조건

자체 Amazon S3 버킷을 구성하기 전에 다음 요구 사항을 충족하는지 확인합니다.

지원되는 암호화 구성

버킷은 다음 암호화 구성 중 하나를 사용해야 합니다.

다음은 지원하지 않습니다.

Amazon S3 버킷 구성

AWS 변환 콘솔에서 자체 Amazon S3 버킷을 사용하도록 AWS 변환을 구성할 수 있습니다.

구성을 저장한 후 AWS 변환은 버킷을 사용하여 변환 아티팩트를 저장합니다.

필수 버킷 정책

AWS 변환 액세스 권한을 부여하도록 버킷 정책을 구성해야 합니다. AWS 변환 서비스 보안 주체가 변환 아티팩트를 읽고, 쓰고, 삭제하고, 나열할 수 있도록 Amazon S3 버킷에 다음 버킷 정책을 추가합니다.

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "transform.amazonaws.com"
                ]
            },
            "Action": [
                "s3:GetObject",
                "s3:PutObject",
                "s3:DeleteObject",
                "s3:AbortMultipartUpload",
                "s3:ListMultipartUploadParts",
                "s3:PutObjectTagging"
            ],
            "Resource": "arn:aws:s3:::bucket-name/AWSTransform/*",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "profile-account-id",
                    "aws:SourceArn": "profile-arn"
                }
            }
        },
        {
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "transform.amazonaws.com"
                ]
            },
            "Action": "s3:ListBucket",
            "Resource": "arn:aws:s3:::bucket-name",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "profile-account-id",
                    "aws:SourceArn": "profile-arn"
                }
            }
        }
    ]
}

다음 값을 교체합니다.

필수 CORS 구성

웹 애플리케이션 AWS 변환을 사용하는 경우 Amazon S3 버킷에서 CORS(Cross-Origin Resource Sharing)를 구성해야 합니다. AWS 변환을 활성화한 후 웹 애플리케이션 도메인을 찾을 수 있습니다. 자세한 내용은 AWS 변환 시작하기 단원을 참조하십시오.

[
    {
        "AllowedHeaders": [
            "host",
            "content-type",
            "if-none-match",
            "x-amz-checksum-sha256",
            "x-amz-expected-bucket-owner",
            "x-amz-server-side-encryption",
            "x-amz-server-side-encryption-aws-kms-key-id",
            "x-amz-server-side-encryption-context",
            "x-amz-source-account",
            "x-amz-source-arn"
        ],
        "AllowedMethods": [
            "GET",
            "PUT",
            "HEAD"
        ],
        "AllowedOrigins": [
            "webapp-domain"
        ],
        "ExposeHeaders": [
            "ETag",
            "x-amz-checksum-sha256",
            "x-amz-request-id",
            "x-amz-id-2"
        ],
        "MaxAgeSeconds": 3600
    }
]

다음 값을 교체합니다.

KMS 키 정책(선택 사항)

이 섹션은 버킷이 고객 관리형 KMS 키로 암호화된 경우에만 적용됩니다. 버킷에서 SSE-S3를 사용하는 경우이 섹션을 건너뜁니다.

버킷 암호화를 위해 자체 AWS KMS 키를 지정하는 경우 키 정책에 다음 문을 추가합니다. AWS 변환은 전달 액세스 세션(FAS)을 사용하여 서비스 보안 주체에 대한 권한 부여를 생성합니다. 이러한 권한 부여는 Amazon S3 버킷의 키 및 액세스 아티팩트를 검증하는 데 사용됩니다.

{
    "Sid": "AllowAWSTransformServiceAccess",
    "Effect": "Allow",
    "Principal": {
        "AWS": "arn:aws:iam::key-owner-account-id:root"
    },
    "Action": [
        "kms:CreateGrant",
        "kms:DescribeKey"
    ],
    "Resource": "*",
    "Condition": {
        "StringEquals": {
            "kms:ViaService": "transform.region.amazonaws.com"
        }
    }
}

다음 값을 교체합니다.

기본 버킷으로 다시 전환

언제든지 서비스 관리형 버킷으로 다시 전환할 수 있습니다.

버킷에 직접 파일 업로드

AWS 변환 웹 애플리케이션을 사용하지 않고도 Amazon S3 버킷에 직접 파일을 업로드할 수 있습니다. 업로드된 파일을 변환 에이전트가 사용할 수 있도록 하려면 해당 파일을 작업의 User Uploads 폴더에 업로드합니다. 이 폴더의 디렉터리 경로는 다음 형식을 사용합니다.

AWSTransform/Workspaces/workspace-id/Jobs/job-id/User Uploads/

다음 값을 교체합니다.

AWS 변환의 각 작업에는 고유한 User Uploads 폴더가 있습니다. 이 경로에 업로드하는 파일은 웹 애플리케이션에 표시되며, 변환 에이전트가 작업을 완료하는 동안 사용할 수 있습니다.

파일 경로에는 .., //또는 선행 또는 후행 공백이 포함되어서는 안 됩니다. 이러한 제약 조건을 위반하는 파일은 에이전트에게 표시되지 않습니다.

x-amz-server-side-encryption: aws:kms
x-amz-server-side-encryption-aws-kms-key-id: your-kms-key-arn

호환성 매트릭스

다음 표에는 AWS 변환과 일반적인 Amazon S3 버킷 기능의 호환성이 요약되어 있습니다.