Akamai (BYOCDN)
此配置将代理式流量(来自 AI 机器人和 LLM 用户代理的请求)路由到 Edge Optimize 后端服务(live.edgeoptimize.net)。 人类访客和 SEO 机器人仍将照常从您的源站获得响应。 完成设置后,可在响应中查找头部 x-edgeoptimize-request-id 以测试配置是否成功。
先决条件
在配置 Akamai 属性管理器规则之前,请确保您已具备以下条件:
- 可以为您的域访问 Akamai 属性管理器。
- 从Edge UI检索到Adobe Brand Visibility优化API密钥。 有关步骤,请参阅检索您的 API 密钥。
- (可选)要测试暂存路由,请参阅暂存 API 密钥。
设置选项
可通过两种方式在Edge上为Akamai配置以进行优化:
- 选项1:Adobe Brand Visibility中的引导式设置(推荐) — 使用Adobe Brand Visibility部署路由配置。
- 选项2:手动设置 — 在Akamai属性管理器中配置路由。
选项1:Adobe Brand Visibility中的引导式设置
引导式设置要求您自己的Akamai帐户中具有Akamai EdgeGrid API客户端,该客户端具有 属性管理器(PAPI) — 读 — 写 目标属性的组和合同访问权限,以及在Akamai暂存和生产环境中激活属性版本的权限。 Adobe Brand Visibility仅将这些凭据用于设置,不会存储它们。
准备Akamai EdgeGrid API客户端
如果您还没有合适的API客户端,请在Akamai控制中心创建一个:
- 打开管理>身份和访问。
- 在 用户和API客户端 上,选择创建API客户端。
- 选择我自己,然后选择高级。 将客户端限制为属性管理器(PAPI) — READ-WRITE,仅保留目标组和合同,并确认在暂存和生产环境中激活的权限。
- 创建客户端,然后立即下载或复制凭据文件。 您需要客户端密钥、API主机、访问令牌和客户端令牌。 客户端密钥只显示一次。
部署路由配置
- 为要配置的URL打开CDN配置。
- 在 将优化部署到AI代理 中,根据需要选择启用。
- 选择在Akamai (Beta)中部署路由。
- 粘贴EdgeGrid凭据文件,或分别输入客户端密钥、API主机、访问令牌和客户端令牌,然后连接。
- 选择Akamai资产,审查建议的更改,然后按照引导式步骤进行部署。 在激活新资产版本之前获得批准。
从Adobe Brand Visibility在Akamai中
选项 2:手动设置
使用以下步骤可手动配置Akamai属性管理器规则。
配置
以下 Akamai 属性管理器规则可将代理式 HTML 页面流量路由至 Edge Optimize。 该配置包括以下步骤:
1. 设置路由条件(用户代理和 HTML 流量匹配)
为以下用户代理设置路由:
*AdobeEdgeOptimize-AI*
*ChatGPT-User*
*GPTBot*
*OAI-SearchBot*
*PerplexityBot*
*Perplexity-User*
*ClaudeBot*
*Claude-User*
*Claude-SearchBot*
html 和 EMPTY_STRING。 如果您的网站通过其他 URL 模式提供 HTML,或包含无扩展名的非页面路由(如 API 端点),请通过添加基于路径的条件来优化该规则。
2. 设置源站和 SSL 行为
将源站设置为 live.edgeoptimize.net,将 SAN 与 *.edgeoptimize.net 匹配
3. 设置缓存键变量
将缓存键变量 PMUSER_EDGE_OPTIMIZE_CACHE_KEY 设置为 LLMCLIENT=TRUE;X_FORWARDED_HOST={{builtin.AK_HOST}}
4. 缓存规则
5. 修改传入请求标头
将以下传入请求标头:x-edgeoptimize-api-key 设置为从 LLMO 检索到的 API 密钥x-edgeoptimize-config 设置为 LLMCLIENT=TRUE;x-edgeoptimize-url 设置为 {{builtin.AK_URL}}
允许 Optimize at Edge 通过防火墙规则(可选)
如果您的CDN使用WAF或机器人管理器:
-
在WAF或机器人管理器中允许列表
*AdobeEdgeOptimize/1.0*用户代理,以便Edge上的优化服务可以获取您的源内容。 -
如果您的防火墙需要用户代理以外的其他验证,请生成密钥(例如,
openssl rand -hex 32)并:- 将带有密码的
x-edgeoptimize-fetcher-key添加到您的路由规则中其他x-edgeoptimize-*标头旁边。 - 添加WAF或机器人管理器规则,以允许请求
x-edgeoptimize-fetcher-key与同一密码匹配。
- 将带有密码的
-
在Edge中优化会按原样转发此标头 — 您拥有完整的密钥生命周期。
*AdobeEdgeOptimize/1.0*用户代理和 x-edgeoptimize-fetcher-key 标头列入允许列表。6. 修改传入响应标头
7. 缓存 ID 修改
8. 更改传出请求头
将 x-forwarded-host 头部设置为 {{builtin.AK_HOST}}
9. 站点故障转移
站点故障转移配置包含两个部分:一是在 Optimize at Edge 主路由规则中配置故障转移行为;二是配置一个同级规则,在发生回退时添加响应头。
9a. 配置站点故障转移行为
在 Optimize at Edge 主路由规则中,创建一个名为 站点故障切换行为 的子规则。 将其设置为匹配任意条件,并添加以下条件:
- 响应状态代码位于
400到599范围内。 - 源站超时为
Yes。
9b. 配置故障转移响应标头规则
| code language-none |
|---|
|
网站故障转移可确保当 Edge Optimize 返回错误或发生超时时,Akamai 会为您的原始主机名重新创建请求,从而使访客仍能收到网站的正常响应。
2XX 或 3XXx-edgeoptimize-request-id。4XX-5XX,或源站发生超时x-edgeoptimize-fo: true。验证设置
完成设置后,验证机器人流量是否被路由到 Edge Optimize,以及人类流量是否不受影响。
1. 测试机器人流量(应被优化)
用代理式用户代理模拟 AI 机器人请求:
curl -svo /dev/null https://www.example.com/page.html \
--header "user-agent: chatgpt-user"
成功的响应包括 x-edgeoptimize-request-id 头部,用于确认请求是通过 Edge Optimize 路由的:
< HTTP/2 200
< x-edgeoptimize-request-id: 50fce12d-0519-4fc6-af78-d928785c1b85
2. 测试人类流量(不应受影响)
模拟一个常规的人类浏览器请求:
curl -svo /dev/null https://www.example.com/page.html \
--header "user-agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36"
响应 不 应包含 x-edgeoptimize-request-id 头部。 页面内容和响应时间应保持与启用 Optimize at Edge 之前时完全相同。
3. 如何区分这两种场景
x-edgeoptimize-request-idx-edgeoptimize-fotrue)也可以在Adobe Brand Visibility UI中查看流量路由的状态。 导航到 客户配置 并选择 CDN配置 选项卡。
要进一步了解Edge优化,包括可用的机会、自动优化工作流和常见问题,请返回Edge优化概述。