요청 인증: 쿼리 파라미터 사용(AWS 서명 버전 4)

인증 개요(인증 방법 참조)에 설명된 대로 쿼리 문자열 파라미터를 사용하여 인증 정보를 제공할 수 있습니다. 쿼리 파라미터를 사용하여 요청을 인증하는 것은 요청을 하나의 URL에서 완전히 표현하려는 경우에 유용합니다. 이 방법을 URL 미리 서명이라고도 합니다.

미리 서명된 URL의 사용 사례 시나리오는 Amazon S3 리소스에 대한 임시 액세스 권한을 부여할 수 있다는 것입니다. 예를 들어 웹 사이트에 미리 서명된 URL을 포함하거나 명령줄 클라이언트(예: Curl)에 이를 사용하여 객체를 다운로드할 수 있습니다.

다음은 미리 서명된 URL의 예입니다.

https://examplebucket.s3.amazonaws.com/test.txt
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=<your-access-key-id>/20130721/us-east-1/s3/aws4_request
&X-Amz-Date=20130721T201207Z
&X-Amz-Expires=86400
&X-Amz-SignedHeaders=host
&X-Amz-Signature=<signature-value>  

예제 URL에서 다음 사항에 유의하세요.

다음 표에서는 인증 정보를 제공하는 URL의 쿼리 파라미터를 설명합니다.

<your-access-key-id>/<date>/<AWS 리전>/<AWS-service>/aws4_request

AKIAIOSFODNN7EXAMPLE/20130721/us-east-1/s3/aws4_request

서명 계산

다음 다이어그램은 서명 계산 프로세스를 보여줍니다.

다음 표에서는 다이어그램에 표시된 함수를 설명합니다. 이러한 함수의 코드를 구현해야 합니다.

public static String UriEncode(CharSequence input, boolean encodeSlash) {
          StringBuilder result = new StringBuilder();
          for (int i = 0; i < input.length(); i++) {
              char ch = input.charAt(i);
              if ((ch >= 'A' && ch <= 'Z') || (ch >= 'a' && ch <= 'z') || (ch >= '0' && ch <= '9') || ch == '_' || ch == '-' || ch == '~' || ch == '.') {
                  result.append(ch);
              } else if (ch == '/') {
                  result.append(encodeSlash ? "%2F" : ch);
              } else {
                  result.append(toHexUTF8(ch));
              }
          }
          return result.toString();
      }

서명 프로세스에 대한 자세한 내용(정식 요청 생성, 서명할 문자열 및 서명 계산에 대한 세부 정보)은 Authorization 헤더에 대한 서명 계산: 페이로드를 단일 청크로 전송(AWS 서명 버전 4) 섹션을 참조하세요. 미리 서명된 URL에서 CanonicalRequest를 생성하는 것이 다음과 같이 다르다는 점을 제외하면 프로세스는 전반적으로 동일합니다.

예제

examplebucket 버킷에 test.txt 객체가 있다고 가정해 보겠습니다. 미리 서명된 URL을 생성하여 24시간(86,400초) 동안 이 객체를 다른 사람과 공유하려고 합니다.

https://examplebucket.s3.amazonaws.com/test.txt
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20130524%2Fus-east-1%2Fs3%2Faws4_request
&X-Amz-Date=20130524T000000Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host
&X-Amz-Signature=<signature-value>

다음 단계에서는 먼저 서명 계산을 설명한 다음 미리 서명된 URL 구성을 설명합니다. 이 예제에서는 다음을 추가로 가정합니다.

이 예제를 테스트 사례로 사용하여 코드가 계산하는 서명을 확인할 수 있습니다. 단, 동일한 버킷 이름, 객체 키, 타임스탬프 및 다음 예제 자격 증명을 사용해야 합니다.

예제 2

다음은 X-Amz-Security-Token 파라미터와 함께 미리 서명된 URL을 보여주는 예제입니다(이전 예제와 관련이 없음).

https://examplebucket.s3.us-east-1.amazonaws.com/test.txt
?X-Amz-Algorithm=AWS4-HMAC-SHA256
&X-Amz-Credential=AKIAIOSFODNN7EXAMPLE%2F20130524%2Fus-east-1%2Fs3%2Faws4_request
&X-Amz-Date=20200524T000000Z&X-Amz-Expires=86400&X-Amz-SignedHeaders=host
&X-Amz-Security-Token=IQoJb3JpZ2luX2VjEMv%2F%2F%2F%2F%2F%2F%2F%2F%2F%2FwEaCXVzLWVhc3QtMSJGMEQCIBSUbVdj9YGs2g0HkHsOHFdkwOozjARSKHL987NhhOC8AiBPepRU1obMvIbGU0T%2BWphFPgK%2Fqpxaf5Snvm5M57XFkCqlAgjz%2F%2F%2F%2F%2F%2F%2F%2F%2F%2F8BEAAaDDQ3MjM4NTU0NDY2MCIM83pULBe5%2F%2BNm1GZBKvkBVslSaJVgwSef7SsoZCJlfJ56weYl3QCwEGr2F4BmCZZyFpmWEYzWnhNK1AnHMj5nkfKlKBx30XAT5PZGVrmq4Vkn9ewlXQy1Iu3QJRi9Tdod8Ef9%2FyajTaUGh76%2BF5u5a4O115jwultOQiKomVwO318CO4l8lv%2F3HhMOkpdanMXn%2B4PY8lvM8RgnzSu90jOUpGXEOAo%2F6G8OqlMim3%2BZmaQmasn4VYRvESEd7O72QGZ3%2BvDnDVnss0lSYjlv8PP7IujnvhZRnj0WoeOyMe1lL0wTG%2Fa9usH5hE52w%2FYUJccOn0OaZuyROuVsRV4Q70sbWQhUvYUt%2B0tUMKzm8vsFOp4BaNZFqobbjtb36Y92v%2Bx5kY6i0s8QE886jJtUWMP5ldMziClGx3p0mN5dzsYlM3GyiJ%2FO1mWkPQDwg3mtSpOA9oeeuAMPTA7qMqy9RNuTKBDSx9EW27wvPzBum3SJhEfxv48euadKgrIX3Z79ruQFSQOc9LUrDjR%2B4SoWAJqK%2BGX8Q3vPSjsLxhqhEMWd6U4TXcM7ku3gxMbzqfT8NDg%3D
&X-Amz-Signature=<signature-value>