submitty/docker-test-saml-idp

模拟SAML身份提供商Docker镜像

镜像概述

该Docker镜像提供了一个容器化的模拟SAML（安全断言标记语言）身份提供商（Identity Provider, IdP），专为CI（持续集成）测试设计。它允许开发和测试团队在不依赖真实SAML身份提供商的情况下，验证应用程序的SAML认证流程，从而加速集成测试并降低外部依赖。

核心功能和特性

• SAML 2.0协议支持：完整模拟SAML 2.0身份提供商功能，包括断言生成、单点登录（SSO）流程
• 可定制配置：支持自定义实体ID、服务提供商（SP）断言消费者服务（ACS）URL、用户属性等
• 轻量级设计：基于精简基础镜像构建，启动速度快，资源占用低，适合CI环境
• 无状态运行：无需持久化存储，配置通过环境变量或命令行参数注入，便于CI/CD流水线集成
• 元数据端点：提供标准SAML元数据URL，支持服务提供商自动发现和配置

使用场景和适用范围

• CI/CD流水线集成测试：在自动化测试中验证应用对SAML认证的处理逻辑
• 开发环境调试：本地开发时模拟SAML登录流程，无需连接生产环境身份提供商
• SAML协议兼容性测试：验证应用对不同SAML响应格式、属性配置的兼容性
• 培训与演示：作为SAML协议教学或产品演示的临时身份提供商

使用方法和配置说明

基本运行方式

通过以下命令启动模拟SAML身份提供商容器：

bash
docker run -d -p 8080:8080 --name mock-saml-idp saml-mock-idp:latest

容器启动后，可通过http://localhost:8080访问模拟IdP控制台，通过http://localhost:8080/saml/idp/metadata获取SAML元数据。

环境变量配置

可通过环境变量自定义IdP行为，常用配置参数如下：

示例：自定义服务提供商ACS URL和用户信息

bash
docker run -d -p 8080:8080 \
  -e SP_ACS_URL="https://myapp.example.com/saml/acs" \
  -e USER_EMAIL="ci-test@example.com" \
  --name mock-saml-idp saml-mock-idp:latest

Docker Compose配置

在多服务测试环境中，可通过Docker Compose集成该镜像：

yaml
version: '3'
services:
  mock-idp:
    image: saml-mock-idp:latest
    ports:
      - "8080:8080"
    environment:
      - IDP_ENTITY_ID=urn:ci:mock:idp
      - SP_ACS_URL=http://webapp:3000/saml/acs
      - SP_ENTITY_ID=urn:ci:mock:sp
    networks:
      - test-network

  webapp:
    image: my-webapp:latest
    depends_on:
      - mock-idp
    environment:
      - SAML_IDP_METADATA_URL=http://mock-idp:8080/saml/idp/metadata
    networks:
      - test-network

networks:
  test-network:

集成验证

1. 启动容器后，从应用程序配置中指向IdP元数据URL（如http://mock-idp:8080/saml/idp/metadata）
2. 触发应用的SAML登录流程，系统将重定向至模拟IdP的登录页面
3. 直接点击"登录"按钮（无需输入凭据），模拟IdP将生成SAML响应并重定向回应用的ACS端点
4. 验证应用是否正确处理SAML断言并完成身份验证流程