Assinador CMS

Finalizar Assinatura CMS/CAdES - V2 Assíncrono Compliance FW2

post/fw/v2/cms/pkcs1/assinaturas/acoes/finalizar

Request

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.

Request body multipart/form-data

certificatestring required

Certificado do signatário [chave pública do certificado codificada em Base64].

returnTypestring

Define o tipo de retorno da requisição. LINK retorna uma resposta JSON, a qual possui links para downloads dos arquivos assinados. BASE64 retorna uma lista com arquivos assinados, codificados em Base64. Caso LINK, o arquivo será excluído da cache após o download. Default: BASE64.

attachedstring required

Define se o documento original deve ou não ser anexado na estrutura da assinatura digital. [Valores disponíveis: true ou false].

hashAlgorithmstring required

Algoritmo de HASH. [Valores disponíveis: SHA1, SHA256, SHA512]

profilestring required

Tipo de perfil desejado para a assinatura a ser gerada. [Valores disponíveis: BASIC, COMPLETE, ADRB, ADRT, ADRV, ADRC, ADRA, ETSI_B, ETSI_T, ETSI_LT, ETSI_LTA]

noncestring required

Nonce da Requisição. Nonce de Requisição é um número qualquer para identificação do lote de itens para serem assinados.

operationTypestring required

Tipo de Operação. [Valores disponíveis: SIGNATURE, CO_SIGNATURE]

finalizations[0][document]string binary required

Documento original, em qualquer formato, que será assinado (tamanho máximo do arquivo: 100 MB). Formato do documento: qualquer formato. Caso efetue o envio dos documentos em formato hash, este parâmetro não deve ser utilizado. Para lotes, basta incrementar o valor do índice, por ex: originalDocuments[1][content], originalDocuments[2][content]

finalizations[0][hash]string

Hash do documento original (formato na base hexadecimal). Esse parâmetro é o recomendado a ser utilizado, pois melhora o desempenho e evita tráfego desnecessário do conteúdo do documento. Para lotes, basta incrementar o valor do índice, por ex: originalDocuments[1][hash], originalDocuments[2][hash]

finalizations[0][nonce]string required

Nonce da assinatura. Nonce é um número qualquer para identificação do item dentro de um lote, que é retornado na resposta.

finalizations[0][signatureValue]string required

Conteúdo Base64 da Assinatura [Assinatura ou co-assinatura]. Valor correspondente ao signedAttributes cifrado com a chave privada, por exemplo, via BRy Extension, e codificado em Base64).

finalizations[0][signedAttributes]string required

Conteúdo Base64 dos atributos assinados SignedAttributes [Assinatura ou co-assinatura] retornados na Inicialização da assinatura.

finalizations[0][signature]string binary

O arquivo de assinatura digital, quando a operação ser feita for Co-Assinatura.

oidPoliticastring

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

Example request

{
  "certificate": "Certificado codificado em Base64",
  "returnType": "BASE64",
  "attached": "false",
  "hashAlgorithm": "SHA256",
  "profile": "TIMESTAMP",
  "nonce": "123",
  "operationType": "SIGNATURE",
  "oidPolitica": "2.16.76.1.7.1.1.2.3"
}

Response

OR

Example response

{
  "identificador": "ABC123",
  "quantidadeAssinaturas": 1,
  "documentos": [
    {
      "hash": "ABCDEF123456",
      "nomeArquivo": "Arquivo.txt",
      "links": [
        {
          "href": "https://link_para_recuperar_documento_Assinado"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.