智慧互安认证平台

一、产品概述

统一认证平台是企业级一站式身份认证解决方案，整合多种认证方式和登录机制，支持灵活的认证策略配置，可有效简化企业身份管理流程，提升系统安全性与用户体验。无论是企业内部系统集成，还是第三方应用对接，平台均提供标准化认证接口与完善的权限控制能力。

1.1 核心功能

功能模块	功能说明
多维度认证方式	支持账号密码、邮箱、短信登录；后续将接入QQ、微信、支付宝等社交认证，以及UKey硬件免登录机制
账号映射机制	平台账号与第三方系统账号建立映射关系，实现一次认证多系统通行，无需重复注册
认证信息穿透	认证信息安全透传至第三方系统；非密码登录场景下，由平台统一生成和验证验证码
灵活登录策略	支持同端互斥、异端互斥、全端互斥三种策略，精细化控制用户登录行为

1.2 核心认证机制

1.3 适用场景

• 企业内部系统：统一各业务系统身份认证，提升办公效率；
• 第三方应用集成：为合作伙伴系统提供标准化认证接入能力；
• 高安全要求场景：通过硬件免登和登录互斥保障账号安全。

二、平台提供接口

2.1 获取token令牌

用于获取平台认证所需的token令牌，作为后续统一登录的核心凭证。

请求参数（JSON）

参数名	类型	必填	说明
appId	String	是	应用ID
secret	String	是	应用密钥

响应参数

参数名	类型	说明
code	Integer	响应状态码（200表示操作成功）
message	String	响应提示信息
data.token	String	平台返回的认证令牌
isSucceed	Boolean	操作是否成功（true/false）

2.2 统一登录页面

通过获取到的token令牌，重定向至该地址完成统一认证登录操作。

说明：将“令牌”替换为通过「获取token令牌」接口获取的有效token值，访问该地址后将跳转至统一认证登录页面。

三、接入方提供接口

3.1 注销接口

由接入方实现并配置地址，平台在需要注销用户登录状态时调用该接口。

请求参数（JSON）

参数名	类型	说明
token	String	加密数据（接入方需使用应用私钥解密）

解密后参数结构：

响应要求：无需返回响应数据，平台仅需确认接口可正常调用。

3.2 登录接口

由接入方实现并配置地址，平台登录成功后会跳转至该接口地址，接入方通过解析token参数完成后续登录处理。

请求参数

参数名	类型	说明
token	String	加密数据（接入方需解密解析）

解密后参数详情：

参数名	类型	说明
appId	String	应用ID
certificationType	Integer	认证类型（0-账号密码、1-邮箱、2-短信、3-QQ、4-微信、5-支付宝）
loginType	Integer	登录方式（1-映射、2-透传）
expireTime	Long	链接有效时间（平台默认1分钟，接入方需自行判断超时无效）
username	String	用户账号（映射登录传映射账号，透传登录传透传账号）
password	String	用户密码（该参数在账号透传且密码认证的情况下才会传输）

四、接口调用流程

• 接入方调用「获取token令牌」接口，传入appId和secret获取有效token；
• 接入方拼接token至「统一登录页面」地址，引导用户跳转至该页面完成统一认证；
• 平台认证成功后，跳转至接入方配置的「登录接口」地址，传入加密token参数；
• 接入方解析token参数，根据loginType（映射/透传）完成自身系统的登录逻辑；
• 当需要注销登录时，平台调用接入方配置的「注销接口」，接入方执行注销操作。

五、注意事项

• token令牌为敏感凭证，接入方需做好传输和存储安全防护；
• 接入方提供的接口需保障高可用性，避免影响用户登录/注销流程；
• 加密参数解密所需的私钥由接入方在应用管理中获取，需妥善保管，防止泄露；
• 登录接口的链接有效时间由平台设置为1分钟，接入方需严格校验，超时则视为无效请求；
• 接入方需根据certificationType区分不同认证类型，适配对应的登录逻辑。