外部集成
外接调用 User-Agent 说明
了解外部客户端何时应发送可识别的 User-Agent 以及如何对请求头策略进行故障排除。
什么时候需要 User-Agent
OmniGateway 并不要求每个客户端都伪装成其他产品。然而,配置的上游或访问策略可能需要可识别的客户端 User-Agent。
仅当您选择的路线记录了要求时才启用或自定义此请求头。保持值稳定,以便请求日志保持可诊断性。
按此顺序配置请求头
- 首先设置正确的授权请求头并验证 401 不是由 API 密钥引起的。
- 在添加可选请求头之前确认协议和基本 URL。
- 启用发送其标准 User-Agent 的客户端选项,或者添加自定义值(如果路由需要)。
- 重新启动客户端并测试最小请求。
Authorization: Bearer $OMNIGATEWAY_API_KEYUser-Agent: your-client/version解决与请求头相关的故障
- 401 通常表示身份验证,而不是 User-Agent 策略。
- 身份验证成功后的 403 可以指示令牌组或上游策略限制。
- 除非客户端协议需要,否则不要同时发送
x-api-key和 Bearer 身份验证。 - 切换提供商时删除旧的代理请求头,以便旧凭据不会转发。