السجل THPDFCertificateValidationOptions
يضبط مراسي الثقة وأدلة الإبطال دون اتصال وقيود السياسات وحدود الخوارزميات للتحقق من مسار الشهادات
التصريح
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;
الوحدة
HPDFSignVerify
الحقول
| الحقل | الغرض |
|---|---|
TrustAnchors | شهادات مراسي ثقة مرمَّزة بـ DER يُسمح لها بإغلاق المسار |
IntermediateCertificates | شهادات وسيطة غير موثوقة إضافية يمكن للباني استخدامها عندما تكون مجموعة CMS غير مكتملة |
OCSPResponses / CRLs / DeltaCRLs | مجموعات دون اتصال من استجابات OCSP وقوائم CRL الأساسية وقوائم الدلتا |
CRLIssuerCertificates | الشهادات المستخدمة للتحقق من توقيعات موقّعي قوائم CRL |
OCSPResponseSources / CRLSources / DeltaCRLSources | وسم مصدر الأدلة المسجَّل لكل عنصر من المجموعة، ويظهر في معلومات التحقق |
RevocationMode | يختار سلوك الإبطال rvmNone أو rvmBestEffort أو rvmRequire |
ValidationTime | الوقت الذي تُقيَّم عنده فحوص الصلاحية والطزاجة |
MaxPathLength | الحد الأقصى لعدد الشهادات بين الورقة ومرساة الثقة؛ ويضبط Default القيمة 12 |
OCSPNoncePolicy | ما إذا كانت قيم nonce لـ OCSP إلزامية أو تُطابق عند وجودها أو تُتجاهل؛ وDefault يطابقها عند وجودها |
ExpectedOCSPNonce | بايتات nonce الدقيقة المطلوبة عندما يشترط ذلك السياسة |
OCSPMaxAgeDays / CRLMaxAgeDays | الحد الأقصى لعمر استجابات OCSP وقوائم CRL المقبول؛ ويضبط Default القيمتين 7 و30 يومًا |
OCSPAllowedClockSkewMinutes / CRLAllowedClockSkewMinutes | تسامح الساعة المطبق على طوابع وقت الأدلة؛ ويضبط Default 5 دقائق لكل منهما |
RequireOCSPNextUpdate / RequireCRLNextUpdate | رفض الأدلة التي لا تحمل حقل next-update |
AllowDelegatedOCSPResponders | قبول الاستجابات الموقَّعة من مستجيبين مفوَّضين؛ وDefault يسمح بها |
RequireOCSPNoCheckForDelegated | طلب امتداد OCSPNoCheck على شهادات المستجيبين المفوَّضين |
AllowIndirectCRLs | قبول قوائم CRL الصادرة عن موقع قوائم غير مباشر؛ وDefault يسمح بها |
RequireDeltaCRLWhenAdvertised | الفشل عندما يُعلن عن مؤشر CRL دلتا دون توفير قائمة دلتا فعليًا |
TrustPurpose / CustomTrustPurposeOID | غرض الشهادة المطلوب لمرساة الثقة؛ ويقبل Default أي غرض |
InitialPolicySet | معرفات OID لسياسات الشهادات التي يجب أن يستوفيها المسار المتحقق منه |
RequireExplicitCertificatePolicy | طلب سياسة شهادة صريحة واحدة على الأقل في المسار |
InhibitCertificatePolicyMapping | تعطيل معالجة تعيين سياسات الشهادات |
InhibitAnyCertificatePolicy | استثناء مؤهل anyPolicy من معالجة السياسات |
AlgorithmPolicy | حدود حجم المفتاح والخوارزميات المطبقة على كل شهادة وتوقيع في المسار |
FetchMissingIntermediates | جلب الشهادات الوسيطة الناقصة عبر عناوين AIA caIssuers قبل الفشل بـ cvsPathBuildingFailed؛ ويبقى النقل على عهدة المستدعي |
MaxFetchedIntermediates | سقف عدد الشهادات الوسيطة التي يمكن لعملية تحقق واحدة جلبها عبر AIA |
Default | دالة فئة تُعيد الضبط المدمج الملخَّص أعلاه |
ملاحظات الاستخدام
- ابدأ من
THPDFCertificateValidationOptions.Defaultولا تتجاوز إلا ما تحتاجه سياستك، حتى تبقى نوافذ الطزاجة وغرض الثقة مطابقة لافتراضيات المكتبة - لا تفتح المكتبة مقابس أبدًا: وفر الأدلة عبر المجموعات، أو استخدم نسخة التحقق عبر الإنترنت مع نقل على عهدة المستدعي عندما تحتاج
FetchMissingIntermediatesإلى الجلب - تتقابل مصفوفات المصادر ترابطًا واحدًا إلى واحد مع مجموعات الأدلة، ما يتيح للتقارير إسناد كل حكم إبطال إلى مصدره