> For the complete documentation index, see [llms.txt](https://docs.userauth.com.br/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.userauth.com.br/bem-vindo-a-base-de-conhecimento-do-userauth-ng.md).

# Bem-vindo à Base de Conhecimento do UserAuth-NG

UserAuth-NG: Inteligência, Identidade e Controle de Tráfego para pfSense®

O UserAuth-NG é um pacote exclusivo desenvolvido pela ConexTI para servidores físicos ou virtuais rodando a plataforma de Firewall pfSense® CE. Distribuído por meio de uma Licença Anual de Uso, o pacote garante suporte técnico especializado, contínuas atualizações de segurança e evolução tecnológica constante.

#### 🛡️ 1. Entradas e Identidade Flexíveis

O sistema centraliza e unifica múltiplos métodos de autenticação e contexto de rede, permitindo identificar o usuário de forma transparente ou controlada:

* Múltiplas Fontes de Entrada: Suporte integrado a AD Windows (via WSS), Captive Portal (local, social, Enterprise e MFA) e integrações via VPN / RADIUS.
* Mapeamento de Contexto: Criação automática de um robusto *Cache de Identidades* (usuário ↔ IP), gerenciamento de grupos de sessão e autenticação por MAC.

#### ⚙️ 2. Classificação de Tráfego e Políticas Avançadas (L7)

Na camada de controle, o UserAuth-NG elimina a necessidade de proxies complexos intermediários através de uma arquitetura modular de alta performance:

* Regras L7 e Inspeção Profunda: Filtragem avançada baseada em identidade, origem, destino, domínio, SNI e assinaturas JA4.
* Filtro DNS e Categorias: Controle granular de acesso a aplicações e conteúdos (como Netflix, YouTube, WhatsApp e Conteúdo Adulto) utilizando listas, expressões regulares (regex) e exceções customizadas.
* Estratégias de Decisão Flexíveis: Lógica de processamento de políticas otimizada (*first\_match* / *deny\_overrides*).

#### 🚀 3. Ecossistema de Engines e Integrações

O tráfego da rede é processado por um conjunto robusto de motores especializados que atuam em conjunto no pfSense®:

* Múltiplas Engines de Rede: Integração nativa com DNS Server, Web Proxy (HTTP/CONNECT e transparente), Quic Proxy, Captura Passiva de pacotes, PF/PFLOG e Suricata / IPRep para reputação e segurança.
* Decisão Imediata (Pass/Block): O tráfego de rede é liberado ou bloqueado instantaneamente nas camadas de DNS, proxy e firewall, garantindo latência zero na navegação.

#### 🤖 4. Inteligência Artificial (IA) em Segundo Plano

Uma das grandes inovações do ecossistema é o uso de IA operando de forma assíncrona — ou seja, a decisão imediata do tráfego nunca espera a IA, garantindo máxima velocidade:

* Decision Engine & Fingerprints: Análise automatizada de padrões, catálogo de aplicações e suporte a backends avançados (como Ollama, LM Studio, APIs compatíveis, Hermes Agent ou OpenCloud).
* Assistente Inteligente: Auxilia administradores com explicações contextuais de eventos e revisão automatizada de políticas de acesso.

#### 📊 5. Visibilidade e Auditoria Completa

O sistema eleva o nível de monitoramento corporativo muito além do HTTP/HTTPS tradicional:

* Logs: Registros detalhados de conexões estabelecidas ou negadas em tempo real.
* Estatísticas e Auditoria: Visão panorâmica e comportamental de toda a navegação dos usuários na internet, integrada dinamicamente com Aliases do PF e listas de IPRep.