서명된 AWS API 요청 생성

• HTTPMethod - HTTP 메서드(예:GET, PUT, HEAD 및 DELETE).

• CanonicalUri – 도메인 이름 뒤에 오는 / 문자로 시작하여 문자열의 끝 또는 쿼리 문자열 파라미터가 있는 경우 물음표 문자(?)까지의 절대 경로 구성 요소 URI의 URI 인코딩 버전입니다. 절대 경로가 비어있는 경우, 슬래시 문자(/)를 사용합니다. 다음 예제에서 URI /amzn-s3-demo-bucket/myphoto.jpg는 절대 경로이며 절대 경로에는 / 문자를 인코딩하지 않습니다.

  http://s3.amazonaws.com/amzn-s3-demo-bucket/myphoto.jpg

• CanonicalQueryString - URI 인코딩 쿼리 문자열 파라미터. 각 이름과 값을 개별적으로 URI 인코딩합니다. 또한 표준 쿼리 문자열의 파라미터를 키 이름별로 알파벳순으로 정렬해야 합니다. 정렬은 인코딩 후에 이루어집니다. 다음 URI 예제의 쿼리 문자열은 다음과 같습니다.

  http://s3.amazonaws.com/amzn-s3-demo-bucket?prefix=somePrefix&marker=someMarker&max-keys=2

  표준 쿼리 문자열은 다음과 같습니다(가독성을 위해 줄바꿈 추가됨).

  UriEncode("marker")+"="+UriEncode("someMarker")+"&"+
  UriEncode("max-keys")+"="+UriEncode("20") + "&" +
  UriEncode("prefix")+"="+UriEncode("somePrefix")

  요청이 하위 리소스를 대상으로 하는 경우 해당 쿼리 파라미터 값은 빈 문자열("")이 됩니다. 예를 들어, 다음 URI는 amzn-s3-demo-bucket 버킷에서 ACL 하위 리소스를 식별합니다.

  http://s3.amazonaws.com/amzn-s3-demo-bucket?acl

  이 경우 CanonicalQueryString은 다음과 같습니다.

  UriEncode("acl") + "=" + ""

  URI에 ? 문자가 포함되지 않은 경우 요청에는 쿼리 문자열이 없으며, 표준 쿼리 문자열을 빈 문자열("")로 설정합니다. 여전히 줄 바꿈 문자("\n")를 포함해야 합니다.

• CanonicalHeaders - 요청 헤더와 해당 값이 포함된 목록. 개별 헤더 이름과 값 페어는 줄 바꿈 문자("\n")로 구분됩니다. 다음은 CanonicalHeader의 예제입니다.

  Lowercase(<HeaderName1>)+":"+Trim(<value>)+"\n"
  Lowercase(<HeaderName2>)+":"+Trim(<value>)+"\n"
  ...
  Lowercase(<HeaderNameN>)+":"+Trim(<value>)+"\n"

  CanonicalHeaders 목록에는 다음이 포함되어야 합니다.

  • HTTP host 헤더

  • Content-Type 헤더가 요청에 있는 경우 이를 CanonicalHeaders 목록에 추가해야 합니다.

  • 요청에 포함할 x-amz-* 헤더 또한 추가되어야 합니다. 예를 들어, 임시 보안 인증 정보를 사용하는 경우 요청에 x-amz-security-token을 포함해야 합니다. 이 헤더를 CanonicalHeaders 목록에 추가해야 합니다.

  참고

  Amazon S3 AWS 요청에는 x-amz-content-sha256 헤더가 필요합니다. 요청 페이로드의 해시를 제공합니다. 페이로드가 없는 경우 빈 문자열의 해시를 제공해야 합니다.

  각 헤더 이름은 다음과 같아야 합니다.

  • 소문자를 사용합니다.

  • 알파벳 순서로 표시됩니다.

  • 뒤에 콜론(:)이 와야 합니다.

  값의 경우 다음을 수행해야 합니다.

  • 선행 또는 후행 공백을 모두 잘라냅니다.

  • 순차적 공백을 단일 공백으로 변환합니다.

  • 쉼표를 사용하여 다중 값 헤더의 값을 구분합니다.

  • host 헤더(HTTP/1.1) 또는 :authority 헤더(HTTP/2) 및 모든 x-amz-* 헤더를 서명에 포함해야 합니다. 서명에 content-type과 같은 다른 표준 헤더를 선택적으로 포함할 수 있습니다.

  이 예제에서 사용하는 Lowercase() 및 Trim() 함수는 이전 섹션에서 설명합니다.

  다음은 CanonicalHeaders 문자열의 예입니다. 헤더 이름은 소문자이고 정렬되어 있습니다.

  host:s3.amazonaws.com
  x-amz-content-sha256:e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855
  x-amz-date:20130708T220855Z

  참고

  승인 서명을 계산하기 위해 host 및 모든 x-amz-* 헤더만 필요합니다. 하지만 데이터 변조 방지를 위해 서명 계산에 모든 헤더를 포함하는 것이 좋습니다.

• SignedHeaders - 알파벳순으로 정렬되고 세미콜론으로 구분된 소문자 요청 헤더 이름 목록입니다. 목록의 요청 헤더는 CanonicalHeaders 문자열에 포함한 것과 동일합니다. 이전 예제에서 SignedHeaders의 값은 다음과 같습니다.

  host;x-amz-content-sha256;x-amz-date

• HashedPayload - HTTP 요청 본문의 페이로드를 해시 함수의 입력으로 사용하여 생성된 문자열입니다. 이 문자열은 소문자 16진수 문자를 사용합니다.

  Hex(SHA256Hash(<payload>>))

  요청에 페이로드가 없는 경우 빈 문자열의 해시를 계산합니다. 예를 들어, GET 요청을 사용하여 객체를 검색하는 경우 페이로드에 아무 것도 없습니다.

  Hex(SHA256Hash(""))

  참고

  Amazon S3의 경우 표준 요청을 생성할 때 리터럴 문자열 UNSIGNED-PAYLOAD를 포함하고, 요청을 보낼 때는 x-amz-content-sha256 헤더 값과 동일한 값을 설정합니다.

  Hex(SHA256Hash("UNSIGNED-PAYLOAD"))

• Algorithm - 표준 요청의 해시를 생성하는 데 사용되는 알고리즘입니다. SHA-256의 경우, 알고리즘은 AWS4-HMAC-SHA256입니다.

• RequestDateTime - 보안 인증 범위에 사용된 날짜 및 시간입니다. 이 값은 ISO 8601 형식의 현재 UTC 시간입니다 (예: 20130524T000000Z).

• CredentialScope - 결과로 나오는 서명을 지정된 리전 및 서비스로 제한하는 자격 증명 범위입니다. 문자열의 형식은 YYYYMMDD/region/service/aws4_request입니다.

• HashedCanonicalRequest - 이전 단계에서 계산된 표준 요청의 해시입니다.

필수 입력

• 비밀 액세스 키가 포함된 문자열 Key.

• 자격 증명 범위에 사용된 날짜가 YYYYMMDD 형식으로 포함된 문자열 Date.

• 리전 코드(예: us-east-1)가 포함된 문자열 Region.

  리전 문자열 목록은 AWS 일반 참조의 리전 엔드포인트를 참조하세요.

• 서비스 코드(예: ec2)가 포함된 문자열 Service.

• 이전 단계에서 생성한 서명할 문자열입니다.