spideroak/docker-oidc-proxy

evry/oidc-proxy

镜像概述

本Docker镜像用于OpenID Connect（OIDC）代理认证，可将后端服务置于Keycloak等OIDC认证提供商之后，实现安全的身份验证。镜像基于Nginx反向代理和OpenResty，并使用lua-resty-openidc库处理OIDC认证流程。

核心功能

• 支持OpenID Connect协议的认证代理
• 兼容Keycloak等主流OIDC认证服务
• 通过环境变量配置，无需修改配置文件
• 基于Nginx和OpenResty实现高性能代理

使用场景

• 需要为未自带OIDC认证的后端服务添加身份验证保护
• 企业内部服务的统一身份认证管理
• SaaS应用的第三方OIDC认证集成

配置说明

镜像通过以下环境变量进行配置：

• OID_SESSION_SECRET：Cookie会话的密钥值
• OID_SESSION_CHECK_SSI：是否检查SSI（取值on或off）
• OID_SESSION_NAME：Cookie会话名称
• OID_REDIRECT_PATH：认证后的重定向路径
• OID_DISCOVERY：OIDC提供商的well-known发现URL
• OID_CLIENT_ID：OIDC客户端ID
• OID_CLIENT_SECRET：OIDC客户端密钥
• PROXY_HOST：待代理服务的主机名
• PROXY_PORT：待代理服务的端口
• PROXY_PROTOCOL：待代理服务的协议（http或https）

部署示例

bash
docker run \
  -e OID_DISCOVERY=https://my-auth-server/auth \
  -e OID_CLIENT_ID=my-client \
  -e OID_CLIENT_SECRET=my-secret \
  -e PROXY_HOST=my-service \
  -e PROXY_PORT=80 \
  -e PROXY_PROTOCOL=http \
  -p 80:80 \
  docker.xuanyuan.run/evry/oidc-proxy

许可证

本Docker镜像遵循https://github.com/evry/docker-oidc-proxy/blob/master/LICENSE。
镜像中包含的软件许可证如下：

• docker-openresty：https://github.com/openresty/docker-openresty/blob/master/COPYRIGHT
• lua-resty-http：https://github.com/bungle/lua-resty-http/blob/master/LICENSE
• lua-resty-jwt：https://github.com/pingidentity/lua-resty-jwt/blob/master/LICENSE.txt
• lua-resty-openidc：https://github.com/pingidentity/lua-resty-openidc/blob/master/LICENSE.txt
• lua-resty-session：https://github.com/bungle/lua-resty-session/blob/master/LICENSE

支持的Docker版本

本镜像官方支持Docker 1.12版本，对1.0及以上旧版本提供尽力支持。

用户反馈

文档参考

• http://docs.docker.com
• http://nginx.org/en/docs/
• http://openresty.org/
• https://github.com/pingidentity/lua-resty-openidc#readme

问题反馈

若遇到问题或有疑问，请通过https://github.com/evry/docker-oidc-proxy/issues联系我们。

贡献指南

欢迎贡献新功能、修复或更新，无论大小。建议在编码前通过GitHub Issues讨论计划，以便获得指导和反馈。