layout: docs-default
授权和认证 Endpoint
授权Endpoint可以用来获取访问令牌或者授权码(隐式或者授权码flow).可以使用web浏览器或者WebView来启动处理流程。
支持的参数
请看 规格.
-
client_id
(required)- 客户端标识符
-
scope
(required)- 一个或多个注册的作用域
-
redirect_uri
(required)- 必须和一个允许的重定向URIs匹配上。
-
response_type
(required)-
code
请求授权码 -
token
请求访问令牌(只有资源作用域才能申请访问令牌) -
id_token token
请求一个身份令牌和一个访问令牌 (资源作用域和身份作用域都被允许)
-
-
response_mode
(可选)-
form_post
通过一个表单Post发回令牌。否则直接把令牌编码后返回。
-
-
state
(推荐)- idsrv 会把状态值放在响应里面送回请求方,这个可以用来关联请求和响应。
-
nonce
(使用implicit flow的身份令牌必须指明)- idsrv 会把 nonce 的值放到身份令牌中, 可以用来关联请求和令牌)
-
prompt
(可选)-
none
请求时不会弹出UI让用户选择。如果不可能 (比如,用户必须登陆或者同意(consent)
),会返回错误 -
login
显示登陆界面,即使用户已经登陆,有一个有效的会话。
-
-
code_challenge
(使用proof keys必须使用 - v2.5新增)- 为 proof key flows发送code challenge )
-
code_challenge_method
(可选 - 默认是当使用 proof keys为纯文本 - v2.5新增)-
plain
表示Challenge使用纯文本(不推荐) -
S256
表示challenge 使用SHA256哈希。
-
-
login_hint
(可选)- 用这个值预填登陆页面上的用户名输入框
-
ui_locales
(可选)- 登陆页面期望显示的语言
-
max_age
(可选)- 用户登陆后超过多长时间(单位为秒),登陆界面弹出。
-
acr_values
(可选)- 运行传送一些附加的认证相关信息给用户服务--值有特定格式意义:
-
idp:name_of_idp
跳过登陆/主页界面并直接把用户转到选择的第三方认证服务器(基于客户端配置) -
tenant:name_of_tenant
用于把承租人名字转给用户服务
-
- 运行传送一些附加的认证相关信息给用户服务--值有特定格式意义:
例子
(去除URL encoding,提高url可读性)
GET /connect/authorize?client_id=client1&scope=openid email api1&response_type=id_token token&redirect_uri=https://myapp/callback&state=abc&nonce=xyz