CloudFront 웹 배포를 기반으로 여러 API Gateway API에 대한 사용자 지정 도메인 엔드포인트를 구성하려면 어떻게 해야 합니까?

해결 방법

사용자 지정 도메인 이름을 만들어 API 연결

API Gateway에서 API의 사용자 지정 도메인 이름을 만듭니다. 여러 API를 다양한 기본 경로로 같은 도메인에 매핑하려면 다음을 참조하십시오.

• REST API의 경우, REST API의 사용자 지정 도메인 이름 설정을 참조하십시오.
• HTTP API의 경우, HTTP API의 사용자 지정 도메인 이름 설정을 참조하십시오.
• WebSocket API의 경우, WebSocket API의 사용자 지정 도메인 이름 설정을 참조하십시오.

API Gateway에서 사용자 지정 도메인 이름을 만들었으면, DNS 레코드를 업데이트해 사용자 지정 도메인 이름을 API 엔드포인트에 매핑합니다. Amazon Route 53에서 DNS를 업데이트하는 방법은 도메인 이름을 사용하여 Amazon API Gateway API로 트래픽 라우팅을 참조하십시오.

다음 예시에서는 REST API 리전 사용자 지정 도메인 이름 설정을 사용했습니다.

• https://restapiId1.execute-api.us-west-2.amazonaws.com/stage1/example1/home
• https://restapiId2.execute-api.us-west-2.amazonaws.com/stage2/example2/home

사용자 지정 도메인 기본 경로 매핑의 예시:

• 기본 경로 /api1은 restapiId1 ID로 REST API의 stage1 단계에 매핑됩니다.
• 기본 경로 /api2는 restapiId2 ID로 REST API의 stage2 단계에 매핑됩니다.

사용자 지정 도메인 URL의 예시:

• https://apigw.customdomain.com/api1/example1/home
• https://apigw.customdomain.com/api2/example2/home

CloudFront 웹 배포 만들기

배포를 만들려면 다음 단계를 완료하십시오.

1. CloudFront 콘솔을 엽니다.
2. 배포 만들기를 선택합니다.
3. 오리진 도메인으로 API Gateway 사용자 지정 도메인 이름을 입력합니다. 예를 들어 apigw.customdomain.com과 같습니다.
4. 오리진 경로는 비워둡니다.
   참고: 오리진 경로의 기본 경로가 잘못되었으면 CloudFront가 Missing Authentication Token과 함께 403 Forbidden 오류를 반환합니다. 자세한 내용은 API Gateway REST API 엔드포인트 403 ‘Missing Authentication Token’ 오류를 해결하려면 어떻게 해야 합니까?를 참조하십시오.
5. 최소 오리진 SSL 프로토콜로 TLSv1.2를 선택합니다.
6. 오리진 프로토콜 정책으로는 HTTPS 전용을 선택합니다.
7. (선택 사항) 오리진에 사용자 지정 헤더를 추가하려면 헤더 추가를 선택하고, 헤더 이름과 값을 입력합니다.
8. 오리진 요청 정책으로 AllViewerExceptHostHeader를 선택하여 모든 요청 파라미터를 전달합니다.
9. (선택 사항) 캐시를 비활성화하려면 캐시 정책으로 CachingDisabled를 선택하십시오.
10. 뷰어 프로토콜 정책으로는 필요에 따라 HTTPS 전용 또는 HTTP를 HTTPS로 리디렉션을 선택합니다.
11. 배포 만들기를 선택합니다.

배포를 만들고 나면 배포 상태가 InProgress에서 Deployed로 변경됩니다.

CloudFront 웹 배포 테스트

다음 단계를 완료합니다.

1. CloudFront 콘솔을 엽니다.
2. 웹 배포의 도메인 이름을 적어 두십시오. 예를 들어 a222222bcdefg5.cloudfront.net과 같습니다.
3. 배포를 테스트합니다.

테스트에 성공하면 HTTP 200 OK 응답이 반환됩니다. 전파에 최대 24시간이 걸립니다. 요청이 응답을 반환하지 않으면 CloudFront DNS 레코드가 아직 진행 중인 것입니다. 배포가 배포되지 않은 경우, HTTP 5xx 오류가 표시될 수 있습니다. DNS 전파가 완료되지 않았으면 다른 HTTP 4xx 오류가 발생할 수 있습니다.

CloudFront 배포를 만들고 나면 CloudFront 배포 하나와 API Gateway 사용자 지정 도메인 이름에서 API 두 개를 요청할 수 있습니다.

CloudFront 웹 배포에 수신되는 승인 헤더를 전달하는 방법은 자체 CloudFront를 사용하여 API Gateway를 설정하려면 어떻게 해야 하나요?를 참조하십시오.

관련 정보

API Gateway의 REST API에 대한 API 엔드포인트 유형