자습서: 프라이빗 REST API 빌드

AWS CloudFormation 콘솔(https://console.aws.amazon.com/cloudformation)을 엽니다.

스택 생성을 선택한 다음 새 리소스 사용(표준)을 선택합니다.

템플릿 지정에서 템플릿 파일 업로드를 선택합니다.

다운로드한 템플릿을 선택합니다.

다음을 선택합니다.

스택 이름에 private-api-tutorial을 입력하고 다음을 선택합니다.

스택 옵션 구성에서 다음을 선택합니다.

기능의 경우 AWS CloudFormation이 계정에 IAM 리소스를 생성할 수 있음을 확인합니다.

제출을 선택합니다.

https://console.aws.amazon.com/apigateway에서 API Gateway 콘솔에 로그인합니다.

API 생성(Create API)을 선택한 다음 REST API에 대해 빌드(Build)를 선택합니다.

API 이름에서 private-api-tutorial을(를) 입력합니다.

API 엔드포인트 유형에서 프라이빗을 선택합니다.

VPC 엔드포인트 ID의 경우 AWS CloudFormation 스택의 출력에서 VPC 엔드포인트 ID를 입력합니다.

API 생성(Create API)을 선택합니다.

https://console.aws.amazon.com/apigateway에서 API Gateway 콘솔에 로그인합니다.

API를 선택합니다.

/ 리소스를 선택한 다음 메서드 생성을 선택합니다.

메서드 유형에서 GET을 선택합니다.

통합 유형에서 Lambda 함수를 선택합니다.

Lambda 프록시 통합을 켭니다. Lambda 프록시 통합을 통해 API Gateway는 정의된 구조를 사용하여 이벤트를 Lambda에 보내고 Lambda 함수의 응답을 HTTP 응답으로 변환합니다.

Lambda 함수의 경우 1단계에서 AWS CloudFormation 템플릿으로 생성한 함수를 선택합니다. 함수의 이름은 private-api-tutorial로 시작합니다.

메서드 생성을 선택합니다.

https://console.aws.amazon.com/apigateway에서 API Gateway 콘솔에 로그인합니다.

API를 선택합니다.

리소스 정책, 정책 생성을 차례로 선택합니다.

다음 정책을 입력합니다. vpceID를 AWS CloudFormation 스택의 출력(Outputs)에서 VPC 엔드포인트 ID로 바꿉니다.

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Deny",
            "Principal": "*",
            "Action": "execute-api:Invoke",
            "Resource": "execute-api:/*",
            "Condition": {
                "StringNotEquals": {
                    "aws:sourceVpce": "vpceID"
                }
            }
        },
        {
            "Effect": "Allow",
            "Principal": "*",
            "Action": "execute-api:Invoke",
            "Resource": "execute-api:/*"
        }
    ]
}

Save changes(변경 사항 저장)를 선택합니다.

https://console.aws.amazon.com/apigateway에서 API Gateway 콘솔에 로그인합니다.

API를 선택합니다.

Deploy API(API 배포)를 선택합니다.

스테이지에서 새 스테이지를 선택합니다.

단계 이름에 test를 입력합니다.

(선택 사항) 설명에 설명을 입력합니다.

[Deploy]를 선택합니다.

https://console.aws.amazon.com/apigateway에서 API Gateway 콘솔에 로그인합니다.

API를 선택합니다.

기본 탐색 창에서 스테이지를 선택한 후 테스트 스테이지를 선택합니다.

스테이지 세부 정보에서 복사 아이콘을 선택하여 API의 호출 URL을 복사합니다. 이 URL은 https://abcdef123.execute-api.us-west-2.amazonaws.com/test와 같은 형식입니다. 1단계에서 생성한 VPC 엔드포인트에는 프라이빗 DNS가 활성화되어 있으므로 제공된 URL을 사용하여 API를 호출할 수 있습니다.

curl을 사용하여 VPC 외부에서 API를 호출합니다.

curl https://abcdef123.execute-api.us-west-2.amazonaws.com/test

Curl은 API의 엔드포인트를 확인할 수 없음을 나타냅니다. 다른 응답을 받은 경우 2단계로 돌아가서 API의 엔드포인트 유형에 대해 프라이빗(Private)으로 선택해야 합니다.

curl: (6) Could not resolve host: abcdef123.execute-api.us-west-2.amazonaws.com/test

https://console.aws.amazon.com/ec2/에서 Amazon EC2 콘솔을 엽니다.

인스턴스를 선택합니다.

1단계에서 AWS CloudFormation 템플릿으로 생성한 private-api-tutorial이라는 인스턴스를 선택합니다.

연결(Connect)을 선택한 다음 세션 관리자(Session Manager)를 선택합니다.

연결(Connect)을 선택하여 인스턴스에 대한 브라우저 기반 세션을 시작합니다.

세션 관리자 세션에서 curl을 사용하여 API를 호출합니다. Amazon VPC에서 인스턴스를 사용하고 있기 때문에 API를 호출할 수 있습니다.

curl https://abcdef123.execute-api.us-west-2.amazonaws.com/test

응답 Hello from Lambda!이 수신되는지 확인합니다.

https://console.aws.amazon.com/apigateway에서 API Gateway 콘솔에 로그인합니다.

API 페이지에서 API를 선택합니다. API 작업을 선택하고 API 삭제를 선택한 다음 선택을 확인합니다.

AWS CloudFormation 콘솔(https://console.aws.amazon.com/cloudformation)을 엽니다.

AWS CloudFormation 스택을 선택합니다.

삭제를 선택한 다음 해당 선택을 확인합니다.