THotPDF.SaveIncrementalUpdateAuthenticated Method

Autentificerer signede revisionspolitikker, afviser forbudte ændringer og publicerer en inkrementel opdatering atomisk

Deklarationer

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

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

Arbejdsgang

Skriver den afventende inkrementelle revision til en unik kandidat i målmappe
Indlæser hver politik fra netop den revision, som dens signatur-byte-interval beskytter
Autentificerer hver CMS-signatur med politik og validerer eventuelt dens certifikatsti
Klassificerer hver senere revision og håndhæver DocMDP-, FieldMDP-, UR- eller UR3-, Identity- og unknown-transform-beslutninger
Publicerer den accepterede kandidat med en write-through atomisk erstatning

En afvisning sletter kandidaten og efterlader en eksisterende målfil byte-for-byte uændret

Indstillinger

Medlem	Formål
`Authentication`	`ipaCryptographic` kræver en gyldig CMS byte-range-signatur, mens `ipaTrustedCertificate` desuden kræver `cvsTrusted` fra validering af certifikatsti og tilbagekaldelse
`RequireSignaturePolicy`	Afviser dokumenter uden en autentificeret transform-politik, når `True`, hvilket er standardværdien
`CertificateValidation`	Trust anchors, intermediates, offline tilbagekaldelsesbeviser, valideringstidspunkt, formål og algoritmepolitik, som trusted-certificate-tilstanden bruger

Resultatdetaljer

THPDFAuthenticatedIncrementalUpdateInfo rapporterer slutstatus, indeks for den fejlende signatur, signatur- og certifikatstatus, samlet signaturantal, antal autentificerede politikker og et diagnostisk problem

Vigtige statusser omfatter aiusAccepted, aiusNoSignaturePolicy, aiusSignatureInvalid, aiusCertificateUntrusted, aiusPolicyMalformed, aiusPolicyViolation og aiusCommitFailed

Brug

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;

Sikkerhedsgrænse

En politik, der kun er strukturelt til stede, bliver aldrig autoritativ, før dens signatur autentificerer med succes
Politikordbøger læses fra det signede snapshot og bindes til det oprindelige signaturobjekt, byte-interval og CMS-værdi, så en senere revision ikke kan omdirigere eller erstatte sin egen autoritet
Trusted-certificate-tilstanden er passende, når underskriverens identitet betyder noget ud over dokumentintegriteten
Den almindelige SaveIncrementalUpdate-metode forbliver tilgængelig for usignerede arbejdsgange, der ikke kræver politik-håndhævelse