Como Configurar a Integração com MK-Auth
🔗 O que é: permite que os clientes do seu provedor entrem no WiFi informando apenas o CPF/CNPJ. O sistema consulta o MK-Auth e libera o acesso se o cliente estiver ativo — sem cadastro e sem senha.
⚠️ Não confundir: MK-Auth (mk-auth.com.br) e MK Solutions são sistemas diferentes, de empresas diferentes. Cada um tem sua própria integração no painel. Verifique qual você usa antes de configurar.
✅ Antes de começar
Você vai precisar de três informações do seu MK-Auth:
- Endereço do servidor — onde o MK-Auth está instalado
- Client ID e Client Secret — gerados no próprio MK-Auth
- Um CPF de cliente ativo, para testar
Onde obter o Client ID e o Client Secret
- Acesse o painel do seu MK-Auth
- Vá em Permissões de acesso
- Gere ou localize as credenciais de API
- Copie os dois valores — o Secret costuma ser exibido apenas uma vez
1️⃣ Habilitar a integração
- Vá em Integrações no menu lateral
- Localize MK-Auth e clique em Configurar
2️⃣ Preencher os dados
| Campo | O que informar |
|---|---|
| URL do servidor | Endereço do MK-Auth. Ex: https://mkauth.seuprovedor.com.br |
| Client ID | Obtido em Permissões de acesso |
| Client Secret | A chave secreta correspondente |
| Perfil de acesso | Tempo e velocidade que o cliente recebe ao entrar |
🔒 Use HTTPS em produção. Com http://, as credenciais de API trafegam sem criptografia.
3️⃣ Escolher o perfil de acesso
O Perfil de acesso define quanto tempo e qual velocidade o cliente do provedor recebe.
É o que permite dar um tratamento melhor a quem é cliente: enquanto um visitante que entra por e-mail recebe o perfil padrão do aparelho, quem se identifica pelo CPF pode receber mais tempo ou mais banda.
Deixando em branco, será usado o perfil padrão do aparelho.
4️⃣ Testar a configuração
Depois de salvar, clique em Testar Configuração e informe o CPF de um cliente ativo. O teste mostra cada etapa:
- Conexão — o servidor foi alcançado
- Autenticação — Client ID e Secret foram aceitos
- Consulta — o cliente foi localizado pelo CPF
- Autorização — o cliente está ativo e não bloqueado
- Perfil — qual perfil seria aplicado
💡 Só é preciso o CPF. Diferente do login por LDAP, aqui não se informa senha: quem valida o cliente é o MK-Auth, usando as credenciais de API que você configurou.
🔧 Solução de problemas
"Não foi possível conectar"
- Confirme a URL, incluindo
https:// - Verifique se o servidor aceita conexões a partir da internet
- Teste abrir o endereço no navegador
"Client ID ou Client Secret inválidos"
Gere novamente as credenciais em Permissões de acesso no MK-Auth e cole com atenção — espaços no início ou fim invalidam a chave.
"CPF não encontrado"
O cliente não existe no MK-Auth com esse documento. Confirme se está cadastrado e se o CPF está correto. Pode digitar com ou sem pontuação — o sistema remove automaticamente.
"Cliente sem permissão de acesso"
O cliente foi encontrado, mas está bloqueado ou não ativado no MK-Auth. É o comportamento esperado: quem está com o serviço suspenso não deve entrar no WiFi. Regularize no MK-Auth e teste de novo.
📖 Precisa de ajuda?
Entre em contato pelo menu Suporte, informando qual etapa do teste falhou e a mensagem exibida.