• 목차

개요

• 미리 서명된 URL을 생성하려면 먼저 IAM 사용자 자격 증명(액세스 키 및 비밀 키)을 사용 중인 Amazon S3 SDK 에 지정해야 한다.
• 자격 증명을 SDK 에 지정하고 사용자가 직접 객체를 업로드 할 수 있도록 미리 서명된 URL 을 생성해보자.

pre-signed URL

• Amazon S3 Bucket 에 액세스할 수 있는 권한을 가진 URL
• **사용자(고객)가 자격 또는 권한 없이 객체를 공유(GET) 하거나 업로드(PUT)**하도록 할 수 있다.
• 미리 서명된 URL은 사용자(고객)이/가 객체를 버킷에 업로드할 수 있도록 하고 싶지만 AWS 보안 자격 증명이나 권한이 필요하지 않은 경우에 유용하다.
• 미리 서명된 URL은 만료 날짜 및 시간까지 여러 번 사용할 수 있다.
• URL을 사용하여 객체를 업로드하면 Amazon S3가 지정된 버킷에 객체를 생성한다.
• 미리 서명된 URL에 지정된 것과 동일한 키를 가진 객체가 이미 버킷에 있는 경우 Amazon S3는 기존 객체를 업로드된 객체로 바꾼다.

example URL

https://<BUCKET_NAME>.ap-northeast-2.amazonaws.com/folder/object.png?
X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=<YOUR_ACCESS_KEY_ID>/20160115/ap-northeast-2/s3/aws4_request&
&X-Amz-Date=20160115T000000Z
&X-Amz-Expires=86400
&X-Amz-SignedHeaders=host
&X-Amz-Signature=<SIGNATURE_VALUE>

• 미리 선언된 URL의 한 예시

• 가독성을 높이기 위해 URL에 줄 바꿈 문자를 추가

• X-Amz-Credential 헤더 값 가독성을 위해서 “/” 문자를 사용해서 표현 (실제로는 %2F 로 인코딩)

• X-Amz-Signature 헤더를 제외한 모든 쿼리 매개변수들은 표준 쿼리 문자열에 포함 시킨다.

• URL내에 인증 정보를 제공하기 위해, 다음과 같은 다양한 쿼리 매개변수들이 포함

  매개변수	설명
  X-Amz-Algorithm	서명 버전과 알고리즘을 식별하고, 서명을 계산하는데 사용.
  서명 버전 4를 위해서 “AWS4-HMAC-SHA256” 로 설정
  X-Amz-Credential	액세스 키 ID와 범위 정보(요청 날짜, 사용하는 Region, 서비스 명).
  Region 명은 리전 및 엔드포인트에서 확인 가능
  X-Amz-Date	날짜는 ISO 8601 형식. 예: 20160115T000000Z
  X-Amz-Expires	미리 선언된 URL이 유효한 시간 주기. 초 단위. 정수 값.
  최소 1에서 최대 604800 (7일) 예: 86400 (24시간)
  X-Amz-SignedHeaders	서명을 계산하기 위해 사용되어지는 헤더 목록.
  HTTP host 헤더가 요구됨
  X-Amz-Signature	요청을 인증하기 위한 서명

AWS SDK for Java2.x