> For the complete documentation index, see [llms.txt](https://docs.vaultid.com.br/workspace/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vaultid.com.br/workspace/cess/hubdeautenticacao/inicializacao-e-token.md).

# Inicialização e Token

O Certifier Auth Hub é um sistema seguro que requer a identificação prévia da aplicação integradora. Para listar as certificadoras autorizadas e iniciar sessões de autenticação, o cliente **obrigatoriamente** precisa carregar o Hub enviando um Token de Acesso válido na URL.

{% hint style="info" icon="key" %}
**Como funciona o fornecimento do Token**\
As configurações de acesso da sua aplicação são cadastradas pelo suporte da Soluti. O suporte gera a URL de inicialização completa contendo o token de acesso e a fornece diretamente à sua equipe. Portanto, **não é necessário que sua aplicação realize fluxos adicionais de autenticação ou geração de tokens**.
{% endhint %}

#### Regras de Negócio e Validação

* **Validade Longa:** O token de acesso gerado pelo suporte possui validade de **1 ano (365 dias)**. Ele pode ser utilizado de forma fixa no frontend do seu sistema durante esse período.
* **Renovação e Revogação:** Ao expirar o prazo de 1 ano, ou caso o token seja revogado por motivos de segurança (o sistema do Hub possui suporte para revogação imediata de tokens de acesso), sua aplicação passará a receber erro de acesso e você deverá solicitar a geração de um novo token ao suporte da Soluti.
* Caso o parâmetro `token` não seja enviado na URL, seja inválido, esteja expirado ou tenha sido revogado, o Hub redirecionará automaticamente para uma página de erro (Status 404).
* O token é usado para identificar quais certificadoras estão habilitadas para a sua licença e aplicar as devidas regras de negócio e layout.

#### URL Oficial de Produção

O endereço base de produção do Certifier Auth Hub é:

```
Endereço de Produção
https://certifierauthhub.vaultid.com.br
```

#### Como inicializar o Hub (Parâmetros de URL)

Ao inicializar o Hub, sua aplicação deve passar parâmetros na query string. A tabela abaixo detalha todos os parâmetros suportados:

<table><thead><tr><th width="133">PARÂMETRO</th><th width="174">OBRIGATORIEDADE</th><th>TIPO/FORMATO</th><th width="253" valign="middle">Descrição &#x26; Diretrizes (RFC / ICP-Brasil)</th><th width="130">EXEMPLO</th></tr></thead><tbody><tr><td><mark style="color:violet;">token</mark></td><td><strong>Obrigatório</strong></td><td>String (JWT)</td><td valign="middle">Token de acesso gerado pela Soluti. Identifica a sua aplicação, as certificadoras habilitadas para a sua licença e as regras de negócio vigentes.</td><td>eyJhbGciOi...</td></tr><tr><td><mark style="color:violet;">login_hint</mark></td><td><em><strong>Opcional</strong></em></td><td>String (Texto)</td><td valign="middle">Dica de login para o provedor de identidade (conforme diretrizes da <strong>ICP-Brasil (DOC-ICP-17 / DOC-ICP-17.01)</strong> para PSCs). Utilizado por certificadoras compatíveis para pré-preencher o documento (CPF/CNPJ) do usuário na tela de consentimento de assinatura.</td><td>12345678909</td></tr></tbody></table>

#### URL Oficial de Inicialização

O token e os demais parâmetros opcionais devem ser injetados como parâmetros de query string na URL base do Hub:

```
URL de Exemplo
https://certifierauthhub.vaultid.com.br/?token=SEU_TOKEN_JWT&login_hint=12345678909

```