Satosa 是一个高度可配置的 Python 实现的身份代理
2025-05-16
2
参考资料
Satosa 详细简介
Satosa 是一个高度可配置的 Python 实现的身份代理(Proxy),用于 SAML、OIDC 和其他身份协议之间的协议转换和集成。
特点
支持多协议转换(如 SAML ↔ OIDC)
模块化设计,易于扩展
支持插件机制(前端、后端、中间件)
提供 REST API 和 Admin UI
最新更新内容及时间
最新版本:
v8.0.0
(2023年发布)更新内容:
支持 Python 3.10+
改进 OIDC 后端功能
修复安全漏洞
镜像下载地址
Docker Hub:
https://hub.docker.com/r/identitypython/satosa
官网地址
官网:
https://satosa.github.io/
文档地址
官方文档:
https://satosa.readthedocs.io/
Docker 安装示例
docker pull identitypython/satosa:latest docker run -d -p 8080:8080 identitypython/satosa
YAML 设置教程
创建
proxy_conf.yaml
文件:
BASE: "https://satosa.example.com" SERVER_NAME: "satosa.example.com" STATE_ENCRYPTION_KEY: "your_encryption_key"
配置 SAML/OIDC 后端:
backend_config: saml2: config: sp_config: metadata: local: ["/path/to/metadata.xml"]
常用错误问题
"Invalid metadata"
检查 SAML/OIDC 元数据文件路径是否正确。
"State encryption failed"
确保
STATE_ENCRYPTION_KEY
配置正确且足够长。"Missing required attribute"
检查身份提供者(IdP)返回的属性是否匹配配置。
Docker 容器启动失败
检查端口是否冲突(默认 8080)。
声明:本站所有文章资源内容,如无特殊说明或标注,均为采集网络资源。如若本站内容侵犯了原著者的合法权益,可联系本站删除。