DEENESPTFRRUARHIKOZHNL

क्लास ara::crypto::cryp::SymmetricKey

[SWS_CRYPT_23800] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02403

class SymmetricKey :          public CryptoObject {...};

Symmetric Key interface.

Header-Datei#include "ara/crypto/cryp/cryobj/symmetric_key.h"
Forwarding-Header#include "ara/crypto/crypto_fwd.h"
Scopenamespace ara::crypto::cryp
Basisklasse(n)CryptoObject

उपयोगकर्ता गाइडएआई जनित

सममितीय क्रिप्टोग्राफ़िक कुंजियों को एनकैप्सुलेट करता है और साझा स्मार्ट पॉइंटर्स के माध्यम से उनके जीवनकाल को नियंत्रित करता है।
एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: f71a58d7ce35 उद्गम खुले प्रश्न (3)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

सममितीय क्रिप्टोग्राफ़िक कुंजियों को एनकैप्सुलेट करता है और साझा स्मार्ट पॉइंटर्स के माध्यम से उनके जीवनकाल को नियंत्रित करता है।

इंटरफ़ेस ara::crypto::cryp::SymmetricKey AUTOSAR Adaptive में सममितीय क्रिप्टोग्राफ़िक कुंजियों के लिए एक अमूर्तता (abstraction) के रूप में कार्य करता है और CryptoObject से मौलिक गुणों को इनहेरिट करता है। अनुप्रयोग और क्रिप्टो संदर्भ मुख्य रूप से हेडर ara/crypto/cryp/cryobj/symmetric_key.h [SWS_CRYPT_23801] के अनुसार मानकीकृत स्मार्ट पॉइंटर प्रकार Sptr (std::shared_ptr<SymmetricKey>) के माध्यम से कुंजी इंस्टेंस का प्रबंधन करते हैं। व्याख्या: इन्स्टैन्शिएशन कुंजी प्रबंधन के समर्पित निर्माण रूटीन के माध्यम से होना चाहिए, जिसमें कुंजी को सिफर या MAC को कॉन्फ़िगर करने के लिए पास किया जाता है। प्रश्न Q-f76fecc360d2d3a5 (खुला) एक निर्णायक सीमा स्थिति के रूप में, साझा सूचक की संदर्भ गणना जीवनकाल निर्धारित करती है, ताकि एनकैप्सुलेटेड कुंजी ऑब्जेक्ट केवल अंतिम संदर्भ जारी होने के बाद ही नष्ट हो [SWS_CRYPT_23801]।

संदर्भ

वर्ग ara::crypto::cryp::SymmetricKey AUTOSAR Adaptive Platform (Release R25-11, मॉड्यूल crypto) में सममितीय क्रिप्टोग्राफ़िक कुंजियों के प्रतिनिधित्व के लिए केंद्रीय इंटरफ़ेस बनाता है। क्रिप्टोग्राफ़ी सबसिस्टम के एक प्राथमिक घटक के रूप में, इंटरफ़ेस उन सभी गुणों को एनकैप्सुलेट करता है जो सममितीय क्रिप्टोग्राफ़िक प्रक्रियाओं के लिए आवश्यक हैं। यह वर्ग सीधे CryptoObject (class SymmetricKey : public CryptoObject) से व्युत्पन्न है और इस प्रकार Adaptive Platform की क्रिप्टोग्राफ़िक संस्थाओं के लिए एकीकृत ऑब्जेक्ट पदानुक्रम में फिट बैठता है। इंटरफ़ेस हेडर फ़ाइल ara/crypto/cryp/cryobj/symmetric_key.h [SWS_CRYPT_23801] में घोषित किया गया है।

इंटरैक्शन भागीदारों के रूप में आमतौर पर क्रिप्टोग्राफ़िक निष्पादन संदर्भ और कुंजी प्रबंधन निकाय सामने आते हैं। इंटरफ़ेस कुंजी सामग्री के निर्माण या प्रावधान और इसके परिचालन अनुप्रयोग के बीच की कड़ी के रूप में कार्य करता है। व्याख्या: सममितीय कुंजियों का उपयोग मुख्य रूप से सममितीय सिफर प्रक्रियाओं (जैसे ब्लॉक या स्ट्रीम सिफर) के साथ-साथ Message Authentication Codes (MAC) में वाहन स्तर पर गोपनीयता और डेटा अखंडता को सुरक्षित करने के लिए किया जा सकता है। प्रश्न (खुला) CryptoObject के रूप में एनकैप्सुलेशन के माध्यम से यह सुनिश्चित किया जाता है कि कुंजी सामग्री ठोस क्रिप्टोग्राफ़िक परिवर्तन से अलग (decoupled) रहे।

जीवनचक्र

ara::crypto::cryp::SymmetricKey इंस्टेंस का जीवनचक्र आधुनिक C++ मेमोरी प्रबंधन पैटर्न के साथ निकटता से जुड़ा हुआ है। [SWS_CRYPT_23801] के अनुसार, वर्ग प्रकार उपनाम Sptr प्रदान करता है, जिसे using Sptr = std::shared_ptr<SymmetricKey>; के रूप में परिभाषित किया गया है। इस साझा स्मार्ट पॉइंटर के माध्यम से, इंटरफ़ेस ऑब्जेक्ट के जीवनचक्र को संदर्भ-गिना (reference-counted) और नियतात्मक रूप से नियंत्रित किया जाता है।

व्याख्या: व्यवहार में इंस्टेंस का वास्तविक निर्माण और आरंभीकरण क्रिप्टो स्टैक के विशेष कुंजी जनरेटर, लोडर रूटीन या कुंजी प्रबंधन घटकों के माध्यम से होना चाहिए, क्योंकि इंटरफ़ेस परिभाषा प्रत्यक्ष रॉ-कुंजी इन्स्टैन्शिएशन के लिए किसी भी सार्वजनिक डिफ़ॉल्ट कंस्ट्रक्टर को प्रदर्शित नहीं करती है। प्रश्न Q-51acf16b99d9ad1b (खुला) एक बार जब कोई कुंजी इंस्टेंस Sptr के रूप में निर्मित हो जाता है, तो इसे कई सॉफ़्टवेयर घटकों या क्रिप्टोग्राफ़िक संदर्भों द्वारा समवर्ती और स्वामित्व-साझाकरण के साथ संदर्भित किया जा सकता है [SWS_CRYPT_23801]।

अंतर्निहित संसाधनों की रिहाई स्वचालित रूप से तब होती है जब अंतिम सक्रिय Sptr नष्ट हो जाता है या रीसेट हो जाता है। व्याख्या: CryptoObject से व्युत्पत्ति यह दर्शाती है कि मेमोरी में संवेदनशील कुंजी सामग्री विशेष रूप से सुरक्षित है और जीवनकाल समाप्त होने के बाद पढ़ने से रोकने के लिए ऑब्जेक्ट के विनाश के समय सुरक्षित रूप से शुद्ध (Zeroization) की जाती है। प्रश्न (खुला) std::shared_ptr का उपयोग संदर्भ काउंटरों के प्रबंधन में थ्रेड सुरक्षा की भी गारंटी देता है, जबकि संदर्भित कुंजी ऑब्जेक्ट तक पहुंच स्वयं साझा संसाधनों के लिए सामान्य सिंक्रनाइज़ेशन नियमों के अधीन होती है।

उपयोग पथ

एक Adaptive अनुप्रयोग में ara::crypto::cryp::SymmetricKey का नियमित उपयोग एक संरचित प्रवाह का पालन करता है जो परिभाषित स्मार्ट पॉइंटर पर निर्भर करता है [SWS_CRYPT_23801]:

  • हेडर समावेशन: सबसे पहले, उपयोग करने वाला सॉफ़्टवेयर घटक प्रकार परिभाषा और उपनाम Sptr तक पहुंच प्राप्त करने के लिए हेडर #include "ara/crypto/cryp/cryobj/symmetric_key.h" को शामिल करता है [SWS_CRYPT_23801]।
  • कुंजी अधिग्रहण: अनुप्रयोग ara::crypto::cryp::SymmetricKey::Sptr [SWS_CRYPT_23801] के रूप में इंटरफ़ेस प्राप्त करता है, उदाहरण के लिए एक अपस्ट्रीम कुंजी प्रावधान प्रक्रिया से।
  • वैधता जांच: परिचालन उपयोग से पहले, कॉलर सत्यापित करता है कि प्राप्त Sptr nullptr के बराबर नहीं है और एक बरकरार CryptoObject को इंगित करता है।
  • क्रिप्टो संदर्भों को असाइनमेंट: कुंजी सूचक को आगामी एन्क्रिप्शन या डिक्रिप्शन ऑपरेशनों या अखंडता जांचों के लिए कॉन्फ़िगर करने के लिए जिम्मेदार क्रिप्टोग्राफ़िक संदर्भ को पास किया जाता है।
  • विमोचन: परिवर्तनों के पूरा होने के बाद या एप्लिकेशन संदर्भ समाप्त होने पर, सूचक को त्याग दिया जाता है; कुंजी का विनाश अंतिम Sptr [SWS_CRYPT_23801] के स्वचालित विलोपन द्वारा होता है।

यह मार्गदर्शिका AUTOSAR Adaptive Platform Release R25-11 विनिर्देश पर आधारित है। विवरण संदर्भित विनिर्देश तत्वों के साथ-साथ इस रूप में चिह्नित व्याख्याओं पर आधारित हैं।

UML क्लास आरेख

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

G nara__crypto__cryp__SymmetricKey111 SymmetricKey nara__crypto__cryp__CryptoObject679 CryptoObject nara__crypto__cryp__SymmetricKey111->nara__crypto__cryp__CryptoObject679 nara__crypto__Serializable855 Serializable nara__crypto__cryp__CryptoObject679->nara__crypto__Serializable855

टाइप उपनाम

Sptr टाइप उपनाम

Shared smart pointer of the interface.

using Sptr = std::shared_ptr<SymmetricKey>;

टाइप उपनामों का प्रलेखन

टाइप उपनाम Sptr [SWS_CRYPT_23801] Upstream: RS_CRYPTO_02201

using Sptr = std::shared_ptr<SymmetricKey>;

Shared smart pointer of the interface.

Header-Datei#include "ara/crypto/cryp/cryobj/symmetric_key.h"
Scopeclass ara::crypto::cryp::SymmetricKey
SymbolSptr

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

Record
AUTOSAR/AP/record/SWS_CRYPT_23801
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_23801@rel:R25-11#d8a19f2f
Content hash
d8a19f2f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_23801
Status: valid/unmigrated Version: rel:R25-11#882653b8 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_23801@rel:R25-11#882653b8
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#d033faab2026-09-30
  • R19-11rel:R19-11#a0669f0d2026-10-14
  • R20-11rel:R20-11#c490e0a52026-10-14
  • R21-11rel:R21-11#c490e0a52026-10-14
  • R22-11rel:R22-11#b634ae6e2026-10-14
  • R23-11rel:R23-11#cb129b992026-10-14
  • R24-11rel:R24-11#cb129b992026-10-14
  • R25-11rel:R25-11#882653b82026-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