tachybase_todo/packages/plugins/@tachybase/plugin-saml/README.zh-CN.md

1.6 KiB
Raw Blame History

SAML

提供SAML2.0 SSO登录功能。

依赖

  • @tachybase/auth 认证插件,提供认证相关功能,表、模型、函数复用等。

使用方法

以Google WorkSpace IdP为例

将Google设置为IdP

Google管理控制台 - 应用 - Web应用和移动应用

进行应用设置之后,复制SSO网址实体ID证书

在Tachybase上新增认证器

插件设置 - 认证 - 新增 - SAML

将刚才复制的信息依次进行填写

  • SSO URL: SSO网址
  • Public Certificate: 证书
  • idP Issuer: 实体id
  • http: 如果是本地http测试可以勾选

之后复制Usage中的SP Issuer/EntityIDACS URL.

在Google上填写SP信息

回到Google控制台服务提供商详细信息页面输入刚才复制的ACS网址和实体ID并勾选已签署响应

属性映射位置添加映射映射对应属性Tachybase可供映射的字段有

  • email必填
  • phone (仅对scope支持phone的平台生效如阿里云)
  • nickname
  • username
  • firstName
  • lastName

用户名使用规则优先级: nickname > username > firstName lastName > nameID

nameID为SAML协议携带无需映射将作为用户唯一标识保存。

在有email或nameID为email的情况下登录时将尝试匹配已有用户否则创建新用户。