xiaopal/kube-oidc-proxy

镜像概述

xiaopal/kube-oidc-proxy是一款为Kubernetes Dashboard提供OpenID Connect（OIDC）登录代理的工具，旨在通过标准化的身份验证协议提升Kubernetes集群管理的安全性与便捷性。

核心功能

1. OIDC登录代理：对接Kubernetes Dashboard，提供基于OIDC的身份验证入口；
2. 会话管理：集中存储与管理用户会话信息；
3. Token自动刷新：通过刷新access-token，自动更新过期的id-token，避免频繁重新登录。

使用场景

适用于Kubernetes集群环境中，需要为Kubernetes Dashboard添加OIDC身份验证机制的场景，尤其适合企业级集群的安全管理需求。

配置说明

需通过环境变量配置以下关键参数：

• OIDC_ISSUER：OIDC服务提供者的地址；
• OIDC_CLIENT_ID：OIDC客户端ID；
• OIDC_CLIENT_SECRET：OIDC客户端密钥；
• PROXY_PASS：代理目标地址（如Kubernetes Dashboard的访问地址）；
• SESSION_REDIS：存储会话信息的Redis服务地址。

部署示例

生产部署

bash
docker run -it --rm -p 80:80 \
-e OIDC_ISSUER='https://your-oidc-issuer.com' \
-e OIDC_CLIENT_ID='your-client-id' \
-e OIDC_CLIENT_SECRET='your-client-secret' \
-e PROXY_PASS='http://127.0.0.1:9090' \
-e SESSION_REDIS='172.17.0.2' \
xiaopal/kube-oidc-proxy:latest

开发测试

bash
# 构建镜像
docker build -t kube-oidc-proxy:test .

# 运行测试容器
docker run -it --rm --name kube-oidc-proxy --network host \
-e OIDC_ISSUER='[***] \
-e OIDC_CLIENT_ID='test-client-id' \
-e OIDC_CLIENT_SECRET='test-client-secret' \
-e PROXY_PASS='[***] \
kube-oidc-proxy:test