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


---

# 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-as-suas-autenticacoes/autenticacao-com-base-de-usuarios-locais-do-userauth.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.