맞춤 도메인이 통합 개발자 포털의 CNAME 레코드와 일치하지 않습니다.

현재 Apigee Edge 문서가 표시되고 있습니다.
Apigee X 문서로 이동
정보

증상

통합 개발자 포털의 커스텀 도메인 구성은 커스텀 도메인이 CNAME(표준 이름) 레코드와 일치하지 않으면 작동하지 않습니다( 게시 > 포털 > 개발자 포털 > 설정 > 도메인).

오류 메시지

다음과 같은 오류 메시지가 표시됩니다.

Domain does not match CNAME record

Edge UI에 아래와 같이 오류 메시지가 표시됩니다.

포털 > 개발자 포털 > 설정 > 도메인" title="도메인">

가능한 원인

원인 설명 다음에 관한 문제 해결 안내
도메인의 CNAME 레코드가 누락되거나 잘못됨 커스텀 도메인에는 {orgname}-portal.apigee.net을 가리키는 CNAME 레코드가 있어야 합니다. 그렇지 않으면 커스텀 도메인 구성이 실패합니다. Edge 퍼블릭 클라우드 사용자

원인: 도메인의 CNAME 레코드가 누락되거나 잘못됨

진단

다음 단계에 따라 문제를 진단하세요.

  1. 다음 명령어를 실행하여 커스텀 도메인 이름의 DNS 구성을 찾습니다.
    dig +noall +answer {custom-domain}
  2. 위 명령어의 출력에는 {org}-portal.apigee.net 도메인 이름을 가리키는 CNAME 레코드가 포함되어야 합니다. 예:
    dig +noall +answer {custom-domain}
    
    {custom-domain}	{TTL}	IN	CNAME	{orgname}-portal.apigee.net.
  3. 명령어 결과에서 커스텀 도메인에 CNAME 레코드가 없거나 {org}-portal.apigee.net,와 일치하지 않는 CNAME 레코드가 포함된 것으로 표시되면 가상 호스트 생성이 실패합니다. 따라서 Edge UI의 커스텀 도메인 구성 페이지에서 사용자에게 위의 오류 메시지가 표시됩니다.

해상도

커스텀 도메인에 {orgname}-portal.apigee.net을 가리키는 CNAME 레코드가 없으면 다음 단계에 따라 문제를 해결하세요.

  1. 맞춤 도메인 DNS 구성에서 찾은 기존 CNAME 레코드를 삭제합니다.
  2. 커스텀 도메인 페이지에서 사용할 도메인 이름에 CNAME 레코드를 추가하여 {orgname}-portal.apigee.net를 가리킵니다.
  3. 커스텀 도메인 구성 페이지의 도메인 드롭다운 메뉴에서 특정 커스텀 도메인 이름 ({orgname}-portal.apigee.net를 가리키는 CNAME 레코드 포함)을 선택합니다.
  4. 키 저장소에 와일드 카드 인증서를 업로드한 경우 다음 단계를 따르세요.
    1. 드롭다운 메뉴에서 도메인 이름을 선택합니다.
    2. 올바른 하위 도메인 이름을 입력하세요.
  5. 통합 개발자 포털 커스텀 도메인 구성 페이지에서 키 저장소, 별칭, 도메인 이름을 구성하세요.
  6. 저장을 클릭합니다.

문제가 계속되면 진단 정보를 수집해야 함으로 이동합니다.

진단 정보 수집 필요

위의 안내를 따른 후에도 문제가 지속되면 다음 진단 정보를 수집하여 Apigee Edge 지원과 공유하세요.

  • Apigee Edge Cloud 조직 이름
  • Apigee Edge Cloud 통합 개발자 포털 이름
  • 포털 환경에서 생성된 키 저장소의 이름
  • 별칭 이름
  • 커스텀 도메인 이름
  • 오류 메시지를 캡처하는 커스텀 도메인 구성 페이지의 스크린샷