Visão Geral
Essa é a página de Login padrão do Latromi Web:
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!
Implementação
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.
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);
Url de Retorno
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.
Configuração do Sistema
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.
Exemplos de endereços relativos
| Endereço | Comentários |
|---|---|
| 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
| Endereço | Comentários |
|---|---|
| https://login.minha-empresa.com.br/ | Página externa. |
| https://minha-empresa.com.br/shared/login.aspx | Página externa. |
Fallback
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.
Exemplo
https://latromi.minha-empresa.com.br/web/Login.aspx?clear=true