OAuth2.0

OAuth2 是 OAuth2.0 的版本。OAuth 是 Open Authentication 缩写,译为“开放授权”,利用 OAuth2,用户可以把自己的一些权限开放给第三方。

通过 OAuth2 允许用户使用 KOOK 账号登录访问第三方网站等功能.

  • 第一步: 取得机器人 OAuth 相关资质, 详情咨询开发者中心工作人员
  • 第二步: 登录开发者中心 -> 应用详情 -> OAuth2 -> 获取 OAuth 客户端的 client_id 及 client_secret -> 配置 OAuth 授权回调地址(redirect_uri)
  • 目前 KOOK 仅支持 authorization_code 授权方式

    你可以通过配置页面的 OAuth2链接生成器 或自行按照规则拼接生成 OAuth 链接(需在机器人配置中的白名单内), 你的应用应当引导用户点击或跳转到该链接,他们会跳转到相应的授权页面。

    当用户完成授权后, KOOK 会引导用户跳转至你链接参数当中的回调地址(需在机器人配置中的白名单内), 并将携带 authorization_code 的参数作为 HTTP query (GET 参数) 传递.

    https://xxx.xxx.xx/oauth/?code=099096fxxxxx32f489&state=c2275ac413bxxxxx5055

    你的应用获取到该 code 参数后, 即可调用 获取AccessToken 接口获取授权凭证 AccessToken

    当 AccessToken 过期后需再次引导用户重新授权

    此时整个授权流程已经完成, 你可以使用该 token 作为进行用户授权范围内(scope)的动作

    接口请求header示例: Authorization: Bearer xxxxxxxxxxxx

    参考 http 接口规范 - 鉴权

    目前支持的 Scope 及对应能力范围

    scope: get_user_info 允许读取用户信息