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 AUTOSAR Adaptive Platform के मॉड्यूल crypto के भीतर X.509 मानक के अनुसार एक Distinguished Name (DN) का प्रतिनिधित्व करता है। ara::crypto::Serializable के इनहेरिटेंस के माध्यम से, क्लास को सीरियलाइज़ करने योग्य क्रिप्टोग्राफ़िक डेटा संरचना के रूप में टाइप पदानुक्रम में एम्बेड किया गया है। इंटरफ़ेस का प्राथमिक कार्य प्रमाणपत्रों, प्रमाणपत्र धारकों (Subjects) या प्रमाणपत्र जारीकर्ताओं (Issuers) की नाम संरचनाओं को सॉफ़्टवेयर-साइड पर एनकैप्सुलेट करना है। एक मानकीकृत पाठ्य निरूपण का प्रावधान इसमें एक केंद्रीय भूमिका निभाता है: [SWS_CRYPT_40411] के अनुसार, विधि ToString() विनिर्देश RFC 4514 के अनुरूप संपूर्ण Distinguished Name को एक स्ट्रिंग के रूप में निर्यात करती है। यदि अंतर्निहित Distinguished Name में गैर-मानकीकृत विशेषताएँ शामिल हैं, तो इन विशेषताओं के लिए संबंधित Object Identifier (OID) का उपयोग किया जाता है [SWS_CRYPT_40411]।

जीवनचक्र

चूँकि ara::crypto::x509::X509DN शुद्ध वर्चुअल मेथड्स जैसे कि ToString() वाला एक अमूर्त C++ इंटरफ़ेस है, इसलिए इंस्टैंशिएशन सीधे ऍप्लिकेशन डेवलपर्स द्वारा नहीं किया जाता है। पेलोड किसी सार्वजनिक कंस्ट्रक्टर को निर्दिष्ट नहीं करता है; ठोस इंस्टेंसेस का निर्माण संभवतः क्रिप्टोग्राफ़िक सबसिस्टम के उच्च-स्तरीय घटकों या प्रमाणपत्र पार्सर द्वारा किया जाना चाहिए। प्रश्न Q-108d7589869c7370 (खुला)

साझा और दीर्घकालिक एक्सेस के लिए, इंटरफ़ेस std::shared_ptr<const X509DN> के उपनाम के रूप में टाइप विनिर्देशक Sptrc को परिभाषित करता है [SWS_CRYPT_40401]। एक स्थिर शेयर्ड पॉइंटर का उपयोग स्वामित्व और एक्सेस अवधारणा को रेखांकित करता है: X509DN के इंस्टेंस बाहरी रूप से अपरिवर्तनीय (immutable) हैं। कई उपभोक्ता रीड एक्सेस के दौरान सिंक्रोनाइज़ेशन ओवरहेड के बिना Distinguished Name के एक ही निरूपण को सुरक्षित और स्टेटलेस रूप से साझा कर सकते हैं। समवर्तीता के संबंध में, केंद्रीय विधि ToString() को स्पष्ट रूप से थ्रेड-सेफ़ घोषित किया गया है [SWS_CRYPT_40411]। इस प्रकार समान शेयर्ड पॉइंटर पर या विभिन्न थ्रेड्स में समानांतर कॉल बाहरी लॉक के बिना अनुमत हैं। इसके अतिरिक्त, विनिर्देश इस कॉल के लिए पूर्ण अपवाद सुरक्षा (exception safe) का आश्वासन देता है [SWS_CRYPT_40411]।

उपयोग पथ

विशिष्ट उपयोग पथ लॉगिंग, प्रमाणीकरण या पहचान सत्यापन के लिए स्वरूपित Distinguished Name को पढ़ने और आगे संसाधित करने पर केंद्रित है। एक अनुप्रयोग आमतौर पर 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=... जैसे विशेषता-मान युग्मों के मानकीकृत रूप में या मालिकाना विशेषताओं के मामले में OIDs का उपयोग करते हुए [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 इसके लिए कोई डोमेन-विशिष्ट त्रुटि स्थिरांक प्रदान न करता हो।

यह मार्गदर्शिका Adaptive Platform (रिलीज़ R25-11, मॉड्यूल crypto) के लिए AUTOSAR विनिर्देश पर आधारित है और स्वचालित रूप से तैयार की गई थी।

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 · जर्मन मूल

इंटरफ़ेस ara::crypto::x509::X509DN की शुद्ध-वर्चुअल विधि ToString RFC 4514 [SWS_CRYPT_40411] के अनुसार पूर्ण Distinguished Name (DN) को एकल स्वरूपित स्ट्रिंग के रूप में निर्यात करती है। यदि DN में गैर-मानकीकृत विशेषताएँ शामिल हैं, तो स्ट्रिंग में नाम के स्थान पर इन विशेषताओं के लिए उनके Object Identifier (OID) का उपयोग किया जाता है [SWS_CRYPT_40411]। उपयोग करने के लिए, हेडर ara/crypto/x509/x509_dn.h शामिल किया जाना चाहिए [SWS_CRYPT_40411]।

कॉल को एक निरंतर (constant) इंस्टेंस पर समकालिक और पैरामीटर-रहित रूप से निष्पादित किया जाता है। रिटर्न प्रकार ara::core::Result<ara::core::String> के रूप में कार्य करता है, जो सफल होने पर Distinguished Name का पूर्ण स्ट्रिंग प्रतिनिधित्व प्रदान करता है [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#8bff5520
Content hash
8bff5520
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#5ebbef00
Content hash
5ebbef00
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