spectare/oidc-token-test-service

OIDC令牌模拟测试服务

镜像概述

已弃用 - 请访问 https://hub.docker.com/repository/docker/spectare/fakeidp 获取最新版本。

本镜像提供一个基于HTTP(S)的OIDC令牌模拟服务，包含有效的密钥和发现端点，允许根据自定义声明生成JWT令牌，主要用于开发和测试环境中模拟OIDC身份提供商(IdP)的行为。

核心功能和特性

• 提供HTTP(S)服务端点，包含有效的密钥和OIDC发现端点
• 支持根据自定义声明集生成JWT令牌
• 提供/userinfo端点，可返回令牌中包含的用户信息
• 可通过环境变量配置服务绑定地址和端口

使用场景和适用范围

• OIDC客户端应用开发测试
• 验证JWT令牌处理逻辑
• 模拟用户认证流程
• 测试依赖OIDC身份验证的系统组件

使用方法和配置说明

基本运行方式

bash
docker run -p 9090:9090 -e BIND=0.0.0.0 -e PORT=9090 -e EXPOSED_HOST=http://localhost:9090 spectare/oidc-token-test-service:latest

环境变量说明

注意：需要将容器内端口映射到主机，并确保暴露所选择的端口。

生成JWT令牌示例

1. 创建包含自定义声明的JSON文件（如claim.json）：

json
{
  "iss": "http://localhost:9090/mock",
  "sub": "CgVhZG1pbhIFbG9jYWw",
  "aud": "cafienne-ui",
  "exp": 1576568495,
  "iat": 1576482095,
  "at_hash": "zqKhL-sV6TNJUFQSF7PwLQ",
  "email": "admin@example.com",
  "email_verified": true,
  "name": "admin"
}

2. 向/token端点发送POST请求生成令牌：

bash
curl -d "@claim.json" -X POST http://`hostname -f`:9090/token

userinfo端点使用

1. 使用上述方法生成JWT令牌
2. 向/userinfo端点发送GET请求，包含Authorization头：

bash
curl -H "Authorization: Bearer <生成的令牌>" http://`hostname -f`:9090/userinfo

支持的用户信息字段

userinfo端点返回的信息基于令牌中的声明，目前支持以下字段：

• name：用户名
• email：用户***
• email_verified：***是否已验证

此外，iss（发行者）和sub（主题）是生成令牌的必填字段，用于验证过程。