jefferyb/shibboleth-sp

jefferyb/shibboleth-sp

Shibboleth服务提供商（SP）镜像，可作为反向代理放置在需要保护的服务前端，实现身份认证与访问控制，适用于需单点登录（SSO）或身份验证的场景。

支持的标签

• latest（对应https://github.com/jefferyb/docker-shibboleth-sp/blob/master/Dockerfile%EF%BC%89

环境变量

基础配置

• HOSTNAME：默认"localhost"，服务的主机名。

Apache相关

• SERVICE_TO_PROTECT：默认"localhost"，需保护的后端服务地址。
• SERVICE_PORT：默认"80"，需保护的后端服务端口。

Shibboleth相关

• IDP_ENTITY_ID：默认"[***]"，身份提供商（IDP）实体ID。
• IDP_METADATA_URL：默认"[***]"，IDP元数据URL。
• SUPPORT_EMAIL：默认"root@localhost"，支持***。
• SHIB_METADATA_BACKUP_URL：默认"[***]"，元数据备份URL。
• SHIB_DOWNLOAD_METADATA：默认true，是否自动下载元数据。

端口

• 80（HTTP）
• 443（HTTPS）

配置说明

Apache证书设置

• 证书名称：ssl.key（私钥）、ssl.crt（证书）
• 位置：/etc/apache2/ssl/
• 步骤：
  1. 获取或生成证书（自签名或权威证书）。
  2. 通过Dockerfile复制或挂载证书：

     Dockerfile
     COPY etc/apache2/ssl/ssl.key /etc/apache2/ssl/ssl.key
     COPY etc/apache2/ssl/ssl.crt /etc/apache2/ssl/ssl.crt
     

Shibboleth证书设置

• 证书名称：sp-key.pem（私钥）、sp-cert.pem（证书）
• 位置：/etc/shibboleth/
• 步骤：
  1. 生成证书：

     bash
     HOSTNAME='example.com'
     shib-keygen -f -u _shibd -h ${HOSTNAME} -y 7 -e https://${HOSTNAME}/shibboleth -o etc/shibboleth/
     

  2. 复制或挂载证书到指定目录。

部署示例

Docker部署

bash
# 启动后端服务（Tomcat示例）
docker run -d --name tomcat-server tomcat

# 启动Shibboleth SP
docker run -d \
  --name shibboleth-sp \
  --link tomcat-server \
  -e SERVICE_TO_PROTECT='tomcat-server' \
  -e SERVICE_PORT='8080' \
  -e HOSTNAME=example.com \
  -e IDP_ENTITY_ID=https://samltest.id/saml/idp \
  -e IDP_METADATA_URL=https://samltest.id/saml/idp \
  -e SUPPORT_EMAIL=root@localhost \
  -e SHIB_METADATA_BACKUP_URL=https://samltest.id/saml/idp \
  -e SHIB_DOWNLOAD_METADATA=true \
  -p 80:80 \
  -p 443:443 \
  jefferyb/shibboleth-sp

访问https://example.com将重定向到Shibboleth登录页面。

Docker Compose部署

yaml
version: '2'
services:
  tomcat-server:
    image: tomcat
  shibboleth-sp:
    image: jefferyb/shibboleth-sp
    container_name: shibboleth-sp
    environment:
      - SERVICE_TO_PROTECT=tomcat-server
      - SERVICE_PORT=8080
      - HOSTNAME=example.com
      - IDP_ENTITY_ID=https://samltest.id/saml/idp
      - IDP_METADATA_URL=https://samltest.id/saml/idp
      - SUPPORT_EMAIL=root@localhost
      - SHIB_METADATA_BACKUP_URL=https://samltest.id/saml/idp
      - SHIB_DOWNLOAD_METADATA=true
    ports:
      - 80:80
      - 443:443
    restart: always
    links:
      - tomcat-server

运行：docker-compose pull && docker-compose up -d，访问https://example.com即可使用。