BRbry
Assinador XML

Finalizar Assinatura XML/XADES

post/api/xml-signature-service/v2/signatures/finalize

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

noncestring required

Nonce da requisição.

certificatestring required

Certificado [conteúdo codificado em Base64]

returnTypestring required

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.

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]

signatureFormatstring required

Formato da assinatura. [Valores disponíveis: ENVELOPED, ENVELOPING, DETACHED]

operationTypestring

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

binaryContentstring

true = Documento original em qualquer formato<br>false = Documento original no formato xml

includeXPathEnvelopedstring

Define se a regra de XPath para que assinaturas anteriores sejam ignoradas em assinaturas enveloped será incluída ou não na assinatura.

finalizations[0][nonce]string

Nonce da assinatura.

finalizations[0][content]string binary required

Arquivo que será assinado. Deve ser adicionado na mesma ordem da inicialização.

finalizations[0][signatureValue]string required

Valor em Base64 do parâmetro signedAttributes retornado do inicializar, assinado com a chave privada do usuário (via Bry Extension por exemplo). Deve ser inserido na mesma ordem do retorno.

finalizations[0][initializedDocument]string required

Conteúdo Base64 do documento inicializado [Assinatura ou co-assinatura]

policyOidstring

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

lineBreakboolean

Define se deve ser utilizado quebra de linha na codificação de dados base64 na estrutura da assinatura como certificado, LCR, cadeia e carimbo do tempo. Padrão é True. Utilize o valor False somente se necessário para compatibilidade com outras plataformas.

Example request

{
  "nonce": "1",
  "certificate": "Certificado codificado em Base64",
  "returnType": "BASE64",
  "hashAlgorithm": "SHA256",
  "profile": "BASIC",
  "signatureFormat": "ENVELOPED",
  "operationType": "SIGNATURE",
  "binaryContent": "false",
  "includeXPathEnveloped": "true",
  "finalizations[0][nonce]": "1",
  "policyOid": "2.16.76.1.7.1.6.2.4"
}

Response

OR
string[] required

Example response

{
  "identificador": "ABC123",
  "documentos": [
    {
      "hash": "ABCDEF123456",
      "links": [
        {
          "href": "https://link_para_recuperar_documento_Assinado"
        }
      ],
      "DocumentoLinkSemNonce": {
        "identificador": "ABC123",
        "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.