Configurar o SSO do Feishu para o Verdent Team
Conecte o Feishu ao Verdent Team para um login corporativo centralizado
O Verdent Team oferece suporte ao single sign-on (SSO) do Feishu. Depois da configuração, membros com um domínio de e-mail corporativo aprovado podem verificar a identidade com a conta Feishu da empresa.
O SSO do Feishu permite usar o sistema de identidade já existente, reduz credenciais separadas e oferece ao Team Owner um único lugar para gerenciar o acesso.
Este guia é destinado aos Team Owners do Verdent Team. Somente um Team Owner pode acessar as configurações do Team e gerenciar o SSO.
Como funciona o SSO do Feishu
O Team Owner cria um aplicativo empresarial personalizado na Feishu Open Platform e adiciona suas credenciais e os domínios de e-mail corporativo ao Verdent Team.
Quando um membro informa um e-mail corporativo correspondente na página de login do Verdent, ele é encaminhado ao Feishu para autorização. O Verdent verifica o e-mail retornado pelo Feishu.
Os membros precisam ter um e-mail corporativo no diretório do Feishu. Sem ele, não é possível entrar pelo SSO do Feishu.
Antes de começar
Você precisa de:
- Uma conta de administrador empresarial do Feishu que possa criar aplicativos personalizados
- Acesso de Owner ao Verdent Team
- O domínio de e-mail corporativo da equipe, como
yourcompany.com
A configuração geralmente leva cerca de 5 minutos.
Abrir as configurações de SSO
- Entre no Verdent e mude para o Team que deseja configurar.
- Abra Settings no console do Team.
- Selecione SSO.
- Clique em Connect SSO.
Mantenha o Verdent e a Feishu Open Platform abertos durante a configuração.
Configurar o aplicativo Feishu
Criar um aplicativo empresarial personalizado
Abra a Feishu Open Platform, entre no Developer Console e clique em Create custom enterprise app. Informe um nome, envie um ícone e crie o aplicativo.
Obter as credenciais do aplicativo
Abra Credentials & Basic Info e localize o App ID e o App Secret:
| Credencial do Feishu | Campo SSO do Verdent |
|---|---|
| App ID | Client ID |
| App Secret | Client Secret |
Client Secret no Verdent.Adicionar a URL de redirecionamento
Abra Development Configuration → Security Settings e adicione esta Redirect URL:
https://login.verdent.ai/passport/sso/callbackhttps, não adicione / no final e remova espaços. Um valor incorreto causa o erro 20029 do Feishu.Conceder permissões
Abra Development Configuration → Permissions e conceda:
| Permissão | Escopo |
|---|---|
| Ler informações básicas do usuário | contact:user.base:readonly |
| Ler informações de e-mail do usuário | contact:user.email:readonly |
O Verdent usa essas permissões para identificar membros pelo nome e e-mail corporativo.
Publicar o aplicativo
Abra Version Management & Release, crie uma versão e envie-a para publicação. Os membros só poderão usar o aplicativo depois que ele for publicado.
Concluir a conexão no Verdent
Volte à configuração do SSO do Feishu no Verdent e informe:
| Campo do Verdent | Valor |
|---|---|
Client ID | App ID do Feishu |
Client Secret | App Secret do Feishu |
Email domain | Domínio de e-mail corporativo |
Você pode adicionar até 5 domínios corporativos. Domínios públicos, como Gmail, não são aceitos.
Salve a configuração e confirme que o SSO do Feishu está ativado no cartão. Você pode desativá-lo temporariamente sem excluir a conexão.
Experiência de login dos membros
Depois que o SSO estiver ativado, os membros informam um e-mail de um domínio configurado, confirmam o uso do SSO, autorizam o acesso no Feishu e retornam ao Verdent. Se o e-mail informado for diferente do e-mail corporativo retornado pelo Feishu, o Verdent solicita confirmação e usa o e-mail do Feishu para autenticação.
Testar e gerenciar a configuração
Antes de disponibilizar o SSO para todos, teste com um membro comum que tenha um e-mail corporativo na conta Feishu. Saia da conta, entre com esse e-mail, conclua a autorização no Feishu e confirme o acesso ao Verdent Team.
Em Team → Settings → SSO, o Team Owner pode ver domínios e status, ativar ou desativar o SSO, atualizar credenciais, reconfigurar uma conexão com falha ou excluí-la.
Solução de problemas
Erro 20029 do Feishu: URL de redirecionamento inválida
No Feishu, abra Development Configuration → Security Settings e confirme que
https://login.verdent.ai/passport/sso/callback foi adicionada exatamente como mostrado.
O Verdent informa que o Client ID ou Client Secret é inválido
Copie novamente o App ID e o App Secret em Credentials & Basic Info. Se o segredo foi redefinido, use o valor mais recente.
O aplicativo não está disponível durante o login
Confirme que uma versão foi criada e publicada em Version Management & Release.
O e-mail aparece vazio após o login
Adicione um e-mail corporativo ao perfil do membro no diretório do Feishu e tente novamente.
O membro não é encaminhado ao SSO do Feishu
Confirme que o e-mail corresponde a um domínio configurado e que o SSO do Feishu está ativado no Verdent.