# Configuração E2Guardian

Quando observamos critérios técnicos entre os pacotes que realizam filtro web disponíveis para o pfSense®, é possível notar muito mais desempenho quando utilizando E2Guardian, sem contar que com ele é possível ter um número maior de funcionalidade quando integrado com o UserAuth.

## Instalando E2guardian

Primeiramente será necessário instalar o pacote, navegue até **"System&#x20;*****->*****&#x20;Package Manager&#x20;*****->*****&#x20;Available Packages"**

Pesquise por ele e faça a devida instalação clicando em "Install":&#x20;

<figure><img src="https://1714437560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpDCDzvnBYNPCAsAfnRIZ%2Fuploads%2FRlOLCLBsqFhl0IamPFA4%2Fimage.png?alt=media&#x26;token=c6af418d-ff93-4319-8c0a-9e01d7da74fb" alt=""><figcaption></figcaption></figure>

## Ativando E2Guardian <a href="#ativando-e2guardian" id="ativando-e2guardian"></a>

Inicialmente deve-se ativar a ferramenta e selecionar as interfaces de origem que serão auditadas pela ferramenta. Selecionando o modo de trabalho como transparente ou não e a porta que o serviço será iniciada.

<figure><img src="https://1714437560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpDCDzvnBYNPCAsAfnRIZ%2Fuploads%2F3ll3wkP5xMbBPqmd9Eqr%2Fimage.png?alt=media&#x26;token=5381bfb0-fd66-4d57-a5ae-a5ad0909c609" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1714437560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpDCDzvnBYNPCAsAfnRIZ%2Fuploads%2FaMTSQ3PCeOFwmHl7tw1P%2Fimage.png?alt=media&#x26;token=550e0aef-f045-489e-bb90-465fa38647fb" alt=""><figcaption></figcaption></figure>

Além destas configurações básicas, deve-se tomar muito cuidado com o campo de **“Http workers”**, pois ele interfere de forma direta o desempenho do proxy.

<figure><img src="https://1714437560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpDCDzvnBYNPCAsAfnRIZ%2Fuploads%2FDd6PvHO2D9eSlQkIjOnj%2Fimage.png?alt=media&#x26;token=ba6d9d56-2ecc-4f43-ad46-5be0bc5ff529" alt=""><figcaption></figcaption></figure>

Nele deve ser informa o número de conexões simultâneas, número que deve ser observado em cada ambiente.

## Filtro de páginas HTTPs <a href="#filtro-de-paginas-https" id="filtro-de-paginas-https"></a>

Para realizar o filtro de páginas HTTPs também com o E2Guardian deve-se criar uma CA no pfSense® e ativar o recurso na ferramenta selecionando a autoridade certificadora criada, caso contrário só será filtrado páginas HTTP.

**Criando a Autoridade Certificadora**

Para criar a CA, basta acessar dentro do pfSense® o menu **"*****System -> Certificate Manager -> CAs"*** e adicionar uma nova CA e preencher as informações solicitadas.

<figure><img src="https://1714437560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpDCDzvnBYNPCAsAfnRIZ%2Fuploads%2F1W8m7ArP8RIu2W5ZRKDz%2Fimage.png?alt=media&#x26;token=fdb71be9-55bf-4b73-87a7-eb5eb95cebc0" alt=""><figcaption></figcaption></figure>

Para selecionar a CA e ativar o recurso no pacote, basta acessar a dashboard principal do E2guardian e selecionar o campo **“*****Enable SSL support*****”** e selecionar autoridade criada.

<figure><img src="https://1714437560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpDCDzvnBYNPCAsAfnRIZ%2Fuploads%2FbZHoPFEUvsX6dgkhLejB%2Fimage.png?alt=media&#x26;token=185e3bc9-2f94-43d6-b404-85af11bf28f6" alt=""><figcaption></figcaption></figure>

## Integrando o tipo de autenticação

Para integrar o E2guardian com o UserAuth deve ser selecionado o **“*****Auth Plugins*****”** como **DNS,** dessa forma ele estará preparado para identificar o nome de cada usuário já tratado pela ferramenta de autenticação UserAuth.

<figure><img src="https://1714437560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpDCDzvnBYNPCAsAfnRIZ%2Fuploads%2Faylfvv1xdcJSc0YUEW7u%2Fimage.png?alt=media&#x26;token=df7efb51-aabc-4e2f-aae5-eac85b9fb87b" alt=""><figcaption></figcaption></figure>

### Configuração de níveis de acesso <a href="#configuracao-de-niveis-de-acesso" id="configuracao-de-niveis-de-acesso"></a>

Dentro da aba “*Groups*” é possível criar os níveis de acesso para os respectivos usuários do ambiente.

OBS: para o correto funcionamento do pacote é recomendado que nunca seja excluído ou alterado de ordem o grupo “*default*”, ele serve como index de partida para os demais grupos.

<figure><img src="https://1714437560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpDCDzvnBYNPCAsAfnRIZ%2Fuploads%2FuMad5D7HFZ1Ij46YbTko%2Fimage.png?alt=media&#x26;token=56653b73-eedb-42ef-981e-cd7d579dcee5" alt=""><figcaption></figcaption></figure>

A configuração deste novo grupo exige uma serie de configuração indexadas da aba “*ACL*” que podem ou não ser criadas antes do grupo.

<figure><img src="https://1714437560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpDCDzvnBYNPCAsAfnRIZ%2Fuploads%2FEHRikhVuucXFy3YEj4id%2Fimage.png?alt=media&#x26;token=253b56c9-00b0-46ba-991a-efe61e44baa1" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1714437560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpDCDzvnBYNPCAsAfnRIZ%2Fuploads%2Fuy5Z8m5L75VuMon8E5HH%2Fimage.png?alt=media&#x26;token=d5d6725f-db9d-45b5-ae5b-84c02c3e6da3" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1714437560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpDCDzvnBYNPCAsAfnRIZ%2Fuploads%2FeLdBGCJY2ZSM8CHidHKy%2Fimage.png?alt=media&#x26;token=d3a63487-532e-413f-846d-50055a229bde" alt=""><figcaption></figcaption></figure>

## Atribuindo usuários aos grupos <a href="#atribuindo-usuarios-aos-grupos" id="atribuindo-usuarios-aos-grupos"></a>

Para alocar os usuários aos seus devidos grupos, basta adicioná-los no grupo desejado na aba “*Users*”.

<figure><img src="https://1714437560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpDCDzvnBYNPCAsAfnRIZ%2Fuploads%2FF8btcvaIKNwxxCB55Nmv%2Fimage.png?alt=media&#x26;token=e200fea6-76b9-4261-a2d4-2e5fe8b102cd" alt=""><figcaption></figcaption></figure>

OBS: Essa “**configuração manual dos usuários em seus grupos**” é utilizada quando a origem dos grupos na ferramenta UserAuth é marcada como **“*****E2guardian Groups*****”**, conforme explicado, quando ativada a ferramenta, caso contrário, deve manter os campos vazios, pois o UserAuth alocará os usuários dinamicamente conforme AD.

<figure><img src="https://1714437560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpDCDzvnBYNPCAsAfnRIZ%2Fuploads%2FcpwYTmrSVZtaG9wGaJkZ%2Fimage.png?alt=media&#x26;token=295f8218-62cc-49cc-a6ec-c0bd2dfbc8bd" alt=""><figcaption></figcaption></figure>

## Configurando log <a href="#configurando-log" id="configurando-log"></a>

Nas opções da aba **“Report and Log”** é possível configurar a tela de erro que será exibida, optando pela tela padrão ou personalizando a página conforme a necessidade.

<figure><img src="https://1714437560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpDCDzvnBYNPCAsAfnRIZ%2Fuploads%2FFIjRPmuBPIIho3zjokCS%2Fimage.png?alt=media&#x26;token=c12ccd8f-a684-4f69-a681-17e018aacd30" alt=""><figcaption></figcaption></figure>

Ainda nesta aba, podemos alterar o formato do log que é uma configuração essencial para leitura correta dessas informações pelo Sarg (pacote integrado para leitura e geração dos relatórios de acesso). O Sarg entende logs apenas o padrão Squid, por isso é necessário mudar esta opção para “*Squid Log File Format*”, consulte o capítulo sobre relatórios o Sarg [clicando aqui.](https://docs.userauth.com.br/opcoes-avancadas-do-userauth/filtro-de-logs-com-sarg/sarg-com-e2guardian)

<figure><img src="https://1714437560-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpDCDzvnBYNPCAsAfnRIZ%2Fuploads%2FnuZ5TceQ84EU4odPFlqs%2Fimage.png?alt=media&#x26;token=dc21fcd3-f4fe-4792-a0b4-2befda109170" alt=""><figcaption></figcaption></figure>

Caso queira entender mais sobre a ferramenta, o time da ConexTI elaborou um treinamento exclusivo [sobre o pacote E2Guardian ministrado](https://sys-squad.com/produto/e2guardian/) pelo próprio desenvolvedor da ferramenta, disponível na plataforma de ensino [Sys-Squad](https://sys-squad.com/).<br>
