Opções de assinatura nativas no Linux
A ABI nativa de callbacks vincula as constraints de assinatura de documentos à saída real do CMS e à aparência gerada
Digest e metadados Unicode
A operação sign aceita digestMethod como SHA256, SHA384 ou SHA512; o default é SHA256 e o valor selecionado determina o digest real do signer do CMS
reason, location, contactInfo, signerName e legalAttestation aceitam strings Unicode sem caracteres NUL embutidos
Metadados seguem a política de string encryption do documento de origem, incluindo entrada autenticada AES-256
legalAttestation se aplica a assinaturas de certificação e vira o valor Legal.Attestation do catalog
Valores obrigatórios de seeds governam o digest real, razão, propriedades de certificados, permissão de certificação, atestação legal, perfil de aparências, informações de revogação e comportamento de timestamps
Bytes explícitos de confiança
trustedCAPEM, timestampTrustedCAPEM e timestampTrustedCRLPEM aceitam bytes PEM em strings JSON
As entradas legadas correspondentes de paths são trustedCAFile, timestampTrustedCAFile e timestampTrustedCRLFile; forneça bytes ou um path para cada fonte de confiança
Entradas PEM são mantidas em arquivos privados exclusivos com modo 0600 durante a operação e removidos depois; as respostas não expõem esses paths gerados
A confiança no certificado do signer é avaliada apenas quando configurada explicitamente, enquanto a verificação de integridade do CMS ainda checa a assinatura real e o binding do certificado de assinatura
Informações validadas de revogação assinadas
Forneça um objeto revocationInfo com enabled, certificatesBase64, ocspResponsesBase64, crlsBase64 e trustedCAPEM ou trustedCAFile
enabled tem default true; informações desabilitadas não podem incluir arrays de evidências
Os arrays contêm strings canônicas Base64 para certificados DER completos, objetos OCSPResponse bem-sucedidos e objetos CertificateList
clockSkewSeconds tem default 300 e precisa estar entre 0 e 86400; maxOCSPAgeSeconds tem default 86400 e precisa ser positivo; requireTimestamp tem default false
A validação checa as cadeias de certificados do signer e do timestamp incluído contra confiança explícita, cobertura completa não raiz, matching de issuer e serial, assinaturas de CRLs e OCSPs, autorização de responders, intervalos de validade e status revogado
Evidências malformadas, velhas, incompletas, não confiáveis ou revogadas falham antes da publicação do PDF
Evidências validadas viram o atributo CMS assinado 1.2.840.113583.1.1.8, e o resultado reporta revocationInfoEvaluated e revocationInfoValid
signatures.verify aceita o mesmo objeto revocationInfo para validar o atributo assinado realmente embutido; CRLs e respostas OCSP do chamador não substituem esse atributo durante a verificação
Objetos de evidências e bytes totais compartilham os limites da operação, e as checagens criptográficas usam o token de cancelamento da operação
Presets reais nomeados de aparências
Forneça um objeto appearance com caption, fontFamily opcional e profileName opcional
| profileName | Estilo realmente gerado |
|---|---|
| HotPDF.StandardApproval | Texto azul centralizado a 11 pontos, borda retangular, fundo branco e uma única linha de texto |
| HotPDF.StandardCertification | Texto preto alinhado à esquerda a 10 pontos, borda retangular, fundo branco e wrapping multilinha |
| HotPDF.Compact | Texto preto alinhado à direita a 8 pontos, sem fundo nem borda pintados, e uma única linha de texto |
O preset determina seu estilo e tamanho de fonte; um perfil desconhecido falha em vez de rotular uma aparência arbitrária
Um AppearanceFilter obrigatório corresponde ao perfil realmente gerado durante a operação atual; uma aparência carregada anteriormente precisa ser regenerada
Sem profileName, fontSize tem default 12; caption, fontFamily e fontSize legados no nível superior permanecem suportados
Não combine uma caption de nível superior com um objeto appearance
Proveniência de transporte da aplicação
credentialSourceURL declara a proveniência de credenciais asserida pela aplicação que fornece a identidade, e timestampServerURL declara a proveniência de endpoint asserida pelo callback de timestamps dela
Esses valores são comparados com as constraints correspondentes obrigatórias de seeds; eles não recuperam credenciais, não acessam um servidor remoto nem autenticam independentemente a identidade do endpoint HTTPS
A aplicação controla a recuperação de identidades e a autenticação de transporte
timestampServerURL exige um callback real em hpdf_signing_operation_v1, e a resposta RFC 3161 retornada precisa passar pelas checagens de imprint de assinatura, nonce, propósito do certificado do TSA, confiança explícita e revogação solicitada
Workflows de assinatura · Transporte de timestamps · Constraints de seeds · Perfis de aparências