DEENESPTFRRUARHIKOZHNL

فئة ara::crypto::x509::CertificateValidationResult

[SWS_CRYPT_50179] Upstream: RS_CRYPTO_02306

class CertificateValidationResult {...};

X.509 Certificate Validation Result.

Header-Datei#include "ara/crypto/x509/certificate_validation_result.h"
Forwarding-Header#include "ara/crypto/crypto_fwd.h"
Scopenamespace ara::crypto::x509

دليل المستخدممولَّد بالذكاء الاصطناعي

يوفّر نتائج عمليات التحقق من شهادات X.509 مع الحالة، وسلسلة الشهادات التي تم العثور عليها، وشهادة الخطأ.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 1ece3477b66c المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يوفّر نتائج عمليات التحقق من شهادات X.509 مع الحالة، وسلسلة الشهادات التي تم العثور عليها، وشهادة الخطأ.

توفّر الواجهة ara::crypto::x509::CertificateValidationResult نتيجة التحقق من صحة شهادة X.509 وتتم إدارتها عادةً كـ Sptrc غير قابل للتعديل [SWS_CRYPT_50093]. عبر توابعها، يستعلم التطبيق عن الحالة الإجمالية، أو يحدد سلسلة الشهادات الكاملة مع شهادة الطرفية عند الموضع 0، أو يعزل الشهادة الفاشلة. إذا كان الفحص ناجحًا، يفشل الاستدعاء لتحديد الشهادة المعيبة برمز الخطأ ara::crypto::CryptoErrc::kNoSuchValue [SWS_CRYPT_50095]. وجميع توابع الواجهة مصممة لتكون آمنة بالنسبة للخيوط وآمنة بالنسبة للاستثناءات.

السياق

تغلّف الواجهة ara::crypto::x509::CertificateValidationResult نتيجة عملية التحقق من صحة شهادة X.509 داخل وحدة Adaptive crypto. تتمثل مسؤوليتها الأساسية في تزويد التطبيقات المستدعية بنتيجة فحص مهيكلة ومتسقة. ويشمل ذلك كلاً من حالة التحقق المجمعة لمسار الشهادة والوصول إلى كائنات الشهادات المعنية. وباعتبارها وسيطًا بين آليات التحقق التشفيري الداخلية والتطبيقات الحرجة للأمان، تتيح الفئة تقييمًا متمايزًا للتسلسلات الهرمية للشهادات. وتشمل أطراف التفاعل المركزية لها مثيلات من Certificate::Sptrc، والتي إما تُجمّع كسلسلة شهادات كاملة أو يُشار إليها في حالة الخطأ كسبب للفشل.

دورة الحياة

بصفتها واجهة افتراضية بحتة، لا تعرّف CertificateValidationResult أي دوال بناء عامة خاصة بها. ويتم التحكم في مدة البقاء وعلاقات الملكية بشكل أساسي بواسطة المؤشر الذكي ذي النوع المحدد Sptrc، المعرّف كـ std::shared_ptr<const CertificateValidationResult> [SWS_CRYPT_50093]. يُنشئ هذا المؤشر الثابت نموذج ملكية مشترك وغير قابل للتعديل: بعد اكتمال التحقق من صحة الشهادة، يُتاح كائن النتيجة كلقطة غير قابلة للتعديل. ومن المفترض أن يتم إنشاء النسخ الملموسة وتهيئتها داخليًا عبر دوال تحقق عليا في الواجهة الخلفية للمنصة. سؤال Q-a5580dcf443b0905 (مفتوح) ونظرًا لأن جميع الدوال الأعضاء معلنة كـ const وكذلك noexcept ومحددة صراحةً بأنها آمنة بالنسبة للخيوط وآمنة بالنسبة للاستثناءات ([SWS_CRYPT_50094]، [SWS_CRYPT_50095]، [SWS_CRYPT_50096])، يمكن لخيوط متعددة الوصول إلى نفس المثيل بشكل متزامن ودون تدابير مزامنة إضافية حتى يتم تحرير المرجع الأخير.

مسار الاستخدام

يبدأ مسار الاستخدام النموذجي بعد استلام مثيل CertificateValidationResult::Sptrc من فحص شهادة سابق. ينفذ المستدعون التقييم في تسلسل موحد:

  • أولاً، يستدعي التطبيق GetValidationStatus() للاستعلام عن النتيجة الأساسية للتحقق من صحة الشهادة كـ CertificateValidationStatus [SWS_CRYPT_50094].
  • إذا كان التحقق ناجحًا، يستدعي العميل GetCertificateChain() لاسترداد سلسلة الشهادات التي تم العثور عليها أثناء عملية الفحص كـ ara::core::Vector<Certificate::Sptrc> [SWS_CRYPT_50096]. وفقًا للمواصفة، تبدأ هذه السلسلة دائمًا عند موضع الفهرس 0 بشهادة الطرفية (Leaf Certificate) [SWS_CRYPT_50096].
  • أما إذا فشل التحقق من صحة المسار، فيستدعي المستدعي GetFailedCertificate() لتحديد الشهادة المحددة التي تسببت في خطأ التحقق [SWS_CRYPT_50095].
الاستعلام عن نتيجة التحقق من الصحةالتطبيقCertificateValidationResultGetValidationStatus()Result<CertificateValidationStatus>altValidierung erfolgreich (kValid)GetCertificateChain()Result<Vector<Certificate::Sptrc>>Validierung fehlgeschlagenGetFailedCertificate()Result<Certificate::Sptrc>

مخطط تسلسل: المسار النموذجي للاستعلام عن حالة التحقق، وسلسلة الشهادات، وسبب الخطأ. المصادر: [SWS_CRYPT_50094]، [SWS_CRYPT_50095]، [SWS_CRYPT_50096]

سيناريوهات الأخطاء

تعتمد إدارة الأخطاء في الواجهة على ara::core::Result، حيث تلتزم جميع الاستدعاءات بضمان noexcept وتكون آمنة بالنسبة للاستثناءات:

  • التحقق الناجح وGetFailedCertificate(): عند اكتمال الفحص بنجاح (قيمة الإرجاع kValid)، لا توجد أي شهادة تسببت في الفشل. في هذه الحالة، يفشل استدعاء GetFailedCertificate() برمز الخطأ ara::crypto::CryptoErrc::kNoSuchValue [SWS_CRYPT_50095]. يجب على التطبيقات تفسير هذا الخطأ كتأكيد منطقي لسلسلة خالية من الأخطاء أو ربط الاستدعاء بحالة سالبة.
  • أخطاء الحالة الخاصة بالتنفيذ: لم يتم تحديد رموز أخطاء قياسية لـ GetValidationStatus()، ولكن يتم تغليف الأخطاء الخاصة بالتنفيذ في ara::core::Result المُرجع [SWS_CRYPT_50094].
  • الاستعلام عن سلسلة الشهادات: لا تحدد GetCertificateChain() أيضًا أي رموز أخطاء قياسية [SWS_CRYPT_50096]؛ وتتم الإشارة إلى أي حالات خطأ داخلية عبر ara::core::Result الناتج.

يعتمد هذا الدليل حصريًا على مواصفات AUTOSAR Adaptive للوحدة crypto في الإصدار R25-11.

خريطة الأعضاء

الدوال الأعضاء

3
GetCertificateChainGetFailedCertificateGetValidationStatus

أسماء الأنواع البديلة

1
Sptrc

مخطط الفئة

Hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); Klicken öffnet die jeweilige Klassenseite.

G nara__crypto__x509__CertificateValidationResult372 CertificateValidationResult + GetCertificateChain() + GetFailedCertificate() + GetValidationStatus()

عرض التفاصيل

اختر عنصرًا من المخطط.

الدوال الأعضاء

GetCertificateChain دالة

Get the certificate chain found during certificate validation.

virtual ara::core::Result< ara::core::Vector< Certificate::Sptrc > > GetCertificateChain () const noexcept=0;
GetFailedCertificate دالة

Get the certificate that caused the certificate path validation to fail.

virtual ara::core::Result< Certificate::Sptrc > GetFailedCertificate () const noexcept=0;
GetValidationStatus دالة

Get the result of the certificate validation.

virtual ara::core::Result< CertificateValidationStatus > GetValidation Status () const noexcept=0;

أسماء الأنواع البديلة

Sptrc اسم نوع بديل

Smart pointer of the interface.

using Sptrc = std::shared_ptr<const CertificateValidationResult>;

توثيق الدوال

دالة GetCertificateChain [SWS_CRYPT_50096] Upstream: RS_CRYPTO_02306

virtual ara::core::Result< ara::core::Vector< Certificate::Sptrc > > GetCertificateChain () const noexcept=0;

Get the certificate chain found during certificate validation.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: dd73a4abf162 المصدر أسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

يتم توفير الطريقة GetCertificateChain للفئة ara::crypto::x509::CertificateValidationResult عبر ملف الرأس #include "ara/crypto/x509/certificate_validation_result.h" [SWS_CRYPT_50096]. وتُستخدم للاسترجاع المتزامن لسلسلة الشهادات التي تم العثور عليها أثناء التحقق من صحة الشهادة [SWS_CRYPT_50096].

لا تتوقع الواجهة أي معاملات وتُرجع ara::core::Result<ara::core::Vector<Certificate::Sptrc>> بشكل متزامن [SWS_CRYPT_50096]. يحتوي المتجه الناتج على مؤشرات ذكية إلى شهادات السلسلة التي تم التحقق من صحتها، بدءًا من شهادة الطرف عند موضع الفهرس 0 [SWS_CRYPT_50096].

معالجة الأخطاء

لم يتم تحديد أخطاء قياسية لهذه الدالة [SWS_CRYPT_50096]. تفسير: بما أن قيمة الإرجاع مصنفة مع ذلك كـ ara::core::Result، فمن المرجح أن حالات الخطأ التي تحدث تعود حصريًا إلى تفاصيل التنفيذ الخاصة بالشركة المصنعة. سؤال Q-967fe725a5505c11 (مفتوح)

التزامن والقيود

تم الإعلان عن الطريقة كدالة افتراضية صرفة، وحُددت كـ const وnoexcept، وصُنفت صراحةً على أنها thread-safe وexception safe [SWS_CRYPT_50096]. وبذلك تكون الاستدعاءات المتوازية على نفس المثيل ممكنة بأمان دون مزامنة خارجية.

تفاعل

تفي الدالة بالمتطلب ذي المستوى الأعلى [RS_CRYPTO_02306] في الوحدة crypt لـ Adaptive Platform [SWS_CRYPT_50096].

تم إنشاء هذا النص بواسطة نظام ذكاء اصطناعي استنادًا إلى مواصفة AUTOSAR R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/crypto/x509/certificate_validation_result.h"
Scopeclass ara::crypto::x509::CertificateValidationResult
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::Result<ara::core::Vector<Certificate::Sptrc > >A vector containing the found certificate chain, beginning with the leaf certificate at position 0.

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CRYPT_50096
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50096@rel:R25-11#d02201c5
Content hash
d02201c5
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50096
Status: valid/unmigrated Version: rel:R25-11#f119a26e Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CRYPT_50096@rel:R25-11#f119a26e
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة GetFailedCertificate [SWS_CRYPT_50095] Upstream: RS_CRYPTO_02306

virtual ara::core::Result< Certificate::Sptrc > GetFailedCertificate () const noexcept=0;

Get the certificate that caused the certificate path validation to fail.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 416a503d8d3e المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُستخدم طريقة الواجهة المتزامنة GetFailedCertificate للفئة ara::crypto::x509::CertificateValidationResult للاسترجاع المستهدف للشهادة التي تسببت في فشل التحقق من صحة مسار الشهادة [SWS_CRYPT_50095]. تتوفر الدالة عبر ملف الرأس ara/crypto/x509/certificate_validation_result.h ويتم استدعاؤها بدون معاملات تمرير [SWS_CRYPT_50095]. كقيمة إرجاع، توفر كائن نتيجة من النوع ara::core::Result<Certificate::Sptrc>، والذي يغلف في حالة النجاح مؤشرًا ذكيًا إلى الشهادة المتسببة في الخطأ [SWS_CRYPT_50095].

معالجة الأخطاء

إذا كان التحقق السابق من صحة مسار الشهادة ناجحًا (النتيجة kValid)، فبالتالي لم تؤدِ أي شهادة إلى حدوث خطأ في التحقق [SWS_CRYPT_50095]. وفي هذا التكوين، يبلغ GetFailedCertificate عن خطأ ويقدم في كائن النتيجة رمز الخطأ المحدد ara::crypto::CryptoErrc::kNoSuchValue بدلالات تراجع موثقة [SWS_CRYPT_50095]. لذلك، يجب على المكونات المستدعية التحقق إلزاميًا مما إذا كان ara::core::Result يحتوي على رمز خطأ قبل الوصول إلى مؤشر الشهادة، وذلك لمنع عمليات الوصول غير الصحيحة.

التزامن والقيود

تم الإعلان عن دالة العنصر كعملية استعلام صرفة بالمُعدِّلات const وnoexcept [SWS_CRYPT_50095]. ووفقًا لمتطلبات المواصفة، تم تنفيذها لتكون آمنة تمامًا من الاستثناءات (exception safe) وآمنة بالنسبة للخيوط (thread-safe) [SWS_CRYPT_50095]. ولهذا السبب، يمكن استدعاء الطريقة بأمان وبشكل متزامن من خيوط متعددة دون تدابير مزامنة إضافية.

تم إنشاء هذا النص بواسطة ذكاء اصطناعي ويستند إلى مواصفات AUTOSAR R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I1)

Header-Datei#include "ara/crypto/x509/certificate_validation_result.h"
Scopeclass ara::crypto::x509::CertificateValidationResult
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::Result<Certificate::Sptrc >A result containing the certificate that caused the certificate path validation to fail

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kNoSuchValuerollback_semantics if the certificate validation returned kValid, i.e., no certificate caused the validation to fail.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CRYPT_50095
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50095@rel:R25-11#f2c33932
Content hash
f2c33932
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50095
Status: valid/unmigrated Version: rel:R25-11#a460c4b9 Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CRYPT_50095@rel:R25-11#a460c4b9
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

دالة GetValidationStatus [SWS_CRYPT_50094] Upstream: RS_CRYPTO_02306

virtual ara::core::Result< CertificateValidationStatus > GetValidation Status () const noexcept=0;

Get the result of the certificate validation.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 6c769a28da81 المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُستخدم الطريقة GetValidationStatus للاسترجاع المتزامن لنتيجة التحقق من صحة فحص الشهادة [SWS_CRYPT_50094]. تم الإعلان عنها كدالة عضو ثابتة وافتراضية صرفة للواجهة ara::crypto::x509::CertificateValidationResult ومُدرجة عبر ملف الرأس ara/crypto/x509/certificate_validation_result.h [SWS_CRYPT_50094]. لا تقبل الدالة أي معاملات تمرير وتُرجع ara::core::Result<CertificateValidationStatus>، والذي يغلف حالة التحقق من صحة الشهادة في حالة النجاح [SWS_CRYPT_50094].

معالجة الأخطاء

لم يتم تحديد رموز خطأ قياسية لـ GetValidationStatus [SWS_CRYPT_50094]. وإذا فشل تقييم الحالة أو تحديدها، فإن ara::core::Result المُرجَع يحتوي بدلًا من ذلك على رمز خطأ خاص بالتنفيذ [SWS_CRYPT_50094]. وبالتالي، يجب على المتصلين دائمًا فحص كائن النتيجة بحثًا عن حالات الخطأ قبل الوصول إلى قيمة الحالة الفعلية.

التزامن والقيود

تم تحديد العملية كـ noexcept وبشكل صريح كآمنة بالنسبة للخيوط (thread-safe) وآمنة من الاستثناءات (exception safe) [SWS_CRYPT_50094]. وبالتالي يمكن استدعاؤها بأمان وبشكل متزامن من خيوط مختلفة على نفس المثيل دون الحاجة إلى آليات مزامنة إضافية.

تم توليد إشعار الاستخدام هذا آليًا استنادًا إلى مواصفة AUTOSAR Adaptive R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei#include "ara/crypto/x509/certificate_validation_result.h"
Scopeclass ara::crypto::x509::CertificateValidationResult
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::Result<CertificateValidationStatus >The result of the certificate validation, or an implementation specific error.

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CRYPT_50094
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50094@rel:R25-11#b7f6b422
Content hash
b7f6b422
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50094
Status: valid/unmigrated Version: rel:R25-11#e76328ae Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CRYPT_50094@rel:R25-11#e76328ae
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill

توثيق أسماء الأنواع البديلة

اسم نوع بديل Sptrc [SWS_CRYPT_50093] Upstream: RS_CRYPTO_02306

using Sptrc = std::shared_ptr<const CertificateValidationResult>;

Smart pointer of the interface.

Header-Datei#include "ara/crypto/x509/certificate_validation_result.h"
Scopeclass ara::crypto::x509::CertificateValidationResult
SymbolSptrc

Request a governed re-review of this record. The record is not changed immediately.

Record
AUTOSAR/AP/record/SWS_CRYPT_50093
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50093@rel:R25-11#116081b8
Content hash
116081b8
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50093
Status: valid/unmigrated Version: rel:R25-11#0adf21c8 Versionshistorie & Revisions (1 transition)
Current State
valid/unmigrated
Reason
mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record
Campaign
2026-08-13-status-backfill
Active Version
AUTOSAR/AP/record/SWS_CRYPT_50093@rel:R25-11#0adf21c8
Point-in-Time History:
DateActorTransitionReason / RationaleCampaign
2026-08-13toolnone → valid/unmigratedmechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record2026-08-13-status-backfill