Configurer la connexion sociale avec DingTalk

Le connecteur officiel Logto pour la connexion sociale DingTalk dans les applications web.

astuce:

Ce guide suppose que vous avez une compréhension de base des Connecteurs Logto. Pour ceux qui ne sont pas familiers, veuillez vous référer au guide des Connecteurs pour commencer.

Commencer

Le connecteur web DingTalk est conçu pour les applications web de bureau. Il utilise le flux d'authentification OAuth 2.0.

Créer une application web sur la plateforme DingTalk Open

Conseil : Vous pouvez ignorer certaines sections si vous les avez déjà terminées.

Enregistrer un compte développeur DingTalk

Si vous ne possédez pas de compte développeur DingTalk, veuillez vous inscrire sur la plateforme DingTalk Open.

Créer une application

1. Dans la plateforme DingTalk Open "Développement d'application" > "Application d'entreprise interne" > "Application DingTalk", cliquez sur "Créer une application"
2. Renseignez le nom de l'application et la description, puis cliquez sur "Enregistrer"
3. Dans la barre de navigation de gauche, sélectionnez "Configuration du développement" > "Paramètres de sécurité", trouvez et configurez l’"URL de redirection" ${your_logto_origin}/callback/${connector_id}. Vous pouvez trouver le connector_id sur la page de détails du connecteur après avoir ajouté le connecteur correspondant dans la console d'administration
4. Dans la barre de navigation de gauche, sélectionnez "Informations de base" > "Identifiants et informations de base" pour obtenir le Client ID et le Client Secret

Configurer les permissions

Dans "Configuration du développement" > "Gestion des permissions", sélectionnez les permissions Contact.User.Read et Contact.User.mobile et autorisez-les

Publier l’application

Dans la barre de navigation de gauche, sélectionnez "Publication de l'application" > "Gestion des versions et publication", créez et publiez la première version pour activer le Client ID et le Client Secret

remarque:

Si l'application ne publie pas de version, les "Client ID" et "Client Secret" obtenus ne pourront pas être utilisés, ou les requêtes échoueront.

Configurer votre connecteur

Renseignez les champs clientId et clientSecret avec le Client ID (anciennement AppKey et SuiteKey) et le Client Secret (anciennement AppKey et SuiteKey) que vous avez obtenus sur les pages de détails de l’application OAuth mentionnées dans la section précédente.

Le paramètre scope prend actuellement en charge deux valeurs : openid et openid corpid. openid permet d’obtenir le userid de l’utilisateur après autorisation, tandis que openid corpid permet d’obtenir à la fois l’id de l’utilisateur et l’id de l’organisation sélectionnée lors du processus de connexion. Les valeurs doivent être séparées par un espace. Remarque : l’encodage URL est requis.

Types de configuration

Nom	Type
clientId	string
clientSecret	string
scope	string

Tester le connecteur DingTalk

C’est tout. Le connecteur DingTalk devrait maintenant être disponible. N’oubliez pas d’activer le connecteur dans l’expérience de connexion.

Une fois le connecteur web DingTalk activé, vous pouvez vous reconnecter à votre application pour vérifier son bon fonctionnement.

remarque:

Veuillez vous assurer de respecter strictement les spécifications d’utilisation et les directives de développement de la plateforme DingTalk Open pendant le processus de développement.

Support

Si vous avez des questions ou besoin d’une assistance supplémentaire, veuillez consulter la documentation développeur DingTalk ou contacter le support technique DingTalk.