npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

@logto/connector-dingtalk-web

v0.2.0

Published

Dingtalk web connector implementation.

Downloads

53

Readme

DingTalk Web Connector

The official Logto connector for DingTalk social sign-in in web apps.

钉钉 web 应用社交登录官方 Logto 连接器 中文文档

Table of contents

Get started

The DingTalk web connector is designed for desktop web applications. It uses the OAuth 2.0 authentication flow.

Create a web app in the DingTalk Open Platform

💡 Tip You can skip some sections if you have already finished.

Register a DingTalk developer account

If you do not have a DingTalk developer account, please register at the DingTalk Open Platform.

Create an application

  1. In the DingTalk Open Platform "Application Development" > "Internal Enterprise Application" > "DingTalk Application", click "Create Application"
  2. Fill in the application name and description, and click "Save"
  3. 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
  4. 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 你可以跳过已经完成的部分。

注册钉钉开发者账号

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

创建应用

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

配置权限

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

应用发布

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

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

配置你的连接器

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

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

配置类型

| Name | Type | |--------------|--------| | clientId | string | | clientSecret | string | | scope | string |

测试钉钉连接器

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

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

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

支持

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