DEENESPTFRRUARHIKOZHNL

فئة ara::crypto::x509::X509DN

[SWS_CRYPT_40400] Upstream: RS_CRYPTO_02306

class X509DN : public ara::crypto::Serializable {...};

Interface of X.509 Distinguished Name (DN).

Header-Datei#include "ara/crypto/x509/x509_dn.h"
Forwarding-Header#include "ara/crypto/crypto_fwd.h"
Scopenamespace ara::crypto::x509
Basisklasse(n)ara::crypto::Serializable

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

يغلف X.509 Distinguished Name ويخرجه منسقاً كسلسلة نصية متوافقة مع RFC-4514.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: d02e57b4256c المصدر أسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يغلف X.509 Distinguished Name ويخرجه منسقاً كسلسلة نصية متوافقة مع RFC-4514.

تُستخدم الواجهة ara::crypto::x509::X509DN لتغليف وتوفير X.509 Distinguished Name كهيكل بيانات قابل للتسلسل داخل وحدة التشفير. عبر الاسم المستعار Sptrc، تتحقق الملكية المشتركة الثابتة للمثيلات بصيغة std::shared_ptr<const X509DN> [SWS_CRYPT_40401]. يقوم التابع المركزي ToString() بتنسيق الاسم الكامل وفقاً للمعيار RFC 4514 ويعمل بأمان تام لمؤشرات الترابط وبدون رموز خطأ قياسية [SWS_CRYPT_40411]. يتلقى المتصلون النتيجة كـ ara::core::Result<ara::core::String>، والتي يجب التحقق من صحتها قبل مواصلة المعالجة.

السياق

تمثل الواجهة المجردة ara::crypto::x509::X509DN داخل الوحدة crypto في AUTOSAR Adaptive Platform اسماً مميزاً (Distinguished Name - DN) وفقاً لمعيار X.509. من خلال الوراثة من ara::crypto::Serializable، يتم تضمين الفئة كهيكل بيانات تشفير قابل للتسلسل في التسلسل الهرمي للأنواع. وتتمثل المهمة الأساسية للواجهة في تغليف هياكل أسماء الشهادات، أو حاملي الشهادات (Subjects)، أو جهات إصدار الشهادات (Issuers) على مستوى البرمجيات. ويحتل توفير تمثيل نصي معياري دوراً مركزياً: وفقاً لـ [SWS_CRYPT_40411]، يقوم التابع ToString() بتصدير الاسم المميز الكامل كسلسلة نصية مطابقة للمواصفة RFC 4514. وإذا تضمن الاسم المميز الأساسي سمات غير قياسية، فسيتم استخدام معرف الكائن المقابل (OID) لهذه السمات [SWS_CRYPT_40411].

دورة الحياة

نظراً لأن ara::crypto::x509::X509DN هي واجهة C++ مجردة ذات توابع افتراضية تماماً مثل ToString()، فلا يتم إنشاء مثيل لها مباشرة بواسطة مطوري التطبيقات. لا تحدد حمولة البيانات أي مُنشئ عام؛ ويُرجح أن يتم إنشاء مثيلات فعلية بواسطة مكونات عليا أو محللات الشهادات للنظام الفرعي للتشفير. سؤال Q-108d7589869c7370 (مفتوح)

للوصول المشترك وطويل الأمد، تحدد الواجهة محدد النوع Sptrc كاسم مستعار لـ std::shared_ptr<const X509DN> [SWS_CRYPT_40401]. ويؤكد استخدام مؤشر مشترك ثابت على مفهوم الملكية والوصول: تكون مثيلات X509DN غير قابلة للتغيير (immutable) ظاهرياً. يمكن للعديد من المستهلكين مشاركة نفس التمثيل للاسم المميز بأمان وبدون حالة، دون الحاجة إلى تكاليف مزامنة إضافية لعمليات القراءة. وفيما يتعلق بالتزامن، تم التصريح صراحة عن التابع المركزي ToString() كآمن لمؤشرات الترابط (thread-safe) [SWS_CRYPT_40411]. وبالتالي يُسمح بالاستدعاءات المتوازية عبر نفس المؤشر المشترك أو عبر مؤشرات ترابط مختلفة دون أقفال خارجية. بالإضافة إلى ذلك، تضمن المواصفة أماناً كاملاً من الاستثناءات (exception safe) لهذا الاستدعاء [SWS_CRYPT_40411].

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

يركز مسار الاستخدام النموذجي على قراءة ومعالجة الاسم المميز المنسق للتسجيل، أو المصادقة، أو التحقق من الهوية. يستلم التطبيق عادةً مؤشراً من النوع ara::crypto::x509::X509DN::Sptrc [SWS_CRYPT_40401].

على هذا المثيل، ينفذ المتصل التابع ToString() [SWS_CRYPT_40411]. يتم الاستدعاء noexcept ويُرجع ara::core::Result<ara::core::String> [SWS_CRYPT_40411]. عند التقييم الناجح، يحتوي كائن Result على السلسلة النصية المنسقة وفقاً لـ RFC 4514، على سبيل المثال في الشكل القياسي لأزواج السمات والقيم مثل CN=... أو باستخدام OID للسمات الخاصة [SWS_CRYPT_40411]. يمكن للتطبيق بعد ذلك استخراج السلسلة النصية الناتجة وإعادة استخدامها لإجراء عمليات فحص خاصة بالتطبيق، أو المقارنات، أو سجلات التدقيق.

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

تتميز معالجة الأخطاء عند التفاعل مع ara::crypto::x509::X509DN بتصميم واضح ومبسط. على الرغم من أن ToString() يستخدم نوع الإرجاع ara::core::Result<ara::core::String>، إلا أن المواصفة تنص صراحة على أن الدالة لا تحدد أي رموز خطأ قياسية [SWS_CRYPT_40411]. وهذا يعني أنه في سياق المواصفة العادي، لا توجد أسباب رفض تقنية أو أخطاء تحقق متوقعة لعملية التسلسل.

نظراً لأن الدالة محددة أيضاً كـ noexcept وكآمنة من الاستثناءات (exception safe) [SWS_CRYPT_40411]، فإن استثناءات C++ المتزامنة مستبعدة. وإذا ظهرت حالات خطأ داخل ara::core::Result المُرجع، فمن المحتمل أن تُعزى إلى أسباب خاصة بالمنصة أو التنفيذ، مثل نقص الذاكرة أثناء تخصيص سلسلة النتائج. سؤال Q-10477dd7d77e3b78 (مفتوح) لذلك، يجب على المتصلين دائماً التحقق مما إذا كان Result يحتوي على قيمة صالحة أو خطأ قبل فك القيمة، حتى وإن لم تحدد AUTOSAR ثوابت خطأ خاصة بالمجال لذلك.

يستند هذا الدليل إلى مواصفة AUTOSAR الخاصة بـ Adaptive Platform (الإصدار R25-11، الوحدة crypto) وتم إنشاؤه تلقائياً.

مخطط الفئات UML

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

G nara__crypto__x509__X509DN930 X509DN + ToString() nara__crypto__Serializable855 Serializable nara__crypto__x509__X509DN930->nara__crypto__Serializable855

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

ToString دالة

Get the whole Distinguished Name (DN) as a single string according to RFC 4514. If the DN contains unstandardized attributes, the attribute’s OID is used.

virtual ara::core::Result< ara::core::String > ToString () const noexcept=0;

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

Sptrc اسم نوع بديل

Const shared smart pointer of the interface.

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

توثيق الدوال

دالة ToString [SWS_CRYPT_40411] Upstream: RS_CRYPTO_02306

virtual ara::core::Result< ara::core::String > ToString () const noexcept=0;

Get the whole Distinguished Name (DN) as a single string according to RFC 4514. If the DN contains unstandardized attributes, the attribute’s OID is used.

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

تُصدّر الطريقة الافتراضية البحتة ToString الخاصة بالواجهة ara::crypto::x509::X509DN الاسم المميّز (DN) الكامل كسلسلة نصية مفردة ومنسقة وفقًا لـ RFC 4514 [SWS_CRYPT_40411]. إذا كان DN يتضمن سمات غير معيارية، يُستخدم في السلسلة النصية معرف الكائن (OID) الخاص بهذه السمات بدلاً من الاسم [SWS_CRYPT_40411]. للاستخدام، يجب تضمين ملف الرأس ara/crypto/x509/x509_dn.h [SWS_CRYPT_40411].

يُنفذ الاستدعاء بشكل متزامن ودون معلمات على مثيل ثابت. يُستخدم ara::core::Result<ara::core::String> كنوع إرجاع، والذي يوفر في حالة النجاح التمثيل النصي الكامل للاسم المميّز [SWS_CRYPT_40411]. لم تُحدد المواصفة رموز أخطاء خاصة أو معيارية لهذه الدالة [SWS_CRYPT_40411].

للاستخدام في التشغيل المتزامن، صُنفت ToString بأنها آمنة بالنسبة للخيوط (thread-safe) [SWS_CRYPT_40411]. بالإضافة إلى ذلك، ينطبق الأمان من الاستثناءات (exception safe)، مدعومًا بمواصفة noexcept لتوقيع الدالة، والتي تستبعد حدوث استثناءات C++‎ [SWS_CRYPT_40411].

تم إنشاء ملاحظة الاستخدام هذه تلقائيًا بناءً على مواصفة AUTOSAR.

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

Rückgabewert

TypBeschreibung
ara::core::Result<ara::core::String >String of the whole DN string

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_40411
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_40411@rel:R25-11#f45034ad
Content hash
f45034ad
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_40411
Status: valid/unmigrated Version: rel:R25-11#027bb18b Versionshistorie & Revisions (1 transition, 8 revision)
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_40411@rel:R25-11#027bb18b
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#0a4f449c2026-09-30
  • R19-11rel:R19-11#aa7783f22026-10-14
  • R20-11rel:R20-11#107617f62026-10-14
  • R21-11rel:R21-11#ffe162c32026-10-14
  • R22-11rel:R22-11#c6c8fcc72026-10-14
  • R23-11rel:R23-11#8b07ee3d2026-10-14
  • R24-11rel:R24-11#d26b8a3b2026-10-14
  • R25-11rel:R25-11#027bb18b2026-10-14 active
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_40401] Upstream: RS_CRYPTO_02306

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

Const shared smart pointer of the interface.

Header-Datei#include "ara/crypto/x509/x509_dn.h"
Scopeclass ara::crypto::x509::X509DN
SymbolSptrc

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

Record
AUTOSAR/AP/record/SWS_CRYPT_40401
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_40401@rel:R25-11#dd134c20
Content hash
dd134c20
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_40401
Status: valid/unmigrated Version: rel:R25-11#a001dc44 Versionshistorie & Revisions (1 transition, 8 revision)
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_40401@rel:R25-11#a001dc44
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#0b636ab72026-09-30
  • R19-11rel:R19-11#ced209c92026-10-14
  • R20-11rel:R20-11#202479662026-10-14
  • R21-11rel:R21-11#202479662026-10-14
  • R22-11rel:R22-11#c65923232026-10-14
  • R23-11rel:R23-11#7df124232026-10-14
  • R24-11rel:R24-11#7df124232026-10-14
  • R25-11rel:R25-11#a001dc442026-10-14 active
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