您正在查看的是 Apigee Edge 文档。
转到 Apigee X 文档。 信息
问题
如果自定义网域与 CNAME(规范名称)记录不匹配,集成开发者门户中的自定义网域配置将不起作用:发布 > 门户 > 开发者门户 > 设置 > 网域。
错误消息
系统会显示以下错误消息:
Domain does not match CNAME record
Edge 界面中会显示错误消息,如下所示:
门户 > 开发者门户 > 设置 > 网域" title="Domains">
可能的原因
原因 | 说明 | 适用于以下项目的问题排查说明: |
---|---|---|
网域的 CNAME 记录缺失或不正确 | 自定义网域应具有指向 {orgname}-portal.apigee.net 的 CNAME 记录。否则,自定义网域配置将失败。 |
Edge 公有云用户 |
原因:网域的 CNAME 记录缺失或不正确
诊断
请按以下步骤诊断问题:
-
执行以下命令,查找自定义域名的 DNS 配置:
dig +noall +answer {custom-domain}
-
上述命令的输出应包含一条指向
{org}-portal.apigee.net
域名的 CNAME 记录。 例如:dig +noall +answer {custom-domain} {custom-domain} {TTL} IN CNAME {orgname}-portal.apigee.net.
-
如果命令的输出显示自定义网域没有 CNAME 记录或包含与
{org}-portal.apigee.net,
不匹配的 CNAME 记录,则这就是虚拟主机创建失败的原因。因此,系统会在 Edge 界面的自定义网域配置页面上向用户显示上述错误消息。
分辨率
如果自定义网域不包含指向 {orgname}-portal.apigee.net
的 CNAME 记录,请执行以下步骤来解决问题:
- 移除自定义网域 DNS 配置中的任何现有 CNAME 记录。
-
将 CNAME 记录添加到您的域名(您要在自定义网域页面使用)以指向
{orgname}-portal.apigee.net
。 -
在自定义网域配置页面中,从网域下拉菜单中选择特定的自定义域名(其 CNAME 记录指向
{orgname}-portal.apigee.net
)。 - 如果您已向密钥库上传了通配符证书,请执行以下操作:
- 从下拉菜单中选择域名,然后
- 填写正确的子域名
- 在集成式开发者门户自定义网域配置页面中配置密钥库、别名、域名。
- 点击保存。
如果问题仍然存在,请转到必须收集诊断信息。
必须收集的诊断信息
如果在按照上述说明操作后问题仍然存在,请收集以下诊断信息并将其分享给 Apigee Edge 支持:
- Apigee Edge Cloud 组织名称
- Apigee Edge Cloud 集成式开发者门户名称
- 在门户环境中创建的密钥库的名称
- 别名
- 自定义域名
- 捕获错误消息的自定义网域配置页面的屏幕截图