THPDFCertificateValidationOptions Record
Konfiguruje kotwice zaufania, offline dowody unieważnień, ograniczenia polityk i limity algorytmów dla walidacji ścieżki certyfikatów
Deklaracja
THPDFCertificateValidationOptions= record
TrustAnchors: THPDFDERArray;
IntermediateCertificates: THPDFDERArray;
OCSPResponses: THPDFDERArray;
CRLs: THPDFDERArray;
DeltaCRLs: THPDFDERArray;
CRLIssuerCertificates: THPDFDERArray;
OCSPResponseSources: THPDFValidationEvidenceSourceArray;
CRLSources: THPDFValidationEvidenceSourceArray;
DeltaCRLSources: THPDFValidationEvidenceSourceArray;
RevocationMode: THPDFRevocationMode;
ValidationTime: TDateTime;
MaxPathLength: Integer;
OCSPNoncePolicy: THPDFOCSPNoncePolicy;
ExpectedOCSPNonce: TBytes;
OCSPMaxAgeDays: Double;
OCSPAllowedClockSkewMinutes: Integer;
RequireOCSPNextUpdate: boolean;
AllowDelegatedOCSPResponders: boolean;
RequireOCSPNoCheckForDelegated: boolean;
CRLMaxAgeDays: Double;
CRLAllowedClockSkewMinutes: Integer;
RequireCRLNextUpdate: boolean;
AllowIndirectCRLs: boolean;
RequireDeltaCRLWhenAdvertised: boolean;
TrustPurpose: THPDFCertificateTrustPurpose;
CustomTrustPurposeOID: AnsiString;
InitialPolicySet: THPDFOIDArray;
RequireExplicitCertificatePolicy: boolean;
InhibitCertificatePolicyMapping: boolean;
InhibitAnyCertificatePolicy: boolean;
AlgorithmPolicy: THPDFCertificateAlgorithmPolicy;
// v2.738.0 online chain building: when the path cannot close with
// the supplied pool, fetch the missing intermediates through the
// AIA caIssuers URLs of the leaf-most unmatched certificate before
// failing with cvsPathBuildingFailed (transport stays caller-side)
FetchMissingIntermediates: boolean;
MaxFetchedIntermediates: Integer;
class function Default: THPDFCertificateValidationOptions; static;
end;
Jednostka
HPDFSignVerify
Pola
| Pole | Przeznaczenie |
|---|---|
TrustAnchors | Zakodowane w DER certyfikaty kotwic zaufania uprawnione do domknięcia ścieżki |
IntermediateCertificates | Dodatkowe niezaufane certyfikaty, których budowniczy może użyć, gdy pula CMS jest niekompletna |
OCSPResponses / CRLs / DeltaCRLs | Offline pule odpowiedzi OCSP, bazowych CRL i delt CRL |
CRLIssuerCertificates | Certyfikaty używane do weryfikacji podpisów podpisujących CRL |
OCSPResponseSources / CRLSources / DeltaCRLSources | Tag źródła dowodów zapisywany dla każdej pozycji z puli, ujawniany w informacjach walidacji |
RevocationMode | Wybiera zachowanie unieważnień rvmNone, rvmBestEffort albo rvmRequire |
ValidationTime | Czas, w którym oceniane są sprawdzenia ważności i świeżości |
MaxPathLength | Maksymalna liczba certyfikatów między liściem a kotwicą zaufania, Default ustawia 12 |
OCSPNoncePolicy | Czy nonce OCSP są wymagane, dopasowywane gdy występują, czy ignorowane, Default dopasowuje, gdy występują |
ExpectedOCSPNonce | Dokładne bajty nonce wymagane, gdy polityka tego żąda |
OCSPMaxAgeDays / CRLMaxAgeDays | Maksymalny akceptowany wiek odpowiedzi OCSP i CRL, Default ustawia 7 i 30 dni |
OCSPAllowedClockSkewMinutes / CRLAllowedClockSkewMinutes | Tolerancja zegara stosowana do znaczników czasu dowodów, Default ustawia po 5 minut |
RequireOCSPNextUpdate / RequireCRLNextUpdate | Odrzuca dowody bez pola next-update |
AllowDelegatedOCSPResponders | Akceptuje odpowiedzi podpisane przez delegowanych respondentów, Default na to pozwala |
RequireOCSPNoCheckForDelegated | Żąda rozszerzenia OCSPNoCheck na certyfikatach delegowanych respondentów |
AllowIndirectCRLs | Akceptuje CRL wydane przez pośredniego podpisującego CRL, Default na to pozwala |
RequireDeltaCRLWhenAdvertised | Kończy się błędem, gdy wskaźnik delty CRL jest ogłaszany, ale żadna delta CRL nie została dostarczona |
TrustPurpose / CustomTrustPurposeOID | Wymagany cel certyfikatu dla kotwicy zaufania, Default akceptuje dowolny cel |
InitialPolicySet | OID-y polityk certyfikatów, które zwalidowana ścieżka musi spełnić |
RequireExplicitCertificatePolicy | Żąda co najmniej jednej jawnej polityki certyfikatów w ścieżce |
InhibitCertificatePolicyMapping | Wyłącza przetwarzanie mapowania polityk certyfikatów |
InhibitAnyCertificatePolicy | Wyklucza kwalifikator anyPolicy z przetwarzania polityk |
AlgorithmPolicy | Limity rozmiaru klucza i algorytmów stosowane do każdego certyfikatu i podpisu w ścieżce |
FetchMissingIntermediates | Pobiera brakujące certyfikaty pośrednie przez URL-e AIA caIssuers, zanim zawodzi z cvsPathBuildingFailed, transport pozostaje po stronie wywołującego |
MaxFetchedIntermediates | Limit tego, ile certyfikatów pośrednich jedna walidacja może pobrać przez AIA |
Default | Class function zwracająca wbudowaną konfigurację streszczoną powyżej |
Uwagi dotyczące użycia
- Startuj od
THPDFCertificateValidationOptions.Defaulti nadpisuj tylko to, czego wymaga twoja polityka, dzięki czemu okna świeżości i cel zaufania odpowiadają domyślnym ustawieniom biblioteki - Biblioteka nigdy nie otwiera socketów: dostarczaj dowody przez pule albo użyj wariantu walidacji online z transportem po stronie wywołującego, gdy
FetchMissingIntermediatesmusi coś pobrać - Tablice źródeł parują jeden do jednego z pulami dowodów, dzięki czemu raporty potrafią przypisać każdy werdykt unieważnienia do jego pochodzenia