Pular para o conteúdo principal

Configurar login social com DingTalk (Set up social login with DingTalk)

O conector oficial do Logto para login social com DingTalk em aplicativos web.

dica:

Este guia assume que você tem um entendimento básico dos Conectores (Connectors) do Logto. Para aqueles que não estão familiarizados, consulte o guia de Conectores para começar.

Primeiros passos (Get started)

O conector web do DingTalk é projetado para aplicativos web de desktop. Ele utiliza o fluxo de autenticação OAuth 2.0.

Crie um aplicativo web na DingTalk Open Platform

Dica: Você pode pular algumas seções se já tiver concluído.

Registre uma conta de desenvolvedor DingTalk

Se você ainda não possui uma conta de desenvolvedor DingTalk, registre-se na DingTalk Open Platform.

Crie um aplicativo

  1. Na DingTalk Open Platform, acesse "Desenvolvimento de Aplicativos" > "Aplicativo Empresarial Interno" > "Aplicativo DingTalk" e clique em "Criar Aplicativo"
  2. Preencha o nome do aplicativo e a descrição, e clique em "Salvar"
  3. Na barra de navegação à esquerda, selecione "Configuração de Desenvolvimento" > "Configurações de Segurança", localize e configure a "URL de Redirecionamento" ${your_logto_origin}/callback/${connector_id}. Você pode encontrar o connector_id na página de detalhes do conector após adicionar o respectivo conector no console de gerenciamento
  4. Na barra de navegação à esquerda, selecione "Informações Básicas" > "Credenciais e Informações Básicas" para obter o Client ID e o Client Secret

Configure permissões

Em "Configuração de Desenvolvimento" > "Gerenciamento de Permissões", selecione as permissões Contact.User.Read e Contact.User.mobile e autorize-as

Publique o aplicativo

Na barra de navegação à esquerda, selecione "Publicação do Aplicativo" > "Gerenciamento e Publicação de Versão", crie e publique a primeira versão para ativar o Client ID e o Client Secret

nota:

Se o aplicativo não publicar uma versão, o "Client ID" e o "Client Secret" obtidos não poderão ser usados, ou as solicitações falharão.

Configure seu conector

Preencha os campos clientId e clientSecret com o Client ID (anteriormente AppKey e SuiteKey) e Client Secret (anteriormente AppKey e SuiteKey) que você obteve nas páginas de detalhes do aplicativo OAuth mencionadas na seção anterior.

O campo scope atualmente suporta dois valores: openid e openid corpid. openid permite obter o userid do usuário após a autorização, enquanto openid corpid permite obter tanto o id do usuário quanto o id da organização selecionada durante o processo de login. Os valores devem ser separados por espaço. Observação: é necessário codificação de URL.

Tipos de configuração

NomeTipo
clientIdstring
clientSecretstring
scopestring

Teste o conector DingTalk

É isso. O conector DingTalk deve estar disponível agora. Não se esqueça de Habilitar o conector na experiência de login.

Depois que o conector web DingTalk estiver habilitado, você pode fazer login novamente em seu aplicativo para verificar se está funcionando.

nota:

Por favor, garanta o estrito cumprimento das especificações de uso e diretrizes de desenvolvimento da DingTalk Open Platform durante o processo de desenvolvimento.

Suporte

Se você tiver alguma dúvida ou precisar de mais assistência, visite a Documentação do Desenvolvedor DingTalk ou entre em contato com o suporte técnico da DingTalk.