钉钉登录配置

更新时间:2025-03-13 06:38:49
重要

本文中含有需要您注意的重要提示信息,忽略该信息可能对您的业务造成影响,请务必仔细阅读。

网盘与相册服务(开发者版)提供了钉钉扫码登录网盘的方式。如果希望网盘用户通过钉钉扫码登录网盘,则您需要进行钉钉扫码登录配置。本文介绍如何在网盘与相册服务(开发者版)配置钉钉扫码登录。

前提条件

操作步骤

步骤一:创建钉钉内部应用

  1. 通过浏览器访问钉钉开放平台,登录开发者账号。

  2. 在页面顶部导航栏,单击开发者后台

  3. 在页面顶部导航栏,单击应用开发,跳转到钉钉应用列表。

  4. 单击右侧创建应用,填入应用信息,单击保存image

  5. 创建成功后会自动跳转到钉钉应用详情。

步骤二:配置重定向URL并开启权限

  1. 配置重定向URL

    在钉钉应用详情页面内的左侧导航栏,选择开发配置>安全设置,添加重定向URL

    说明

    填写时,将domainId替换为您的实际domainId

    • 重定向URL配置格式为https://domainId.api.aliyunpds.com/v2/oauth/callback

    • 如果您已开通并配置登录认证域名,则重定向URL格式为https://www.example.com/v2/oauth/callback

    • 如果您已开通登录认证域名,但是未配置域名,则重定向URL格式为https://domainId.auth.aliyunpds.com/v2/oauth/callback

    • 如果您使用的是20230302日之前创建的域,则重定向URL格式为https://domainId.auth.aliyunpds.com/v2/oauth/callbackimage

  2. 开启所需权限

    1. 在钉钉应用详情页面内的左侧导航栏,选择开发配置>权限管理

    2. 权限范围,按需选择全部员工部分员工

      部分员工:授权用户数量即等同于云盘同步用户数。

    3. 需要的权限有两类:

      1. 通讯录个人信息读权限

        在权限管理页面左侧列表选择个人权限,勾选通讯录个人信息读权限

        image

      2. 通讯录管理全部权限

        在权限管理页面左侧列表选择通讯录管理,勾选全部权限(勾选时注意翻页)。

        image

      3. 勾选完成后,在右上角单击批量申请

步骤三:配置钉钉登录

  1. 获取钉钉应用Client IDClient Secret。

    1. 在钉钉应用详情页面的左侧导航栏,选择基础信息>凭证与基础信息

    2. 保存应用凭证下的Client IDClient Secret。

    image

  2. 配置钉钉登录到网盘与相册服务(开发者版)

    1. 进入网盘与相册服务(开发者版)域列表

    2. 找到您需要配置钉钉登录的域,在该域的右侧列单击详情

      image

    3. 进入域详情页面后,选择用户体系,单击配置,打开PDS登录页面配置

      image

    4. 打开启用钉钉登录开关,在AppID填入钉钉Client ID,在AppSecret填入钉钉Client Secret,单击确定。

      image

步骤四:钉钉同步配置

说明

钉钉同步配置默认未开启,如需使用请联系我们开启功能。

  1. 使用管理员账号登录网盘与相册服务(开发者版),进入管理控制台

  2. 在左侧导航栏选择专属登录配置>钉钉配置

  3. 同步配置模块单击编辑

    4766892efbaaf46d35d9e27f40155acf

  4. 配置同步选项。

    • 如果不需要开启钉钉同步功能,请跳过此步骤。如果不开启同步配置功能,仅启用钉钉登录功能,任何组织范围内的钉钉用户都可以登录企业云盘,在登录时自动创建账号,无组织结构。

    • 如果开启同步功能,则可导入钉钉内的用户和组织结构。具体配置步骤如下:

      • 在同步配置页面,打开同步配置开关并配置同步信息。

      • 警告

        同步范围变更时请谨慎操作。同步范围变更后,不在范围内的用户会被禁用(不会自动删除)。如果又将该用户划入同步范围内,该用户也不会自动变成启用,需要管理员手动将用户状态设置为启用。

      • image

      • 单击配置检测,可以检测同步的部门数量和员工数量,如果此步骤报错,请检查上一步的授权是否按要求完成。

      • 同步时间设置可以选择手动同步或者自动同步

        • 手动同步:手动同步组织或用户到云盘。使用手动同步时,如果原数据有更新,可能无法同步变更到云盘,此时需要再次手动执行同步操作。例如,在企业人员管理应用场景下,员工有新增,这些变更可能无法及时反映到服务中,导致新配置人员无法登录到云盘。

        • 自动同步:根据指定同步频率和时间将组织或用户同步到云盘。同步频率可设置为每日、每周或每月,同步时间可选择24小时中的任意整点时间。

      • 同步手机号/邮箱,按需开启。

        • 开启同步手机号,将同步员工在钉钉的手机号,同步成功之后支持员工使用该手机号登录。

        • 开启同步邮箱,将同步员工在钉钉的邮箱。

  5. 查看导入结果。

    1. 单击立即同步

    2. 同步完成后会展示导入结果。如遇到导入失败情况,会在导入结果展示导入失败原因。

image

  1. 查看上一次同步信息。

    上次同步信息区域,可查看上次同步时间上次同步状态。单击右侧详情,可查看上次同步详细信息。

    image

步骤五:使用钉钉登录网盘与相册服务

在浏览器登录网盘与相册服务时,其他登录方式下方将出现钉钉登录选项。

image

常见问题

如何获取domainId

  1. 进入网盘与相册服务(开发者版)域列表

  2. 找到您需要查看 domainId 的域,在列表右侧点击详情

  3. 在基本信息下,ID即是您的domainId。

image

使用钉钉登录时报错:url参数和应用配置的回调域名不匹配

请检查钉钉应用回调地址配置是否正确。

使用钉钉登录时报错:无效的appid

请检查网盘与相册服务中的钉钉配置AppID是否与钉钉应用ClientID一致。

钉钉重定向URL修改正确地址后,访问仍然报错

如果您确认重定向URL配置正确,但在单击钉钉登录时仍然报错,则请确保在修改重定向URL后,钉钉应用已经重新发布。

  • 本页导读 (1)
  • 前提条件
  • 操作步骤
  • 步骤一:创建钉钉内部应用
  • 步骤二:配置重定向URL并开启权限
  • 步骤三:配置钉钉登录
  • 步骤四:钉钉同步配置
  • 步骤五:使用钉钉登录网盘与相册服务
  • 常见问题
AI助理

点击开启售前

在线咨询服务

你好,我是AI助理

可以解答问题、推荐解决方案等