自訂網域與整合式開發人員入口網站中的 CNAME 記錄不符

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件
資訊

問題

如果自訂網域與 CNAME (「標準名稱」) 記錄不符,以下為整合式開發人員入口網站的自訂網域設定將無法運作:依序前往「發布」>「入口網站」>「開發人員入口網站」>「設定」>「網域」

錯誤訊息

系統會顯示下列錯誤訊息:

Domain does not match CNAME record

錯誤訊息會顯示在 Edge UI 中,如下所示:

入口網站 > 開發人員入口網站 > 設定 > Domains" title="Domains">

可能原因

原因 說明 適用於
網域的 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. 如果您已將萬用字元憑證上傳到 KeyStore,請按照下列步驟操作:
    1. 從下拉式選單中選取網域名稱,然後
    2. 填寫正確的子網域名稱
  5. 在經過整合的開發人員入口網站自訂網域設定頁面設定 KeyStore、別名和網域名稱
  6. 按一下「儲存」

如果問題仍未解決,請參閱「必須收集診斷資訊」。

必須收集診斷資訊

如果按照上述說明操作後問題仍未解決,請收集下列診斷資訊,並與 Apigee Edge 支援團隊分享:

  • Apigee Edge Cloud 機構名稱
  • Apigee Edge Cloud 整合式開發人員入口網站名稱
  • 在入口網站環境中建立的 KeyStore 名稱
  • 別名名稱
  • 自訂網域名稱
  • 自訂網域設定頁面擷取錯誤訊息的螢幕截圖