设置钉钉社交登录
Logto 官方为 Web 应用提供的钉钉社交登录连接器。
本指南假设你对 Logto 连接器 (Connectors) 有基本的了解。对于不熟悉的人,请参考 连接器 (Connectors) 指南以开始了解。
入门指南
钉钉 Web 连接器专为桌面 Web 应用设计,采用 OAuth 2.0 认证 (Authentication) 流程。
在钉钉开放平台创建 Web 应用
提示:如果你已经完成了部分步骤,可以跳过相关部分。
注册钉钉开发者账号
如果你还没有钉钉开发者账号,请前往 钉钉开放平台 注册。
创建应用
- 在钉钉开放平台 “应用开发” > “企业内部应用” > “钉钉应用”中,点击“创建应用”
- 填写应用名称和应用描述,点击“保存”
- 在左侧导航栏选择“开发配置” > “安全设置”,找到并配置“回调地址”
${your_logto_origin}/callback/${connector_id}
。你可以在管理控制台添加相应连接器后,在连接器详情页找到connector_id
- 在左侧导航栏选择“基本信息” > “凭证与基础信息”,获取
Client ID
和Client Secret
配置权限
在“开发配置” > “权限管理”中,选择 Contact.User.Read
和 Contact.User.mobile
权限并进行授权
发布应用
在左侧导航栏选择“应用发布” > “版本管理与发布”,创建并发布第一个版本以激活 Client ID
和 Client Secret
如果应用未发布版本,获取到的 “Client ID” 和 “Client Secret” 将无法使用,或请求会失败。
配置你的连接器
将你在上文 OAuth 应用详情页获得的 Client ID(原 AppKey 和 SuiteKey) 和 Client Secret(原 AppKey 和 SuiteKey) 分别填写到 clientId
和 clientSecret
字段中。
scope
目前支持两个值:openid
和 openid corpid
。openid
允许在授权后获取用户的 userid
,而 openid corpid
允许在登录流程中获取用户的 id
以及所选组织的 id
。多个值请用空格分隔。注意:需要进行 URL 编码。
配置类型
名称 | 类型 |
---|---|
clientId | string |
clientSecret | string |
scope | string |
测试钉钉连接器
就是这样。现在钉钉连接器应该可以使用了。别忘了 在登录体验中启用连接器。
启用钉钉 Web 连接器后,你可以再次登录你的应用,检查是否可以正常使用。
请确保在开发过程中严格遵守钉钉开放平台的使用规范和开发指南。
支持
如果你有任何疑问或需要进一步帮助,请访问 钉钉开发者文档 或联系钉钉技术支持。