集成应用免登对接说明

1. 概述

本文档面向需要将自有系统与简道云进行免登集成的第三方开发者，说明如何通过简道云提供的 OAuth 授权机制，实现用户无需重复登录即可在两套系统间流转。

完成对接后，用户可在以下两种场景中实现免登：

本文仅讲解接口理论，具体实现示例请参考：集成应用免登对接示例

2. 授权流程

简道云提供两种授权方式，区别在于由哪一侧发起跳转：

2.1 主页跳转流程

由简道云发起跳转，适用于用户从简道云产品中心进入第三方系统的场景。

1）用户在简道云单击「进入应用」，跳转至「应用首页」（第三方服务端），并在 URL 中附加 code 参数。

2）第三方服务端接收请求后，提取 code 值，调用简道云 API 接口（见第三章），兑换当前用户的身份信息。

3）第三方服务端将用户重定向至第三方系统的地址，URL 中携带获取到的简道云身份信息。

4）第三方系统识别 URL 参数中的用户信息，在自身系统中寻找对应的用户，以该用户完成登录。

2.2 OAuth 授权流程

当用户已在第三方系统内，且需要主动获取其简道云身份时，由第三方系统构造授权 URL 并将用户重定向至简道云授权页。用户完成授权后，简道云将用户重定向回指定的回调地址，并携带 code 和 state 参数。

1）构造授权 URL 并重定向用户

在用户触发简道云登录操作时，按以下格式构造授权 URL，并将用户浏览器重定向至指定地址：

https://www.jiandaoyun.com/open/user/oauth/login?app_id={Suite ID}&state={STATE}&redirect_uri={REDIRECT_URI}

URL 参数说明：

2）简道云回调

用户在简道云完成授权后，简道云将用户重定向至上一步设置的 redirect_uri，并附加以下参数：

3）校验 state 参数，确认其与上一步中生成的值完全一致。校验失败时，拒绝本次请求，以防 CSRF 攻击。

4）校验通过后，在第三方服务端持有 code，调用简道云 API 接口（见第三章），兑换当前用户的身份信息。

3）第三方服务端将用户重定向至第三方系统的地址，URL 中携带获取到的简道云身份信息。

4）第三方系统识别 URL 参数中的用户信息，在自身系统中寻找对应的用户，以该用户完成登录。

3. 获取简道云登录用户信息接口

主页跳转流程与 OAuth 授权流程在获取到 code 后，均通过本接口换取用户身份信息。

接口信息

请求说明

请求头：

请求体：

{
     "code": "xxxxx"
}

响应说明

成功响应字段：

成功响应示例：

{
    "user_name": "jdy-developer",
    "user_id": "620a31c23e7c5a00081e7acf",
    "tenant_id": "62bd1de4b507f400065d3cd0"
}

完整调用示例（cURL）

curl --location 'https://api.jiandaoyun.com/api/v3/user/oauth/auth_info' \
--header 'Authorization: Bearer YOUR_SUITE_SECRET' \
--header 'Content-Type: application/json' \
--data '{
    "code": "USER_CODE"
}'

其中：

核心原则