Skip to content

Restrição de rede da gestão

Um streamer edge serve mídia para a internet, mas a mesma porta HTTP expõe também a API de administração, o console, as métricas e o diagnóstico. A restrição de rede fecha o plano de gestão às redes confiáveis, mantendo a reprodução, a publicação e o tráfego próprio do cluster.

A restrição é uma lista de endereços IPv4/IPv6 e CIDR no ajuste management_allowed_ips. Enquanto a lista estiver definida, uma rota de gestão responde a uma solicitação de qualquer outro endereço com 403 e sem redirecionamento. Se a lista estiver ausente ou vazia, nada fica restrito.

O que é gestão e o que não é

A divisão está fixada no código e não se configura:

  • A mídia continua pública — HLS, DASH, fragmentos MPEG-TS/fMP4, pré-visualizações, VOD, rotas legacy de reprodução, publicação (MPEG-TS push, WHIP/WHEP) e o upload de VOD assinado. Valem a autorização habitual: tokens de reprodução, sessões de publicação, permissões de upload.
  • Gestão é todo o resto — a API de administração (v3/v4), o console e seus recursos, métricas, diagnóstico, o relé ONVIF, o proxy reverso integrado quando de fato executa a solicitação, NMOS tanto na porta compartilhada quanto na dedicada, e qualquer rota que o servidor não reconheça. A verificação de saúde também é gestão: o balanceador que sonda o servidor precisa estar em uma rede permitida.

A autorização não desaparece: um endereço permitido ainda precisa passar pelo login habitual, pelas chaves de API e pelos papéis. A restrição limita quem pode bater à porta, não quem é admitido.

Configurar a política

Em um cluster a política vive no console do central, seção Configurações → Restrição de rede da gestão. Três estados:

  • Não definido (herdado) — vale o valor da camada menos prioritária; para um streamer gerenciado é a configuração local dele.
  • Desativada (todas as redes) — gravada como uma lista vazia [], desliga explicitamente a restrição e sobrepuja as camadas inferiores.
  • Redes permitidas — um endereço ou CIDR por linha.

O servidor grava e devolve a forma canônica: um endereço sem máscara vira 192.0.2.10/32 ou 2001:db8::10/128, e os host bits de um CIDR são mascarados (198.51.100.77/24 é gravado como 198.51.100.0/24). A ordem das entradas é preservada. Um erro de digitação em uma linha é rejeitado ao salvar: 422 com o caminho até a entrada, e a mensagem aparece no campo.

O formulário adverte antes de salvar uma lista não vazia: certifique-se de que a rede da qual você está conectado conste nela, ou o console mesmo ficará inacessível. Se isso acontecer, corrija o ajuste a partir de uma máquina dentro de uma rede permitida (ou por um caminho fora de banda, como o console do hipervisor). Não existe um mecanismo automático de "permitir meu endereço atual".

Para um streamer autônomo sem central, o mesmo ajuste é o campo management_allowed_ips de nível superior da configuração do servidor.

Camadas e o cartão do streamer

A política é composta de camadas, a mais forte por último: o arquivo principal, depois o central e por fim os arquivos drop-in da máquina. No diretório .d ao lado da configuração, só são lidos como drop-ins os arquivos *.json e *.conf: um *.yaml ali é ignorado silenciosamente, então nomeie os drop-ins de acordo ou a lista deles não será aplicada. Em streamers gerenciados o central entrega seu ajuste como um valor somente de leitura; não é possível definir uma política própria por máquina. Se o documento de um streamer vier a conter seu próprio management_allowed_ips, o servidor rejeita a gravação com 422 sem alterar o documento; uma chave gravada obsoleta pode ser removida escrevendo null, o que limpa a cópia entregue sem tocar na política comum.

O cartão do streamer mostra os dois lados separadamente:

  • Definido no central — a política comum da página de configurações.
  • Aplicado pelo nó (último relatório) — a lista que a máquina de fato aplica, conforme o último relatório, com a hora em que foi recebido.

As duas listas podem diferir: um drop-in local na máquina substitui o central, e o cartão o indica. Uma lista relatada vazia significa que a restrição está desativada na máquina; um relatório ausente significa sem dados, não uma restrição desligada: a política comum nunca é substituída por um relatório ausente. Se a máquina perder a conexão, a última lista relatada permanece no cartão marcada como não confirmada.

Como uma solicitação é verificada

Somente o endereço par da conexão TCP é verificado. X-Forwarded-For, X-Real-IP e Forwarded são ignorados: os proxies confiáveis do lado da reprodução não influenciam a gestão, e um cabeçalho falsificado não muda nada. Um endereço IPv4 escrito na forma IPv4-mapped IPv6 também corresponde a entradas IPv4 da lista; uma rede IPv6 explícita mantém sua própria correspondência.

Permitir um proxy reverso significa confiar em todas as solicitações do seu endereço: o streamer não consegue distinguir os clientes do proxy. Mantenha o caminho de gestão por uma rota direta LAN/VPN, ou aplique sua própria lista de permitidos no proxy.

Aplicação e entrega

A mudança na lista é aplicada na hora, sem reinício e sem reatribuir portas: a reprodução não é interrompida. Um streamer gerenciado inicia a partir da configuração salva mesmo sem link com o central; quando o ajuste do central chega, ele se sobrepõe. Se a recarga da configuração falhar antes de ser aplicada, continua valendo a lista anterior; uma aplicação parcial (por exemplo, a lista nova publicada mas com outra etapa falhada) deixa a lista nova em vigor junto com o erro: o cartão mostra o valor e o config_error separadamente, sem reversão silenciosa. Um arquivo drop-in defeituoso é ignorado com um aviso, como antes: se ele carregava a lista mais restrita, a política efetiva pode enfraquecer — acompanhe o conteúdo do diretório .d.

Central integrado

Se o central estiver instalado na mesma máquina que o streamer (entrega integrada), ele aceita e guarda o ajuste e o entrega aos streamers gerenciados, mas ainda não o aplica às próprias rotas de gestão: o cartão deste nó na lista de máquinas o mostra diretamente: «definido no central» aparece, mas «aplicado pelo nó» consta como «desativado», com uma explicação. Uma lista salva ainda não significa que este servidor esteja protegido: os streamers gerenciados aplicam a política independentemente dele.

Reversão e downgrade

Se reverter a versão do próprio streamer, o ajuste some apenas dos seus arquivos de configuração local; o ajuste salvo no central e a cópia local da configuração entregue são preservados e voltam na próxima atualização. Reverter apenas o central pode entregar aos streamers um documento sem este campo, e a política comum será desativada nos streamers novos. Depois de voltar à versão nova do central, salve novamente a lista desejada nas configurações comuns (mesmo que ela já esteja escrita, salve o mesmo texto de novo) e verifique nos cartões dos streamers que ela foi aplicada: nem uma reinicialização nem um documento intacto bastam, sozinhos, para restaurar a entrega.

No que a restrição não se transforma

  • Não é um firewall: guarda as rotas HTTP de gestão do servidor, não a máquina. A filtragem no nível do sistema operacional continua por sua conta.
  • Não substitui a autorização: logins, tokens e papéis funcionam como antes.
  • Não restringe os protocolos de mídia: RTSP, RTMP, SRT e demais protocolos não HTTP ficam fora deste mecanismo.