tboss_oa_module/docs/dingtalk/server/身份验证-概述.md

概述

更新于 2026-01-22“免登”是指用户进入应用后，无需输入钉钉用户名和密码，应用程序可自动获取当前用户身份，并以此身份登录系统的流程。通过免登机制，开发者可以实现无缝的身份认证体验，提升用户使用便捷性与安全性。

适用对象

本文档适用于以下类型的应用开发者：

• 企业内部应用：由企业自行开发并仅供本企业员工使用的应用。

• 第三方企业应用（ISV 应用）：由第三方服务商开发并提供给多个企业客户安装使用的 SaaS 类应用。

• 应用管理后台系统：需要企业管理员在钉钉管理后台直接访问的配置与管理系统。

支持的免登场景

• 网页应用（H5微应用）免登

• 应用管理后台免登

• 实现网页方式登录应用（登录第三方网站）

  • 浏览器内实现

    • 扫码登录

    • 使用钉钉账号密码方式登录

企业内部应用免登

当企业开发者开发了一个企业内部应用时，企业员工在钉钉内使用该应用，无需输入账户密码即可自动登录所开发的系统。

免登步骤，详情参见网页应用（H5微应用）免登。

步骤	说明
步骤一：获取免登授权码。	PC端暂不支持小程序开发，如果要开发PC端应用，需使用微应用开发方式。
步骤二：获取access_token。	调用接口获取企业内部应用的accessToken。
步骤三：获取用户userid。	调用接口通过免登码获取用户信息获取用户的userid。
步骤四：获取用户详情。	调用接口查询用户详情获取用户详情信息。

第三方企业应用免登

在钉钉上开发的第三方企业应用，作为公开的云端SaaS服务可以让企业客户安装使用。管理员开通第三方企业应用后，企业员工在钉钉内使用该第三方企业应用时，无需输入账号密码便可直接登录该应用。

免登步骤，详情参见第三方企业应用免登流程。

步骤	说明
步骤一：获取免登授权码	PC端暂不支持小程序开发，如果要开发PC端应用，需使用微应用开发方式。
步骤二：获取access_token	调用接口获取第三方应用授权企业的accessToken。
步骤三：获取用户userid。	调用接口通过免登码获取用户信息获取用户的userid。
步骤四：获取用户详情。	调用接口查询用户详情获取用户详情信息。

应用管理后台免登

当开发的应用需要企业管理员在钉钉管理后台对应用进行一些设置和管理功能时，你需要开发一套应用的后台管理系统，管理员在钉钉管理后台直接点应用管理后台，便可免输入账户密码实现自动登录你的应用管理后台系统。

免登步骤，详情参见应用管理后台免登。

步骤	说明
步骤一：获取免登授权码。	当企业管理员登录钉钉管理后台后，点击工作台中的应用，会自动跳转到应用的后台地址，钉钉会把code参数追加到此URL地址中。请保存code参数值，在后面的步骤会用到，如下图：

| | 步骤二：获取应用后台免登的access_token。 | 调用接口获取微应用后台免登的accessToken获取应用后台免登的access_token。 | | 步骤三：获取应用管理员的身份信息。 | 使用步骤一获取到的code和步骤二获取到的access_token换取应用管理员的身份信息，详情请参考获取应用管理后台免登的用户信息。 |