> 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/configurando-o-seu-userauth/escolha-o-seu-filtro-de-acesso/filtro-dns-com-bind/relatorios-de-acesso-do-userauth.md).

# Relatórios de acesso do UserAuth

## Configuração dos logs UserAuth <a href="#configuracao-dos-logs-userauth" id="configuracao-dos-logs-userauth"></a>

Na versão 4 do UserAuth foi aberta a possibilidade de gerar relatórios dos acessos, utilizando os domínios e FQDNs que são identificados quando se utiliza a integração com filtro DNS.

Para ativar essa funcionalidade, basta navegar até a opção "**Logs"** na guia **General** do UserAuth.

Será necessário configurar a integração com o serviço DNS e paramentos de logs do pfSense®. Configurados na pagina inicial do UserAuth, configuração de **Logs**.

* **Integrate userauth authenticated user to pfSense logs:** Adiciona o nome do usuario aos registros do lo&#x67;**.**
* **Add fqdn to destination:** Adicionará o fqdn nos logs gerados pelo UserAuth, sendo um requisito ter o NGRules ativo;
* **Add rule description:** Adicionará nos logs a descrição da regra criada para identificar o acesso;

Ao selecionar está opçõa, se faz necessario adicionar a descrição ao configurar a regra.

<figure><img src="/files/JL0PX08UWBQ49E2K26Ok" alt=""><figcaption></figcaption></figure>

* **Add DNS/bind9 resolution logs:** Inclui os logs de DNS;
* **Logs Volumetry:** Adiciona volumetria aos logs;
* **Remote syslog:** Integração de um servidor de Greylog externo;
* **Parallel log monitor:** Configuração de quantidade processos máximo para processamento dos logs.

<figure><img src="/files/bredyyjzKdcxuc0oKSqa" alt=""><figcaption></figcaption></figure>

**Patch Configuration:** Aqui temos duas opções:

* **Enable userauth in Sarg:** Nessa opção podemos realizar a integração dos logs entre o UserAuth e o Sarg, permitindo assim uma opção a mais para o gerenciamento dos relatórios;
* **Remove log duplicate:** Essa função foi criada para melhorar os logs do próprio pfSense, que trás por padrão informações de acessos duplicadas.

<figure><img src="/files/JkdUiqf1gzgVU421nLPb" alt=""><figcaption></figcaption></figure>

**Send logons to syslog:** Neste campo pode ser configurado um servidor de logs externos, como por exemplo um Greylog, basta adicionar o IP dele e a ferramenta fará o envio das informações de acesso.

**Logons Log Retention Count:** Se trata do número de dias que os arquivos de logs de login serão retidos antes que a cópia mais antiga seja removida durante a rotação.

**Shipping Format send logons:** Formato que o log pode ser encaminhado para um servidor externo.

<figure><img src="/files/LKkqNoFzVMbCOrO2Wo5i" alt=""><figcaption></figcaption></figure>

## Configuração dos logs no pfSense® <a href="#configuracao-dos-logs-userauth-1" id="configuracao-dos-logs-userauth-1"></a>

Será necessário, inicialmente, aplicar uma configuração dentro dos logs do pfSense® ***"Status -> System Logs -> Settings"***, visto que a ferramenta apenas visualiza o que o pfSense® gera.

Nesta mesma tela de configuração existe a possibilidade de seguir diretamente para a tela de configuração, basta clicar em "**Goto pfSense system log config page".**

<figure><img src="/files/q9VQEMcIe2bP96ZDuZrD" alt=""><figcaption></figcaption></figure>

**Agora siga a ordem de ajustes abaixo:**

* **Log firewall default block:** Vamos desabilitar os logs padrão de bloqueio.
* **Forward/Reverse Display:** Vamos ativar  essa opção de exibição

<figure><img src="/files/bUrLOdg3ywhgtmwid9oD" alt=""><figcaption></figcaption></figure>

* **Log Rotation Size:** Altere o tamanho do arquivo de Logs, lembrando que o tamanho é definido por (Bytes), importante tomar cuidado na hora da conversão.

Na imagem abaixo temos como exemplo  "512000000 KB" convertendo isso para MB da um total de "500MB"

<figure><img src="/files/kAB3HOUGlGeX83JnGIep" alt=""><figcaption></figcaption></figure>

## Relatórios de acessos <a href="#configuracao-dos-logs-userauth-2" id="configuracao-dos-logs-userauth-2"></a>

Após realizar todas as configurações acima citadas, será possível consultar e exportar os logs dos acessos.

&#x20;Basta acessar a guia **"Logs"** do UserAuth.

<figure><img src="/files/Ut1SVH2drhyUGR5j9doc" alt=""><figcaption></figcaption></figure>

Dentro da guia "Logs" temos 3 opções que podem ser vistar na imagem acima:

* **Firewall:** Essa opção trás os logs dos acessos do usuários;
* **UserAuth:** Nessa opção é possível visualizar os logs do próprio UserAuth;
* **User History:** Histórico de login e logoff dos usuários.

## Logs -> Firewall <a href="#configuracao-dos-logs-userauth-3" id="configuracao-dos-logs-userauth-3"></a>

Nessa tela será possível visualizar os logs dos acessos, para tal, você pode utilizar algumas opções de filtros:

* **Max lines:** Quantidade de linhas apresentadas em tela;
* **Firewall Logs Files:** Selecione quais arquivos de banco de dados você deseja usar em sua pesquisa, sendo possível mais de um para exibição;
* **Update Interval:** Com que frequência as entradas de log são atualizadas;
* **String Filter:** Filtro de informações no log, ao clicar em obter ajuda serão apresentadas algumas opções de filtros, para a descrição destas opções avançadas de filtro acesse nesse manual "**Opções avançadas para filtro de logs"**;
* **String Filter Limit:** Tamanho máximo para o conteúdo filtrado;
* **Export Logs:** É possível exportar os registros exibidos na tela utilizando as opções de CSV e HTML. Ao selecionar a opção "Arquivo Completo", será realizado o download do arquivo completo do dia, porém sem formatação.

<figure><img src="/files/6v9UmUmGk2r76GOQHOZ9" alt=""><figcaption></figcaption></figure>

Nos registros deste log, que serão exibidos em tempo real, serão informados o país de origem e destino da conexão, através da bandeira.

Ao clicar no IP de destino ou origem, duas abas serão exibidas logo acima, informando em qual tabela/alias o IP clicado está presente e a quais regras ele pertence.

Para entender como utilizar filtros avançados, clique [aqui](/configurando-o-seu-userauth/escolha-o-seu-filtro-de-acesso/filtro-dns-com-bind/relatorios-de-acesso-do-userauth/utilizacao-avancada-relatorio-com-userauth.md).

## **Logs -> UserAuth**

**Aqui temos algumas opções de filtros, mas são basicamente os mesmo acima informados.**

<figure><img src="/files/Ox5XKAlqeZhxSGbHtykK" alt=""><figcaption></figcaption></figure>

### Firewall logs

Nos campos abaixo temos os registros com as informações relacionadas a licenças do pacote, vencimento, além da quantidade de usuários conectados.

Caso você tenha integração com o AD, serão exibidas informações relacionadas a sincronização e eventos locais, bem como IP e usuário de acesso.

<figure><img src="/files/kNCex8BD6hyKdEMkPPnM" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/AaiTMKaJ3IcOikpjw7kl" alt=""><figcaption></figcaption></figure>

## **Logs -> User History**

Nessa aba, vamos ter também as mesmas opções de filtros já repassados no início dessa página.

<figure><img src="/files/kz4S1Uzqr4pe35MSVsDn" alt=""><figcaption></figcaption></figure>

### Firewall logs

Nos logs vamos ter as informações de login e logoff de cada usuário, além dos eventos relacionadas a data, grupo pertencente, endereço IP, endereço MAC e onde foi feita autenticação (AD, CP ou MAC)

<figure><img src="/files/b1bHWmgGmvVxbwiNejTt" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/2FjbWspNkqGMMa1jOSMS" alt=""><figcaption></figcaption></figure>
