# 提供授权页面

以接入A企业平台(example.com)为例:

  1. A企业提供授权页面给乐享:https://example.com/auth?appid=12,url可自由填写path和query

  2. 当未具有A企业乐享登录态的成员打开https://lexiangla.com?company_from=a, 会直接跳转到https://example.com/auth?appid=12&redirect_uri={REDIRECT_URI}&state={STATE}。比起A企业提供的授权页面,从乐享跳转过来的地址会多携带redirect_uristate两个参数

参数说明

参数 说明
redirect_uri 用户授权后重定向的回调地址,urldecode后得到https://lexiangla.com/suites/auth-callback?url=https%3A%2F%2Flexiangla.com%3Fcompany_from%3Da

若开发者需获取用户要访问的乐享地址,可再次urldecode其中的url参数
state 乐享携带过来的随机字符串,重定向到回调地址时须原样返回
  1. 用户在A企业平台授权成功后,由A企业平台生成用户身份的临时授权码,并重定向到乐享https://lexiangla.com/suites/auth-callback?code={CODE}&state={STATE}。建议此URL通过上述第2步得到的redirect_uri拼上&code=xxx&state=xxx来生成

参数说明

参数 必须 说明
code 由A企业生成的临时授权码,乐享服务器将调用A企业的用户信息接口换取用户ID
切勿直接用员工ID或相关明文信息替代,否则会被利用漏洞非法冒充他人身份登录乐享
state 乐享携带过来的随机字符串,须原样返回。若state不对会提示登录信息已过期