Migração de sistema

Provisionamento automático MikroTik para provedores

Transforme plano e contrato em configuração de rede com consistência, sem abrir mão de homologação, permissões mínimas e retorno seguro.

Provisionar manualmente funciona quando poucas ativações dependem da memória de uma pessoa. Com o crescimento, diferenças de nome, velocidade, pool e perfil geram retrabalho e tornam o diagnóstico mais difícil.

O provisionamento automático liga uma regra do ERP a uma ação no RouterOS. Para funcionar com segurança, precisa de padrões técnicos, vínculo confiável do assinante, comunicação protegida, confirmação do resultado e rollback documentado.

O que é provisionamento automático

Provisionamento automático é o processo de transformar uma decisão comercial ou operacional em configuração técnica. Ao ativar um contrato, por exemplo, o sistema usa regras aprovadas para criar ou atualizar o acesso correspondente.

Automação não elimina a responsabilidade da equipe de rede. Ela executa de forma repetível aquilo que já foi modelado, testado e autorizado; regras mal definidas apenas produzem erros com mais velocidade.

  • Ativação de um acesso conforme o plano contratado.
  • Mudança controlada de perfil ou velocidade.
  • Suspensão e retorno de acordo com regra definida.
  • Registro do comando, equipamento e resultado.

Padronize planos, perfis e identificadores

Antes da integração, elimine nomes ambíguos e documente qual perfil técnico corresponde a cada plano comercial. Defina também como o assinante será identificado no ERP, no RADIUS e no MikroTik.

Evite inferir uma configuração apenas pelo texto do plano. Use identificadores estáveis e validações explícitas para impedir que uma mudança de nome comercial aponte para o perfil errado.

  • Plano comercial e perfil técnico relacionados por identificador.
  • Velocidade, burst, pool, endereço e demais parâmetros revisados.
  • Regra para logins duplicados ou já existentes.
  • Convenção de nomes que não dependa de uma pessoa específica.

API ou RADIUS: caminhos diferentes

A API do RouterOS permite que um software consulte e ajuste configurações usando a estrutura de comandos do sistema. Em uma arquitetura RADIUS, autenticação e accounting podem ser centralizados, e mudanças compatíveis podem usar Disconnect Message ou Change of Authorization.

A escolha depende de topologia, escala, disponibilidade e política de segurança. Nem todo atributo pode ser alterado durante uma sessão; a documentação oficial do MikroTik deve orientar o desenho e os testes.

  • API: gestão direta de recursos permitidos no RouterOS.
  • RADIUS: autenticação e accounting centralizados em cenários compatíveis.
  • CoA: alteração limitada aos atributos suportados pelo equipamento.
  • Disconnect: encerramento controlado quando a mudança exige nova sessão.

Proteja a conexão com o roteador

A integração não deve reutilizar a conta administrativa cotidiana. Crie um usuário próprio, limite permissões e origem de acesso, mantenha segredos fora de planilhas e revise os registros de autenticação.

Prefira transporte protegido e evite expor serviços de gerenciamento diretamente à internet. A alternativa exata depende da rede do provedor e deve ser validada pelo responsável técnico.

  • Credencial exclusiva por finalidade ou ambiente.
  • Permissões mínimas para os comandos realmente usados.
  • Endereços de origem e portas limitados.
  • Segredos rotacionados e acesso auditado.
  • Homologação separada da produção.

Desenhe o fluxo de ponta a ponta

A ação começa com um evento válido no ERP, passa por uma fila controlada, chega ao equipamento e retorna com sucesso ou falha. Tentativas repetidas precisam ser idempotentes para não criar registros duplicados.

Quando o roteador não responde, a tarefa deve continuar pendente e visível. Marcar como concluído por ausência de erro local cria um estado falso e dificulta o suporte.

  • Validar empresa, contrato, plano, equipamento e acesso.
  • Gerar uma ação única com identificador rastreável.
  • Executar somente no roteador correto.
  • Confirmar o estado após a mudança.
  • Reprocessar falhas sem duplicar configuração.

Homologue com rollback real

Faça backup e exporte a parte relevante da configuração antes do piloto. O manual do RouterOS explica que o export não inclui todos os dados sensíveis, portanto entenda as limitações de cada mecanismo de recuperação.

Teste em pequena escala e guarde o estado anterior de cada item alterado. Safe Mode pode ajudar durante mudanças manuais, mas um provisionamento automatizado precisa de compensação própria e de um procedimento operacional de retorno.

  • Criar novo acesso e confirmar autenticação.
  • Alterar plano e validar velocidade e perfil.
  • Suspender e restaurar sem perder o vínculo.
  • Simular indisponibilidade, timeout e resposta parcial.
  • Executar o rollback e conferir o estado final.

O MK-Link relaciona assinante, contrato, plano e integração de rede para organizar o provisionamento no contexto da operação. A equipe configura os equipamentos e perfis aplicáveis antes de liberar ações automáticas.

Comece com um roteador e um grupo controlado, acompanhe logs e pendências e amplie somente após validar os cenários críticos. Perfis de outros fabricantes ou modelos devem permanecer isolados para evitar efeitos colaterais.

  • Vínculo entre regra comercial e perfil técnico.
  • Ações registradas no histórico operacional.
  • Pendências visíveis quando o equipamento não responde.
  • Expansão gradual por equipamento e cenário homologado.

Fontes e referências

Consulte a documentação vigente antes de alterar rede, cobrança ou configuração fiscal.

Perguntas frequentes

Respostas para decidir com segurança

O que pode ser provisionado no MikroTik?

Depende da arquitetura e dos recursos habilitados. A operação pode incluir acessos PPPoE, perfis e parâmetros relacionados, mas cada comando deve ser validado para a versão do RouterOS e a política do provedor.

Preciso usar RADIUS para automatizar?

Não obrigatoriamente. API e RADIUS atendem modelos diferentes. Escolha conforme a topologia, a escala, o controle de sessões e os requisitos de disponibilidade.

É seguro expor a API do MikroTik na internet?

Exposição direta amplia a superfície de ataque. Restrinja origem, portas e permissões e use uma conexão protegida adequada à rede. A configuração deve ser revisada pelo responsável técnico.

Como evitar duplicar usuários ao reprocessar uma falha?

Use identificador único, consulte o estado atual antes de criar e faça a operação idempotente. Uma nova tentativa deve continuar a ação anterior, não abrir um provisionamento independente.

Posso ativar em todos os roteadores de uma vez?

Não é recomendável. Homologue por versão, equipamento e perfil; monitore o piloto; e amplie em lotes pequenos com critérios de interrupção e rollback definidos.

Transforme o conteúdo em processo

Crie sua conta no MK-Link e organize a rotina do provedor com dados, responsáveis e estados visíveis.

P.S.: comece com um fluxo controlado e avance somente depois de validar os dados e as automações.