# 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 *****->***** Package Manager *****->***** Available Packages"**

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

<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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.userauth.com.br/configurando-o-seu-userauth/escolha-o-seu-filtro-de-acesso/filtro-web-com-e2guardian/configuracao-e2guardian.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.