Apostila, Acesso pelo site da instituição
Abaixo as informações necessárias para fazer o acesso ao sistema através do site da instituição.
URL de Autenticação: https://app.gennera.com.br/gcas/login
Parâmetros:
ielogin: Código do cliente;
username: Login do usuário;
password: Senha do usuário;
resposta: Resposta secreta do usuário (Pode ser fixado um valor padrão para os clientes que não utilizam o controle de resposta secreta);
modulo: Código do módulo em que o usuário quer se logar (1 - Portal Educacional, 2 - Portal Aluno, 3 - Portal Professor, 4 - Genion (Gerencial), 5 - Biblioteca);
tipo: Tipo do usuário (1 - Usuário, 2 - Professor, 3 - Aluno, 4 - Pai, 5 - Mãe, 6 - Responsável, 7 - Adotador);
auto: Realiza autenticação automática (parâmetro obrigatório e interno da Gennera). Valor padrão "true";
homeUrl: URL para onde o sistema deverá redirecionar o usuário, ao fazer o logout. Campo não obrigatório (caso não seja fornecido, será redirecionado para a página de login do sistema de autenticação da Gennera);
senha_esquecida: Identificador de esquecimento de senha (1 - Redirecionar para tela de recuperação de senha).
Exemplo:
<html> <head> <title>Escola Modelo - Gennera</title> </head> <body> <FORM name=log action="https://app.gennera.com.br/gcas/login" target="_blank" method="post"> <INPUT type="text" name="ielogin" id="ielogin"> <INPUT type="text" name="username" id="username"> <INPUT type="password"name="password" id="password"> <INPUT type="password" name="resposta" id="resposta"> <INPUT type="hidden" name="tipo" id="tipo" value="1"> <INPUT type="hidden" name="modulo" id="modulo" value="1"> <INPUT type="hidden" name="auto" id="auto" value="true"> <INPUT type="hidden" name="homeUrl" id="homeUrl" value="http://www.gennera.com.br/login">
<INPUT name="submit" type="submit" value="Enviar"> </FORM> </body> </html>
Observações:
1. O exemplo acima é um modelo de utilização que deve ser editado pelo cliente conforme suas necessidades;
2. Todos os parâmetros, exceto "senha_esquecida" e "homeUrl", são obrigatórios;
3. Para maior segurança, os parâmetros devem ser repassados via método POST.
4. O parâmetro "senha_esquecida" só deverá ser enviado caso o usuário escolha a opção "Esqueci minha senha", link que poderá ser incluído diretamente no site da instituição. Ao clicar nesse link o site ainda deverá validar a digitação dos parâmetros "ielogin" e "username", obrigatórios para a recuperação da senha.