CONTEÚDO
- Visão Geral
- Exemplo de utilização
- Demais Informações
01. VISÃO GERAL
Este documento tem como objetivo apresentar uma visão geral das parametrizações, necessárias para a realização do login no produto TOTVS - Linha Datasul com a utilização do protocolo OpenID Connect (OIDC).
02. EXEMPLO DE UTILIZAÇÃO
A partir da release 12.1.2305, foi disponibilizada uma nova opção de efetuar o login no produto TOTVS, no qual com a utilização dos portais de terceiros, é integrado o protocolo OIDC para efetuar suas devidas validações.
Nota
Somente são consideradas os dados (e-mail do usuário) para autorizar o login. As configurações de perfil e permissões de acesso as telas são realizadas exclusivamente dentro do produto TOTVS - Linha Datasul.
As etapas a seguir apresentam um passo a passo de como proceder para efetuar a parametrização do login integrado com o Azure AD (com protocolo OIDC).
- Efetuar o cadastro de um Aplicativo no portal que será utilizado como base de autenticação do login. O link: Azure AD - Aplicativo apresenta exemplos de como proceder;
- Após a conclusão do cadastro, localize informações do Application ID () e Directory ID (ID da Aplicação) para configurar no produto em Propriedades → Acesso → OIDC;
- Consulte o link: CFG - Acesso para mais informações dos campos que devem ser configurados;
- Não esqueça de reiniciar o servidor de aplicação Web (Apache Tomcat) após realizar as parametrizações.
- Caso a opção de login esteja habilitada, um botão é apresentado em tela.
- Para efetuar o login com portais de terceiros, basta clicar no mesmo e inserir as credenciais do portal que a integração foi realizada;
- Mesmo com a opção de login com portais de terceiros ativada, ainda é possível realizar o login "tradicional" (usuário e senha interno do ERP ou LDAP)
Dica
A chave de relacionamento entre o portal escolhido e o ERP Datasul é efetivada com a utilização do e-mail, portanto deve-se garantir que o mesmo esteja corretamente cadastrado para o usuário do ERP e que este campo seja único.
Caso não seja encontrado o e-mail ou exista em duplicidade, mesmo com o sucesso da autenticação no portal, não será permitida a entrada no ERP Datasul!
Com todas as parametrizações concluídas, o fluxo do login no ERP Datasul com a utilização do protocolo OIDC será similar a apresentação abaixo:
03. DEMAIS INFORMAÇÕES
- Protocolos homologados para a utilização em conjunto com o TOTVS - Linha Datasul:
- Microsoft Azure AD: https://learn.microsoft.com/pt-br/azure/active-directory/develop/v2-protocols-oidc