# Autenticação

## Visão Geral

Este tópico está organizado em sub-tópicos específicos para cada configuração, pois a ativação de cada parâmetro pode gerar novas opções e variáveis no sistema, permitindo expandir e detalhar as regras aplicadas.

Selecione o tópico correspondente à ação que será realizada para iniciar o procedimento no módulo de Autenticação:

* [Método de Autenticação](#metodo-de-autenticacao)
* [LDAP](#ldap)

## Como acessar a aba Autenticação

Acesse o menu **Configuração > Sistema.** Na tela de configurações do Sistema, clique no nome **Autenticação** para estender a tela com os campos a serem preenchidos.

<figure><img src="/files/iLyu11uEG4gEUa9jFQtv" alt=""><figcaption><p><em>Tela de configurações do Sistema</em></p></figcaption></figure>

### Método de Autenticação

Na seção Autenticação, é possível configurar alguns campos, preencha da seguinte forma:

1. **Método de Autenticação**: Define o tipo de autenticação que o sistema utilizará para acesso.

Clique em **Salvar** para aplicar a configuração.

<figure><img src="/files/UkDgyZR8PzaAFi20nor6" alt=""><figcaption><p><em>Sub-Tópico Método de Autentificação</em></p></figcaption></figure>

### LDAP

Para configurar o LDAP, é necessário, em parceria com a área de TI, obter as informações do servidor onde o protocolo está ativo, garantindo que o SURICATO possa se conectar corretamente e compartilhar os dados necessários.

#### Preparando Ambiente para o LDAP

Antes de configurar o servidor **LDAP**, é necessário ajustar uma parametrização no arquivo **php.ini**:

* Localize o arquivo no diretório do SURICATO. O caminho padrão é:\
  `..\Program Files\Telematica\SURICATO\apache\php`
* Abra o arquivo **php.ini** com um editor de texto, como o **Bloco de Notas**, e altere o valor necessário antes de prosseguir com a configuração do LDAP.

<figure><img src="/files/d7mwx2TsXfI5Olsu3Oeq" alt=""><figcaption><p><em>Arquivo php.ini</em></p></figcaption></figure>

No **Bloco de Notas**, localize o parâmetro:

```
extension=php_ldap.dll
```

* Se houver um ponto e vírgula (`;`) no início da linha, remova-o para habilitar a extensão.
* Salve o arquivo para aplicar a alteração.

<figure><img src="/files/ZZQ7NqMQzSUD0HmFzctw" alt=""><figcaption><p><em>Alteração Arquivo php.ini</em></p></figcaption></figure>

Após ajustar o **php.ini**, configure o **LDAP** no SURICATO seguindo os passos abaixo:

* **Endereço IP do Servidor LDAP**: Informe o IP do servidor onde o LDAP está ativo.
* **Porta do Servidor LDAP**: Informe a porta utilizada pelo protocolo LDAP.
* **Login Administrator**: Insira o usuário administrador do LDAP.
* **Password Administrator**: Informe a senha do administrador do LDAP.
* **LDAP Base de Pesquisa DN**: Defina a base DN utilizada para pesquisas.
* **LDAP Filtro de Pesquisa**: Configure o filtro de pesquisa conforme necessário.
* **LDAP Sincronizar MemberOf**: Ative caso deseje sincronizar os grupos **MemberOf** do LDAP.

Clique em **Salvar** para registrar as configurações.

<figure><img src="/files/fhP3vrxNsNgTWxJn8bDG" alt=""><figcaption><p><em>Sub-Tópico LDAP</em></p></figcaption></figure>

### Erros Comuns

Após configurar todos os parâmetros para utilização do **LDAP** no SURICATO, é possível que ocorram erros ao tentar realizar o primeiro login, principalmente se o usuário ainda não tiver sido pré-cadastrado no sistema.

* **Solução para erro de usuário não cadastrado**:\
  Crie um **Grupo de Usuário** com o mesmo nome definido no parâmetro **“Search Base”** e vincule o usuário a este grupo.

<figure><img src="/files/AwOE3JvzmKFtPkndmBOI" alt=""><figcaption><p><em>Exemplo – Erro SURICATO</em></p></figcaption></figure>

* **Falha no login por usuário inativo ou digitação incorreta de credenciais**:\
  Verifique se o usuário está ativo e se as credenciais foram digitadas corretamente.

<figure><img src="/files/fMjEk9pspF9UQgdKJUHs" alt=""><figcaption><p><em>Exemplo – Erro SURICATO</em></p></figcaption></figure>

* **Falha de autenticação devido a parametrização do LDAP**:\
  Se a autenticação falhar por algum problema de configuração na aplicação, a mensagem de erro será exibida. Neste caso:
  1. Contate o administrador do **AD** do servidor onde o SURICATO está implementado.
  2. Solicite as permissões necessárias para o usuário de autenticação e os grupos da base.
  3. Confirme os **Distinguished Names** corretos para parametrizar corretamente o LDAP no SURICATO.
  4. Se necessário, utilize o **ADExplorer** para validar a conexão com os mesmos parâmetros fornecidos.

<figure><img src="/files/RR4cfB0pgTgmT0Sr523m" alt=""><figcaption><p><em>Exemplo – Erro SURICATO</em></p></figcaption></figure>

## FAQ - Perguntas Frequentes

<details>

<summary>O campo “Nome do Grupo” pode ser deixado em branco ao cadastrar uma Hora Extra?</summary>

Não. O campo é obrigatório e deve ser preenchido para que o cadastro seja salvo.

</details>

<details>

<summary>É possível adicionar e-mails ou telefones de SMS sem vincular um grupo de Hora Extra?</summary>

Não. É necessário que o grupo já esteja cadastrado antes de incluir destinatários.

</details>

<details>

<summary>O que acontece se um colaborador for adicionado ao grupo sem estar cadastrado no sistema?</summary>

O sistema não permitirá a inclusão; é obrigatório que o colaborador e a empresa estejam cadastrados.

</details>

<details>

<summary>Durante a edição de um grupo, é permitido alterar o ID do cadastro?</summary>

Não. O ID do cadastro é fixo e não pode ser modificado.

</details>

<details>

<summary>É possível cadastrar mais de um horário para o mesmo grupo de Hora Extra?</summary>

Sim, mas cada horário deve ser informado nos campos Horário 1 e Horário 2 para definir início e fim da notificação.

</details>


---

# 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://software-telematica-com.gitbook.io/suricato-docs/manual-de-operacao/manual-do-suricato/processos-configuracoes-e-relatorios/configuracoes/sistema/autenticacao.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.