입력한 호스트는 콘텐츠를 제공할 도메인이며 이 도메인은 최상위 도메인 또는 하위 도메인일 수 있습니다.
도메인 제공업체에 따라 이 용어를 '호스트 이름', '이름', '도메인'으로 표시할 수도 있습니다.
값: 제공된 IP 주소를 레코드 값에 할당합니다.
도메인 제공업체에 따라 이 용어를 '데이터', '지정 대상', '콘텐츠', '주소', 'IP 주소'로 표시할 수도 있습니다.
SSL 인증서가 프로비저닝되기를 기다립니다.
DNS를 Firebase 호스팅에 연결한 후 최대 24시간까지 걸릴 수 있습니다.
대부분의 경우 레코드 전파와 SSL 인증서 프로비저닝은 도메인 제공업체에 따라 몇 시간 내에 이루어집니다.
고급 설정
커스텀 도메인 추가 마법사의 고급 설정 모드에서는 트래픽을 해당 서버로 연결하기 전에 도메인을 안전하게 제공하도록 호스팅을 구성할 수 있습니다. 일반적으로 호스팅에는 도메인에서 트래픽을 성공적으로 제공하기 위해 3가지 항목이 필요합니다.
소유권 레코드: TXT 레코드가 호스팅에 도메인에서 제공할 사이트를 알려줍니다.
SSL 인증서: 호스팅 서버와 최종 사용자 간의 암호화된 통신을 사용 설정하는 도메인 특정 인증서입니다.
호스팅 IP 주소: 도메인의 모든 요청을 호스팅 서버로 연결하는 하나 이상의 A 및 AAAA 레코드입니다.
고급 설정은 호스팅이 처음 2개의 요구사항을 미리 처리할 수 있도록 도메인 구성을 안내하므로, 도메인의 트래픽 수신을 시작하기 전에 올바른 콘텐츠를 제공할 준비가 됩니다.
이 마법사는 이 프로세스를 2단계 워크플로로 표시합니다.
도메인 준비
DNS 레코드 업데이트: 도메인에 하나 이상의 레코드를 추가합니다.
소유권: `hosting-site=[site_id]` 형식의 TXT 레코드입니다.
CAA(선택사항): 호스팅의 인증 기관이 도메인의 SSL 인증서를 민팅하도록 허용하는 CAA 레코드 쌍입니다. 호스팅에서 인증서 프로비저닝을 방해하는 기존 CAA 레코드가 발견된 경우에만 제공됩니다.
SSL 인증서 설정: 이 마법사는 호스팅의 인증 기관이 도메인의 SSL 인증서를 민팅하기 위해 사용할 ACME 챌린지를 제공합니다. DNS 또는 HTTP 챌린지 중에서 선택할 수 있습니다.
DNS 챌린지: 도메인 제공업체의 DNS 관리 사이트로 이동합니다. ACME 챌린지 하위 도메인 키 및 제공된 값으로 TXT 레코드를 추가합니다. TXT 레코드 전파에 최대 24시간이 걸릴 수 있습니다.
HTTP 챌린지: 지정된 URL에서 기존 사이트에 제공된 텍스트 파일을 업로드하고 해당 존재 유무를 확인합니다.
호스팅이 CA에서 확인을 요청하기 전에 ACME 챌린지를 자체적으로 검증하려고 시도합니다. 간헐적인 서비스 문제 등의 이유로 CA가 챌린지 검증을 실패하면 호스팅이 새로운 챌린지 집합을 생성해야 합니다. 확인에 성공하면 호스팅이 SSL 인증서를 프로비저닝하고 전파를 허용하는 데 몇 시간까지 걸릴 수 있습니다.
호스팅으로 이동
호스팅으로 도메인 소유권이 설정되고 SSL 인증서가 프로비저닝된 후 DNS 제공업체로 돌아가고 호스팅에 DNS A/AAAA 레코드 연결 요청을 추가합니다.
유형: 요청된 DNS A/AAAA 레코드를 추가합니다.
호스트: 두 레코드 모두 커스텀 도메인 키를 입력합니다.
입력한 호스트는 콘텐츠를 제공할 도메인이며 이 도메인은 최상위 도메인 또는 하위 도메인일 수 있습니다. 도메인 제공업체에 따라 이 용어를 '호스트 이름', '이름', '도메인'으로 표시할 수도 있습니다.
값: 도메인이 지정된 IP 주소를 가리키도록 각 DNS A/AAAA 레코드에 값을 하나씩 할당합니다.
도메인 제공업체에 따라 이 용어를 '데이터', '지정 대상', '콘텐츠', '주소', 'IP 주소'로 표시할 수도 있습니다.
SSL 인증서 프로비저닝 대기
도메인 소유권이 인증되면 DNS A 레코드가 Firebase 호스팅을 가리키도록 설정된 후 24시간 내에 도메인의 SSL 인증서가 프로비저닝되어 글로벌 CDN을 통해 배포됩니다.
FirebaseApp SSL 인증서에 도메인이 주체 대체 이름(SAN) 중 하나로 표시됩니다. 브라우저의 보안 도구를 사용하면 이 인증서를 볼 수 있습니다. 도메인이 프로비저닝되는 동안 도메인 이름이 포함되지 않는 잘못된 인증서가 표시될 수 있습니다. 이는 정상적인 절차 중 한 부분이며 도메인 인증서를 사용할 수 있게 되면 해결됩니다.
고급 설정 사용자의 웹사이트는 프로젝트의 Firebase 호스팅 페이지에 있는 설정 상태가 연결됨으로 업데이트될 때까지 이전 호스팅 업체에서 호스팅됩니다.
커스텀 도메인 키
DNS 레코드를 추가하거나 수정할 때 서로 다른 도메인 제공업체의 DNS 관리 사이트 내 호스트 필드에는 서로 다른 입력 값을 입력해야 합니다. 아래에 자주 사용되는 제공업체의 일반적인 입력 값이 정리되어 있습니다.
자세한 안내는 도메인 제공업체의 문서를 참조하세요.
도메인 유형
커스텀 도메인 키
최상위 도메인
일반적인 입력 값은 다음과 같습니다.
@
최상위 도메인 이름(예: example.com)
호스트 필드 비우기
하위 도메인
일반적인 입력 값은 다음과 같습니다.
전체 하위 도메인 이름(예: app.example.com)
하위 도메인 부분만(예: .example.com을 제외한 app)
www.example.com의 하위 도메인에서 www만
일반적인 도메인 제공업체
다음은 몇 가지 일반적인 도메인 제공업체 및 각 제공업체에 필요한 입력 유형입니다.
이 정보는 가능한 한 최신 상태로 유지되지만, 자세한 안내는 도메인 제공업체의 문서를 참조하세요.
Cloudflare
유형
호스트
값
DNS TXT 레코드 입력
TXT
example.com
Firebase Console에 제공된 인증 값
DNS A 레코드 입력
A
example.com
199.36.158.100
A
www
199.36.158.100
Google Domains
유형
호스트
값
DNS TXT 레코드 입력
TXT
@
Firebase Console에 제공된 인증 값
DNS A 레코드 입력
A
@
199.36.158.100
A
www
199.36.158.100
Google Cloud DNS
유형
호스트
값
DNS TXT 레코드 입력
TXT
example.com
Firebase Console에 제공된 인증 값
DNS A 레코드 입력
A
example.com
199.36.158.100
A
www
199.36.158.100
NameCheap
유형
호스트
값
DNS TXT 레코드 입력
TXT
@
Firebase Console에 제공된 인증 값
DNS A 레코드 입력
A
@
199.36.158.100
A
@
199.36.158.100
Squarespace
유형
호스트
값
DNS TXT 레코드 입력
TXT
@
Firebase Console에 제공된 인증 값
DNS A 레코드 입력
A
@
199.36.158.100
A
www
199.36.158.100
커스텀 도메인의 설정 상태 설명
상태
설명
설정 필요
DNS 레코드를 사용하여 구성을 변경해야 할 수 있습니다.
대부분의 경우 DNS A 레코드는 도메인 이름 제공업체에서 Firebase 호스팅 서버로 전파되지 않습니다.
문제해결 팁: 24시간이 지난 경우 레코드가 Firebase 호스팅을 가리키도록 설정되었는지 확인하세요.
드물지만 특히 고급 설정 과정을 사용하는 경우에 다음과 같은 이유로 SSL 챌린지가 실패할 수 있습니다.
DNS 레코드의 A 레코드 또는 CNAME 레코드가 다른 호스팅 제공업체를 가리킵니다.
문제해결 팁: A 레코드가 Firebase 호스팅만 가리키는지 확인하고 CNAME 레코드를 모두 삭제하세요.
마이그레이션할 수 없고 토큰(사이트에 제공한 DNS TXT 레코드 또는 업로드된 파일)이 현재 유효하지 않습니다.
문제해결 팁: 도메인에 대한 View(뷰)를 클릭한 후 기존 도메인에 새 토큰을 제공하세요.
