stefaanvermassen/aad-apache

stefaanvermassen/aad-apache镜像说明

镜像概述

本镜像基于官方httpd镜像构建，集成了Azure Active Directory（AAD）的SAML 2.0认证功能，帮助Web应用快速实现与AAD的单点登录（SSO）集成，简化企业级Web服务的身份管理流程，同时保留httpd原生的Web服务能力。

核心功能

1. AAD SAML集成：支持通过SAML 2.0协议与Azure AD进行身份验证，实现企业用户的单点登录。
2. 原生Web服务：保留httpd的所有基础功能，可直接部署静态资源或动态Web应用。
3. 配置灵活性：允许通过环境变量或挂载配置文件自定义SAML参数（如元数据URL、实体ID等），适配不同AAD租户需求。

使用场景

1. 企业内部Web应用需要通过Azure AD进行身份验证的场景。
2. 部署需要SSO功能的公共或私有Web服务，提升用户登录体验与安全性。
3. 替换传统用户名密码认证方式，降低账号管理成本与安全风险。

配置说明

需配置以下关键参数（通过环境变量或配置文件实现）：

• AAD_SAML_METADATA_URL：Azure AD租户的SAML元数据地址（格式：https://login.microsoftonline.com/[租户ID]/federationmetadata/2007-06/federationmetadata.xml）。
• AAD_SAML_ENTITY_ID：应用的SAML实体ID（通常为应用的公开访问URL）。
• 其他可选参数：如SAML断言消费者服务URL、证书路径等（具体参考镜像文档）。

部署示例

Docker Run命令

bash
docker run -d -p 80:80 \
  -e AAD_SAML_METADATA_URL="https://login.microsoftonline.com/your-tenant-id/federationmetadata/2007-06/federationmetadata.xml" \
  -e AAD_SAML_ENTITY_ID="http://your-app-domain.com" \
  docker.xuanyuan.run/stefaanvermassen/aad-apache

Docker Compose配置

yaml
version: '3.8'
services:
  aad-apache:
    image: stefaanvermassen/aad-apache
    ports:
      - "80:80"
    environment:
      - AAD_SAML_METADATA_URL=[***]
      - AAD_SAML_ENTITY_ID=[***]
    volumes:
      - ./custom-apache-conf:/usr/local/apache2/conf # 挂载自定义Apache配置（可选）