在AEM as a Cloud Service中配置和验证专用出口IP
AEM as a Cloud Service中的专用出口IP配置让客户感到困惑,因为创建是在程序级别进行的,但只有在每个环境明确启用该IP后,它才会对出站流量处于活动状态。 专用IP绝不会出现在Cloud Manager UI中;它是通过DNS查找对程序的外部主机名进行检索的。 配置延迟和Cloud Manager配额错误加剧了这种混乱。 创建网络基础架构,在每个环境中启用它,通过DNS解析IP,并确认出站流量使用该IP完成有效的允许列表配置。
描述 description
问题:在AEM as a Cloud Service中找不到专用出口IP或不会路由出站流量
说明
在Cloud Manager中配置专用出口IP地址时,客户无法找到正确的配置UI,遇到意外的UI行为,或不确定如何检索最终出口IP以为外部系统允许列表。 Cloud Manager显示错误,如An error occurred while triggering network creation、Only one network infrastructure per program is allowed或NETWORK_INFRASTRUCTURES_EXCEEDS_LIMIT。 客户还需要验证AEM用于出站调用(HTTP/HTTPS或SMTP)的IP地址,尤其是防火墙或WAF 列入允许列表的IP地址。 当功能未在环境级别完全配置或尚未启用,或者项目级基础架构创建与环境级启用混淆时,会出现问题。
环境:
- Adobe Experience Manager as a Cloud Service (AEMaaCS)
- AEM Assets Essentials
- Cloud Manager(高级联网)
问题/症状:
- Cloud Manager显示错误,如
An error occurred while triggering network creation或Only one network infrastructure per program is allowed。 - 在UI中找不到专用出口IP地址,并且IP不会显示在Cloud Manager的任何位置。
- 由于无法识别的源IP,到第三方系统的出站连接被阻止,从而导致403/503错误或WAF拒绝。
- 专用出口IP基础结构似乎已创建,但出站流量未使用预期的源IP。
根本原因:
AEM as a Cloud Service使用Cloud Manager配置高级联网功能。 专用出口IP创建在程序级别进行,但是出站流量的IP在根据环境明确启用之前不处于活动状态。 专用IP未出现在UI中;相反,必须通过DNS查找对其进行解析。 对这些步骤的错误解释,再加上Cloud Manager UI差异和最多达一到两个小时的配置延迟,会导致混淆或出站失败。 尝试在一个程序中创建多个基础结构或超出配额时,会出现一些Cloud Manager错误。
如何确认
-
验证配置状态。 登录到Cloud Manager,选择您的项目,打开 环境 选项卡,然后在左侧边栏中选择网络基础架构。 显示 专用出口IP地址 的记录,其状态为 就绪 或正在设置。
-
使用本地DNS查找检索专用出口IP,将
{programId}替换为您的项目ID:code language-none dig +short p{programId}.external.adobeaemcloud.com
该命令返回单个公共IP地址。 如果记录返回为空,则配置尚未完成。
解决方法 resolution
-
创建专用出口IP基础架构。 在Cloud Manager中,转到环境
>网络基础架构>添加网络基础架构,选择专用出口IP地址,选择一个区域,然后单击保存。 此时会显示一个新条目,其状态将在大约15到60分钟内更改为就绪。 如果Cloud Manager返回An error occurred while triggering network creation或NETWORK_INFRASTRUCTURES_EXCEEDS_LIMIT,请解析权限或删除现有的基础结构,因为每个程序只允许一个网络基础结构。 -
在环境级别启用专用出口IP。 转到环境,选择特定环境(Dev/Stage/Prod),打开高级网络,启用网络基础结构,然后单击保存。 在网络基础结构下,确认 环境 列显示环境为已启用。 如果未更新,请确认您在环境级别对话框中按了保存。
-
检索专用出口IP并进行确认。 运行DNS查找并确认返回的IP与日志中显示的值或通过远程回显服务显示的值相匹配:
code language-none dig +short p{programId}.external.adobeaemcloud.com -
验证出站流量是否使用专用出口IP。 从AEM代码或使用系统代理属性的HTTP客户端,调用echo服务或您的目标系统,然后确认目标记录了
dig命令返回的相同IP。 确保客户端代码使用系统代理设置,如HttpClientBuilder.useSystemProperties()。 -
根据需要配置SMTP或其他非HTTP/HTTPS流量。 对于SMTP或自定义端口,请在Cloud Manager中提交
portForwardsJSON定义。 确认第三方日志,其中显示从专用IP到达的请求。 如果连接失败,请验证端口转发定义,并在基础结构达到就绪状态后重试。
验证
-
运行DNS查找并确认它返回预期的IP:
code language-none dig +short p{programId}.external.adobeaemcloud.com -
执行从AEM到回显服务的测试HTTP调用,并确认返回的IP与专用出口IP匹配。
-
确认第三方系统(SMTP、WAF、CRM等)现在可以从专用IP注册入站流量。