Skip to content

简化授权码认证

前端发起应用单点认证时,通过获取的client_id参数,组装认证请求url,发起访问。

请求说明

http
GET https://{your_domain}/api/v1/oauth2/authorize

请求参数:

参数名中文名称必填示例值描述
response_type授权类型必须token此值固定为token
client_id应用标识必须RqB2HiHC9N676qA申请接入后分配给第三方应用的clientid。
redirect_uri回调地址可选http://oauthdemo.bccastle.com
/demo/index.jsp
授权后的回调地址,
必须是注册应用时填写的可信域名一致,
注意需要将url进行URLEncode。
state状态码可选15924362client端状态值。用于防止CSRF攻击,
成功授权后回调时会原样带回。
请检查用户与state状态绑定。
scope适用范围可选get_user_info此值固定为get_user_info

请求示例

https://{your_domain}/api/v1/oauth2/authorize?response_type=token&client_id={client_id}&redirect_uri=http://oauthdemo.bccastle.com/demo/index.jsp&state=15924362

返回示例

正确返回示例

http
HTTP Status: 302 REDIRECT
http://oauthdemo.bccastle.com/demo/index.jsp/#access_token=NObiIMkOvBgHIo8&token_type=Bearer&expires_in=6285&scope=get_user_info&state=15924362

client_id参数缺失

json
HTTP Status: 400 BAD REQUEST 
{
    "error": "invalid_request",
    "error_description": "Missing client_id"
}

client_id参数不正确

json
HTTP Status: 400 BAD REQUEST 
{
    "error": "invalid_request",
    "error_description": "client_id parameter is error"
}

response_type参数名称、值错误

json
HTTP Status: 400 BAD REQUEST 
{
    "error": "unsupported_response_type",
    "error_description": "Unsupported response types: [xxx]"
}

redirect_uri参数不正确

json
HTTP Status: 400 BAD REQUEST
{ 
    "error": "invalid_request",
    "error_description": "Invalid redirect: https://www.baidu.com does not match one of the registered values."
}

scope参数不正确

json
HTTP Status: 302 
{redirect_uri}?error=invalid_scope&error_description=Invalid scope: xxx&state=123456

返回参数

如果用户成功登录并授权,则会跳转到指定的回调地址,并在redirect_uri地址后带上Authorization Code和原始的state值。

参数名中文名称必填示例值描述
access_token授权令牌必须NObiKQS-cn8AWnZyIMkOvBgHIo8作为URL锚点参会,并不是query参数
token_type令牌类型必须Bearer固定 Bearer
expires_in授权令牌的有效期必须7199授权服务器返回给应用的访问票据的有效期。注意:有效期以秒为单位。
scope授权范围必须get_user_info固定 get_user_info
state应用端的状态码可选15924362client端的状态值。用于第三方应用防止CSRF攻击,成功授权后回调时会原样带回。

下一步:获取用户信息

竹云IDaaS开放平台