自定义网域与集成的开发者门户中的 CNAME 记录不匹配

您正在查看 Apigee Edge 文档。
转到 Apigee X 文档
info

问题

如果自定义 网域与 CNAME(规范名称)记录不匹配,则集成式开发者门户中的自定义网域配置将无法正常运行: 发布 > 门户 > 开发者 门户 > 设置 > 网域。

错误消息

系统会显示以下错误消息:

Domain does not match CNAME record

该错误消息会显示在 Edge 界面中,如下所示:

Portals > Developer Portal > Settings > Domains" title="Domains">

可能的原因

原因 说明 适用的问题排查说明
网域的 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 记录,或者 包含与{org}-portal.apigee.net,不匹配的 CNAME 记录,则这是导致虚拟主机创建失败的原因。因此,上述错误消息会 显示在 Edge 界面的自定义网域配置页面上。

解决方案

如果自定义网域不包含指向 {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 集成式开发者门户名称
  • 在门户环境中创建的密钥库的名称
  • 别名
  • 自定义网域名称
  • 自定义网域配置页面的屏幕截图,其中包含错误消息