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

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件
info

問題

如果自訂網域與 CNAME (正規名稱) 記錄不符,整合式開發人員入口網站中的自訂網域設定將無法運作: 「發布」>「入口網站」>「開發人員入口網站」>「設定」>「網域」。

錯誤訊息

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

Domain does not match CNAME record

Edge 使用者介面會顯示錯誤訊息,如下所示:

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

可能原因

原因 說明 適用於以下裝置的疑難排解操作說明:
網域的 CNAME 記錄遺失或不正確 自訂網域應有指向 {orgname}-portal.apigee.net 的 CNAME 記錄。否則自訂網域設定就會失敗。 Edge Public Cloud 使用者

原因:網域的 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 記錄,或包含不符的 CNAME 記錄{org}-portal.apigee.net,,這就是虛擬主機建立失敗的原因。因此,Edge 使用者介面的自訂網域設定頁面會向使用者顯示上述錯誤訊息。

解析度

如果自訂網域未包含指向 {orgname}-portal.apigee.net 的 CNAME 記錄,請按照下列步驟解決問題:

  1. 移除自訂網域 DNS 設定中的所有現有 CNAME 記錄。
  2. 在網域名稱 (您想在自訂網域頁面中使用的網域名稱) 中新增 CNAME 記錄,指向 {orgname}-portal.apigee.net
  3. 在自訂網域設定頁面中,從「網域」的下拉式選單選取特定自訂網域名稱 (該網域的 CNAME 記錄指向 {orgname}-portal.apigee.net)。
  4. 如果您已將萬用字元憑證上傳至 KeyStore,請執行下列步驟:
    1. 從下拉式選單中選取網域名稱,然後
    2. 填入正確的子網域名稱
  5. 在整合式開發人員入口網站的自訂網域設定頁面中,設定金鑰儲存區、別名和網域名稱
  6. 按一下「儲存」

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

必須收集診斷資訊

如果按照上述指示操作後問題仍未解決,請收集下列診斷資訊,並提供給 Apigee Edge 支援團隊

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