사용자 지정 도메인 문제 해결 - AWS Amplify 호스팅

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

사용자 지정 도메인 문제 해결

AWS Amplify 콘솔에서 앱에 사용자 지정 도메인을 추가할 때 문제가 발생하는 경우, 이 섹션의 다음 항목에서 문제 해결 도움말을 참조하십시오.

여기에서 문제 해결 방법을 찾을 수 없다면 AWS Support에 문의하세요. 자세한 내용을 알아보려면 AWS Support 사용 설명서지원 사례 만들기를 참조하세요.

CNAME 리졸빙이 되는지 어떻게 확인합니까?

  1. 타사 도메인 공급자와 함께 DNS 레코드를 업데이트한 후에는 dig와 같은 도구나 https://www.whatsmydns.net/과 같은 무료 웹사이트를 사용하여 CNAME 레코드가 제대로 해결되고 있는지 확인할 수 있습니다. 다음 스크린샷은 whatsmydns.net을 사용하여 www.example.com 도메인의 CNAME 레코드를 확인하는 방법을 보여줍니다.

    
                     확인할 웹 사이트 이름을 입력하는 whatsmydns.net의 스크린샷
  2. 검색을 선택하면 whatsmydns.net에 CNAME에 대한 결과가 표시됩니다. 다음 스크린샷은 CNAME이 cloudfront.net URL로 올바르게 확인되는지 확인하는 결과 목록의 예입니다.

    
                     CNAME 확인 결과를 표시하는 whatsmydns.net의 스크린샷.

타사에서 호스팅하는 도메인이 확인 보류 상태로 고착된 경우,

  1. 커스텀 도메인이 확인 보류 중 상태에서 멈춘 경우, CNAME 레코드가 해결되고 있는지 확인하십시오. 이 작업을 수행하는 방법에 대한 지침은 이전 문제 해결 항목인 CNAME 문제가 해결되었는지 확인하는 방법을 참조하십시오.

  2. CNAME 레코드가 확인되지 않는 경우, 도메인 공급자의 DNS 설정에 해당 CNAME 항목이 있는지 확인하십시오.

    중요

    사용자 지정 도메인을 생성하는 즉시 CNAME 레코드를 업데이트하는 것이 중요합니다. 앱이 Amplify 콘솔에 생성되면 몇 분마다 CNAME 레코드의 리졸빙 여부를 확인해야 합니다. 1시간 후에 리졸빙이 되지 않는 경우, 몇 시간마다 확인을 해야 하므로 도메인의 사용 준비 완료에 지연이 초래될 수 있습니다. 앱을 만든 후 몇 시간 후에 CNAME 레코드를 추가하거나 업데이트한 경우, 이로 인해 앱이 확인 보류 중 상태에서 멈출 가능성이 높습니다.

  3. CNAME 레코드가 존재하는지 확인한 경우, DNS 공급자에 문제가 있을 수 있습니다. DNS 공급자에게 연락하여 DNS 확인 CNAME 리졸빙이 되지 않는 이유를 진단하거나 DNS를 Route 53로 마이그레이션할 수 있습니다. 자세한 내용은 Amazon Route 53을 기존 도메인의 DNS 서비스로 지정 단원을 참조하십시오.

Amazon Route 53으로 호스팅된 도메인이 확인 보류 상태로 고착된 경우,

도메인을 Amazon Route 53으로 이전한 경우, 도메인은 앱 생성 시 Amplify에서 발급한 것과 다른 이름 서버를 가질 수 있습니다. 오류의 원인을 진단하려면 다음 단계를 수행하십시오.

  1. Amazon Route 53 콘솔에 로그인합니다.

  2. 탐색 창에서 호스팅 영역을 선택한 다음 연결 중인 도메인의 이름을 선택합니다.

  3. 호스팅 영역 세부 정보 섹션에서 이름 서버 값을 기록합니다. 다음 단계를 완료하려면 이 값이 모두 필요합니다. Route 53 콘솔의 다음 스크린샷은 오른쪽 하단에 이름 서버 값의 위치를 표시합니다.

    
                     Route 53 콘솔의 호스팅 영역 세부 정보 섹션의 스크린샷
  4. 탐색 창에서 등록된 도메인을 선택합니다. 등록된 도메인 섹션에 표시된 이름 서버가 호스팅 영역 세부 정보 섹션의 이전 단계에서 기록한 이름 서버 값과 일치하는지 확인하십시오. 일치하지 않는 경우, 이름 서버 값을 호스팅 영역의 값과 일치하도록 편집하십시오. Route 53 콘솔의 다음 스크린샷은 오른쪽에 이름 서버 값의 위치를 표시합니다.

    
                     Route 53 콘솔의 등록 도메인 섹션 스크린샷.
  5. 이렇게 해도 문제가 해결되지 않으면 AWS Support에 문의하세요. 자세한 내용을 알아보려면 AWS Support 사용 설명서지원 사례 만들기를 참조하세요.

CNAME AlreadyExistsException 오류가 발생합니다.

CNAME AlreadyExistsException 오류가 발생하면 연결하려고 시도한 호스트 이름 중 하나 (하위 도메인 또는 apex 도메인) 가 이미 다른 Amazon 배포에 배포되었음을 의미합니다. CloudFront 오류의 원인을 진단하려면 다음 단계를 수행하십시오.

  1. Amazon CloudFront 콘솔에 로그인하여 이 도메인을 다른 배포에 배포하지 않았는지 확인합니다. 한 번에 하나의 CloudFront 배포에 단일 CNAME 레코드를 첨부할 수 있습니다.

  2. 이전에 도메인을 배포에 CloudFront 배포한 경우 해당 도메인을 제거해야 합니다.

    1. 왼쪽 탐색 창에서 배포를 선택합니다.

    2. 편집할 배포판 이름을 선택합니다.

    3. 일반 탭을 선택합니다. 설정 섹션에서 편집을 선택합니다.

    4. 대체 도메인 이름(CNAME)에서 도메인 이름을 제거합니다. 그런 다음 변경 사항 저장을 선택합니다.

  3. 이 도메인이 사용자가 소유하는 다른 Amplify 앱에 연결되어 있는지 확인하십시오. 그렇다면 호스트 이름 중 하나를 재사용하려고 하지 마십시오. www.example.com을 다른 앱에 사용하는 경우, 현재 연결 중인 앱에서는 www.example.com을 사용할 수 없습니다. blog.example.com과 같은 다른 하위 도메인을 사용할 수 있습니다.

  4. 이 도메인이 다른 앱에 성공적으로 연결되었다가 최근 1시간 내에 삭제된 경우, 최소 1시간이 지난 후에 다시 시도하십시오. 6시간이 지난 후에도 이 예외가 계속 표시되면 문의하세요 AWS Support. 자세한 내용을 알아보려면 AWS Support 사용 설명서지원 사례 만들기를 참조하세요.

추가 확인 필요 오류가 발생합니다.

추가 확인 필요 오류가 발생하면 AWS Certificate Manager (ACM) 에서 이 인증서 요청을 처리하려면 추가 정보가 필요하다는 의미입니다. 이는 예를 들어 도메인이 Alexa Top 1000 웹 사이트 순위에 든 경우, 사기 방지 조치로 이루어질 수 있습니다. 필요한 정보를 제공하려면 지원 센터를 사용하여 AWS Support에 문의하십시오. 지원 계획이 없는 경우, ACM 토론 포럼에서 새 스레드를 게시할 수 있습니다.

참고

amazonaws.com, cloudfront.net 또는 elasticbeanstalk.com으로 끝나는 이름과 같이 Amazon 소유 도메인 이름에 대한 인증서를 요청할 수 없습니다.

URL에 404 오류가 나타납니다. CloudFront

트래픽을 처리하기 위해 Amplify 호스팅은 CNAME 레코드를 통해 CloudFront URL을 가리킵니다. 앱을 사용자 지정 도메인에 연결하는 과정에서 Amplify 콘솔은 앱의 CloudFront URL을 표시합니다. 하지만 이 CloudFront URL을 사용하여 애플리케이션에 직접 액세스할 수는 없습니다. 404 오류가 반환됩니다. 애플리케이션은 Amplify 앱 URL(예: https://main.d5udybEXAMPLE.amplifyapp.com)또는 사용자 지정 도메인(예 www.example.com)을 사용해서만 리졸빙됩니다.

Amplify는 요청을 올바른 배포된 브랜치로 라우팅해야 하며 호스트 이름을 사용하여 이 작업을 수행합니다. 예를 들어 앱의 기본라인 브랜치를 가리키는 도메인 www.example.com을 구성할 수 있지만 동일한 앱의 dev 브랜치를 가리키도록 dev.example.com을 구성할 수도 있습니다. 따라서 Amplify가 요청을 적절하게 라우팅할 수 있도록 구성된 하위 도메인을 기반으로 애플리케이션을 방문해야 합니다.

내 도메인을 방문할 때 SSL 인증서 또는 HTTPS 오류가 발생합니다.

타사 DNS 공급자와 함께 CAA (인증 기관 권한 부여) DNS 레코드를 구성한 경우, ACM AWS Certificate Manager (ACM) 이 사용자 지정 도메인 SSL 인증서에 대한 중간 인증서를 업데이트하거나 재발급하지 못할 수 있습니다. 이 문제를 해결하려면 Amazon 인증 기관 도메인 중 하나 이상을 신뢰하는 CAA 레코드를 추가해야 합니다. 다음 절차는 수행해야 하는 단계를 설명합니다.

Amazon 인증 기관을 신뢰할 수 있는 CAA 레코드를 추가하려면
  1. Amazon 인증 기관 도메인 중 하나 이상을 신뢰하도록 도메인 공급자와 함께 CAA 레코드를 구성하십시오. CAA 레코드 구성에 대한 자세한 내용은AWS Certificate Manager 사용 설명서의 CAA(인증 기관 승인) 문제를 참조하십시오.

  2. 다음 방법 중 하나를 사용하여 SSL 인증서를 업데이트합니다.