Postman 接口集分享

授权码模式

用户未认证，跳转登录页面

  1. response_type: code
  2. client_id: test_client_id_1
  3. redirect_uri: http://test1.cdk8s.com:9393/client-scribejava/user?id=123456&name=cdk8s
  4. state: 12345
  • 完整 demo：
  1. http://sso.cdk8s.com:9091/sso/oauth/authorize?response_type=code&client_id=test_client_id_1&redirect_uri=http%3A%2F%2Ftest1.cdk8s.com%3A9393%2Fclient-scribejava%2FcodeCallback%3Fredirect_uri%3Dhttp%253A%252F%252Ftest1.cdk8s.com%253A9393%252Fclient-scribejava%252Fuser%253Fid%253D123456%2526name%253Dcdk8s
  • 其中，最让人看不懂的是：http%3A%2F%2Ftest1.cdk8s.com%3A9393%2Fclient-scribejava%2FcodeCallback%3Fredirect_uri%3Dhttp%253A%252F%252Ftest1.cdk8s.com%253A9393%252Fclient-scribejava%252Fuser%253Fid%253D123456%2526name%253Dcdk8s
    • 这里进行了 URL 转码
    • 其中还有一个子参数：%3Fredirect_uri%3Dhttp%253A%252F%252Ftest1.cdk8s.com%253A9393%252Fclient-scribejava%252Fuser%253Fid%253D123456%2526name%253Dcdk8s
      • 该参数也进行了一个 URL 转码
      • 这个地址也就是用户最终登录后的跳转地址
    • Spring Security 的客户端没有这种情况，是因为它内部做了 cookie 的映射，所以最终重定向的地址不是根据 url 参数来的
    • 我们封装的 tkey-sso-client-scribejava 则是完全根据 url 参数来做最后登录成功的跳转
  • state 可以为空

用户提交的用户名和密码不匹配

  • 停留在登录页面，显示登录错误信息

用户提交的用户名和密码匹配

  • 301 重定向到：http://test1.cdk8s.com:9393/client-scribejava/codeCallback?redirect_uri=http%3A%2F%2Ftest1.cdk8s.com%3A9393%2Fclient-scribejava%2Fuser%3Fid%3D123456%26name%3Dcdk8s

业务系统回调接口触发授权码第二步，通过 code 换取 token（核心点）

  1. grant_type: authorization_code
  2. code: OC-106-uUddPxoWCEa4NBO5GaVIRJOTZLlWbHNr
  3. redirect_uri: http://test1.cdk8s.com:9393/client-scribejava/user?id=123456&name=cdk8s
  4. client_id: test_client_id_1
  5. client_secret: test_client_secret_1

请求参数合法，系统返回

  • 状态码 200
  • JSON 数据
  1. {
  2.     "access_token": "AT-MISqrbWUxFWc1xU4e8JK2OcMgJYusF22-101",
  3.     "token_type": "Bearer",
  4.     "expires_in": 57600,
  5.     "refresh_token": "RT-7UPY41g9j5K8rKBZse4qo4iP6sAbU2Df-102"
  6. }

请求参数不合法，系统返回

  • 状态码 400
  • JSON 数据
  1. {
  2.     "error": "invalid request",
  3.     "error_description": "请求类型不匹配",
  4.     "error_uri_msg": "See the full API docs at https://github.com/cdk8s"
  5. }

业务系统通过 access_token 换取用户信息（核心点）

  1. access_token: AT-dJTLEsFLR2PbxU1l8GPx3CUS9O3Lhzdn-102

请求参数合法，系统返回

  • 状态码 200
  • JSON 数据
  1. {
  2.     "username": "admin",
  3.     "name": "admin",
  4.     "id": "111222333",
  5.     "user_id": "111222333",
  6.     "user_attribute": {
  7.         "email": "admin@cdk8s.com",
  8.         "user_id": "111222333",
  9.         "username": "admin"
  10.     },
  11.     "grant_type": "authorization_code",
  12.     "client_id": "test_client_id_1",
  13.     "iat": 1562134212,
  14.     "exp": 1562191812
  15. }

请求参数不合法，系统返回

  • 状态码 400
  • JSON 数据
  1. {
  2.     "error": "invalid request",
  3.     "error_description": "请求类型不匹配",
  4.     "error_uri_msg": "See the full API docs at https://github.com/cdk8s"
  5. }