更新时间:2024-08-30 GMT+08:00
分享

认证登录

功能介绍

用户访问集成应用时,应用向OneAccess发起基于CAS的认证登录(重定向方式),用户添加该应用授权账号,用户使用应用认证登录接口POST/api/v1/login/form 传递参数:username、password;用户输入用户密码认证成功后,在调用下面的接口,OneAccess将重定向回应用,携带ticket参数传递Service Ticket票据。

接口约束

URI

GET /api/v1/cas/login

表1 Query参数

参数

是否必选

参数类型

描述

service

String

应用接受票据的地址,URL编码,必须与应用CAS配置中的应用回调URL一致。

请求参数

响应参数

状态码: 302

表2 响应Header参数

参数

参数类型

描述

Location

String

认证登录成功,重定向地址。例:https://example.com?ticket=ST-eYlKs8FrLCltwRwfm8AiwCxmQ8gAL...

请求示例

调用CAS单点登录接口进行认证,配置携带票据信息的重定向地址为https://example.com。

GET https://{domain_name}/api/v1/cas/login?service=https://example.com

响应示例

状态码

状态码

描述

302

认证登录成功或已登录,携带Service Ticket重定向到service地址。例:https://example.com?ticket=ST-eYlKs8FrLCltwRwfm8AiwCxmQ8gALNSK

错误码

请参见错误码

相关文档