# Configuração do Suricato Client

## Visão Geral

Este tópico apresenta os procedimentos para parametrização de leitura e gravação de SmartCard e a habilitação do webservice do `Suricato Client` na interface do sistema.

Neste procedimento, você vai aprender:

* [Como configurar](#configurando-smartcard-para-leitura-e-gravacao) o SmartCard para leitura e gravação.
* [Como configurar o Suricato](#configuracao-no-suricato) para utilizar o Suricato Client.

## Regras de Negócio

Antes de iniciar a parametrização dos arquivos e do sistema, observe as seguintes diretrizes:

* **Conectividade Física:** A porta `COM` da leitora deve ser identificada e configurada de forma idêntica em todas as instâncias do ambiente.
* **Sincronismo de Taxa:** O valor de taxa de transmissão (*Bits por segundo*) deve ser idêntico no arquivo de configuração e nas propriedades do hardware no sistema operacional.
* **Acesso a Arquivos:** Garanta a integridade e a validade do caminho absoluto apontado para o arquivo `Chave.cfg`.
* **Otimização de Leitura:** Altere o parâmetro `ReaderType` conforme necessidade de desempenho.
* **Habilitação do Serviço:** A parametrização da porta TCP na interface do Suricato é obrigatória para ativar o uso do cliente local.
* **Restrição de Porta:** A definição da porta TCP com o valor `0` desabilita por completo a comunicação do `Suricato Client`.

### Configuração de SmartCard (Leitura e Gravação)

{% stepper %}
{% step %}
A parametrização do hardware de SmartCard é realizada através do arquivo de inicialização local do componente.

* **Arquivo de Configuração:** `SuriSmartcard.ini`
* **Diretório Padrão:** `C:\suricato-client\tools\`
  {% endstep %}

{% step %}

#### Parâmetros do Arquivo

<pre><code><strong>[SmartCard]
</strong>ReaderType=1
CommPort=4
BitsSecond=57600
ChaveCFG="C:\tsi\Chave_TSI.cfg"
</code></pre>

{% endstep %}

{% step %}

#### Detalhamento dos Campos

No arquivo, você indica a porta **COM**, no parâmetro `CommPort=XPTO` e o arquivo `chave.cfg`.

* `ReaderType` (Modo de Operação):
  * `0` → Executa a busca automática do parâmetro *BitsSecond* (sujeito a latência operacional intermitente).
  * `1` → Desativa a busca automática e executa a leitura direta (recomendado para otimização de desempenho).
* `CommPort` (Porta de Comunicação):
  * Informa o número da porta `COM` atribuída à leitora (*Exemplo:*  `COMMPORT= 4`). Esta Porta deve ser exatamente a mesma em três pontos:
    1. Gerenciador de Dispositivos do Windows.
    2. Arquivo `SuriSmartcard.ini`.
    3. Arquivo `suricato-application.properties`.
* `BitsSecond` **(Taxa de Transmissão)**:
  * **Valor padrão homologado:** `57600`.
  * **Alinhamento no Windows:** Acesse o *Gerenciador de Dispositivos* → *Propriedades da Porta COM utilizada* → *Definições da Porta* e defina o campo *Bits por segundo* para `57600`.

```
BitsSecond=57600
```

* `ChaveCFG` **(Caminho da Chave)**:
* Indica o diretório e o nome exato do arquivo de criptografia (Ex: `"C:\\tsi\\Chave_TSI.cfg"`).

{% hint style="warning" %}
**Observação:** Após concluir a primeira instalação do serviço, configure o `ReaderType=1` e reinicie o processo do `Suricato Client` para validar a alteração de performance.
{% endhint %}
{% endstep %}
{% endstepper %}

## Configuração no Suricato

Para que a aplicação passe a consumir as rotinas do cliente local, os parâmetros devem ser espelhados na interface web.

* Caminho no Menu:  `Configuração | Sistema | Geral`&#x20;

Nesta tela, configure os parâmetros do **Suricato Client**, incluindo:

1. Tipos de gravação de biometria
2. Configuração de leitura/gravação de SmartCard
3. Captura de foto
4. Scanner
5. Pad de assinatura
6. Porta TCP utilizada pelo webservice do Suricato Client
7. Tipo de geração de lista

{% hint style="danger" %}
**Atenção:** Se a porta TCP for configurada como **0**, o sistema **não utilizará o Suricato Client,** isso significa que o serviço ficará **desabilitado.**
{% endhint %}

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

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

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

## FAQ – Perguntas Frequentes

<details>

<summary>Onde configuro o SmartCard?</summary>

No arquivo `SuriSmartcard.ini`, dentro da pasta `tools` do Suricato Client.

</details>

<details>

<summary>O que acontece se a porta COM estiver errada?</summary>

A leitora não será reconhecida.

</details>

<details>

<summary>Qual valor devo usar para BitsSecond?</summary>

Utilize 57600 e mantenha igual no sistema e no Windows.

</details>

<details>

<summary>Para que serve o ReaderType?</summary>

Controla o modo de leitura:

* 0 = busca automática (mais lento)
* 1 = leitura direta (mais rápido)

</details>

<details>

<summary>Preciso reiniciar após alterar configurações?</summary>

Sim. Reinicie o Suricato Client.

</details>

<details>

<summary>O que acontece se a porta TCP estiver como 0?</summary>

O Suricato Client será desabilitado.

</details>

<details>

<summary>Onde configuro o uso do Suricato Client no sistema?</summary>

No menu: Configuração | Sistema | Geral.

</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/configuracao-do-suricato-client.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.