单点登录-纷享销客应用
概述
纷享销客是一款连接型CRM系统，为企业提供营销获客、销售管理、渠道管理、服务管理等一体化智能CRM解决方案。其自有PaaS平台能够满足中大型企业的个性化需求，并为快消、农牧、制造业、高科技等行业提供专属CRM解决方案。
本文档详细介绍如何通过专属集成平台（专属集成平台）与纷享销客实现应用免登（SSO单点登录）功能，支持两种主流认证协议：SAML 2.0和OIDC (OpenID Connect)。通过配置单点登录，用户可使用统一的身份信息访问纷享销客，无需重复登录，显著提升用户体验和工作效率。
技术方案对比
| 协议类型 | 优势 | 适用场景 | 复杂度 |
|---|---|---|---|
| SAML 2.0 | 成熟稳定，安全性高，支持大型企业身份管理系统 | 企业级应用集成，内部系统对接 | 中等 |
| OIDC | 轻量级，基于REST/JSON，适合Web和移动应用 | 多终端支持，现代Web应用 | 较低 |
前提条件
- 账号准备：
- 拥有纷享销客管理员账号，具备认证配置权限
- 拥有专属集成平台管理员账号
- 用户数据准备：
- 专属集成平台中已创建相应用户
- 纷享销客中已创建对应用户
- 重要：确保纷享销客用户的手机号与专属集成平台中对应用户的手机号保持一致
- SAML协议特殊要求：
- 纷享销客需要申请并审核通过企业专属域名
- 需准备好专属集成平台的SAML元数据文件
SAML协议配置
纷享销客配置
确认企业域名
登录纷享销客管理后台，进入"后台管理 → 企业设置"界面 确认是否已有企业专属域名。若无，需联系纷享销客销售/售前申请域名注意：域名审核需要客户联系纷享销客的销售/售前进行审核，否则审核流程会很慢。
配置SAML单点登录
域名审核通过后，进入单点配置界面 根据界面提示填写配置信息
配置关键参数说明：
| 参数名称 | 来源 | 取值示例 | 说明 |
|---|---|---|---|
| 单点登录URL | 域名申请后自动填充 | baidu.my.fxiaoke.com/saml2/sp/sso/login | 需纯英文，不含特殊符号和空格 |
| 用户创建 | 根据需求选择 | 【登录前导入】 | 建议选择【登录前导入】 |
| 标识符实体 | 纷享销客元数据 | xxx-crm | 从纷享销客元数据XML的EntityDescriptor-entityID获取 |
| 登录页面URL | 专属集成平台元数据 | https://sso.xxx.com/cas/idp/profile/SAML2/Redirect/SSO | 从SingleSignOnService-Binding-Location获取 |
| 签发者ID | 专属集成平台元数据 | https://sso.xxx.com/idp | 从EntityDescriptor-entityID获取 |
| X.509证书 | 专属集成平台元数据 | (证书内容) | 访问metadata连接从ds:X509Certificate获取 |
| 跳转方式 | 专属集成平台元数据 | HTTP-POST/HTTP-Redirect | 从SingleSignOnService-Binding-bindings获取 |
| 昵称 | 客户定义或元数据获取 | urn:oid:2.5.4.42 | AttributeStatement-Attribute-Name |
| 邮箱 | 客户定义 | http://schemas.xmlsoap.org/ws/2005/05/identity/claims/emailaddress | 用于获取用户邮箱信息 |
重要信息：纷享销客的SAML元数据获取地址为：
https://{客户纷享销客域名}/saml2/sp/sso/metadata.xml
专属集成平台配置
登录专属集成平台管理控制台 导航至"应用管理"页面，新建或选择已有SAML应用 配置SAML应用参数： - **SSO URL**：从纷享销客元数据中获取（三个URL值相同） - **接受者URL**：同SSO URL - **目的URL**：同SSO URL - **SP实例ID**：从纷享销客元数据中的entityID获取 - **用户ID格式**：选择适合的格式（通常为邮箱或NameID） - **唯一标识匹配规则**：在SAML高级配置中，可以自定义唯一标识匹配规则
验证SAML配置
配置完成后保存，并设置应用的授权范围可通过企业微信/钉钉扫码或其他方式尝试登录纷享销客，验证单点登录是否生效。
OIDC协议配置
纷享销客配置
创建认证服务商
登录纷享销客管理后台，进入"认证服务商"界面 点击"新增认证服务商"，选择"OpenID Connect"类型 填写配置信息
| 参数名称 | 说明 | 示例值 |
|---|---|---|
| 提供商类型 | 选择OpenID Connect | OpenID Connect |
| 名称 | 认证提供商名称 | 身份认证 |
| URL后缀 | 用于生成OAuth2 SSO登入/登出/回调地址 | fxoidc（自定义） |
| Consumer Key | 专属集成平台应用的Client ID | （从专属集成平台应用获取） |
| Consumer Secret | 专属集成平台应用的Client Secret | （从专属集成平台应用获取） |
| Authorize接口地址 | 授权端点 | https://<您的域名>/iam/authorize |
| Token接口地址 | 获取Token的端点 | https://<您的域名>/iam/token |
| 用户信息接口地址 | 获取用户信息的端点 | https://<您的域名>/iam/userinfo |
| 授权范围 | 允许访问的权限描述 | openid profile address phone email offline_access |
| 外部用户身份认证字段 | 第三方用户标识字段 | phone_number（或其他唯一标识） |
| 纷享用户身份认证字段 | 纷享内用户标识字段 | phone（或对应的手机号字段） |
| 自定义登出地址 | 单点登出时访问的地址 | https://<您的域名>/iam/logout |
重要提示：配置保存后，系统会生成单点登录地址、回调地址和登出地址，这些信息将用于专属集成平台的配置。
专属集成平台配置
登录专属集成平台管理控制台 创建OIDC协议应用 配置应用参数： - 填写基本信息（名称、图标等） - 在RedirectURIs字段中填入纷享销客生成的回调地址 - 选择合适的授权范围 - 配置其他必要参数 记录应用的Client ID和Client Secret，填入纷享销客配置中
完成配置
配置完成后，通过纷享销客生成的单点登录地址即可实现免登功能。典型的登录URL格式如下：
https://<您的域名>/iam/authorize?client_id=您的ClientID&response_type=code&tcode=您的企业代码&scope=openid%20profile%20email%20address%20phone&state=1&redirect_uri=https://您的企业域名.my.fxiaoke.com/oauth/sp/callback/您的URL后缀
常见问题
域名申请审核时间由纷享销客决定，通常需要1-3个工作日。若直接联系纷享销客的销售或售前人员申请，流程会更快。<Accordion title="Q：配置SAML后，登录时提示"无效的SAML响应"或身份验证失败？" defaultOpen={false}>
常见原因及解决方案：
- 检查X.509证书是否正确复制，包括开头和结尾标记
- 确认签发者ID与专属集成平台元数据中的完全一致
- 验证跳转方式（HTTP-POST/HTTP-Redirect）是否选择正确
<Accordion title="Q：配置OIDC后，登录时出现"invalid_client"错误？" defaultOpen={false}>
这通常表示Consumer Key或Secret配置错误，请检查：
- 专属集成平台应用的Client ID和Secret是否正确复制
- RedirectURIs是否配置正确
- 确认应用状态是否为启用状态
最佳实践
选择合适的协议
- SAML协议适合注重安全性的大型企业，特别是已有完善身份认证体系的组织
- OIDC协议适合对接现代Web应用，并追求简单配置和更好用户体验的场景
- 若需要细粒度控制或特殊业务逻辑，建议使用OIDC协议或自定义认证服务商方式
用户数据同步策略
- 预先同步：建议在配置单点登录前，确保两个系统的用户数据已完成同步
- 保持一致性：建立用户数据同步机制，确保两个系统的关键字段（如手机号、邮箱）保持一致
- 处理特殊字符：注意电话号码格式（+86前缀）、字符编码等可能导致匹配失败的细节问题
安全建议
- 证书管理：
- 使用强密钥和算法生成证书
- 定期更新证书，避免过期导致服务中断
- 安全保存证书私钥
- 访问控制：
- 实施最小权限原则
- 定期审查授权范围
- 建立用户访问审计机制
- 监控与日志：
- 启用详细的认证日志
- 监控异常登录行为
- 建立安全事件响应机制
参考资源
元数据获取地址
- 纷享销客SAML元数据：
https://{客户纷享销客域名}/saml2/sp/sso/metadata.xml - 专属集成平台SAML元数据：通过专属集成平台应用详情页获取
参考文档
- 纷享销客认证服务商参考文档：纷享销客认证服务商配置指南
修改于 2026-05-06 13:02:30