nagyesta/assumed-identity

!https://raw.githubusercontent.com/nagyesta/assumed-identity/main/.github/assets/AssumedIdentity-Logo-512.png

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>

可用版本列表请参见https://hub.docker.com/r/nagyesta/assumed-identity/tags%E3%80%82

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

预期响应示例：

json
{"access_token":"dummy","expires_in":172800,"expires_on":1693250639,"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>

可用版本列表请参见https://hub.docker.com/r/nagyesta/assumed-identity/tags%E3%80%82

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

预期响应示例：

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

确认Assumed Identity实例工作正常后，可根据应用程序的语言和客户端实现，添加相应的环境变量来配置被测应用使用该实例。具体配置示例可参考Lowkey Vault的https://github.com/nagyesta/lowkey-vault#example-projects%E3%80%82

Git仓库

更多信息请访问https://github.com/nagyesta/assumed-identity/tree/main%EF%BC%81