nttoan26/kong-oidc

nttoan26/kong-oidc 镜像说明

镜像概述

本镜像基于Kong API网关，集成了revomatico/kong-oidc（v1.2.3-1）和BGaunitz/kong-plugin-jwt-keycloak（1.1.0-1）两个插件，旨在为API服务提供身份验证与授权能力。

核心功能

1. OpenID Connect（OIDC）认证：支持通过OIDC协议与身份提供商（如Keycloak、Auth0等）集成，实现用户身份验证。
2. JWT-Keycloak验证：针对Keycloak签发的JWT令牌进行验证，确保API请求的合法性。

使用场景

• 企业内部API服务的身份认证与权限控制。
• 需要与Keycloak或其他OIDC提供商集成的API网关场景。
• 对API访问进行细粒度授权管理的场景。

配置说明

1. 启用插件：通过Kong Admin API启用oidc和jwt-keycloak插件。
2. OIDC配置：设置OIDC的issuer URL、客户端ID、客户端密钥等参数。
3. JWT-Keycloak配置：配置Keycloak的公钥地址、令牌验证规则等。

部署示例

Docker Run命令

bash
docker run -d \
  -p 8000:8000 \
  -p 8443:8443 \
  -p 8001:8001 \
  -e KONG_PLUGINS=oidc,jwt-keycloak \
  docker.xuanyuan.run/nttoan26/kong-oidc

启用插件示例（通过Kong Admin API）

bash
# 启用oidc插件
curl -X POST http://localhost:8001/plugins \
  -d "name=oidc" \
  -d "config.issuer=[***]" \
  -d "config.client_id=your-client-id" \
  -d "config.client_secret=your-client-secret"

# 启用jwt-keycloak插件
curl -X POST http://localhost:8001/plugins \
  -d "name=jwt-keycloak" \
  -d "config.keycloak_url=[***]" \
  -d "config.realm=your-realm"