nagyesta/assumed-identity Docker 镜像 - 轩辕镜像

!AssumedIdentity

Assumed Identity Docker镜像文档

镜像概述和主要用途

Assumed Identity是一个简单的测试替身，用于模拟Azure实例元数据服务（Instance MetaData Service）处理托管身份令牌的方式。当Docker容器在169.254.169.254IP上启动时，本地执行的测试可以保持与生产代码相同的身份验证方法（假设生产代码使用托管身份令牌）。

核心功能和特性

• 模拟Azure托管身份令牌提供机制
• 支持使用169.254.169.254IP地址模拟真实服务环境
• 可通过环境变量配置自定义端口，避免与云环境中真实元数据服务冲突
• 提供符合标准格式的假令牌响应，包含访问令牌、过期时间等字段

使用场景和适用范围

• 本地开发环境中测试依赖Azure托管身份认证的应用程序
• 在云托管虚拟机（VM）上进行测试时，避免与真实的Azure实例元数据服务冲突
• 需要保持测试环境与生产环境身份验证流程一致性的场景

使用方法和配置说明

在开发机器上启动容器

Assumed Identity需要使用169.254.169.254IP来模拟真实的托管身份机制与假令牌提供器。为此，需先创建合适的Docker网络：

bash
# 一次性设置
docker network create --subnet=169.254.169.0/24 assumed-id

然后在运行容器时指定正确的IP：

bash
docker run --net assumed-id --ip 169.254.169.254 --rm nagyesta/assumed-identity:<version>

可用版本列表请参见此处。

容器启动后，可通过访问以下URL进行测试： http://169.254.169.254/metadata/identity/oauth2/token?api-version=2018-02-01&resource=https://localhost/

预期响应示例：

json
{"access_token":"dummy","expires_in":***,"expires_on":***,"refresh_token":"dummy","resource":"https://localhost/","token_type":"Bearer"}

在云托管VM上启动容器

默认配置（如上述使用部分所述）在云VM上无法工作，因为云VM使用169.254.169.254IP作为提供实例元数据的真实服务。作为解决方法，可使用默认自动分配的IP启动Assumed Identity容器，并通过环境变量配置非默认端口。例如：

bash
docker run -e ASSUMED_ID_PORT=8080 -p 8080:8080 --rm nagyesta/assumed-identity:<version>

可用版本列表请参见此处。

容器启动后，可通过访问以下URL进行测试： http://localhost:8080/metadata/identity/oauth2/token?api-version=2018-02-01&resource=https://localhost/

预期响应示例：

json
{"access_token":"dummy","expires_in":***,"expires_on":***,"refresh_token":"dummy","resource":"https://localhost/","token_type":"Bearer"}

确认Assumed Identity实例工作正常后，可根据应用程序的语言和客户端实现，添加相应的环境变量来配置被测应用使用该实例。具体配置示例可参考Lowkey Vault的示例项目。

Git仓库

更多信息请访问GitHub仓库！