v1

latestOpenAPI 3.0.0MIT2026-08-0414772502.0 KB

Assinador CMS

Assinar CMS/CAdES utilizando certificado em arquivo (Passo único) ⚠️

⚠️ Disponível somente para implantação on-premises

post/fw/v1/cms/pkcs12/assinaturas

Headers

Token de acesso aos serviços BRy emitido no BRy Cloud. É obrigatório em todas as requisições ao HUB. Para utilizar esta documentação é necessário inserir o token em Authorize.

Senha do PKCS12 (.pfx/.p12) configurado para a assinatura. Deve ser fornecido em formato Base64.

Request body

signatariostring required

Nome do arquivo pfx/p12

perfilstring required

String representando o tipo de perfil desejado para a assinatura a ser gerada. [Valores disponíveis: BASIC, TIMESTAMP, COMPLETE, ADRB, ADRT, ADRV, ADRC, ADRA, ETSI_B, ETSI_T, ETSI_LT e ETSI_LTA]. Aceita também os valores legados em português para os perfis de assinatura CMS básica.

formatoDadosstring required

String indicando qual será o formato de codificação dos dados a serem assinados. [Valores disponíveis: Base64]

algoritmoHashstring required

String que representa o algoritmo de hash que será utilizado para gerar a assinatura. [Valores disponíveis: SHA1, SHA256 e SHA512].

formatoAssinaturastring required

Formato do processamento dos documentos recebidos na lista de hashes. [Valores disponíveis: HASH, ATTACHED e DETACHED].

coAssinaturaboolean

Boolean representando se será realizado uma coassinatura. Valor padrão é false.

hashesstring[] required

Array de strings com os conteúdos a serem assinados. Atualmente se o formatoAssinatura for HASH deve ser enviado os resumos criptográficos (hashes) calculados a partir do documento original. Caso formatoAssinatura seja algum dos demais valores (ATTACHED ou DETACHED), deve ser enviado o conteúdo original do documento que se deseja assinar.

comentariosstring[]

Array de strings com um conjunto de comentários que serão inseridos na assinatura. Parâmetro Opcional, mas se utilizado deve ser enviado um comentario para cada assinatura a ser realizada.

nomeDocumentosstring[]

Array de strings com um conjunto de nomes que serão inseridos na assinatura como nome do documento. Parâmetro Opcional, mas se utilizado deve ser enviado um nome para cada assinatura a ser realizada.

oidPoliticastring

Quando enviado, este parâmetro define o OID da política de assinatura a ser usada com perfil de assinatura selecionado.

Example request

{
  "signatario": "Nome do arquivo pfx/p12",
  "perfil": "TIMESTAMP",
  "formatoDados": "Base64",
  "algoritmoHash": "SHA256",
  "formatoAssinatura": "ATTACHED",
  "hashes": [
    "SGFzaCBlbSBiYXNlIDY0"
  ],
  "comentarios": [
    "Um Comentario."
  ],
  "nomeDocumentos": [
    "Nome documento"
  ],
  "oidPolitica": "2.16.76.1.7.1.1.2.3"
}

Response

Signature response

padraostring

assinaturasstring[]

Example response

{
  "padrao": "CADES",
  "assinaturas": [
    "Base 64 da assinatura"
  ]
}