# Testes e Problemas Comuns

## Visão Geral

Este procedimento orienta como validar o funcionamento do Suricato Client após a instalação e como identificar e corrigir os problemas mais comuns relacionados à execução, comunicação e dispositivos.

## Regras de Negócio

* **Status do Serviço:** O Suricato Client deve estar em execução ativa no sistema operacional para responder às requisições do navegador.
* **Drivers de Dispositivos:** Biometrias, leitores e PADs de assinatura devem estar conectados fisicamente e com seus respectivos drivers instalados.
* **Modo de Operação:** O navegador web não pode executar o sistema em modo de compatibilidade ou sob a zona de intranet.
* **Exclusividade de Porta:** A porta de rede lógica configurada para o serviço deve estar totalmente dedicada ao Suricato Client, sem concorrência com outras aplicações.
* **Loopback Local:** O navegador deve possuir permissão explícita para efetuar requisições HTTPS direcionadas ao endereço de *localhost*.

## Como testar o funcionamento do Suricato Client

#### Configuração de Porta do Serviço

Caso necessite alterar a porta padrão de comunicação do serviço devido a conflitos na rede local, edite o arquivo de propriedades conforme as diretrizes abaixo:

```
# Diretório: \SURICATO-client\SURICATO-application.properties

# Altere o valor abaixo caso a porta 9000 esteja ocupada por outro serviço
server.port=9000
```

### Passo a Passo para Homologação e Testes

Após a instalação, acesse o sistema.

{% stepper %}
{% step %}
Acione uma funcionalidade que utilize um dispositivo (ex: biometria).
{% endstep %}

{% step %}
Verifique se o Suricato Client é iniciado automaticamente.
{% endstep %}

{% step %}
Confirme se o leitor correspondente responde corretamente:

* Leitor Sagem (OP)
* Leitor Suprema (OP1/OP4)

Valide se a tela de captura é exibida sem erros.

#### Leitor Sagem (OP)

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

#### Leitor Suprema (OP1/OP4)

<figure><img src="/files/JU1xsRioFeDKd0RnD1UI" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

### Problemas Comuns

#### Verificar modo de compatibilidade

{% stepper %}
{% step %}
Certifique-se de que o navegador não está em modo compatibilidade.
{% endstep %}

{% step %}
Evite adicionar o sistema na zona de intranet do navegador (ex: Internet Explorer).
{% endstep %}

{% step %}
Caso esteja ativo, desative o modo compatibilidade.

{% hint style="danger" %}
**Importante:** O Suricato Client não funciona corretamente em modo compatibilidade
{% endhint %}

<figure><img src="/files/mHjKDGE0YuiEhTJtvGHM" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

#### Verificar porta em uso

{% stepper %}
{% step %}
Acesse o diretório:\
`\SURICATO-client\SURICATO-application.properties`
{% endstep %}

{% step %}
Localize a configuração:\
`server.port=9000`
{% endstep %}

{% step %}
Verifique se a porta está ocupada por outro serviço.
{% endstep %}

{% step %}
Se necessário, altere para uma porta livre.
{% endstep %}

{% step %}
Reinicie o Suricato Client após a alteração.

<figure><img src="/files/um8K9Ae8FGHOYuBfeSdX" alt=""><figcaption><p><em>Porta em uso</em></p></figcaption></figure>
{% endstep %}
{% endstepper %}

#### Validar acesso ao serviço (Certificado / Permissão)

{% stepper %}
{% step %}
Abra uma tela de captura no sistema (ex: biometria).
{% endstep %}

{% step %}
Pressione **F12** e acesse a aba **Console**.
{% endstep %}

{% step %}
Verifique se há erros de permissão.
{% endstep %}

{% step %}
Caso exista erro, acesse diretamente no navegador:\
[`https://127.0.0.1:9000/SURICATO-client/io/biometria/op1_op4`](https://127.0.0.1:9000/SURICATO-client/io/biometria/op1_op4)
{% endstep %}

{% step %}
Aguarde a abertura da tela de captura.
{% endstep %}

{% step %}
Feche a tela e repita o teste no sistema.

<figure><img src="/files/t2S4ZRzBAJP0SVdOxvmq" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

## FAQ – Perguntas Frequentes

<details>

<summary>O Suricato Client não inicia. O que verificar?</summary>

Confira se o serviço está instalado, rodando e sem erro de porta.

</details>

<details>

<summary>O dispositivo não responde. Qual o problema?</summary>

Verifique conexão, driver e se o Suricato foi acionado corretamente.

</details>

<details>

<summary>Recebo erro de porta em uso. Como resolver?</summary>

Altere a porta no arquivo de configuração e reinicie o sistema.

</details>

<details>

<summary>Aparece erro de permissão no navegador. O que fazer?</summary>

Acesse o endereço local manualmente e repita o teste.

</details>

<details>

<summary>O sistema não funciona corretamente no navegador. Por quê?</summary>

Desative o modo compatibilidade, pois ele interfere no funcionamento.

</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/central-tecnica/instalacao-e-configuracao-de-servicos-do-suricato/instalacao-e-configuracao-do-suricato-client/testes-e-problemas-comuns.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.