PDFium Delphi Component Docs

FPdfTrustedList unit

Unit: FPdfTrustedList
Authenticated European trusted-list snapshots with bounded XML parsing, offline caching, caller-owned updates, trust-store integration, and qualified PAdES policy evaluation

Main API

TPdfEuropeanTrustedList.ParseAuthenticated(XmlData, Authenticator, Options)
TPdfEuropeanTrustedList.LoadCache(Source, Authenticator, Options)
TPdfEuropeanTrustedList.Update(Current, Uri, Source, Authenticator, Options)
TPdfEuropeanTrustedList.SaveCache(Destination)
TPdfEuropeanTrustedList.LoadTrustAnchors
TPdfEuropeanTrustedList.EvaluateQualified(LeafCertificate, CertificateChain, ValidationTime, Evaluation)

Description

ParseAuthenticated requires an IPdfTrustedListAuthenticator to authenticate the exact source bytes before any service becomes usable, leaving XMLDSIG policy and trust-anchor ownership with the application

The bounded namespace-tolerant parser reads ETSI scheme metadata, providers, current service information, service history, X509 certificates, status times, and qualifier URIs while rejecting DTD and entity declarations

SaveCache stores the authenticated source XML with a SHA-256 corruption check, and LoadCache invokes the authenticator again before reconstructing the snapshot

Update fetches through IPdfTrustedListSource, then rejects territory changes, non-advancing sequence numbers, and issue-time rollback

The class implements IPdfTrustStore and IPdfQualifiedTrustEvaluator, so one authenticated snapshot can supply current DER anchors and the optional TPadesTrustValidationOptions.QualifiedTrustEvaluator policy

Interfaces

InterfaceMemberPurpose
IPdfTrustedListAuthenticatorAuthenticateAuthenticates the exact XML bytes and returns diagnostic AuthenticationDetails
IPdfTrustedListSourceFetchRetrieves XML from Uri without exceeding MaxBytes
IPdfQualifiedTrustEvaluatorEvaluateQualifiedEvaluates a leaf and CertificateChain at ValidationTime

Types

TypeFields and purpose
EPdfTrustedListReports authentication, parsing, cache, update, and resource-budget failures
TPdfTrustedListOptionsMaxXmlBytes, MaxServices, MaxCertificates, MaxCertificateBytes, MaxDepth, MaxTokens, and RequireNextUpdate bound parsing; Default returns the production limits
TPdfTrustedListStringArrayDynamic string array used by QualifierUris
TPdfTrustedListServiceHistorical, Territory, ProviderName, ServiceName, ServiceTypeIdentifier, ServiceStatus, StatusStartingTime, QualifierUris, and Certificates preserve one current or historical service state
TPdfTrustedListServicesDynamic array of service-state records
TPdfTrustedListEvaluationEvaluated, Matched, Qualified, Current, Territory, ProviderName, ServiceName, ServiceTypeIdentifier, ServiceStatus, and StatusStartingTime describe the selected policy result

Snapshot properties

PropertyDescription
AuthenticationDetailsAuthenticator-supplied evidence summary
IssueDateTimeUTC-normalised trusted-list issue time
NextUpdateUTC-normalised next-update deadline
SequenceNumberMonotonic trusted-list sequence
ServicesParsed current and historical service states
SourceDigestSHA-256 digest of the authenticated source XML
TerritoryScheme territory code
VersionIdentifierTSL format version identifier

Security boundary

See Also

FPdfCrypto, ValidatePadesTrust