cirrusid/simplesamlphp

SimpleSAMLphp

镜像概述和主要用途

本镜像预配置了Apache 2.4、PHP 8.3和SimpleSAMLphp（SSP），旨在简化单点登录（SSO）服务的部署与集成。通过灵活的配置选项，用户可快速搭建SSO环境，适用于开发、测试及生产环境中需要SSO功能的场景。

核心功能和特性

• 多方式配置控制：支持通过环境变量、挂载自定义配置文件与证书、运行时启用SSP模块及安装Composer模块调整镜像行为
• 预安装依赖：默认安装多种PHP扩展，简化与LDAP和数据库的集成
• 灵活的Apache映射：可通过环境变量调整Apache对SSP的路径映射
• 标准目录结构：遵循SSP官方推荐的目录布局，便于维护和扩展

使用场景和适用范围

• 开发环境快速启动：无需手动配置Apache、PHP和SSP，快速搭建本地SSO测试环境
• SSO集成测试：支持灵活调整配置，适配不同身份提供商（IdP）和服务提供商（SP）的集成测试
• 生产环境基础镜像：可作为基础镜像，通过Dockerfile定制化配置后用于生产环境部署

详细使用方法和配置说明

环境变量配置

示例：修改SSP访问路径为/sso

bash
docker run -e SSP_APACHE_ALIAS=/sso cirrusidentity/simplesamlphp

挂载自定义配置

通过挂载本地配置目录到容器内SSP配置目录，实现自定义配置：

bash
docker run -v ./local-config:/var/simplesamlphp/config -v ./local-cert:/var/simplesamlphp/cert cirrusidentity/simplesamlphp

运行时启用SSP模块

可通过挂载模块目录或在自定义Dockerfile中启用所需模块，例如：

dockerfile
FROM cirrusidentity/simplesamlphp
RUN touch /var/simplesamlphp/modules/example/enable

安装Composer模块

运行时可通过执行Composer命令安装依赖：

bash
docker exec -it <container-id> composer require some/package --working-dir=/var/simplesamlphp

默认设置

• SSP安装路径：/var/simplesamlphp，Apache将/simplesaml路径别名映射到SSP的public文件夹
• 默认文档根目录：/var/www
• 预安装PHP扩展：包含LDAP、数据库等常用扩展，简化外部服务集成
• 灵活的路径调整：通过SSP_APACHE_ALIAS环境变量可自定义SSP的访问路径