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

您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档
信息

问题

如果自定义网域与 CNAME(规范名称)记录不匹配,集成开发者门户中的自定义网域配置将不起作用:发布 > 门户 > 开发者门户 > 设置 > 网域。

错误消息

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

Domain does not match CNAME record

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

门户 > 开发者门户 > 设置 > 网域" 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 界面的自定义网域配置页面上向用户显示上述错误消息。

分辨率

如果自定义网域不包含指向 {orgname}-portal.apigee.net 的 CNAME 记录,请执行以下步骤来解决问题:

  1. 移除自定义网域 DNS 配置中的任何现有 CNAME 记录。
  2. 将 CNAME 记录添加到您的域名(您要在自定义网域页面使用)以指向 {orgname}-portal.apigee.net
  3. 在自定义网域配置页面中,从网域下拉菜单中选择特定的自定义域名(其 CNAME 记录指向 {orgname}-portal.apigee.net)。
  4. 如果您已向密钥库上传了通配符证书,请执行以下操作:
    1. 从下拉菜单中选择域名,然后
    2. 填写正确的子域名
  5. 在集成式开发者门户自定义网域配置页面中配置密钥库、别名、域名
  6. 点击保存

如果问题仍然存在,请转到必须收集诊断信息

必须收集的诊断信息

如果在按照上述说明操作后问题仍然存在,请收集以下诊断信息并将其分享给 Apigee Edge 支持

  • Apigee Edge Cloud 组织名称
  • Apigee Edge Cloud 集成式开发者门户名称
  • 在门户环境中创建的密钥库的名称
  • 别名
  • 自定义域名
  • 捕获错误消息的自定义网域配置页面的屏幕截图