跳到主要内容

钉钉 (X-Pack)

关于钉钉​

  • 通过点击页面右上角小齿轮进入 系统设置 页面，点击 认证设置 > 钉钉 ，进入钉钉配置页面。
  • 钉钉认证 是基于钉钉的身份认证方法，支持 JumpServer 二维码登录和企业身份绑定，实现安全便捷的企业用户登录和管理。

基础配置​

详细参数说明：

表 1 钉钉基础配置参数说明
参数说明示例
启用钉钉认证勾选启用钉钉身份验证启用/禁用
Agent ID钉钉 Agent ID，该 ID 唯一标识企业内的微型应用程序，主要用于发送工作通知
App key钉钉应用程序密钥，这是应用程序的唯一标识符，类似于 API 访问的用户名
App secret钉钉应用程序密钥，类似于 API 访问的密码，用于获取调用钉钉 API 的 访问令牌
映射属性用户属性映射。键表示 JumpServer 用户属性名称，值对应钉钉用户属性名称示例见下文
组织经过身份认证和创建后，用户将被添加到所选组织中默认值：DEFAULT

钉钉用户属性示例

  • 映射属性 字段用于设置用户属性映射。键表示 JumpServer 用户属性名称，值对应钉钉用户属性名称。
  • 钉钉用户属性示例：
{
  "name": "name",
  "username": "name",
  "email": "email"
}

JumpServer 钉钉 URL 说明​

表 2 钉钉 URL 说明
URL 类型地址说明
二维码登录 URLhttps://jumpserver.example.com/core/auth/dingtalk/qr/login/钉钉二维码登录入口
二维码登录回调 URLhttps://jumpserver.example.com/core/auth/dingtalk/qr/login/callback/二维码登录成功回调地址
OAuth 登录 URLhttps://jumpserver.example.com/core/auth/dingtalk/oauth/login/钉钉 OAuth 登录入口
OAuth 登录回调 URLhttps://jumpserver.example.com/core/auth/dingtalk/oauth/login/callback/OAuth 登录成功回调地址