在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 creationOnly one network infrastructure per program is allowedNETWORK_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 creationOnly 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错误。

如何确认

  1. 验证配置状态。 登录到Cloud Manager,选择您的项目,打开 环境 选项卡,然后在左侧边栏中选择网络基础架构。 显示 专用出口IP地址 的记录,其状态为​ 就绪 ​或​正在设置

  2. 使用本地DNS查找检索专用出口IP,将{programId}替换为您的项目ID:

    code language-none
    dig +short p{programId}.external.adobeaemcloud.com
    

该命令返回单个公共IP地址。 如果记录返回为空,则配置尚未完成。

解决方法 resolution

  1. 创建专用出口IP基础架构。 在Cloud Manager中,转到环境>网络基础架构>添加网络基础架构,选择专用出口IP地址,选择一个区域,然后单击保存。 此时会显示一个新条目,其状态将在大约15到60分钟内更改为​就绪。 如果Cloud Manager返回An error occurred while triggering network creationNETWORK_INFRASTRUCTURES_EXCEEDS_LIMIT,请解析权限或删除现有的基础结构,因为每个程序只允许一个网络基础结构。

  2. 在环境级别启用专用出口IP。 转到环境,选择特定环境(Dev/Stage/Prod),打开高级网络,启用网络基础结构,然后单击保存。 在网络基础结构下,确认 环境 列显示环境为​已启用。 如果未更新,请确认您在环境级别对话框中按了保存

  3. 检索专用出口IP并进行确认。 运行DNS查找并确认返回的IP与日志中显示的值或通过远程回显服务显示的值相匹配:

    code language-none
    dig +short p{programId}.external.adobeaemcloud.com
    
  4. 验证出站流量是否使用专用出口IP。 从AEM代码或使用系统代理属性的HTTP客户端,调用echo服务或您的目标系统,然后确认目标记录了dig命令返回的相同IP。 确保客户端代码使用系统代理设置,如HttpClientBuilder.useSystemProperties()

  5. 根据需要配置SMTP或其他非HTTP/HTTPS流量。 对于SMTP或自定义端口,请在Cloud Manager中提交portForwards JSON定义。 确认第三方日志,其中显示从专用IP到达的请求。 如果连接失败,请验证端口转发定义,并在基础结构达到就绪状态后重试。

验证

  1. 运行DNS查找并确认它返回预期的IP:

    code language-none
    dig +short p{programId}.external.adobeaemcloud.com
    
  2. 执行从AEM到回显服务的测试HTTP调用,并确认返回的IP与专用出口IP匹配。

  3. 确认第三方系统(SMTP、WAF、CRM等)现在可以从专用IP注册入站流量。

相关阅读

recommendation-more-help
experience-cloud-kcs-help-kbarticles