| Índice |
|---|
| Dica |
|---|
Só são suportadas integrações no padrão REST. |
Introdução
O processo de re-login é uma funcionalidade implementada na aplicação que permite atualizar os dados de login do beneficiário em determinados intervalos de tempo, sem a necessidade de efetuar um novo login completo. Essa funcionalidade melhora a experiência do usuário, permitindo que ele permaneça logado por um período prolongado sem a necessidade de autenticação repetida. O re-login relogin utiliza um token de segurança para validar a sessão do usuário e pode ser configurado com base em parâmetros específicos.
Pré-requisitos
No processo de relogin é utilizado a integração de Elegibilidade. 1.5 - Elegibilidade
| Aviso |
|---|
IMPORTANTE
|
Segurança e permissões
| Aviso |
|---|
Tokens de segurança ou autenticação A Mobile Saúde descreve nesta documentação o formato de adoção obrigatória quando sua empresa desejar utilizar TOKENS de segurança. O formato suportado pela aplicação está descrito no objeto SEGURANÇA, e sua empresa deve necessariamente implementa-lo conforme descrito quando desejar utilizar essa camada adicional de segurança. Não serão suportadas outras formas de transacionar TOKENs de segurança, como por exemplo tokens de autenticação na URL da requisição, entre outros. Caso tenha dúvidas, ou deseje maiores esclarecimentos, entre em contato com o gestor de projeto encarregado de sua implantação, para atendimento às questões ANTES DE DESENVOLVER SUA API.
Objeto permissões Devemos somente informar na estrutura de permissões dentro do objeto contratos as funcionalidades que o usuário não tem acesso ou ocultar caso queira que não apareça, mas para requisito de validação da estrutura do beneficiário, eleger uma ou mais funcionalidades junto com a equipe de desenvolvimento da Mobile Saúde para facilitar os testes de permissionamento. Lembrando que a tabela de funcionalidades está no final do documento de especificações.
Exemplos de uso:
"permissoes": [ { "funcionalidade": "1", "acesso": false, "mensagemBloqueio": "Você não possui acesso a está funcionalidade, para mais informações entre em contato com 0800", "ocultar": false }]
"permissoes": [ { "funcionalidade": "1", "acesso": false, "mensagemBloqueio": null, "ocultar": false }]
"permissoes": [ { "funcionalidade": "1", "acesso": false, "mensagemBloqueio": null, "ocultar": true }]
"permissoes": null |
| Dica |
|---|
Retornar ao índice |
Critérios de preenchimento
Abreviação | Nome | Descrição |
|---|---|---|
M | Mandatório | O preenchimento do atributo é obrigatório. Caso o atributo esteja nulo ou em branco, seu "response" será rejeitado. |
C | Condicional | O atributo pode tornar-se obrigatório quando um ou mais atributos auxiliares for preenchido / atualizado. |
OP | Opcional | Seu preenchimento não é obrigatório. Pode-se enviar NULL para objetos, ou arrays vazios para tipos Array |
| Dica |
|---|
Retornar ao índice |
Objetos e atributos de retorno
| Nota |
|---|
Os atributos devem seguir exatamente os mesmos nomes indicados nesta documentação, caso contrário, serão rejeitados pelo validador de integração. Exemplo do atributo "usuarioLogado":
|
Método - Relogin
| Dica |
|---|
|
Endpoint
Endpoint | Método | Header Content-Type | Descrição | ||
|---|---|---|---|---|---|
http://exemplo.com/ relogin
| POST | application/json | Endpoint de relogin |
Parâmetros de entrada
Parâmetro | Obrigatório | Tipo | Descrição |
|---|---|---|---|
chave_unica | M | String | ID de identificação do usuário do app. Sugerimos que o login seja o CPF do usuário. |
integracao | M | Objeto | Informações necessárias para realizar a identificação do beneficiário no sistema. Deve existir um objeto idêntico para um dos beneficiários no array " |
Exemplo request
| Bloco de código | ||
|---|---|---|
| ||
url:
https://www.operadoradesaude.com.br/mobilesaude/relogin
Body:
{
"chaveUnica": "<chave_unica>"
"integracao":{
chaveUnica: "chaveUnica",
chave_unica: "chave_unica"
}
} |
Descrição dos objetos e atributos de retorno - Sucesso
| Nota |
|---|
IMPORTANTE Este método utiliza o mesmo payload de resposta que o método de login, para ver os detalhes acompanhe a documentação clicando aqui. |
Parâmetros Utilizados
| Informações |
|---|
Os parametros utilizados no relogin são encontrados no configurador público na aba: “Parâmetros do App” |
reloginIntervaloSolicitaMinutos
...
O parâmetro reloginPeriodoMaximoSemReloginMinutos define o período máximo em que o beneficiário pode permanecer logado sem executar um novo re-login. Ele determina o tempo máximo permitido para que o usuário permaneça autenticado no aplicativo sem a necessidade de realizar uma nova autenticação. Se esse período for ultrapassado, o usuário será deslogado automaticamente para garantir a segurança da sessão.
ReloginIntervaloExecucaoEmHoras
O parâmetro ReloginIntervaloExecucaoEmHoras define o intervalo de tempo em que a função de relogin automático do aplicativo será executada. Esse intervalo determina a frequência com que o aplicativo verificará se é necessário realizar o re-login, de acordo com o valor configurado.
| Nota |
|---|
Caso o valor do parâmetro |
...
Funcionamento do Processo de Re-Login
...
O beneficiário realiza o login no aplicativo.
A data do login é registrada.
Ao fechar e reabrir o aplicativo, o sistema verifica o intervalo de tempo definido pelo parâmetro reloginIntervaloSolicitaMinutos.
Se o intervalo de tempo for ultrapassado, o sistema solicita um novo re-login.
A API de elegibilidade é utilizada para verificar a autenticidade do beneficiário.
Se o re-login for bem-sucedido, a sessão é renovada e o beneficiário permanece logado.
Se o re-login falhar ou o número máximo de tentativas for atingido, o beneficiário é deslogado do aplicativo.
Se o período máximo sem re-login for ultrapassado, o beneficiário é deslogado automaticamente.
Configurando Relogin no Mosia Omnichannel
Para configurar o relogin é necessário:
Acessar o configurador público (caso não saiba como acessar, clique aqui )
“Opções de logins”
“Login”
“Integrações”
“Relogin” > “Editar”
...
6. Valide seus dados no validador de integrações e o seu relogin estará implementado.
| Nota |
|---|
IMPORTANTE Lembre-se que os parâmetros do app serão de extrema importância para o fluxo de funcionamento do relogin para a Operadora. |