Assinatura digital

Na modalidade assinatura em nuvem (via API) só podem ser enviado os hashes dos documentos.

Os hashes estarão em hexadecimal. Se mais de um hash for informado mas o scope do token for de apenas uma assinatura, uma mensagem de erro deve ser retornada.

Podem ser realizadas assinaturas no formato RAW (ASN1 PKCS#1 v1.5), CMS-detached.

Para abstrair o uso de recursos de criptografia em aplicações existentes e nativo em diversas linguagens de programação. Conheça também os middlewares: PKCS11, CSP (Microsoft Crypto API), Engine OpenSSL, JCA/JCE.

Para simplificar o uso dos demais serviços de assinatura padronizadas como CMS, PDF Signature, XMLDsig, CAdES, PAdEs, XAdEs etc. Conheça o CESS.

POST https://api.birdid.com.br/v0/oauth/signature

Headers

NameTypeDescription

Content-Type

string

application/json

Accept

string

application/json

Authorization*

string

Bearer

Request Body

NameTypeDescription

certificate_alias

string

Identificador do certificado correspondente à chave utilizada na assinatura

hashes

array

Array de objetos com a estrutura - id: identificador do conteúdo a ser assinado (pode ser um identificar numérico incremental, por exemplo) - alias: identificador do conteúdo que será exibido no histórico de assinaturas do usuário - hash: conteúdo a ser assinado - hash_algorithm: Object Identifier (OID) do algoritimo de hash. Por exemplo, para SHA256 utilize o OID 2.16.840.1.101.3.4.2.1 - signature_format: formato da assinatura - RAW: Assinatura PKCS#1 v1.5, resultado direto da operação RSA/DSA sobre o hash - CMS: Assinatura CMS-detached utilizando o hash no campo messageDigest

include_chain

boolean

Inclui a cadeia do certificado do assinante nas assinaturas CMS

{
	"certificate_alias": "CERTIFICADO TESTE 1:1234567889",
	"signatures": [{
		"id": "Signature request ID 1",
		"raw_signature": "my raw signature base64"
	}, {
		"id": "Signature request ID 2",
		"raw_signature": "my raw signature base64"
	}, {
		"id": "Signature request ID n",
		"raw_signature": "my raw signature base64"
	}]
}

Last updated