Azure Static Web Apps를 사용한 사용자 지정 도메인

  • 아티클

기본적으로 Azure Static Web Apps는 웹 사이트에 대해 자동 생성된 도메인 이름을 제공하지만 사이트에 대한 사용자 지정 도메인을 가리킬 수 있습니다. 무료 SSL/TLS 인증서는 자동 생성 도메인 이름과 추가할 수 있는 모든 사용자 지정 도메인에 대해 자동으로 만들어집니다.

사용자 지정 도메인을 정적 웹앱에 매핑할 때 몇 가지 옵션을 사용할 수 있습니다. 하위 도메인 및 apex 도메인을 구성할 수 있습니다.

다음 표에는 사용자 지정 도메인 기반 공급자 형식을 구성하는 방법을 보여 주는 문서에 대한 링크가 포함되어 있습니다. 1

작업 사용... 사용...
www 하위 도메인으로 도메인 설정 Azure DNS 외부 공급자
apex 도메인 설정 Azure DNS 외부 공급자

1 GoDaddy 및 Google과 같은 일부 등록기관은 apex 도메인 구성 방법에 영향을 미치는 도메인 레코드를 지원하지 않습니다. 이러한 등록 기관과 함께 Azure DNS를 사용하여 apex 도메인을 설정하는 것이 좋습니다.

참고 항목

미리 보기 환경에 사용자 지정 도메인을 추가하는 것은 지원되지 않습니다. Punycode 도메인 및 xn-- 접두사를 포함한 유니코드 도메인도 지원되지 않습니다.

도메인 정보

apex 도메인 설정은 도메인 이름이 설정되면 구성하는 일반적인 시나리오입니다. ALIAS 또는 ANAME 레코드를 구성하거나 CNAME 평면화를 통해 apex 도메인을 만듭니다. GoDaddy 및 Google과 같은 일부 도메인 등록 기관은 이러한 DNS 레코드를 지원하지 않습니다. 도메인 등록 기관이 필요한 모든 DNS 레코드를 지원하지 않는 경우 Azure DNS를 사용하여 도메인을 구성하는 것을 고려해 보세요.

또는 ALIAS 레코드, ANAME 레코드 또는 CNAME 평면화를 지원하지 않는 도메인 등록 기관의 경우 정적 웹앱에 대한 A 레코드를 구성할 수 있습니다. 그러면 트래픽이 정적 웹앱의 단일 지역 호스트로 전달됩니다. 애플리케이션이 더 이상 글로벌 배포의 이점을 얻지 못하므로 A 레코드를 사용하지 않는 것이 좋습니다. 트래픽이 전역적으로 분산된 경우 애플리케이션 성능에 영향을 줄 수 있습니다.

다음은 사용자 지정 도메인을 설정할 때 접하게 되는 용어입니다.

  • Apex 또는 루트 도메인: 도메인이 www.example.com인 경우 www 접두사는 하위 도메인이라고 하며 example.com의 나머지 세그먼트는 apex 도메인이라고 합니다.

  • 도메인 등록 기관: 등록 기관은 도메인의 가용성을 확인하고 도메인 이름을 구입할 수 있는 권리를 판매합니다.

  • DNS 영역: DNS(도메인 이름 시스템) 영역은 특정 도메인과 연결된 DNS 레코드를 호스팅합니다. 서로 다른 목적으로 트래픽을 유도하는 다양한 기록이 있습니다. 예를 들어, 도메인 example.com에는 여러 DNS 레코드가 포함될 수 있습니다. 하나의 레코드는 mail.example.com(메일 서버용) 및 다른 www.contoso.com(웹 사이트용)에 대한 트래픽을 처리합니다.

  • DNS 호스팅: DNS 호스트는 도메인 이름을 특정 IP 주소로 확인하는 DNS 서버를 유지합니다.

  • 이름 서버: 이름 서버는 도메인의 DNS 레코드 저장을 담당합니다.

사용자 지정 도메인 확인이 Static Web Apps와 함께 작동하려면 DNS를 공개적으로 확인할 수 있어야 합니다. 도메인이 추가된 후 자동 인증서 갱신이 작동하려면 다음 조건 중 하나가 충족되어야 합니다.

  • CNAME 유효성 검사를 통해 정적 웹앱에 사용자 지정 도메인을 추가하는 데 사용된 공용 인터넷 CNAME DNS 레코드가 여전히 존재하는지 유효성을 검사합니다. 이 옵션은 도메인을 정적 웹앱에 추가하기 위해 CNAME 유효성 검사를 사용한 경우에만 유효합니다.
  • 사용자 지정 도메인이 공용 인터넷을 통해 정적 웹앱으로 확인해야 합니다. 이 옵션은 웹앱에 도메인을 추가하는 데 사용된 유효성 검사 방법에 관계없이 유효합니다. 정적 웹앱의 프라이빗 엔드포인트는 사이트 콘텐츠에 대한 인터넷 액세스를 차단하지만 사이트에 대한 인터넷 DNS 확인은 차단하지 않기 때문에 이 방식은 프라이빗 엔드포인트가 사용하도록 설정된 경우에도 유효합니다.

가동 중지 시간이 없는 마이그레이션

현재 프로덕션 웹 사이트를 제공하는 사용자 지정 도메인을 가동 중지 시간이 0인 정적 웹앱으로 마이그레이션할 수 있습니다. DNS 공급자는 동일한 이름/호스트에 대해 여러 레코드를 허용하지 않으므로 도메인 소유권의 유효성을 별도로 검사하고 웹앱으로 트래픽을 라우팅할 수 있습니다.

  1. Azure Portal의 Static Web App을 엽니다.
  2. 사용자 지정 도메인(APEX 또는 하위 도메인)에 대한 TXT 레코드를 추가합니다. 표시된 대로 호스트 값을 입력하는 대신 다음과 같이 DNS 공급자에 호스트를 입력합니다.
    • APEX 도메인의 경우 _dnsauth.www.<YOUR-DOMAIN.COM>을 입력합니다.
    • 하위 도메인의 경우 _dnsauth.<SUBDOMAIN>.<YOUR-DOMAIN.COM>을 입력합니다.
  3. 도메인의 유효성이 검사되면 CNAME, ALIAS 또는 A 레코드를 기본 호스트 이름을 가리키도록 업데이트하여 트래픽을 정적 웹앱으로 마이그레이션할 수 있습니다.

다음 단계

공급자를 기반으로 도메인을 설정하는 방법에 대한 단계는 다음 링크를 사용합니다.