Página de Login Customizada - Tutoriais - LATROMI Community
integração, latromi-web
daniel.giacomelli Abril 28, 2021, 6:20pm #1
Essa é a página de Login padrão do Latromi Web:
Página de Login740×330 38.7 KB
Ela tem um visual interessante, e tem todas as funcionalidades necessárias para a autenticação do usuário no sistema.
No entanto, isso pode não ser o suficiente para a sua empresa. Talvez seja importante exibir o seu próprio logotipo, usar as cores da sua marca ou até mesmo consumir algum serviço antes de entrar no sistema.
Pensando nessa necessidade, implementamos alguns recursos que permitem o uso de uma página de Login completamente nova!
Para substituir a página de Login, será necessário criar uma página nova. Pode ser um arquivo HTML estático hospedado junto ao site; ou uma página externa desenvolvida em qualquer linguagem.
Tenha em mente que a página de Login será consumida via navegador, portanto os usuários precisarão ter acesso liberado para este endereço no firewall (caso seja usado).
Para fazer autenticação será necessário utilizar a API de Autenticação do sistema.
Você encontra informações detalhadas de como implementar a integração neste link.
Após realizar a autenticação usando a API, basta fazer o redirecionamento para a página inicial do sistema usando JavaScript:
// A variável "baseURL" é o endereço base do site.
// Por exemplo: https://latromi.minha-empresa.com.br/web
// A variável "authResult" é o objeto retornado pela API de ingreção
window.location.assign(baseURL + "/?authtk="+ authResult.authToken);
Caso a página de Login tenha sido chamada após o usuário tentar acessar uma página protegida, será adicionado um parâmetro chamado ReturnUrl na URL de Login, contendo o endereço (relativo ou absoluto) que o usuário tentou acessar.
Dessa forma, após a autenticação, é possível direcionar o usuário para página que ele estava tentando acessar.
A implementação deste parâmetro é opcional. Ele pode ser ignorado sem nenhum problema. No entanto, é interessante considerá-lo para melhorar a experiência do usuário.
Para configurar o sistema para usar a sua página de Login Customizada, acesse as Configurações do Site, e informe o endereço da página de Login no campo "Página de Login". O endereço pode ser absoluto ou relativo à pasta raiz do site.
Configurações do Site753×203 6.25 KB
Exemplos de endereços relativos
Public/Login.html Arquivo "Login.html" na pasta "Public" dentro da pasta do Site.
Public/Login/ Pasta "Public/Login" dentro da pasta do Site. Como o documento não foi informado, o documento padrão "Index.html" será utilizado.
…/Login/Login.aspx Pasta "Login", fora da pasta do Site. Pelo fato de estar fora, é tratado como endereço externo, portanto o documento padrão, a linguagem e etc são indiferentes.
Exemplos de endereços absolutos
https://login.minha-empresa.com.br/ Página externa.
https://minha-empresa.com.br/shared/login.aspx Página externa.
Se você tem algum erro na página de Login Customizada, ou informou o endereço errado e isso está impedindo a entrada no sistema, não se preocupe, existe uma solução!
Para desfazer as configurações e voltar a usar a página de Login padrão do sistema, é só chamar a página passando o parâmetro de URL clear=true.