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

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

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

Requisitos BIRD ID PRO: Instalação e configuração | BirdID

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