O login dinâmico via API permite que usuários se autentiquem no WiFeed utilizando as credenciais do seu próprio sistema.
Este artigo orienta como ativar a permissão, criar o tipo de cadastro e configurar a integração da sua API com o WiFeed.
Pré-requisitos para configuração:
Uma API funcional e acessível publicamente (URL válida);
Acesso à plataforma WiFeed: system.wifeed.com.br;
Um usuário de teste (e-mail e senha) do seu sistema, para validar a integração;
Etapa 1 - Ativação de permissão na conta
Para utilização do login dinâmico via API é necessária a ativação de uma permissão específica na conta, entre em contato com a equipe de suporte do WiFeed solicitando a ativação dessa permissão.
Etapa 2 - Criar o tipo de cadastro
Já com a permissão ativa em sua conta, realize o login e crie um novo tipo de cadastro do tipo "login dinâmico" acessando o menu lateral localizado no lado esquerdo da tela.
Preencha os campos conforme solicitado:
Selecione o tipo de formulário “Login dinâmico”.
Clique em "Avançar"
Vincule os locais onde esse tipo de login será aplicado.
Etapa 3 - Configurar a API do cliente com o WiFeed
Na aba "Requisição" realize a configuração da sua API.
Escolha o método HTTP (POST, GET ou PUT);
(O método vai depender de como está configurada sua API)
Informar a URL completa do endpoint de sua API;
Adicione headers, se a API exigir. O Header é opcional, depende se existe na API;
Insira os valores conforme a API solicitar;
Exemplo:
Chave: wifeed-chave
Valor: 6b2c50fa03d834e30a1b0ad2a3bce6
3.1 - Definir parâmetros enviados (Param ou BODY)
Caso sua API espere dados via Param (query string) ou BODY (payload).
Ative os campos do WiFeed que correspondem ao que sua API exige:
Exemplo: se a API pede login e password, ative os campos equivalentes no WiFeed (como E-mail e Senha);
É possível criar novos campos (Passo 3.3);
Os campos que não forem utilizados podem permanecer desativados.
Para cada campo ativo, insira:
Nome do campo: É o nome exato esperado pela API do cliente, exemplo:
- Email
- Senha
Insira um exemplo: Deve ser um dado real do seu banco de dados para realizar o teste de integração bem sucedida, exemplo:
- lucas.a
- p@ssword123
Marque o campo-chave (ícone de chave);
Esse campo marcado como chave será o identificador principal do usuário dentro do WiFeed. (Será feita atualização e esse campo será o identificador em Conexões).
Clique em "Enviar teste" para verificar se a integração está funcionando.
Se o teste falhar, revise:O método utilizado (POST/GET/PUT);
A URL configurada;
A chave e valor configurado no Header (se houver);
A configuração do tipo de envio dos dados, se está como PARAM (enviando como parâmetros da url) ou como BODY (enviando os dados no payload da requisição);
No campo “nome do campo” verifique se a escrita do atributo está de acordo com o esperado pela API;
Verifique se os dados preenchidos em “insira um exemplo” estão corretos e são válidos.
3.2 - Mapeamento de Retorno (opcional)
Se sua API retornar dados do usuário e você desejar salvá-los na plataforma do WiFeed, marque a opção "Salvar dados de retorno no WiFeed"
Ative os campos de retorno do usuário conforme sua API e salve a configuração.
3.3 - Criar novos campos em Param/Body e Retorno (se necessário)
Clique na opção "Adicionar"
Selecione o tipo de campo (de acordo com sua API);
Preencha o nome do campo;
Preencha a legenda do campo (como irá aparecer no captive portal);
Defina o tipo de máscara;
Seleciona a opção "Criar"
Siga os passos do item 3.1 para definir os parâmetros enviados, incluindo os novos.
Finalizada a configuração, nas próximas conexões de usuário em sua rede com captive já será apresentado o botão referente ao login dinâmico.
Em caso de dúvidas entre em contato com nossas equipes de suporte.