> 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/autenticacao-com-base-de-usuarios-locais-do-userauth.md).

# Autenticação com base de usuários locais do UserAuth

Esta funcionalidade na ferramenta UserAuth possibilita a autenticação de usuários cadastrados na própria ferramenta, sendo vantajosa para ambientes onde não se encaixam em outras formas de autenticação, como Active Directory ou qualquer base LDAP/Externa.

Para que essa base local seja consultada, você precisa selecionar na aba "Gerenal" do UserAuth em “**Autentication source”** a opção **"Local – UserAuth Local Users Authentication".**

[**Saiba mais clicando aqui**](/configurando-o-seu-userauth/configuracao-padrao/metodos-de-autenticacao.md)

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

## **Cadastrando os Usuários Locais** <a href="#cadastro-de-usuarios-locais" id="cadastro-de-usuarios-locais"></a>

Para iniciar navegue até:  **Services -> UserAuth Integration -> Local Users**

**Add:** Para criar um novo usuário é muito simples, basta clicar na opção "add" conforme a imagem abaixo.

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

Preencha os campos solicitados conforme a descrição de cada um:

Importante não utilizar caracteres especiais.

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

Primeiramente, é necessário ativar o usuário, selecionando a opção "Enable".

* **Username**: Identificador dos usuários dentro da ferramenta.
* **Full Name**: Nome completo/descrição do usuário.
* **Email**: Endereço de e-mail deste usuário, este campo é opcional para a configuração.
* **Password**: Senha utilizada para este usuário se autenticar pelo Captive Portal do UserAuth.
* **User Cel Phone Number:** Esse campo é utilizado para autenticação via SMS
* **Enable MFA authentication:** Determina se o usuário precisa realizar o MFA ao autenticar utilizando SMS ou Voucher.

  **OBS**: O segundo fator de autenticação quando ativo será exigido somente para usuários que sejam de auto cadastro.
* **Expire date**: Possibilidade de adicionar uma data limite em que este usuário ficará ativo. Após a data mencionada, ele não validará a autenticação.
* **Extra fields:** Campos a mais para o usuário ter a opção de cadastro na hora do Captive Portal.
* **User Type**: Refere-se à forma de cadastro de usuários.
  * *Normal User*: Usuários criados manualmente por um cadastro simples feito pelo administrador da rede.
  * *Self Registration User*: Usuários criados pelo formulário de "Auto cadastro" disponível na rede.
* **Enable Mac Authentication**: Quando ativada esta funcionalidade, permite a autenticação do usuário de forma automática sem a utilização do Captive Portal, apenas cadastrando o MAC address dos dispositivos daquele usuário.
* **MAC Addresses**: Campo para cadastro dos respectivos endereços MAC do usuário, possibilita a adição de vários, sempre um por linha.

<figure><img src="/files/5ahod4FDCQDuFN0QI1En" alt=""><figcaption></figcaption></figure>

**Exportar Usuários Cadastrados**

Usuários cadastrados localmente na ferramenta têm a opção de exportar a lista em formato CSV. Para isso, basta acessar a guia **"General"** do **UserAuth**, descer até a opção "**Local login Options"** e clicar em **"*****Export local Users Info to CSV"***.

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

## Testando o Seu Novo Usuário Local do UserAuth.

**IMPORTANTE:** Para dar início ao teste do usuário criado é importante já ter feito os passos acima explicados nessa página, bem como todas as ativações e registros referente ao UserAuth.

Com o usuário já criado conforme a imagem, vamos conectar na rede onde o Captive Portal está ativo:

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

Nesse ponto vamos inserir o usuário e senha criado, e clicar em **"Aceitar os termos e continuar"**

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

Após a validação do usuário o mesmo será autenticado e você será direcionado para a página configurada anteriormente no UserAuth, nas opções de [personalização do Captive Portal](/configurando-o-seu-userauth/configuracao-padrao/personalizacao-do-captive-portal-do-userauth.md).

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

Podemos acessar a aba **"Active Sessions"** do UserAuth para visualizar o usuário autenticado.

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

Pronto, toda a configuração necessária foi feita e temos o usuário criado/autenticado.
