Página de Login Customizada

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.

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);

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
2 Curtidas

Top, obrigado @daniel.giacomelli por nos atender a esta necessidade!

2 Curtidas