钉钉登录配置

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

前提条件

  • 已有网盘与相册服务(PDS)控制台操作权限。如果使用的是RAM用户且未对RAM用户授予操作相册与网盘服务(AliyunPDSFullAccess)的权限,则完成授权后再进行操作。具体操作,请参见为RAM用户授权

  • 已创建网盘与相册服务(开发者版)域。如果您还未创建域,则需要先创建网盘与相册(开发者版)域,具体操作,请参见快速搭建云盘服务

  • 已有钉钉企业内部开发者权限。如果您还不是钉钉开发者,则需要先成为钉钉开发者,具体操作,请参见成为钉钉开发者

操作步骤

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

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

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

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

    image

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

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

  1. 配置重定向URL

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

    • 重定向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

    • 如果您使用的是在2023年03月02日之前创建的域,则重定向URL格式为https://{domainId}.auth.aliyunpds.com/v2/oauth/callbackimage

  2. 开启成员信息读权限

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

    2. 在权限管理页面搜索成员信息读权限,单击申请权限

    image

  3. 发布钉钉应用。

    1. 在钉钉应用详情页面内的左侧导航栏,选择应用发布>版本管理与发布

    2. 单击页面右侧创建新版本,填写应用版本号版本描述应用可用范围后单击保存

      image

    3. 保存成功后,单击直接发布,完成发布。

      image

步骤三:配置钉钉登录

  1. 获取钉钉应用ClientID和ClientSecret。

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

    2. 保存应用凭证下的ClientID和ClientSecret。

    image

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

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

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

      image

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

      image

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

      image

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

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

    image

  2. 单击钉钉登录,跳转到钉钉登录二维码,扫码并登录。

    image

常见问题

如何获取domainId

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

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

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

image

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

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

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

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

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

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