适用对象
本文档适用于以下类型的应用开发者：- 企业内部应用：由企业自行开发并仅供本企业员工使用的应用。
- 第三方企业应用（ISV 应用）：由第三方服务商开发并提供给多个企业客户安装使用的 SaaS 类应用。
- 应用管理后台系统：需要企业管理员在钉钉管理后台直接访问的配置与管理系统。
支持的免登场景
- 网页应用（H5微应用）免登
- 应用管理后台免登
-
实现网页方式登录应用（登录第三方网站）
-
浏览器内实现
- 扫码登录
- 使用钉钉账号密码方式登录
-
浏览器内实现
企业内部应用免登
当企业开发者开发了一个企业内部应用时，企业员工在钉钉内使用该应用，无需输入账户密码即可自动登录所开发的系统。 免登步骤，详情参见网页应用（H5微应用）免登。| 步骤 | 说明 |
|---|---|
| 步骤一：获取免登授权码。 | PC端暂不支持小程序开发，如果要开发PC端应用，需使用微应用开发方式。 |
| 步骤二：获取 access_token。 | 调用接口获取企业内部应用的 accessToken。 |
| 步骤三：获取用户userid。 | 调用接口通过免登码获取用户信息获取用户的userid。 |
| 步骤四：获取用户详情。 | 调用接口查询用户详情获取用户详情信息。 |
| 步骤 | 说明 |
|---|---|
| 步骤一：获取免登授权码 | PC端暂不支持小程序开发，如果要开发PC端应用，需使用微应用开发方式。 |
| 步骤二：获取 access_token | 调用接口获取第三方应用授权企业的 accessToken。 |
| 步骤三：获取用户userid。 | 调用接口通过免登码获取用户信息获取用户的userid。 |
| 步骤四：获取用户详情。 | 调用接口查询用户详情获取用户详情信息。 |
应用管理后台免登
当开发的应用需要企业管理员在钉钉管理后台对应用进行一些设置和管理功能时，你需要开发一套应用的后台管理系统，管理员在钉钉管理后台直接点应用管理后台，便可免输入账户密码实现自动登录你的应用管理后台系统。 免登步骤，详情参见应用管理后台免登。| 步骤 | 说明 |
|---|---|
| 步骤一：获取免登授权码。 | 当企业管理员登录钉钉管理后台后，点击工作台中的应用，会自动跳转到应用的后台地址，钉钉会把 code 参数追加到此 URL 地址中。请保存 code 参数值，在后面的步骤会用到。 |
| 步骤二：获取应用后台免登的 access_token。 | 调用接口获取微应用后台免登的 accessToken 获取应用后台免登的 access_token。 |
| 步骤三：获取应用管理员的身份信息。 | 使用步骤一获取到的 code 和步骤二获取到的 access_token 换取应用管理员的身份信息，详情请参考获取应用管理后台免登的用户信息。 |