> 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-as-suas-autenticacoes/integrando-userauth-com-dc-ad-windows.md).

# Integrando UserAuth com DC AD Windows

## **Configurando o UserAuth com AD e domínio**

### Pré-requisitos <a href="#pre-requisitos" id="pre-requisitos"></a>

Para que a integração do UserAuth com o AD funcione corretamente deve-se tomar alguns cuidados principalmente referente ao logs. **O AD deve estar gerando corretamente** os eventos de **ID 4624, 4634 e 4769**, para verificar isso você deve acessar o **"Visualizador de Eventos do Windows"**, na aba segurança e pesquisar os eventos acima citados.

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

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

<figure><img src="/files/4YNBuuIvlxZvY0yNzbJw" alt=""><figcaption></figcaption></figure>

Também deve-se verificar se os serviços de logs do servidor estão rodando. Para isso basta acessar a tela de Serviços e verificar:

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

<div align="left"><figure><img src="/files/UqImd1mo2oswRL23ilH3" alt=""><figcaption></figcaption></figure></div>

Com relação aos grupos de acessos criados para acesso a internet, o escopo do grupo deve ser **"Global"** ou **"Universal"**, caso seja criado como **"Dominio Local"** a ferramenta não conseguirá identifica-lo na integração.

<div align="center"><figure><img src="/files/B3uRBngYkuagQz1abmQU" alt=""><figcaption></figcaption></figure></div>

## Adicionando integração com Active Directory <a href="#adicionando-integracao-com-active-directory" id="adicionando-integracao-com-active-directory"></a>

Agora vamos efetuar a configuração dos acessos através do Active Directory do Windows. Inicialmente ativamos o server de domínio, e verificamos suas configurações para poder atribui-lo nas configurações do UserAuth.

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

Em seguida basta acessar a aba de ***Domains*** no UserAuth e adicionar as configurações do controlador de domínio.

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

Atribuímos então a configuração do nosso server de domínios no domínio do UserAuth.

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

## Integração utilizando o Cliente ConexTI <a href="#integracao-utilizando-o-cliente-conexti" id="integracao-utilizando-o-cliente-conexti"></a>

[A partir de 14 de março de 2023, as atualizações do Windows Server](https://support.microsoft.com/en-us/topic/kb5004442-manage-changes-for-windows-dcom-server-security-feature-bypass-cve-2021-26414-f1400b52-c141-43d2-941e-37ed901c769c) não permitirão mais consultas externas via WMI. Portanto, em sistemas que possuam os patches mais recentes do Windows, será necessário instalar o cliente ConexTI para garantir a integração e autenticação transparente dos usuários que ingressam no domínio. O processo é simples: primeiro, altere a opção **WMI client version** nas opções avançadas da ferramenta para ***User WMI Remote Agent*** , clique em salvar.

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

Em seguida faça download do cliente no seu servidor Windows que roda a feature de Active Directory utilizando o botão **"*****Download windows Client"*** presente na aba de **Opções Avançadas** na aba **General** do UserAuth.

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

Para realizar a instalação, comece descompactando o arquivo **".zip"** e, em seguida, execute o arquivo **"ConexTI\_Integration\_Service.exe"**. Assim que o cliente for iniciado, avance para a primeira tela de introdução.

<div align="center"><figure><img src="/files/9L9M538TZU1dmmKr0eeN" alt=""><figcaption></figcaption></figure></div>

Após isso, será exibida a tela de configuração do **IPv4 do Firewall pfSense®**. É para este IP que o cliente ConexTI vai encaminhar os logs de autenticação dos usuários do Active Directory. Tenha certeza sobre qual é o IP do seu Firewall pfSense para que a integração entre o seu Microsoft AD e o Proxy rodando no pfSense aconteça de forma correta.

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

Após inserir o endereço IP do pfSense®, clique em **"Gravar Configuração"** para que o instalador inicie o processo de instalação do cliente e a configuração inicial. Após alguns segundos, o processo será concluído e você será solicitado a finalizar a instalação.

<div align="center"><figure><img src="/files/UvLyTPw8BJb73nBz1gcz" alt=""><figcaption></figcaption></figure></div>

**`IMPORTANTE:`**` ``Quando configurado o CIS (ConexTI Integration Service) no servidor AD, é importante que o serviço WPAD esteja rodando no servidor pfSense®. Caso contrario, serão exibidos logs de TimeOut POST por conta da validação de acesso que o CIS executa. Além disso, após a instalação e configuração do CIS no seu Active Directory, será necessário realizar o restart do PHP no servidor pfSense® (utilizando a opção 16 da Shell).`

`Outra situação importante é garantir que haja uma regra de firewall no seu servidor pfSense® aceitando conexões destinadas à ele mesmo vindas do Active Directory que possui o CIS instalado.`

## Configurando Origem dos Grupos <a href="#configurando-origem-dos-grupos" id="configurando-origem-dos-grupos"></a>

Para que a ferramenta UserAuth pesquise os usuários e alimente os grupos de forma automatizada com base no AD, basta selecionar no campo ***User's group(s) location*** a opção **"Active Directory groups"**.

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

## Verificando integração <a href="#verificando-integracao" id="verificando-integracao"></a>

Podemos verificar que já está comunicando com o server e o UserAuth através da aba logs, verificando que nenhum membro de cliente foi encontrado, e que o usuário Administrador já está logado.

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

## Bloqueando Logs <a href="#bloqueando-logs" id="bloqueando-logs"></a>

Como o UserAuth efetuará uma busca no AD a cada 10 minutos, conforme nós configuramos, os logs de acesso do administrador tendem a se repetir, toda vez que a mesma é efetuada, dessa forma, nós podemos bloquear estes logs com a configuração na aba "**Exception**" adicionando o usuário no campo de "**Ignore accounts**".

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

## Grupos dentro do AD <a href="#grupos-dentro-do-a-d" id="grupos-dentro-do-a-d"></a>

Criamos grupos e usuários dentro do AD.

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

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

Podemos verificar que os usuários já aparecem como encontrados nos logs do UserAuth.

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

Também na guia Active Session podemos verificar que os usuários já aparecem ativos e que o usuário admin criando anteriormente e o marcelloc estavam ainda ativos, visto que cada sessão dura 4 horas.

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

## Desconectando Usuários <a href="#desconectando-usuarios" id="desconectando-usuarios"></a>

Então vamos forçar a desconexão das sessões.

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

## Fazendo logon dentro do dominio <a href="#fazendo-logon-dentro-do-dominio" id="fazendo-logon-dentro-do-dominio"></a>

Agora vamos forçar o logon da conta do Marcelloc no domínio.

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

Podemos verificar que assim que logado, dentro dos logs do UserAuth já aparece as informações de logon.

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

Também nas sessões ativas ele já trouxe a sessão de Marcelloc como ativa novamente.

<figure><img src="/files/1llugzqHAoFTIZBveDq8" alt=""><figcaption></figcaption></figure>

Efetuando o teste de navegação podemos verificar que o mesmo continua navegando.

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

## Aplicando aliases <a href="#aplicando-aliases" id="aplicando-aliases"></a>

Agora vamos duplicar a regra de acesso para avaliar trafego, antes configuramos um alias de portas para auxiliar.

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

Duplicamos a regra e configuramos como operação agora, dando acesso somente ao nosso alias web.

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

E duplicamos a regra novamente, liberando o trafego agora de ICMP, unicamente para verificarmos o trafego.

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

E então colocamos nossa máquina virtual para pingar e vamos analisar o trafego.

<figure><img src="/files/3b5YzXCakygqI3BBAczZ" alt=""><figcaption></figcaption></figure>

## Testando acessos <a href="#testando-acessos" id="testando-acessos"></a>

Como meu perfil do AD está em ambos os grupos, está gerando trafego somente no suporte (por a regra estar por primeiro solicitando a utilização).

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

Mesmo com a regra liberando a conexão através do grupo suporte, os acessos são concedidos através da ordem de configuração do E2Guardian, validando somente o primeiro grupo configurado, nesse nosso caso o operacao, grupo mais limitado.

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

Como os nossos grupos estão sem o filtro de autenticação SSL liberado, verificamos que o site retorna em erro.

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

E tentando acessar um site sem certificação SSL, podemos perceber que ele retorna com a tela de bloqueio (por estar reconhecendo o grupo operação).

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

## Ativando interceptação SSL <a href="#ativando-interceptacao-ssl" id="ativando-interceptacao-ssl"></a>

Agora vamos liberar o filtro SSL para o grupo.

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

E vamos liberar o acesso aos sites no e2guardian.

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

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

Tentando acessar o site com certificado, ele já solicita a instalação do certificado.

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

Agora podemos acessar o firewall para efetuar a liberação do certificado, este que podemos acessar agora da própria VM.

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

Liberado e baixado o mesmo, podemos importar para o browser.

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

Agora ele já reconheceu o certificado instalado e está indo para a tela de bloqueio.

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

Como possuímos somente o site da ConexTI® e as mídias sociais, podemos efetuar o teste, verificando que ele está acessando e gerando o certificado.

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