ConnectorsProxy
ConnectorsProxy 是一个核心组件,提供在 Kubernetes 集群内对集成工具的安全无凭证访问。它作为代理服务器,负责认证注入和请求路由到目标工具。
ConnectorsProxy 使客户端能够访问工具资源而无需直接处理凭证。这种方式带来了显著的安全优势:
- 无凭证访问:通过使用 ServiceAccount 签发的短期令牌,避免将工具凭证直接分发给客户端,防止凭证在客户端(如日志或环境变量)中暴露。
- 集中凭证管理:所有工具凭证由连接器集中管理,无需向每个客户端分发凭证。
平台支持内置和自定义代理实现,以满足多样化的工具认证需求。
目录
内置连接器代理正向代理反向代理自定义连接器代理连接器代理地址与 Connectors CSI Driver 配合使用深入理解 Connectors Proxy在 ConnectorClass 中指定代理Connectors Proxy 认证内置连接器代理
内置的 ConnectorsProxy 实现提供全面的 HTTP/HTTPS 协议支持,支持 Basic Auth 和 Bearer Token 认证方式。它同时支持正向代理和反向代理功能。
正向代理
作为标准 HTTP 代理,使用 http_proxy 和 https_proxy 环境变量。当代理接收到客户端请求时,它会:
- 认证客户端
- 如果当前请求路径指向连接器指定的目标工具,则在请求中注入连接器中指定的工具凭证
- 将认证后的请求转发到目标工具
反向代理
客户端通过直接连接连接器代理地址而非原始工具 URL 来访问工具。代理会:
- 在代理端点接收客户端请求
- 执行客户端认证
- 注入连接器指定的工具凭证并将请求转发到后端工具
自定义连接器代理
对于需要特殊认证机制的工具,可以开发自定义代理实现。根据具体需求,这些代理可以作为正向代理或反向代理实现。
示例:OCI Connector 使用自定义的 OCI 插件代理,支持带有 Bearer Token 授权的 OCI 协议,适用于 Harbor 和 Docker Registry 等注册中心。
用户可以开发自定义代理服务器,并在 connectorclass 中指定。
连接器代理地址
每个 Connector 都有唯一的代理地址,用于访问工具资源。代理地址存储在 status.proxy.httpAddress 字段:
客户端使用此代理地址访问连接器指定的工具中的资源。
有关 connectorclass 的更多字段,请参见 ConnectorClass
与 Connectors CSI Driver 配合使用
Connectors Proxy 与 Connectors CSI Driver 无缝协作,提供完整的无凭证访问解决方案:
- Connectors CSI Driver 挂载包含代理地址和代理认证信息的必要配置文件
Connectors Proxy处理认证注入和请求路由到目标工具- 客户端无需管理凭证即可访问资源
此集成在以下场景中特别有用:
- Kubernetes Job 中的 Git 克隆操作
- Tekton Pipelines 中的镜像推送/拉取操作
- 自定义工作负载中的 API 访问
有关使用 Connectors Proxy 和 Connectors CSI Driver 完成无凭证访问的完整场景,请参见 如何使用 Git Connector 完成无凭证的 Git 克隆
深入理解 Connectors Proxy
在 ConnectorClass 中指定代理
您可以在 ConnectorClass 中指定要使用的代理服务器:
由此 ConnectorClass 创建的连接器将使用 connectors-proxy-service 作为其真实代理服务器。
内置代理配置:
自定义代理配置:
自定义代理可以指向任何能够处理代理请求的地址。
Connectors Proxy 认证
使用 Connectors Proxy 时,客户端必须提供认证。认证使用 ServiceAccount 令牌,且该 ServiceAccount 必须具有目标 Connector 的读取权限。
内置正向代理认证
认证凭据通过 Proxy-Authorization 头传递:
- 用户名:
<connector-namespace>/<connector-name> - 密码:具有读取 Connector 权限的 ServiceAccount 令牌
示例:对于 default 命名空间下的 github Connector:
通过此代理的请求在访问 GitHub 服务时会自动注入 default/github 连接器的认证凭据。
内置反向代理认证
认证凭据通过 Basic Auth 传递:
- 用户名:任意值
- 密码:具有读取 Connector 权限的 ServiceAccount 令牌
示例:对于 default 命名空间下的 github Connector:
代理在转发请求到 GitHub 服务时会自动注入 default/github 连接器的认证凭据。