Ir para o conteúdo

Roteiro: Ajustar o firewall do softswitch com segurança

Perfil necessário: admin Menus usados: Segurança e Rede Risco: alto (regra/prioridade errada bloqueia SIP/RTP ou causa lockout do acesso de gestão) Rollback: corrigir/reordenar as regras e clicar Aplicar firewall novamente; mantenha acesso de console/out-of-band ao host antes de qualquer apply

Pré-requisitos

  • [ ] Seu IP de gestão atual está coberto por uma regra allow (ou é IP de endpoint/endereço confiável, que ganham abertura automática)
  • [ ] Portas centrais conhecidas: SIP 5060 (udp/tcp), RTP 16384-32768/udp
  • [ ] Acesso de console/out-of-band ao host disponível em caso de lockout
  • [ ] Regras vigentes revisadas — o apply é full-sync do conjunto cadastrado no banco

Passo a passo

1. Revisar as regras existentes

Caminho: Segurança e Rede → Firewall (aba Regras)

Página Firewall com o botão Aplicar firewall destacado

Confirme pela listagem:

Coluna O que verificar
Prioridade regras allow de gestão/SIP têm número menor que os drops genéricos (prioridade menor avalia primeiro)
Ação allow (verde) ou drop (vermelho); tipo em allow/drop
Origem CIDR/IP da regra; regras automáticas mostram o nome do endpoint ou Address <ip> na coluna Tipo
Portas conjunto de portas associado (vazio = todas)
Tipo Manual (editável) ou rótulo automático (endpoint/address — o cadeado indica que não se edita aqui)
Ativo regras inativas não entram no apply
Comentário rastreabilidade de quem/por quê

A tag no cabeçalho mostra o estado atual do host: Firewall ativo (verde, tabela nftables sw_firewall aplicada) ou a mensagem Carregando.../Firewall ainda não aplicado... (cinza).

2. Criar conjunto de portas (opcional, recomendado)

Caminho: Segurança e Rede → Firewall → aba Conjuntos de portas Clique: [Novo conjunto]

Dialog Novo conjunto de portas

Preencha:

Campo Obrig. Formato/exemplo Efeito
Nome * sim sip, rtp referência usada pelas regras
Portas * sim 5060 ou 10000-20000 ou 5060,5061 portas do conjunto
Protocolos não udp,tcp (default do formulário) protocolos abrangidos
Descrição não livre documentação interna

Resultado esperado: conjunto listado; linhas com Sistema = Sim são mantidas pelo produto (edição/exclusão bloqueadas).

3. Criar a regra

Caminho: Segurança e Rede → Firewall → aba Regras Clique: [Nova regra]

Dialog Nova regra do firewall

Preencha:

Campo Obrig. Formato/exemplo Efeito
Prioridade sim (default 100) inteiro ≥ 0 ordem de avaliação; menor avalia primeiro
Ação sim allow / drop veredito do tráfego que casa a regra
Origem (CIDR ou IP) sim 192.168.0.0/24 ou 10.0.0.1/32 origem do tráfego
Conjunto de portas não seletor (limpa com o X) restringe a regra às portas do conjunto; vazio = todas
Ativo sim (default ligado) switch habilitação da regra
Comentário não livre rastreabilidade

Clique em [Criar] (ou [Salvar] na edição).

Resultado esperado: regra aparece na listagem na posição de prioridade correta. Regras automáticas (geradas de Endpoints/Endereços Confiáveis) não podem ser editadas nem excluídas aqui — o botão de cadeado indica isso; elas desaparecem quando o recurso de origem é removido.

4. Bloqueios em massa: país, ASN e IPset (opcional)

Caminho: Segurança e Rede → Firewall → aba Bloqueios

  • Sub-aba País — Clique: [Bloquear país]
Campo Obrig. Formato/exemplo Efeito
Código país (ISO 2) * sim BR, US (2 letras, caixa alta) bloqueia origens daquele país
Ativo sim (default ligado) switch habilitação
Comentário não livre rastreabilidade
  • Sub-aba ASN — Clique: [Bloquear ASN]
Campo Obrig. Formato/exemplo Efeito
Número AS * sim 12345 (inteiro ≥ 0) bloqueia origens daquele AS
Ativo sim (default ligado) switch habilitação
Comentário não livre rastreabilidade
  • Sub-aba IPset — Clique: [Novo IPset]
Campo Obrig. Formato/exemplo Efeito
Nome * sim blacklist (fixo após criar) identificação do conjunto
Tipo sim block (vermelho) / allow (verde) semântica do conjunto
Ativo sim (default ligado) switch habilitação
Comentário não livre rastreabilidade

Com o IPset criado, abra [Entradas] (ícone de lista na linha) para gerenciar os CIDRs:

Dialog de entradas do IPset

  • Digite o CIDR (192.168.0.0/24 ou 10.0.0.1/32) e Clique: [Adicionar]; remova com o botão de lixeira da linha.

Resultado esperado: bloqueio listado com contagem de entradas (IPset) — ainda sem efeito no host até o passo 5.

5. Aplicar no host

Caminho: Segurança e Rede → Firewall (qualquer aba — o botão fica no cabeçalho) Clique: [Aplicar firewall]

Resultado esperado: toast de sucesso e a tag do cabeçalho passa a Firewall ativo. O apply executa o script nftables do host (iproute-sw-firewall-apply via sudo) que lê o banco e materializa a tabela inet sw_firewall. Sem esse clique, nada muda no host — salvar/cadastrar é só banco.

6. Validar sem lockout

  • [ ] Tag Firewall ativo no cabeçalho da página
  • [ ] Seu acesso ao admin segue funcionando (gestão)
  • [ ] SIP de produção entra: Chamadas Ativas segue fluindo e registro SIP novo é aceito (Registro SIP)
  • [ ] RTP flui: chamada de teste com MEDIA presente no fluxo SIP (CDR → fluxo SIP)

Chamadas ativas após o apply

Validação

  • [ ] Visual: tag Firewall ativo em Segurança e Rede → Firewall
  • [ ] Funcional: nft list table inet sw_firewall no host reflete as regras; chamada SIPp/registro de endpoint de teste passa

Erros comuns

Sintoma Causa provável Correção
Perdeu acesso ao admin após apply IP de gestão sem allow console/out-of-band; criar allow na prioridade 0 e Aplicar firewall
Chamadas param após apply drop genérico com prioridade menor que o allow do SIP 5060 reordenar prioridades e aplicar de novo
Áudio mudo em um lado range RTP bloqueado criar/ajustar conjunto de portas RTP e aplicar
Carrier não entrega chamada IP do carrier não permitido allow para o IP (ou cadastrar endpoint/endereço confiável) e aplicar
Botão Aplicar firewall falha script ausente no host instalar /usr/local/bin/iproute-sw-firewall-apply + sudoers (ver mensagem de erro)
Regra automática não deixa editar origem endpoint/address gerenciar pelo recurso de origem (Endpoints / Endereços Confiáveis)

Tabela de referência rápida

Item Onde Aplica com
Regras allow/drop aba Regras [Aplicar firewall]
Conjuntos de portas aba Conjuntos de portas [Aplicar firewall]
Bloqueio por país/ASN aba Bloqueios → País / ASN [Aplicar firewall]
IPsets e entradas CIDR aba Bloqueios → IPset [Aplicar firewall]
Abertura automática SIP/RTP Endpoints + Endereços Confiáveis [Aplicar firewall] (não criar regra manual duplicada)
Estado do host tag no cabeçalho da página —