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

[SWS_CRYPT_24000] Upstream: RS_CRYPTO_02104, RS_CRYPTO_02208

class SymmetricKeyWrapperCtx :               public CryptoContext {...};

Context of a symmetric key wrap algorithm.

Header-Datei	#include "ara/crypto/cryp/symmetric_key_wrapper_ctx.h"
Forwarding-Header	#include "ara/crypto/crypto_fwd.h"
Scope	namespace ara::crypto::cryp
Basisklasse(n)	CryptoContext

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

सममितीय कुंजी एन्क्रिप्शन के माध्यम से कुंजियों की सुरक्षित रैपिंग और अनरैपिंग को सक्षम बनाता है।

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 16126e8d9692 उद्गम खुले प्रश्न (1)

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

SymmetricKeyWrapperCtx संदर्भ सममितीय एल्गोरिदम के माध्यम से कुंजियों की क्रिप्टोग्राफ़िक रैपिंग और अनरैपिंग का कार्य करता है। Wrap या UnwrapSymmetricKey के निष्पादन से पहले, संदर्भ को SetKey के माध्यम से एक संगत कुंजी एन्क्रिप्शन कुंजी (KEK) के साथ कॉन्फ़िगर किया जाना चाहिए [SWS_CRYPT_24018]। सभी संचालन शामिल कुंजी ऑब्जेक्ट्स के संगत उपयोग अनुमतियों की अपेक्षा करते हैं और रोलबैक सेमांटिक्स के साथ ara::core::Result के माध्यम से त्रुटियों की रिपोर्ट करते हैं [SWS_CRYPT_24014]। इंटरफ़ेस अपवाद-सुरक्षित है और समवर्ती संचालन के लिए थ्रेड-सुरक्षित के रूप में निर्दिष्ट है।

संदर्भ

SymmetricKeyWrapperCtx वर्ग AUTOSAR Adaptive Platform के भीतर सममितीय कुंजी रैपिंग एल्गोरिदम (Key Wrapping) के लिए मानकीकृत इंटरफ़ेस को परिभाषित करता है। इसका मुख्य उत्तरदायित्व निर्यात के दौरान कुंजियों का क्रिप्टोग्राफ़िक संरक्षण तथा आंतरिक उपयोग के लिए रैप की गई कुंजियों की पुनर्प्राप्ति है। इसमें, वर्ग मुख्य रूप से कुंजी एन्क्रिप्शन कुंजियों (Key Encryption Keys, KEK) के साथ इंटरैक्ट करता है, जो या तो SymmetricKey प्रकार के एक क्षणिक कुंजी ऑब्जेक्ट के रूप में या किसी KeySlot के माध्यम से स्थायी रूप से प्रदान की जाती हैं [SWS_CRYPT_24018], [SWS_CRYPT_50034]। रैप करते समय संदर्भ एक सामान्य CryptoObject स्वीकार करता है [SWS_CRYPT_24014], जबकि अनरैपिंग ऑपरेशन एक नया, उपयोग के लिए तैयार SymmetricKey ऑब्जेक्ट उत्पन्न करता है और वापस लौटाता है [SWS_CRYPT_24016]।

जीवनचक्र

SymmetricKeyWrapperCtx के इंस्टेंसेस टाइप किए गए स्मार्ट पॉइंटर Sptr (std::shared_ptr<SymmetricKeyWrapperCtx> के लिए एक उपनाम) के माध्यम से प्रबंधित किए जाते हैं [SWS_CRYPT_24001]। वास्तविक ऑब्जेक्ट निर्माण एक सक्षम प्रदाता फ़ैक्टरी के माध्यम से होना चाहिए, क्योंकि यह वर्ग विशुद्ध वर्चुअल विधियों वाला एक अमूर्त इंटरफ़ेस प्रस्तुत करता है। प्रश्न Q-7b9a1007da43ddcd (खुला) इंटरफ़ेस के सभी सदस्य फलन अपवाद-सुरक्षित (exception safe) और साथ ही थ्रेड-सुरक्षित (thread-safe) के रूप में निर्दिष्ट हैं, जो समवर्ती सॉफ्टवेयर घटकों में सुरक्षित उपयोग को सक्षम बनाता है [SWS_CRYPT_24014], [SWS_CRYPT_24016]।

लाइफ़साइकिल में संदर्भ दो मुख्य चरणों से गुज़रता है: इंस्टेंसिएशन के तुरंत बाद यह एक गैर-आरंभीकृत अवस्था में होता है। इस चरण में क्रिप्टोग्राफ़िक संचालन और बफ़र गणनाएँ त्रुटि kUninitializedContext के साथ विफल हो जाती हैं [SWS_CRYPT_50035], [SWS_CRYPT_24014]। केवल एक संगत KEK या KeySlot के साथ SetKey के सफल कॉल द्वारा ही संदर्भ परिचालन-तैयार अवस्था में बदलता है, जिसमें कुंजियों को सुरक्षित रूप से रैप या अनरैप किया जा सकता है [SWS_CRYPT_24018], [SWS_CRYPT_50034]।

उपयोग पथ

किसी कुंजी को रैप करने के सामान्य अनुक्रम के लिए कॉन्फ़िगरेशन, बफ़र सत्यापन और निष्पादन का एक समन्वित क्रम आवश्यक होता है। सबसे पहले एप्लिकेशन संदर्भ को SetKey के माध्यम से वांछित KEK ऑब्जेक्ट [SWS_CRYPT_24018] के साथ कॉन्फ़िगर करता है या एक संगत KeySlot को बाउंड करता है [SWS_CRYPT_50034]। दूसरे चरण में, एप्लिकेशन GetRequiredWrappedKeyBufferSize के माध्यम से रैप किए जाने वाले लक्ष्य ऑब्जेक्ट के लिए आवश्यक अधिकतम आउटपुट बफ़र आकार निर्धारित करता है [SWS_CRYPT_50035]। उचित आयाम वाला मेमोरी क्षेत्र (ReadWriteMemRegion) उपलब्ध कराए जाने के बाद, Wrap का कॉल निष्पादित होता है, जो क्रमबद्ध और एन्क्रिप्टेड कुंजी डेटा को बफ़र में लिखता है और बाइट्स की सटीक संख्या लौटाता है [SWS_CRYPT_24014]।

अनुक्रम आरेख: सममितीय कुंजी रैपिंग के लिए विशिष्ट कॉल अनुक्रम। स्रोत: [SWS_CRYPT_24018], [SWS_CRYPT_50035], [SWS_CRYPT_24014]

अनरैपिंग की पूरक प्रक्रिया के लिए, एप्लिकेशन SetKey के माध्यम से कॉन्फ़िगरेशन के बाद रैप किए गए डेटा वाले इनपुट बफ़र को UnwrapSymmetricKey को पास करता है [SWS_CRYPT_24016]। इस प्रक्रिया में, नए बनाए जाने वाले सममितीय कुंजी के लिए लक्ष्य एल्गोरिदम पहचानकर्ता (targetAlgId) और साथ ही अनुमत उपयोग फ़्लैग्स (allowedUsage) को स्पष्ट रूप से निर्धारित किया जाना चाहिए [SWS_CRYPT_24016]।

त्रुटि परिदृश्य

वर्ग की विधियाँ रोलबैक सेमांटिक्स के साथ रिटर्न प्रकार ara::core::Result के माध्यम से त्रुटियों का संकेत देती हैं। मुख्य त्रुटि परिदृश्यों में शामिल हैं:

आरंभीकरण का अभाव: यदि किसी सफल कुंजी असाइनमेंट से पहले GetRequiredWrappedKeyBufferSize, Wrap या UnwrapSymmetricKey को कॉल किया जाता है, तो वे ara::crypto::CryptoErrc::kUninitializedContext लौटाते हैं [SWS_CRYPT_50035], [SWS_CRYPT_24014], [SWS_CRYPT_24016]।
उपयोग अधिकारों का उल्लंघन: KEK सेट करते समय, उसके पास कम से कम kAllowKeyWrapping या kAllowKeyUnwrapping की अनुमति होनी चाहिए, अन्यथा SetKey त्रुटि ara::crypto::CryptoErrc::kUsageViolation के साथ विफल हो जाता है [SWS_CRYPT_24018]। Wrap के मामले में, KEK पर kAllowKeyWrapping का अभाव या रैप की जाने वाली ऑब्जेक्ट पर kAllowSecuredExport का अभाव भी kUsageViolation की ओर ले जाता है [SWS_CRYPT_24014]। अनरैप करते समय, यह जाँचा जाता है कि क्या KEK kAllowKeyUnwrapping की अनुमति देता है [SWS_CRYPT_24016]।
असंगतता और बफ़र त्रुटियाँ: यदि Wrap के लिए लक्ष्य बफ़र बहुत छोटा है, तो ara::crypto::CryptoErrc::kInsufficientCapacity की रिपोर्ट की जाती है [SWS_CRYPT_24014]। त्रुटिपूर्ण कुंजी प्रारूप या असंगत प्रकार ara::crypto::CryptoErrc::kInvalidArgument का कारण बनते हैं [SWS_CRYPT_24014], [SWS_CRYPT_24016]। यदि संदर्भ केवल स्लॉट या केवल कुंजी ऑब्जेक्ट्स का समर्थन करता है, तो SetKey त्रुटि kUnsupported की रिपोर्ट करता है [SWS_CRYPT_24018], [SWS_CRYPT_50034]।
संसाधन संघर्ष और रिक्त स्लॉट: यदि ऑपरेशन किसी व्यस्त संसाधन तक पहुँचता है, तो ara::crypto::CryptoErrc::kBusyResource लौटाया जाता है; यदि संदर्भित KeySlot रिक्त है, तो इसका परिणाम ara::crypto::CryptoErrc::kEmptyKeySlot होता है [SWS_CRYPT_24014], [SWS_CRYPT_24016]।

यह गाइड एक AI द्वारा तैयार की गई थी और पूरी तरह से AUTOSAR विनिर्देश पर आधारित है।

सदस्य मानचित्र

मेथड

GetRequiredWrappedKeyBufferSize SetKey UnwrapSymmetricKey Wrap

टाइप उपनाम

Sptr

क्लास आरेख

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

विवरण दृश्य

रूपरेखा में कोई प्रविष्टि चुनें।

इस रिलीज़ के लिए कोई तत्व डेटा उपलब्ध नहीं

मेथड

GetRequiredWrappedKeyBufferSize फ़ंक्शन

Calculate the maximum required size of the wrapped key output buffer depending on the key to be wrapped.

virtual ara::core::Result< std::size_t > GetRequiredWrappedKeyBuffer Size (const CryptoObject &key) const noexcept;

SetKey फ़ंक्शन 2

Configure the context to use the provided key as key encryption key.

ओवरलोड SetKey 2

virtual ara::core::Result< void > SetKey (SymmetricKey::Sptr key) noexcept=0; SWS_CRYPT_24018

virtual ara::core::Result< void > SetKey (KeySlot::Sptr keySlot) noexcept=0; SWS_CRYPT_50034

UnwrapSymmetricKey फ़ंक्शन

Unwrap a wrapped key using the previously set key encryption key and return an SymmetricKey.

virtual ara::core::Result< SymmetricKey::Sptr > UnwrapSymmetricKey (ReadOnlyMemRegion wrappedKey, AlgId targetAlgId, AllowedUsageFlags allowedUsage) const noexcept=0;

Wrap फ़ंक्शन

Wrap the provided key using the previously set key encryption key.

virtual ara::core::Result< std::size_t > Wrap (CryptoObject::Sptr key, ReadWriteMemRegion wrappedKey) const noexcept=0;

टाइप उपनाम

Sptr टाइप उपनाम

Smart pointer of the interface.

using Sptr = std::shared_ptr<SymmetricKeyWrapperCtx>;

किसी प्रविष्टि के संबंध देखने के लिए उस पर क्लिक करें।

आधार क्लासव्युत्पन्नउपयोग करता हैइनके द्वारा उपयोगइनहेरिटेंससे हटाया गयाइनमें उपयोगइस क्लास में कोई संबंध नहींफ़ंक्शनएआई टिप्पणीक्लास पेज खोलेंक्लास पेज लोड नहीं हो सका।क्रम बदलेंचौड़ाई बदलेंरूपरेखा की चौड़ाई बदलेंखंडपढ़ने का समयSWS संदर्भआरेखवापस बीच मेंक्रम बदलें या शीर्षक पट्टी पर खींचेंअनडॉक करें – सामग्री में दिखाएँबीच वाले कॉलम में ले जाएँशीर्षक पट्टी में टैब के रूप में डॉक करेंतत्वएआई मॉडलऑडिट डोज़ियर खोलेंडोज़ियरसंक्षिप्त संस्करण खोलेंमध्यम संस्करण खोलेंपूर्ण संस्करण खोलेंडिफ़ॉल्ट दृश्य पुनर्स्थापित करेंडिफ़ॉल्ट दृश्य पुनर्स्थापित हुआपूर्ववत करेंविस्तृत दृश्य बंद करेंसिग्नेचरसामान्य जानकारीमानचुनी गई रिलीज़ तक अंतिम परिवर्तनउसके बाद का अगला परिवर्तनक्लिक: रिलीज़ चुनेंयहाँ छोड़ा नहीं जा सकता: डॉक करने के लिए शीर्षक पट्टी पर, अनडॉक करने के लिए बीच वाले कॉलम में खींचें।नयाबदला गयाअपरिवर्तितहटाया गयाशामिल नहींपरिवर्तनसामग्री में कोई परिवर्तन नहींपहली बारहटाया गया:रिलीज़ डेटा उपलब्ध नहीं है।रिलीज़ डेटा लोड हो रहा है …पाठइस रिलीज़ में शब्दावली दर्ज नहींसेल पर होवर या क्लिक करें: चुनी गई रिलीज़ से तुलना करें · रिलीज़ शीर्षक पर क्लिक करें: रिलीज़ चुनेंरिलीज़ चुनेंविवरणरिलीज़तत्वशब्दावली वाली केवल एक रिलीज़PDF में मौजूद, पाठ अभी आयात नहीं हुआपाठ पहली बार दर्ज{rel} से अपरिवर्तितरिलीज़ के रंगसबसे पुराना रिलीज़नवीनतम रिलीज़

मेथड का प्रलेखन

फ़ंक्शन GetRequiredWrappedKeyBufferSize [SWS_CRYPT_50035] Upstream: RS_CRYPTO_02302

virtual ara::core::Result< std::size_t > GetRequiredWrappedKeyBuffer Size (const CryptoObject &key) const noexcept;

Calculate the maximum required size of the wrapped key output buffer depending on the key to be wrapped.

Header-Datei	#include "ara/crypto/cryp/symmetric_key_wrapper_ctx.h"
Scope	class ara::crypto::cryp::SymmetricKeyWrapperCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
key	key to be wrapped

Rückgabewert

Typ	Beschreibung
ara::core::Result<std::size_t >	a result containing the required capacity of the output buffer in bytes or an error

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kUninitializedContext	rollback_semantics if the context was not initialized by deploying a key

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

Record: AUTOSAR/AP/record/SWS_CRYPT_50035
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_50035@rel:R25-11#d2308958
Content hash: d2308958
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50035

Status: valid/unmigrated Version: rel:R25-11#79bcf3cd 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_50035@rel:R25-11#79bcf3cd

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

फ़ंक्शन SetKey [SWS_CRYPT_24018] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

virtual ara::core::Result< void > SetKey (SymmetricKey::Sptr key) noexcept=0;

Configure the context to use the provided key as key encryption key.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: d0a83598653d उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग और सिमेंटिक्स

समकालिक सदस्य फ़ंक्शन SetKey ara::crypto::cryp::SymmetricKeyWrapperCtx के एक इंस्टेंस को इस तरह कॉन्फ़िगर करता है कि पास किया गया ऑब्जेक्ट SymmetricKey::Sptr आगामी कुंजी संचालन के लिए Key Encryption Key (KEK) के रूप में उपयोग किया जाए [SWS_CRYPT_24018]। फ़ंक्शन को noexcept के साथ एक शुद्ध वर्चुअल विधि के रूप में निर्दिष्ट किया गया है और यदि असाइनमेंट सफल रहा हो तो यह एक खाली ara::core::Result<void> लौटाता है [SWS_CRYPT_24018]।

त्रुटि प्रबंधन और रोलबैक

यदि कॉन्फ़िगरेशन के दौरान कोई त्रुटि होती है, तो एक अनिवार्य रोलबैक शब्दार्थ लागू होता है, ताकि संदर्भ की स्थिति अपरिवर्तित रहे [SWS_CRYPT_24018]। संभावित त्रुटि कारणों को ara::crypto::CryptoErrc के त्रुटि कोडों के माध्यम से दर्शाया जाता है:

kIncompatibleObject: पास किया गया कुंजी ऑब्जेक्ट सममित संदर्भ के साथ असंगत है [SWS_CRYPT_24018]।
kUsageViolation: कुंजी के अनुमत उपयोग में न तो kAllowKeyWrapping और न ही kAllowKeyUnwrapping शामिल है [SWS_CRYPT_24018]।
kUnsupported: संदर्भ कार्यान्वयन विशेष रूप से केवल एक KeySlot के माध्यम से एक कुंजी सेट करने का समर्थन करता है [SWS_CRYPT_24018]।

समवर्तीता और परस्पर क्रिया

विधि को thread-safe और अपवाद-सुरक्षित (exception safe) के रूप में निर्दिष्ट किया गया है [SWS_CRYPT_24018]। यदि कुंजियों को स्लॉट के माध्यम से प्रबंधित किया जाता है या संदर्भ विशेष रूप से KeySlots का समर्थन करता है, तो उसी रैपर संदर्भ के लिए KeySlot::Sptr [SWS_CRYPT_50034] के साथ वैकल्पिक ओवरलोड SetKey मौजूद है। यह संदर्भ को Key-Wrapping के निष्पादन समय पर स्लॉट में संग्रहीत कुंजी को लोड करने के लिए कॉन्फ़िगर करता है [SWS_CRYPT_50034]।

यह उपयोग नोट विनिर्देश AUTOSAR Adaptive Platform Release R25-11 पर आधारित है।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)

Header-Datei	#include "ara/crypto/cryp/symmetric_key_wrapper_ctx.h"
Scope	class ara::crypto::cryp::SymmetricKeyWrapperCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
key	the the key encryption key (KEK) object

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	An empty result or an error

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kIncompatibleObject	rollback_semantics if the provided key object is incompatible with this symmetric key context
ara::crypto::CryptoErrc::kUsageViolation	rollback_semantics if the allowed usage of the key does not include kAllowKey Wrapping or kAllowKeyUnwrapping
ara::crypto::CryptoErrc::kUnsupported	rollback_semantics if the context only supports setting a KeySlot

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

Record: AUTOSAR/AP/record/SWS_CRYPT_24018
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_24018@rel:R25-11#4bd857a1
Content hash: 4bd857a1
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_24018

Status: valid/unmigrated Version: rel:R25-11#5ba8abd5 Versionshistorie & Revisions (1 transition, 7 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_24018@rel:R25-11#5ba8abd5

Recorded Revisions (7):

R25-11rel:R25-11#07e640252026-09-30
R20-11rel:R20-11#dc67c1dc2026-10-14
R21-11rel:R21-11#34c85a1a2026-10-14
R22-11rel:R22-11#4ead34ac2026-10-14
R23-11rel:R23-11#9ca31f482026-10-14
R24-11rel:R24-11#bb17e6102026-10-14
R25-11rel:R25-11#5ba8abd52026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

फ़ंक्शन SetKey [SWS_CRYPT_50034] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

virtual ara::core::Result< void > SetKey (KeySlot::Sptr keySlot) noexcept=0;

Configure the context to use the key stored in the provided KeySlot at the time the key wrapping is performed.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 30d79040bb46 उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग

वर्चुअल मेथड SetKey संदर्भ ara::crypto::cryp::SymmetricKeyWrapperCtx को इस प्रकार कॉन्फ़िगर करता है कि प्रदान किए गए KeySlot में संग्रहीत कुंजी का उपयोग तब किया जाए जब Key-Wrapping निष्पादित हो [SWS_CRYPT_50034]। यह कॉल पैरामीटर keySlot के रूप में एक KeySlot::Sptr की अपेक्षा करती है, जिसमें एक सममितीय कुंजी होती है [SWS_CRYPT_50034]। फ़ंक्शन को सिंक्रोनस रूप से कॉल किया जाता है, इसे noexcept के साथ घोषित किया गया है और यह एक ara::core::Result<void> लौटाता है [SWS_CRYPT_50034]।

त्रुटि प्रबंधन

त्रुटि की स्थिति में, मेथड रोलबैक सिमेंटिक्स सुनिश्चित करता है और निम्नलिखित त्रुटि परिणामों में से एक लौटाता है [SWS_CRYPT_50034]:

ara::crypto::CryptoErrc::kIncompatibleObject: पास किया गया keySlot इस संदर्भ के साथ असंगत है [SWS_CRYPT_50034]।
ara::crypto::CryptoErrc::kUnsupported: संदर्भ विशेष रूप से एक प्रत्यक्ष SymmetricKey [SWS_CRYPT_50034] सेट करने का समर्थन करता है।

संगामिति

ऑपरेशन थ्रेड-सुरक्षित (thread-safe) है और गारंटीकृत एक्सेप्शन सुरक्षा (exception safe) प्रदान करता है [SWS_CRYPT_50034]।

इंटरैक्शन

यह इंटरफ़ेस SymmetricKeyWrapperCtx के भीतर SymmetricKey::Sptr वाले ओवरलोड SetKey का स्लॉट-आधारित समकक्ष प्रस्तुत करता है, जो एक कुंजी को सीधे Key Encryption Key (KEK) के रूप में बांधता है [SWS_CRYPT_24018]। एनालॉग स्लॉट-आधारित कॉन्फ़िगरेशन फ़ंक्शंस का उपयोग संबंधित क्रिप्टोग्राफ़िक संदर्भों जैसे KeyDerivationFunctionCtx [SWS_CRYPT_50010], KeyEncapsulatorPublicCtx [SWS_CRYPT_50012], VerifierPublicCtx [SWS_CRYPT_50018], MessageAuthnCodeCtx [SWS_CRYPT_50026] और SignerPrivateCtx [SWS_CRYPT_50036] में भी किया जाता है।

यह उपयोग नोट AUTOSAR Adaptive R25-11 के विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)

Header-Datei	#include "ara/crypto/cryp/symmetric_key_wrapper_ctx.h"
Scope	class ara::crypto::cryp::SymmetricKeyWrapperCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe

Parameter (in)

Parameter	Beschreibung
keySlot	a keyslot containing a symmetric key

Rückgabewert

Typ	Beschreibung
ara::core::Result< void >	An empty result or an error

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kIncompatibleObject	rollback_semantics if the provided keySlot is incompatible with this context
ara::crypto::CryptoErrc::kUnsupported	rollback_semantics if the context only supports setting a SymmetricKey

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

Record: AUTOSAR/AP/record/SWS_CRYPT_50034
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_50034@rel:R25-11#20a82137
Content hash: 20a82137
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50034

Status: valid/unmigrated Version: rel:R25-11#c06f6729 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_50034@rel:R25-11#c06f6729

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

फ़ंक्शन UnwrapSymmetricKey [SWS_CRYPT_24016] Upstream: RS_CRYPTO_02115

virtual ara::core::Result< SymmetricKey::Sptr > UnwrapSymmetricKey (ReadOnlyMemRegion wrappedKey, AlgId targetAlgId, AllowedUsageFlags allowedUsage) const noexcept=0;

Unwrap a wrapped key using the previously set key encryption key and return an SymmetricKey.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: fe87df5f5eae उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

इंटरफ़ेस ara::crypto::cryp::SymmetricKeyWrapperCtx की विधि UnwrapSymmetricKey पूर्व में सेट की गई Key Encryption Key (KEK) का उपयोग करके एक लपेटी गई कुंजी को डिक्रिप्ट करती है और एक नया SymmetricKey ऑब्जेक्ट लौटाती है [SWS_CRYPT_24016]। पैरामीटर के रूप में, सिंक्रोनस फ़ंक्शन सुरक्षित कुंजी डेटा युक्त इनपुट बफ़र (wrappedKey), लक्ष्य कुंजी के लिए एल्गोरिदम पहचानकर्ता (targetAlgId) और इसके अनुमत रूपांतरण प्रकारों के लिए बिट-फ़्लैग (allowedUsage) स्वीकार करता है [SWS_CRYPT_24016]।

रिटर्न मान ara::core::Result<SymmetricKey::Sptr> में सफल निष्पादन पर उत्पन्न कुंजी के लिए एक स्मार्ट पॉइंटर शामिल होता है या यह रोलबैक सिमेंटिक्स के साथ एक त्रुटि का संकेत देता है [SWS_CRYPT_24016]। संभावित त्रुटि कारणों में शामिल हैं:

InvalidArgument: wrappedKey में पास किया गया कुंजी डेटा अनपैक नहीं किया जा सकता है, उदाहरण के लिए किसी अमान्य प्रारूप या गलत बफ़र आकार के कारण [SWS_CRYPT_24016]।
ara::crypto::CryptoErrc::kUninitializedContext: रैपर संदर्भ को अभी तक किसी उपयुक्त KEK के साथ प्रारंभ नहीं किया गया है [SWS_CRYPT_24016]।
ara::crypto::CryptoErrc::kUsageViolation: KEK के उपयोग प्रतिबंध अनपैक करने पर रोक लगाते हैं (kAllowKeyUnwrapping का अभाव) [SWS_CRYPT_24016]।
ara::crypto::CryptoErrc::kUnknownIdentifier: targetAlgId के लिए पास किया गया मान ज्ञात नहीं है या समर्थित नहीं है [SWS_CRYPT_24016]।
ara::crypto::CryptoErrc::kIncompatibleArguments: निर्दिष्ट allowedUsage फ़्लैग targetAlgId या कुंजी प्रकार के साथ असंगत हैं [SWS_CRYPT_24016]।
ara::crypto::CryptoErrc::kBusyResource: ऑपरेशन के लिए आवश्यक सिस्टम संसाधन वर्तमान में व्यस्त है [SWS_CRYPT_24016]।
ara::crypto::CryptoErrc::kEmptyKeySlot: ऑपरेशन के लिए कॉन्फ़िगर किया गया KeySlot रिक्त है [SWS_CRYPT_24016]।

विधि को const और noexcept के रूप में घोषित किया गया है, यह अपवाद सुरक्षा की गारंटी देती है और विनिर्देश के अनुसार समवर्ती कॉल के लिए थ्रेड-सुरक्षित (thread-safe) है [SWS_CRYPT_24016]।

यह पाठ AI द्वारा तैयार किया गया था और मार्गदर्शन के रूप में कार्य करता है। विनिर्देश ही प्रामाणिक है।

Header-Datei	#include "ara/crypto/cryp/symmetric_key_wrapper_ctx.h"
Scope	class ara::crypto::cryp::SymmetricKeyWrapperCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe ara::crypto::CryptoErrc::k rollback_semantics

Parameter (in)

Parameter	Beschreibung
wrappedKey	an input buffer that contains the wrapped key
targetAlgId	the algId of the to be created unwrapped key
allowedUsage	bit-flags that define a list of allowed transformations’ types in which the unwrapped key can be used

Rückgabewert

Typ	Beschreibung
ara::core::Result<SymmetricKey::Sptr >	a result containing the unwrapped SymmetricKey object or an error

Fehler

Fehlercode	Beschreibung
InvalidArgument	if the wrapped key data cannot be unwrapped (e.g., invalid format or size)
ara::crypto::CryptoErrc::kUninitializedContext	rollback_semantics if the context was not initialized by a key value
ara::crypto::CryptoErrc::kUsageViolation	rollback_semantics if the allowed usage of the KEK does not include kAllowKey Unwrapping
ara::crypto::CryptoErrc::kUnknownIdentifier	rollback_semantics if targetAlgId has an unsupported value
ara::crypto::CryptoErrc::kIncompatibleArguments	rollback_semantics if the allowedUsage is incompatible with the targetAlgId or the key type
ara::crypto::CryptoErrc::kBusyResource	rollback_semantics a required resource is busy
ara::crypto::CryptoErrc::kEmptyKeySlot	rollback_semantics if a KeySlot was configured that is currently is empty
ara::crypto::CryptoErrc::kUsageViolation	rollback_semantics if the allowed usage of the KEK does not include kAllowKey Unwrapping

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

Record: AUTOSAR/AP/record/SWS_CRYPT_24016
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_24016@rel:R25-11#151acd97
Content hash: 151acd97
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_24016

Status: valid/unmigrated Version: rel:R25-11#7d151daa 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_24016@rel:R25-11#7d151daa

Recorded Revisions (8):

R25-11rel:R25-11#74bd38af2026-09-30
R19-11rel:R19-11#8ec5b1a02026-10-14
R20-11rel:R20-11#496f81ad2026-10-14
R21-11rel:R21-11#354b26632026-10-14
R22-11rel:R22-11#767017ac2026-10-14
R23-11rel:R23-11#624822262026-10-14
R24-11rel:R24-11#9c4b80db2026-10-14
R25-11rel:R25-11#7d151daa2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

फ़ंक्शन Wrap [SWS_CRYPT_24014] Upstream: RS_CRYPTO_02201

virtual ara::core::Result< std::size_t > Wrap (CryptoObject::Sptr key, ReadWriteMemRegion wrappedKey) const noexcept=0;

Wrap the provided key using the previously set key encryption key.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 8e6ff8198c9d उद्गम

जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

उपयोग

क्लास ara::crypto::cryp::SymmetricKeyWrapperCtx (हेडर फ़ाइल ara/crypto/cryp/symmetric_key_wrapper_ctx.h) की विधि Wrap पूर्व में सेट किए गए कुंजी एन्क्रिप्शन कुंजी (Key Encryption Key - KEK) का उपयोग करके प्रदान की गई कुंजी को लपेटती है [SWS_CRYPT_24014]।

सिंक्रोनस फ़ंक्शन निम्नलिखित पैरामीटर्स की अपेक्षा करता है [SWS_CRYPT_24014]:

key (CryptoObject::Sptr): लपेटी जाने वाली कुंजी।
wrappedKey (ReadWriteMemRegion): एक आउटपुट बफ़र, जिसमें लपेटी गई कुंजी लिखी जाती है।

रिटर्न मान के रूप में, ऑपरेशन एक ara::core::Result<std::size_t> प्रदान करता है, जिसमें सफलता की स्थिति में बफ़र में लिखी गई लपेटी गई कुंजी के बाइट्स की संख्या शामिल होती है [SWS_CRYPT_24014]।

त्रुटि प्रबंधन और सिमेंटिक्स

विधि को exception safe के रूप में परिभाषित किया गया है और यह त्रुटि स्थितियों के लिए सख्त रोलबैक सिमेंटिक्स लागू करती है [SWS_CRYPT_24014]। निम्नलिखित त्रुटि स्थितियाँ रिपोर्ट की जा सकती हैं [SWS_CRYPT_24014]:

InvalidArgument: कुंजी ऑब्जेक्ट को लपेटा नहीं जा सकता (उदा. अमान्य आकार या गलत प्रकार के कारण)।
ara::crypto::CryptoErrc::kUninitializedContext: संदर्भ को अभी तक किसी कुंजी मान के साथ प्रारंभ नहीं किया गया है।
ara::crypto::CryptoErrc::kUsageViolation: KEK के अनुमत उपयोग में kAllowKeyWrapping शामिल नहीं है या ऑब्जेक्ट के उपयोग में kAllowSecuredExport शामिल नहीं है।
ara::crypto::CryptoErrc::kInsufficientCapacity: आउटपुट बफ़र wrappedKey बहुत छोटा है।
ara::crypto::CryptoErrc::kBusyResource: एक आवश्यक संसाधन व्यस्त है।
ara::crypto::CryptoErrc::kEmptyKeySlot: एक कॉन्फ़िगर किया गया KeySlot वर्तमान में खाली है।

समवर्तीता और प्रतिबंध

इंटरफ़ेस को thread-safe के रूप में निर्दिष्ट किया गया है [SWS_CRYPT_24014]। निष्पादन के लिए पूर्वपेक्षा एक पूर्व-प्रारंभीकृत संदर्भ और संबंधित कुंजियों के उपयुक्त उपयोग विशेषताएँ हैं [SWS_CRYPT_24014]।

Header-Datei	#include "ara/crypto/cryp/symmetric_key_wrapper_ctx.h"
Scope	class ara::crypto::cryp::SymmetricKeyWrapperCtx
Exception-Sicherheit	exception safe
Thread-Sicherheit	thread-safe ara::crypto::CryptoErrc::k rollback_semantics

Parameter (in)

Parameter	Beschreibung
key	the key to be wrapped

Parameter (out)

Parameter	Beschreibung
wrappedKey	an output buffer that the wrapped key will be written to

Rückgabewert

Typ	Beschreibung
ara::core::Result<std::size_t >	a result containing either a the number of bytes of the wrapped key or an error

Fehler

Fehlercode	Beschreibung
InvalidArgument	if the key object cannot be wrapped (e.g., invalid size or type)
ara::crypto::CryptoErrc::kUninitializedContext	rollback_semantics if the context was not initialized by a key value
ara::crypto::CryptoErrc::kUsageViolation	rollback_semantics if the allowed usage of the KEK does not include kAllowKey Wrapping or the allowed usage of the object does not include k AllowSecuredExport
ara::crypto::CryptoErrc::kInsufficientCapacity	rollback_semantics if the output buffer is too small
ara::crypto::CryptoErrc::kBusyResource	rollback_semantics a required resource is busy
ara::crypto::CryptoErrc::kEmptyKeySlot	rollback_semantics if a KeySlot was configured that is currently is empty

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

Record: AUTOSAR/AP/record/SWS_CRYPT_24014
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_24014@rel:R25-11#722d8dcf
Content hash: 722d8dcf
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_24014

Status: valid/unmigrated Version: rel:R25-11#d59df6cf 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_24014@rel:R25-11#d59df6cf

Recorded Revisions (8):

R25-11rel:R25-11#ac935a362026-09-30
R19-11rel:R19-11#b94a246e2026-10-14
R20-11rel:R20-11#999104362026-10-14
R21-11rel:R21-11#d51795ed2026-10-14
R22-11rel:R22-11#f7dabf992026-10-14
R23-11rel:R23-11#5c3c2d942026-10-14
R24-11rel:R24-11#90cde3442026-10-14
R25-11rel:R25-11#d59df6cf2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

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

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

using Sptr = std::shared_ptr<SymmetricKeyWrapperCtx>;

Smart pointer of the interface.

Header-Datei	#include "ara/crypto/cryp/symmetric_key_wrapper_ctx.h"
Scope	class ara::crypto::cryp::SymmetricKeyWrapperCtx
Symbol	Sptr

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

Record: AUTOSAR/AP/record/SWS_CRYPT_24001
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_24001@rel:R25-11#b8bb56c9
Content hash: b8bb56c9
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_24001

Status: valid/unmigrated Version: rel:R25-11#aef6197c 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_24001@rel:R25-11#aef6197c

Recorded Revisions (8):

R25-11rel:R25-11#10e154c52026-09-30
R19-11rel:R19-11#521f46bb2026-10-14
R20-11rel:R20-11#0ab69c592026-10-14
R21-11rel:R21-11#8d463cfa2026-10-14
R22-11rel:R22-11#7a7fa6972026-10-14
R23-11rel:R23-11#4b170d372026-10-14
R24-11rel:R24-11#4b170d372026-10-14
R25-11rel:R25-11#aef6197c2026-10-14 active

Date	Actor	Transition	Reason / Rationale	Campaign
2026-08-13	tool	`none` → `valid/unmigrated`	mechanically backfilled by migriere_status_backfill.py -- no per-field curation history exists yet for this record	2026-08-13-status-backfill

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

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

संदर्भ

जीवनचक्र

उपयोग पथ

त्रुटि परिदृश्य

सदस्य मानचित्र

मेथड

टाइप उपनाम

क्लास आरेख

विवरण दृश्य

मेथड

टाइप उपनाम

मेथड का प्रलेखन

फ़ंक्शन GetRequiredWrappedKeyBufferSize [SWS_CRYPT_50035] Upstream: RS_CRYPTO_02302

Parameter (in)

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

फ़ंक्शन SetKey [SWS_CRYPT_24018] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

उपयोग और सिमेंटिक्स

त्रुटि प्रबंधन और रोलबैक

समवर्तीता और परस्पर क्रिया

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (7):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

फ़ंक्शन SetKey [SWS_CRYPT_50034] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

उपयोग

त्रुटि प्रबंधन

संगामिति

इंटरैक्शन

Parameter (in)

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

फ़ंक्शन UnwrapSymmetricKey [SWS_CRYPT_24016] Upstream: RS_CRYPTO_02115

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

फ़ंक्शन Wrap [SWS_CRYPT_24014] Upstream: RS_CRYPTO_02201

उपयोग

त्रुटि प्रबंधन और सिमेंटिक्स

समवर्तीता और प्रतिबंध

Parameter (in)

Parameter (out)

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

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

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

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents: