In the DingTalk Open Platform "Application Development" > "Internal Enterprise Application" > "DingTalk Application", click "Create Application"
Fill in the application name and description, and click "Save"
In the left navigation bar, select "Development Configuration" > "Security Settings", find and configure the "Redirect URL" ${your_logto_origin}/callback/${connector_id}. You can find the connector_id on the connector details page after adding the respective connector in the management console
In the left navigation bar, select "Basic Information" > "Credentials and Basic Information" to get the Client ID and Client Secret

Configure permissions

In "Development Configuration" > "Permission Management", select Contact.User.Read and Contact.User.mobile permissions and authorize them

Release Application

In the left navigation bar, select "Application Release" > "Version Management and Release", create and release the first version to activate the Client ID and Client Secret

ℹ️ Note If the application does not release a version, the obtained "Client ID" and "Client Secret" cannot be used, or requests will fail.

Configure your connector

Fill out the clientId and clientSecret field with Client ID(formerly AppKey and SuiteKey) and Client Secret(formerly AppKey and SuiteKey) you've got from OAuth app detail pages mentioned in the previous section.

scope currently supports two values: openid and openid corpid. openid allows obtaining the user's userid after authorization, while openid corpid allows obtaining both the user's id and the organization id selected during the login process. The values should be space-delimited. Note: URL encoding is required.

Config types

Name	Type
clientId	string
clientSecret	string
scope	string

Test DingTalk connector

That's it. The DingTalk connector should be available now. Don't forget to Enable connector in sign-in experience.

Once DingTalk web connector is enabled, you can sign in to your app again to see if it works.

ℹ️ Note Please ensure strict compliance with the usage specifications and development guidelines of the DingTalk Open Platform during the development process.

Support

If you have any questions or need further assistance, please visit the DingTalk Developer Documentation or contact DingTalk technical support.

钉钉网页连接器

开始上手

钉钉网页连接器是为桌面网页应用设计的。它采用了 OAuth 2.0 认证流程。

在钉钉开放平台新建一个应用

💡 Tip 你可以跳过已经完成的部分。

注册钉钉开发者账号

如果你还没有钉钉开发者账号，请在钉钉开放平台注册。

创建应用

在钉钉开放平台「应用开发」>「企业内部应用」>「钉钉应用」中，点击「创建应用」
填写应用名称和应用描述，点击「保存」
在左侧导航栏选择「开发配置」>「安全设置」，找到并配置「重定向 URL」 ${your_logto_origin}/callback/${connector_id}。其中 connector_id 在管理控制台添加了相应的连接器之后，可以在连接器的详情页中找到
在左侧导航栏选择「基础信息」>「凭证与基础信息」中可以获取「Client ID」、「Client Secret」

配置权限

在「开发配置」>「权限管理」中，选择通讯录个人信息读权限和个人手机号信息权限并进行授权

应用发布

在左侧导航栏选择「应用发布」>「版本管理与发布」，点击「创建新版本」发布第一个版本，以使「Client ID」、「Client Secret」生效

ℹ️ Note 应用不发布版本，所获取的「Client ID」、「Client Secret」均无法使用，或请求错误。

配置你的连接器

在 clientId 和 clientSecret 字段中填入你在上一个部分中提到的 OAuth 应用详情页面获取的 Client ID（原 AppKey 和 SuiteKey）和 Client Secret（原 AppKey 和 SuiteKey）。

scope 目前支持两种值：openid 和 openid corpid。openid 授权后可以获取用户的 userid，而 openid corpid 授权后可以获取用户的 id 和登录过程中用户选择的组织 id。这些值应以空格分隔。注意：需要进行 URL 编码。

配置类型

Name	Type
clientId	string
clientSecret	string
scope	string

测试钉钉连接器

大功告成。别忘了在登录体验中启用本连接器。

在钉钉web连接器启用后，你可以构建并运行你的应用看看是否生效。

ℹ️ Note 请确保在开发过程中，严格遵守钉钉开放平台的使用规范和开发指南。

支持

如有任何问题或需进一步帮助，请访问钉钉开发者文档或联系钉钉技术支持。

7.1 KiB Raw Blame History Unescape Escape

DingTalk Web Connector

Get started

Create a web app in the DingTalk Open Platform

Register a DingTalk developer account

Create an application