> 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/gateway-act/guia-tecnico-carimbo-do-tempo/integracao-e-requisitos-para-utilizacao.md).

# Integração e requisitos para utilização

O acesso às integrações requer um Client ID e um Client Secret, fornecidos pela Soluti.

***1. Carimbo do Tempo***<br>

Na integração direta, a aplicação realiza requisições HTTPS pelo método POST, com autenticação HTTP Basic utilizando as credenciais codificadas em Base64.

A solicitação do carimbo é gerada no formato **TSQ (Time-Stamp Query)** e enviada ao Gateway ACT como conteúdo binário, utilizando Content-Type: application/octet-stream.

Como resposta, o serviço retorna o **TSR (Time-Stamp Response)**, também em formato binário.

**Mais detalhes na documentação técnica** [Carimbo | BirdID](https://docs.vaultid.com.br/workspace/gateway-act/carimbo)<br>

***2. Assinatura + Carimbo do Tempo***

Para utilizar o serviço de **Assinatura + Carimbo do Tempo**, além das credenciais de acesso, é necessário um certificado BirdID válido. Para as requisições REST, também é necessário um access\_token, obtido por meio da autenticação do usuário BirdID.

As requisições são realizadas via HTTPS, pelo método POST, com autenticação HTTP Basic e em formato JSON. Devem ser informados o hash a ser assinado e o access\_token. Opcionalmente, podem ser incluídos o identificador do conteúdo, o alias exibido no histórico e o alias do certificado.

O uso de **Assinatura + Carimbo do Tempo** também requer que o ambiente ***BirdID PRO*** esteja configurado para utilização da **TSA (Time Stamping Authority)**. Essa configuração inclui as variáveis relacionadas à TSA no arquivo .yaml e a indicação, no corpo JSON da requisição, da política de Carimbo do Tempo correspondente à configuração adotada.

As políticas disponíveis são:

* **TSA**: assinatura padrão de PDF/CMS, incluindo a assinatura da autoridade carimbadora do tempo;
* **AD\_RT (ICP-Brasil)**: assinatura padrão nos formatos CAdES/PAdES, incluindo a assinatura da autoridade carimbadora do tempo;
* **AD\_RT**: assinatura padrão no formato XAdES, incluindo a assinatura da autoridade carimbadora do tempo.

**Mais detalhes na documentação técnica**: [Assinatura + Carimbo | BirdID](https://docs.vaultid.com.br/workspace/gateway-act/assinatura-+-carimbo)&#x20;

**Requisitos BIRD ID PRO**: [Instalação e configuração | BirdID](https://docs.vaultid.com.br/workspace/cess/instalacao-e-configuracao) <br>

***3. Assinatura + Carimbo em lote***

A integração de **Assinatura + Carimbo em lote** segue os mesmos requisitos de ***Assinatura + Carimbo do Tempo.***

A diferença está no processamento de múltiplos arquivos em uma única operação. Também é possível informar um identificador para cada arquivo enviado, permitindo sua identificação individual durante o processamento e no retorno.

**Mais detalhes na documentação técnica** : [Assinatura + Carimbo em Lote | BirdID](https://docs.vaultid.com.br/workspace/gateway-act/assinatura-+-carimbo-em-lote)