THotPDF.SaveIncrementalUpdateAuthenticated Method

Autentica le policy di revisione firmate, rifiuta le modifiche vietate e pubblica atomicamente un aggiornamento incrementale

Dichiarazioni

function SaveIncrementalUpdateAuthenticated(
  const TargetFile: TFileName;
  const Options: THPDFAuthenticatedIncrementalUpdateOptions;
  out Info: THPDFAuthenticatedIncrementalUpdateInfo
): Boolean; overload;

function SaveIncrementalUpdateAuthenticated(
  const TargetFile: TFileName;
  out Info: THPDFAuthenticatedIncrementalUpdateInfo
): Boolean; overload;

Workflow

Scrive la revisione incrementale in sospeso su un candidato univoco nella directory di destinazione
Carica ogni policy dalla revisione esatta protetta dal suo byte range di firma
Autentica ogni firma CMS portatrice di policy e valida opzionalmente il suo percorso di certificati
Classifica ogni revisione successiva e applica le decisioni DocMDP, FieldMDP, UR o UR3, Identity e unknown-transform
Pubblica il candidato accettato con una sostituzione atomica write-through

Un rifiuto elimina il candidato e lascia una destinazione esistente byte per byte invariata

Opzioni

Membro	Scopo
`Authentication`	`ipaCryptographic` richiede una firma CMS byte-range valida, mentre `ipaTrustedCertificate` richiede inoltre `cvsTrusted` dalla validazione del percorso di certificati e delle revoche
`RequireSignaturePolicy`	Rifiuta i documenti senza una transform policy autenticata quando `True`, che è il valore predefinito
`CertificateValidation`	Trust anchor, intermediati, evidenze di revoca offline, tempo di validazione, scopo e policy di algoritmo usati dalla modalità trusted-certificate

Dettagli del risultato

THPDFAuthenticatedIncrementalUpdateInfo riporta lo stato finale, l'indice della firma fallita, lo stato di firme e certificati, il numero totale di firme, il numero di policy autenticate e una issue diagnostica

Gli stati importanti includono aiusAccepted, aiusNoSignaturePolicy, aiusSignatureInvalid, aiusCertificateUntrusted, aiusPolicyMalformed, aiusPolicyViolation e aiusCommitFailed

Utilizzo

var
  Info: THPDFAuthenticatedIncrementalUpdateInfo;
begin
  PDF.BeginIncrementalUpdate('certified.pdf');
  PDF.SetLoadedFormFieldValueByName('CustomerName', 'Ada');
  if not PDF.SaveIncrementalUpdateAuthenticated('updated.pdf', Info) then
    raise Exception.Create(String(Info.Issue));
end;

Perimetro di sicurezza

Una policy presente strutturalmente non diventa mai autorevole finché la sua firma non si autentica con successo
I dizionari di policy vengono letti dal snapshot firmato e vincolati all'oggetto firma originale, al byte range e al valore CMS, impedendo a una revisione successiva di dirottare o sostituire la propria autorità
La modalità trusted-certificate è appropriata quando l'identità del firmatario conta, in aggiunta all'integrità del documento
Il normale metodo SaveIncrementalUpdate resta disponibile per i workflow non firmati che non richiedono l'applicazione delle policy