Neste documento você irá entender como realizar as configurações do usuário integrador no Portal Mingle.

Requisitos Mínimos

• Acesso ao Portal do Mingle com um usuário de perfil administrador (TADMIN ou PADMIN).

            Saiba mais sobre os perfis de usuários do portal na documentação: Perfis de usuário e permissões.

• Verificar com o cliente se ele está pronto para utilizar o usuário integrador já que uma vez configurado, todas as requisições realizadas para o host do cliente serão feitas com o usuário integrador. 

Configurando o Aplicativo

Vamos começar habilitando a funcionalidade Usuário Integrador em um aplicativo

1- Considerando que você esteja autenticado como um administrador no Portal do Mingle, crie um novo aplicativo ou clique em editar um aplicativo existente para acessar as configurações

2- Selecione a opção "Utiliza usuário integrador"  conforme a imagem abaixo

3- Clique em salvar após revisar os dados do aplicativo

Após salvar o aplicativo com a opção usuário integrador habilitada, a Landpage passa a solicitar ao cliente as credenciais do usuário integrador no formulário de solicitação de alias.

Para saber mais sobre a funcionalidade da Landpage com usuário integrador clique aqui.

Configurando o Cliente

Essa configuração no cliente é apenas para o Mingle habilitar o usuário integrador em todos os NOVOS hosts.

Para hosts antigos, é necessário a edição do cadastro do host através do portal para habilitar o uso dessa funcionalidade.

Caso posteriormente a opção "Utiliza usuário integrador" do cliente seja desabilitada, os hosts antigos não sofrerão mudanças, porém os novos hosts criados após salvar o cliente terão como padrão a opção "Utiliza usuário integrador" desativada.  

1- Crie um novo cliente ou clique em editar para acessar a página a seguir

2- Selecione a opção Utiliza usuário integrador

3- Clique em salvar após revisar os dados do cliente

Configurando o Host do Cliente

Essa configuração é a mais importante, uma vez que o usuário integrador esteja habilitado no host do cliente, o Mingle vai ignorar as informações de autenticação enviada pela api  /api/api/v1/auth/app/authenticate e utilizará as credenciais informadas na solicitação do Alias.

PS: Solicite ao cliente as credenciais caso ele não tenha preenchido o formulário da Landpage.

Caso você tenha realizado o passo anterior (Configurando o Cliente) antes de criar um host para ele, irá notar que os novos hosts terão a opção Utiliza usuário integrador habilitada por padrão.

Criando ou editando um host

1- Crie um novo host ou clique em editar para acessar a página a seguir;

2- Selecione Utiliza usuário integrador;

3- Clique em salvar após revisar os dados do host do cliente;

Após salvar a configuração acima, todas as autenticações e chamadas de gateway realizadas no aplicativo utilizando este host serão enviadas com as credenciais do usuário integrador (se o cliente possuir cadastro).

Configurando o SET do Cliente

Acesse as configurações de set do cliente. 

Ao realizar o vínculo entre aplicativo e host na tela de SETS o Mingle realizará as seguintes validações:

1- Caso o cadastro do cliente tenha a opção "Utiliza usuário integrador"  habilitada e o cadastro do host não tenha a opção habilitada , o portal exibirá um alerta:

Ao salvar o cadastro do SET sem configurar o host,  a aplicação Mingle seguirá o fluxo normal sem credenciais do usuário integrador.

2-  Se o cliente e o host possui a opção "Utiliza usuário integrador" habilitada, o portal do Mingle valida se o cliente possui pelo menos uma credencial de autenticação no cadastro de usuários integradores:

Ao salvar o cadastro do SET sem o cliente possuir um cadastro de usuário integrador a autenticação do aplicativo não será realizada pois não existem credenciais para serem enviadas ao backend do cliente.

"Usuários dos Apps"(autenticação Mingle) com Usuário Integrador

Essa funcionalidade é opcional e passa a ser habilitada quando: 

1- O host usado pelo cliente está com a opção "Utiliza usuário integrador" habilitada.

2- Existe pelo menos um usuário do app atrelado ao cliente.

3- Existe um usuário integrador vinculado ao usuário do app.

Quando os três pré-requisitos citados acima são existentes no cadastro do cliente, o Mingle espera que os dados de autenticação enviados no login do aplicativo existam na base de dados de autenticação Mingle.

Ou seja, para ter uma autenticação válida, o usuário final do aplicativo deve informar as credenciais corretas de um "usuário do app" (MUSER).

Caso os dados estiverem corretos, é verificado se existe um usuário integrador vinculado a esse registro de MUSER e a autenticação final no backend do cliente é realizada com os dados do usuário integrador.

Siga os passos abaixo para habilitar a autenticação de usuários dos apps com usuário integrador: 

1- Certifique que existe pelo menos um registro de usuário integrador para o cliente desejado

2- Crie um usuário do app

3- Clique em Vincular usuário integrador

4- Selecione o usuário integrador que será utilizado na autenticação final e salve o registro.

Dessa forma, se o host utiliza usuário integrador, será validado o login correto do usuário do exemplo acima: "[email protected]" e o login do usuário integrador "[email protected]" será enviado para o backend do cadastro do host.