Integrações — NiFi

ChartVersion3.0.1TypeapplicationAppVersion1.28.0

CompatibilidadeKubernetes1.32+OpenShift4.19+Rancher2.10.x+

Visão geral das integrações

O Apache NiFi pode ser integrado ao Apache Ranger para controle centralizado de acesso a flows e componentes. Essa integração é configurada pelo chart tdp-ranger (não pelo tdp-nifi): o Ranger instala um plugin no NiFi e passa a ser a fonte de autoridade para todas as decisões de acesso.

Essa página descreve o registro e a configuração da integração pelo lado do Ranger. Para configurar o NiFi para usar o Ranger como mecanismo de autorização (nifiCluster.security.authorization.mode: "ranger"), consulte Segurança — NiFi.

Integração com Apache Ranger

Como funciona

O plugin Ranger para NiFi intercepta as solicitações de acesso aos components do NiFi (ProcessGroups, Processors, portas de entrada/saída) e as valida contra as políticas definidas no Ranger Admin. Políticas padrão são criadas automaticamente pelo configJob do chart tdp-ranger quando a integração está habilitada.

Habilitar a integração

A configuração é feita no chart tdp-ranger, não no tdp-nifi. O chart Ranger precisa ser instalado com rangerIntegrations.nifi.enabled=true e saber onde o NiFi está rodando:

rangerIntegrations:
  configJob:
    enabled: true
  nifi:
    enabled: true
    serviceName: "<NIFI_SERVICE>"
    serviceDisplayName: "NiFi TDP"
    connection:
      nifiUrl: "http://<NIFI_SERVICE>.<NAMESPACE>.svc.cluster.local:8080"
      authenticationType: "none"
    credentials:
      username: "<USERNAME>"
      password: "<PASSWORD>"

Pré-requisito

O NiFi deve estar implantado e acessível a partir do namespace do Ranger antes de habilitar essa integração. O configJob aguarda o Ranger ficar pronto, mas o NiFi precisa estar rodando quando o job executar o registro.

Instalação ou atualização com a integração

Terminal input

helm upgrade --install <RANGER_RELEASE> \
  oci://registry.tecnisys.com.br/tdp/charts/tdp-ranger \
  -n <NAMESPACE> \
  -f <BASE_VALUES_FILE> \
  -f <VALUES_FILE>

Ou via --set:

Terminal input

helm upgrade --install <RANGER_RELEASE> \
  oci://registry.tecnisys.com.br/tdp/charts/tdp-ranger \
  -n <NAMESPACE> \
  --set rangerIntegrations.nifi.enabled=true \
  --set rangerIntegrations.nifi.connection.nifiUrl=http://<NIFI_SERVICE>.<NAMESPACE>.svc.cluster.local:8080

Verificação

Após a integração, verifique no Ranger Admin que o serviço NiFi aparece em Service Manager:

Terminal input

kubectl -n <NAMESPACE> get jobs
kubectl -n <NAMESPACE> logs job/<RANGER_RELEASE>-ranger-integrations

No Ranger Admin, acesse NiFi → Policies para ver as políticas criadas automaticamente.

Parâmetros principais

Parâmetro	Descrição
rangerIntegrations.nifi.enabled	Habilitar a integração NiFi no Ranger
rangerIntegrations.nifi.serviceName	Nome do serviço no Ranger
rangerIntegrations.nifi.connection.nifiUrl	URL do NiFi acessível do cluster
rangerIntegrations.nifi.connection.authenticationType	Tipo de autenticação (none para acesso sem credenciais)
rangerIntegrations.nifi.credentials.username	Usuário admin do NiFi
rangerIntegrations.nifi.credentials.password	Senha do admin do NiFi

Consulte helm show values oci://registry.tecnisys.com.br/tdp/charts/tdp-ranger para a lista completa de parâmetros da integração NiFi.