您正在查看 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 记录缺失或不正确
诊断
请按照以下步骤诊断问题:
-
执行以下命令,查找自定义网域名称的 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。 -
在自定义网域配置页面的网域 的下拉菜单中,选择特定的自定义网域名称(具有指向
{orgname}-portal.apigee.net的 CNAME 记录)。 - 如果您已将通配符证书上传到密钥库,请执行以下操作:
- 从下拉菜单中选择网域名称,然后
- 填写正确的子网域名称
- 在集成式开发者门户自定义网域配置页面中配置密钥库、 别名和网域名称。
- 点击保存 。
如果问题仍然存在,请转到 必须收集诊断信息。
必须收集的诊断信息
如果按照上述说明操作后问题仍然存在,请收集以下诊断 信息并与 Apigee Edge 支持团队分享:
- Apigee Edge Cloud 组织名称
- Apigee Edge Cloud 集成式开发者门户名称
- 在门户环境中创建的密钥库的名称
- 别名
- 自定义网域名称
- 自定义网域配置页面的屏幕截图,其中包含错误消息