DEENESPTFRRUARHIKOZHNL

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

[SWS_CRYPT_21300] Upstream: RS_CRYPTO_02104

class KeyAgreementPrivateCtx :              public CryptoContext {...};

Key Agreement Private key Context interface.

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

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

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

प्राइवेट कुंजी और बाहरी सार्वजनिक कुंजी से सममित लक्ष्य कुंजी की गणना करने के लिए उपयोग किया जाता है।

इंटरफ़ेस ara::crypto::cryp::KeyAgreementPrivateCtx का उपयोग स्थानीय प्राइवेट कुंजी और दूरस्थ पक्ष की सार्वजनिक कुंजी के आधार पर क्रिप्टोग्राफ़िक कुंजी सहमति प्रक्रियाओं (key agreement procedures) को निष्पादित करने के लिए किया जाता है [SWS_CRYPT_21312]। अपनी स्वयं की कुंजी और वैकल्पिक पैरामीटर निर्दिष्ट करने के बाद, मेथड AgreeKey एक साझा रहस्य (shared secret) की गणना करता है और इसे एक सममित कुंजी ऑब्जेक्ट के रूप में लौटाता है। निष्पादन से पहले पूर्ण आरंभीकरण एक केंद्रीय सीमांत शर्त है, क्योंकि kAllowKeyAgreement के लिए अनुपलब्ध पैरामीटर या अनुमतियों की कमी के कारण संबंधित त्रुटि कोड के साथ प्रक्रिया निरस्त हो जाती है [SWS_CRYPT_21312]। सभी ऑपरेशनों को थ्रेड-सुरक्षित डिज़ाइन किया गया है।

संदर्भ

Adaptive Platform के crypto मॉड्यूल में इंटरफ़ेस ara::crypto::cryp::KeyAgreementPrivateCtx का उपयोग असममित कुंजी सहमति प्रक्रियाओं (Key Agreement) को निष्पादित करने के लिए किया जाता है। इसकी मुख्य जिम्मेदारी स्थानीय प्राइवेट कुंजी और संचार भागीदार की सार्वजनिक कुंजी से एक साझा सममित कुंजी की गणना करना है [SWS_CRYPT_21312]। एक विशिष्ट क्रिप्टो संदर्भ के रूप में, क्लास कई कुंजी और स्टोरेज अमूर्तताओं (abstractions) के साथ इंटरैक्ट करता है: अपनी स्वयं की प्राइवेट कुंजी को सीधे PrivateKey ऑब्जेक्ट [SWS_CRYPT_21313] के रूप में या KeySlot [SWS_CRYPT_50053] के माध्यम से संदर्भित करके बाध्य किया जा सकता है। दूरस्थ पक्ष PublicKey के रूप में अपनी सार्वजनिक कुंजी का योगदान देता है, जबकि परिणाम एक स्वतंत्र SymmetricKey ऑब्जेक्ट के रूप में प्रदान किया जाता है [SWS_CRYPT_21312]। इसके अतिरिक्त, एल्गोरिदम-विशिष्ट कॉन्फ़िगरेशन पैरामीटर को मेमोरी क्षेत्र या पूर्णांक के रूप में पारित किया जा सकता है [SWS_CRYPT_50051], [SWS_CRYPT_50052]।

KeyAgreementContext Application Application KeyAgreementPrivateCtx KeyAgreementPrivateCtx Application->KeyAgreementPrivateCtx कॉन्फ़िगर और निष्पादित करता है SymmetricKey SymmetricKey KeyAgreementPrivateCtx->SymmetricKey erzeugt PrivateKey PrivateKey PrivateKey->KeyAgreementPrivateCtx eigener privater Schluessel KeySlot KeySlot KeySlot->KeyAgreementPrivateCtx Schluesselplatz PublicKey PublicKey PublicKey->KeyAgreementPrivateCtx Gegenstellen-Schluessel

संदर्भ आरेख: कुंजियों, कुंजी स्लॉटों और परिणाम ऑब्जेक्ट के साथ KeyAgreementPrivateCtx की परस्पर क्रिया। स्रोत: [SWS_CRYPT_21312], [SWS_CRYPT_21313], [SWS_CRYPT_50053]।

जीवनचक्र

KeyAgreementPrivateCtx का जीवनचक्र और स्वामित्व संबंध शेयर्ड पॉइंटर्स पर आधारित हैं; विनिर्देश इसके लिए प्रकार उपनाम (type alias) KeyAgreementPrivateCtx::Sptr प्रदान करता है [SWS_CRYPT_21301]। व्याख्या: इंस्टैंसिएशन CryptoProvider की उच्च-स्तरीय फ़ैक्टरी के माध्यम से होने की संभावना है, क्योंकि क्लास बिना किसी कंस्ट्रक्टर विनिर्देश के एक शुद्ध वर्चुअल इंटरफ़ेस का प्रतिनिधित्व करता है। प्रश्न Q-22dca518675fba51 (खुला) निर्माण के बाद, इंस्टेंस एक गैर-परिचालन मूल स्थिति में होता है। SetKey [SWS_CRYPT_21313], [SWS_CRYPT_50053] का उपयोग करके प्राइवेट कुंजी के कॉन्फ़िगरेशन और चुनी गई योजना के लिए आवश्यक सभी पैरामीटर [SWS_CRYPT_50051], [SWS_CRYPT_50052] सौंपे जाने के बाद ही संदर्भ आरंभ होता है।

यदि इन कॉन्फ़िगरेशन चरणों के पूरा होने से पहले कुंजी गणना शुरू की जाती है, तो कॉल विफल हो जाती है [SWS_CRYPT_21312]। समवर्तीता के संबंध में, सभी सदस्य फ़ंक्शंस को थ्रेड-सुरक्षित (thread-safe) और अपवाद-सुरक्षित (exception safe) के रूप में निर्दिष्ट किया गया है [SWS_CRYPT_21312], [SWS_CRYPT_21313], [SWS_CRYPT_50051], [SWS_CRYPT_50052], [SWS_CRYPT_50053]। चूंकि निष्पादन फ़ंक्शन AgreeKey को const के रूप में घोषित किया गया है [SWS_CRYPT_21312], इसलिए समान आरंभिक संदर्भ का उपयोग विभिन्न दूरस्थ पक्षों के साथ समझौतों के लिए समानांतर में किया जा सकता है।

उपयोग पथ

व्यावहारिक उपयोग कॉन्फ़िगरेशन और गणना के अनुक्रमिक क्रम में संरचित है:

  • कुंजी असाइनमेंट: सबसे पहले, एप्लिकेशन अपनी स्वयं की प्राइवेट कुंजी को संदर्भ से बांधता है। यह या तो लोड किए गए कुंजी ऑब्जेक्ट के लिए SetKey(PrivateKey::Sptr) [SWS_CRYPT_21313] के माध्यम से होता है या किसी कुंजी स्लॉट के लिए SetKey(KeySlot::Sptr) [SWS_CRYPT_50053] के माध्यम से होता है, जिसकी सामग्री का मूल्यांकन केवल समझौते के समय किया जाता है।
  • पैरामीटर परिभाषा: यदि लक्ष्य एल्गोरिदम को अतिरिक्त आरंभीकरण डेटा की आवश्यकता होती है, तो इन्हें SetParameter के माध्यम से बफ़र ReadOnlyMemRegion [SWS_CRYPT_50051] के रूप में या 64-बिट पूर्णांक std::uint64_t [SWS_CRYPT_50052] के रूप में पारित किया जाता है।
  • कुंजी सहमति: AgreeKey के साथ क्रिप्टोग्राफ़िक एल्गोरिदम निष्पादित किया जाता है [SWS_CRYPT_21312]। कॉलिंग घटक दूरस्थ पक्ष की सार्वजनिक कुंजी (otherSideKey), वांछित लक्ष्य एल्गोरिदम का पहचानकर्ता (targetAlgId) और स्वीकार्य उपयोग फ़्लैग (allowedUsage) पास करता है।
  • परिणाम प्राप्ति: सफल समापन पर, AgreeKey एक SymmetricKey ऑब्जेक्ट लौटाता है, जिसमें परिकलित साझा रहस्य शामिल होता है [SWS_CRYPT_21312]।
कुंजी समझौते का अनुक्रमएप्लिकेशनKeyAgreementPrivateCtxSymmetricKeyUse Case: KonfigurationSetKey(key)Result<void>optअतिरिक्त पैरामीटर आवश्यकSetParameter(name, value)Result<void>Use Case: कुंजी समझौताAgreeKey(otherSideKey, targetAlgId, allowedUsage)Berechnung Shared SecretErzeugungResult<SymmetricKey::Sptr>

अनुक्रम आरेख: कुंजी आवंटन से लेकर सममित कुंजी निर्माण तक कुंजी सहमति का सामान्य प्रवाह। स्रोत: [SWS_CRYPT_21312], [SWS_CRYPT_21313], [SWS_CRYPT_50051]।

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

KeyAgreementPrivateCtx के मेथड्स ara::core::Result के माध्यम से त्रुटियां लौटाते हैं और रोलबैक सिमेंटिक्स सुनिश्चित करते हैं [SWS_CRYPT_21312], [SWS_CRYPT_21313], [SWS_CRYPT_50051], [SWS_CRYPT_50052], [SWS_CRYPT_50053]। विशिष्ट त्रुटि परिदृश्यों में शामिल हैं:

  • CryptoErrc::kUninitializedContext: AgreeKey पर घटित होता है, यदि पहले कोई कुंजी सेट नहीं की गई थी या आवश्यक पैरामीटर गायब हैं [SWS_CRYPT_21312]।
  • CryptoErrc::kIncompatibleObject: रिपोर्ट किया जाता है जब पास किया गया PrivateKey या KeySlot संदर्भ के प्रकार से मेल नहीं खाता है [SWS_CRYPT_21313], [SWS_CRYPT_50053], या जब दूरस्थ पक्ष की कुंजी otherSideKey असंगत होती है [SWS_CRYPT_21312]।
  • CryptoErrc::kUsageViolation: संकेत देता है कि प्राइवेट कुंजी या दूरस्थ पक्ष की कुंजी के लिए kAllowKeyAgreement अधिकार नहीं दिया गया था [SWS_CRYPT_21312], [SWS_CRYPT_21313]।
  • CryptoErrc::kUnsupported: इंगित करता है कि संदर्भ कार्यान्वयन केवल संबंधित अन्य SetKey संस्करण का समर्थन करता है [SWS_CRYPT_21313], [SWS_CRYPT_50053], या कोई अनुरोधित पैरामीटर नाम समर्थित नहीं है [SWS_CRYPT_50051], [SWS_CRYPT_50052]।
  • CryptoErrc::kInvalidArgument: SetParameter में अमान्य मानों [SWS_CRYPT_50051], [SWS_CRYPT_50052] या लक्ष्य कुंजी के लिए अस्वीकार्य allowedUsage फ़्लैग के कारण होता है [SWS_CRYPT_21312]।
  • CryptoErrc::kUnknownIdentifier: ट्रिगर होता है यदि लक्ष्य एल्गोरिदम के लिए पहचानकर्ता targetAlgId अज्ञात है [SWS_CRYPT_21312]।
  • CryptoErrc::kEmptyKeySlot और CryptoErrc::kBusyResource: AgreeKey द्वारा लौटाए जाते हैं, यदि कॉन्फ़िगर किए गए KeySlot में निष्पादन के समय कोई कुंजी नहीं है या कोई आवश्यक संसाधन व्यस्त है [SWS_CRYPT_21312]।

यह क्लास गाइड AUTOSAR विनिर्देश R25-11 के आधार पर autodocs सिस्टम द्वारा उत्पन्न की गई थी।

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

मेथड

3
AgreeKeySetKeySetParameter

टाइप उपनाम

1
Sptr

क्लास आरेख

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

G nara__crypto__cryp__KeyAgreementPrivateCtx203 KeyAgreementPrivateCtx + AgreeKey() + SetKey() + SetParameter() nara__crypto__cryp__CryptoContext85 CryptoContext nara__crypto__cryp__KeyAgreementPrivateCtx203->nara__crypto__cryp__CryptoContext85

विवरण दृश्य

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

मेथड

AgreeKey फ़ंक्शन

Produce a common symmetric key via execution of the key-agreement algorithm using a private key and a public key of another side.

virtual ara::core::Result< SymmetricKey::Sptr > AgreeKey (Public Key::Sptr otherSideKey, AlgId targetAlgId, AllowedUsageFlags allowed Usage) const noexcept=0;
SetKey फ़ंक्शन 2

Configure the context to use the provided key.

ओवरलोड SetKey 2
virtual ara::core::Result< void > SetKey (PrivateKey::Sptr key) noexcept=0; SWS_CRYPT_21313
virtual ara::core::Result< void > SetKey (KeySlot::Sptr keySlot) noexcept=0; SWS_CRYPT_50053
SetParameter फ़ंक्शन 2

Set a parameter of the key agreement identified by parameterName.

ओवरलोड SetParameter 2
virtual ara::core::Result< void > SetParameter (ara::core::StringView parameterName, ReadOnlyMemRegion value) noexcept=0; SWS_CRYPT_50051
virtual ara::core::Result< void > SetParameter (ara::core::StringView parameterName, std::uint64_t value) noexcept=0; SWS_CRYPT_50052

टाइप उपनाम

Sptr टाइप उपनाम

Smart pointer of this interface.

using Sptr = std::shared_ptr<KeyAgreementPrivateCtx>;

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

फ़ंक्शन AgreeKey [SWS_CRYPT_21312] Upstream: RS_CRYPTO_02115

virtual ara::core::Result< SymmetricKey::Sptr > AgreeKey (Public Key::Sptr otherSideKey, AlgId targetAlgId, AllowedUsageFlags allowed Usage) const noexcept=0;

Produce a common symmetric key via execution of the key-agreement algorithm using a private key and a public key of another side.

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

क्लास ara::crypto::cryp::KeyAgreementPrivateCtx की विधि AgreeKey एक साझा सममित कुंजी उत्पन्न करने के लिए एक निजी कुंजी और समकक्ष की सार्वजनिक कुंजी का उपयोग करके एक कुंजी समझौता एल्गोरिदम निष्पादित करती है [SWS_CRYPT_21312]। पैरामीटर के रूप में, समकक्ष की सार्वजनिक कुंजी (otherSideKey), लक्ष्य सममित एल्गोरिदम का पहचानकर्ता (targetAlgId) और अनुमत उपयोग फ़्लैग (allowedUsage) पास किए जाते हैं [SWS_CRYPT_21312]। सफल निष्पादन पर, SymmetricKey::Sptr युक्त एक ara::core::Result लौटाया जाता है, जिसमें परिकलित साझा रहस्य होता है [SWS_CRYPT_21312]। व्याख्या: चूँकि रिटर्न सीधे Result के रूप में होता है न कि किसी एसिंक्रोनस Future प्रकार के माध्यम से, कुंजी गणना संभवतः सिंक्रोनस रूप से निष्पादित होती है। प्रश्न Q-ab31a8a62bb1c583 (खुला)

विधि को thread-safe और exception safe (noexcept) के रूप में परिभाषित किया गया है [SWS_CRYPT_21312]। त्रुटि की स्थिति में, रोलबैक सिमेंटिक्स लागू होते हैं और एक संगत त्रुटि कोड लौटाया जाता है [SWS_CRYPT_21312]:

  • UninitializedContext: संदर्भ को अभी तक कोई कुंजी प्रदान करके प्रारंभ नहीं किया गया है या आवश्यक पैरामीटर पहले SetParameter() के माध्यम से सेट नहीं किए गए हैं [SWS_CRYPT_21312]।
  • CryptoErrc::kIncompatibleObject: सार्वजनिक कुंजी वर्तमान संदर्भ के साथ असंगत है [SWS_CRYPT_21312]।
  • CryptoErrc::kUsageViolation: निजी या सार्वजनिक कुंजी के उपयोग प्रतिबंधों में kAllowKeyAgreement शामिल नहीं है [SWS_CRYPT_21312]।
  • CryptoErrc::kInvalidArgument: पास किए गए allowedUsage फ़्लैग किसी सममित कुंजी के लिए अमान्य हैं [SWS_CRYPT_21312]।
  • ara::crypto::CryptoErrc::kUnknownIdentifier: पहचानकर्ता targetAlgId में एक असमर्थित मान शामिल है [SWS_CRYPT_21312]।
  • CryptoErrc::kBusyResource या CryptoErrc::kEmptyKeySlot: एक आवश्यक संसाधन व्यस्त है या एक कॉन्फ़िगर किया गया KeySlot रिक्त है [SWS_CRYPT_21312]।

यह पाठ एक AI द्वारा जनरेट किया गया था और यह तकनीकी मार्गदर्शन के लिए कार्य करता है।

Header-Datei#include "ara/crypto/cryp/key_agreement_private_ctx.h"
Scopeclass ara::crypto::cryp::KeyAgreementPrivateCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe CryptoErrc::k rollback_semantics

Parameter (in)

ParameterBeschreibung
otherSideKeythe public key of the other side of the Key-Agreement
targetAlgIdidentifier of the symmetric target algorithm
allowedUsagethe allowed usage of the target key

Rückgabewert

TypBeschreibung
ara::core::Result<SymmetricKey::Sptr >a result containing either a unique pointer to the SymmetricKey object, which contains the computed shared secret produced by the Key-Agreement algorithm or an error

Fehler

FehlercodeBeschreibung
UninitializedContextif the context was not initialized by deploying a key or not all required parameters have been set via SetParameter()
CryptoErrc::kIncompatibleObjectrollback_semantics if the public key is not compatible to this context
CryptoErrc::kInvalidArgumentrollback_semantics if the allowed usage flags are invalid for a symmetric key
CryptoErrc::kBusyResourcerollback_semantics a required resource is busy
CryptoErrc::kEmptyKeySlotrollback_semantics if a KeySlot was configured that is currently is empty
CryptoErrc::kUsageViolationrollback_semantics if the allowed usage of the private or public key do not include k AllowKeyAgreement
ara::crypto::CryptoErrc::kUnknownIdentifierrollback_semantics if targetAlgId has an unsupported value

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

Record
AUTOSAR/AP/record/SWS_CRYPT_21312
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_21312@rel:R25-11#c305dc8c
Content hash
c305dc8c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_21312
Status: valid/unmigrated Version: rel:R25-11#26c80425 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_21312@rel:R25-11#26c80425
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#4f58d41f2026-09-30
  • R19-11rel:R19-11#3975d40e2026-10-14
  • R20-11rel:R20-11#340c62732026-10-14
  • R21-11rel:R21-11#633195382026-10-14
  • R22-11rel:R22-11#418b5aab2026-10-14
  • R23-11rel:R23-11#28812de12026-10-14
  • R24-11rel:R24-11#c610b1882026-10-14
  • R25-11rel:R25-11#26c804252026-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

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

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

Configure the context to use the provided key.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 9ab09291ac6b उद्गम
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

विधि SetKey पास की गई निजी कुंजी [SWS_CRYPT_21313] के उपयोग के लिए निजी कुंजी समझौता संदर्भ ara::crypto::cryp::KeyAgreementPrivateCtx को कॉन्फ़िगर करती है। कॉल समकालिक रूप से होती है और पैरामीटर key के माध्यम से स्रोत कुंजी ऑब्जेक्ट [SWS_CRYPT_21313] पर एक स्मार्ट-पॉइंटर (PrivateKey::Sptr) पास करती है।

त्रुटि के मामले में, फ़ंक्शन रोलबैक शब्दार्थ के साथ एक ara::core::Result<void> लौटाता है, जिसमें निम्नलिखित त्रुटि कोड निर्दिष्ट हैं [SWS_CRYPT_21313]:

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

समवर्तीता के संबंध में, ऑपरेशन को थ्रेड-सुरक्षित (thread-safe) और अपवाद-सुरक्षित (exception safe) के रूप में निर्दिष्ट किया गया है [SWS_CRYPT_21313]। क्रिप्टोग्राफ़िक आर्किटेक्चर के संबंधित संदर्भों के समान — उदाहरण के लिए कुंजी अनावरण (key decapsulation) [SWS_CRYPT_21413], हस्ताक्षर निर्माण [SWS_CRYPT_23515] या कुंजी व्युत्पत्ति (key derivation) [SWS_CRYPT_21525] — लोड की गई कुंजी सामग्री के साथ क्रिप्टोग्राफ़िक गणनाएँ किए जाने से पहले SetKey एक प्राथमिक कॉन्फ़िगरेशन चरण के रूप में कार्य करता है।

यह उपयोग नोट विनिर्देश तत्वों के आधार पर स्वचालित रूप से उत्पन्न किया गया था।

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

Header-Datei#include "ara/crypto/cryp/key_agreement_private_ctx.h"
Scopeclass ara::crypto::cryp::KeyAgreementPrivateCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
keythe source key object

Rückgabewert

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

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kIncompatibleObjectrollback_semantics if the provided key object is incompatible with this private key context
ara::crypto::CryptoErrc::kUsageViolationrollback_semantics if the allowed usage of the key does not include kAllowKey Agreement
ara::crypto::CryptoErrc::kUnsupportedrollback_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_21313
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_21313@rel:R25-11#829aaf23
Content hash
829aaf23
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_21313
Status: valid/unmigrated Version: rel:R25-11#616d7c1f 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_21313@rel:R25-11#616d7c1f
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#3d54d9db2026-09-30
  • R20-11rel:R20-11#52811d232026-10-14
  • R21-11rel:R21-11#8def41192026-10-14
  • R22-11rel:R22-11#8a2370692026-10-14
  • R23-11rel:R23-11#817460022026-10-14
  • R24-11rel:R24-11#45330bed2026-10-14
  • R25-11rel:R25-11#616d7c1f2026-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

फ़ंक्शन SetKey [SWS_CRYPT_50053] 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 agreement is performed.

एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 747e7368bae2 उद्गम
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

विधि SetKey ara::crypto::cryp::KeyAgreementPrivateCtx के इंस्टेंस को इस तरह से कॉन्फ़िगर करती है कि बाद के कुंजी समझौते के लिए पास किए गए keySlot में संग्रहीत निजी कुंजी का उपयोग किया जाता है [SWS_CRYPT_50053]। कॉल समकालिक रूप से होता है और इसे noexcept के रूप में घोषित किया गया है।

उपयोग और पैरामीटर

एक इनपुट पैरामीटर के रूप में, इंटरफ़ेस एक KeySlot::Sptr की अपेक्षा करता है, जिसमें एक निजी कुंजी होनी चाहिए [SWS_CRYPT_50053]। कुंजी सामग्री का उपयोग और मूल्यांकन केवल उस समय किया जाता है जब वास्तविक कुंजी समझौता निष्पादित किया जाता है [SWS_CRYPT_50053]। KeySlot के विकल्प के रूप में, संदर्भ [SWS_CRYPT_21313] के माध्यम से सीधे एक PrivateKey::Sptr पास करने की अनुमति देता है।

त्रुटि हैंडलिंग और समवर्तीता

विधि एक ara::core::Result<void> लौटाती है। त्रुटि की स्थिति में, निम्नलिखित त्रुटि कोड के लिए रोलबैक सेमांटिक्स लागू होते हैं [SWS_CRYPT_50053]:

  • ara::crypto::CryptoErrc::kIncompatibleObject: पास किया गया keySlot संदर्भ के साथ असंगत है [SWS_CRYPT_50053]।
  • ara::crypto::CryptoErrc::kUnsupported: संदर्भ कार्यान्वयन विशेष रूप से PrivateKey के माध्यम से एक कुंजी सेट करने का समर्थन करता है [SWS_CRYPT_50053]।

निष्पादन को thread-safe और exception safe के रूप में निर्दिष्ट किया गया है [SWS_CRYPT_50053]।

यह पाठ AUTOSAR R25-11 विनिर्देश के आधार पर एक AI द्वारा जनरेट किया गया था।

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

Header-Datei#include "ara/crypto/cryp/key_agreement_private_ctx.h"
Scopeclass ara::crypto::cryp::KeyAgreementPrivateCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
keySlota keyslot containing a private key

Rückgabewert

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

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kIncompatibleObjectrollback_semantics if the provided keySlot is incompatible with this context
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if the context only supports setting a PrivateKey

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50053
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50053@rel:R25-11#ce07c7a6
Content hash
ce07c7a6
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50053
Status: valid/unmigrated Version: rel:R25-11#a8c300d9 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_50053@rel:R25-11#a8c300d9
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

फ़ंक्शन SetParameter [SWS_CRYPT_50051] Upstream: RS_CRYPTO_02102, RS_CRYPTO_02107, RS_CRYPTO_02108, RS_CRYPTO_02111

virtual ara::core::Result< void > SetParameter (ara::core::StringView parameterName, ReadOnlyMemRegion value) noexcept=0;

Set a parameter of the key agreement identified by parameterName.

Header-Datei#include "ara/crypto/cryp/key_agreement_private_ctx.h"
Scopeclass ara::crypto::cryp::KeyAgreementPrivateCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
parameterNamean identifier of the parameter
valuean input buffer containing the value of the parameter

Rückgabewert

TypBeschreibung
ara::core::Result< void >an empty result on success or an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if the context does not support the parameter
ara::crypto::CryptoErrc::kInvalidArgumentrollback_semantics if the provided parameter value is invalid

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50051
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50051@rel:R25-11#1769c7d8
Content hash
1769c7d8
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50051
Status: valid/unmigrated Version: rel:R25-11#48be7eb5 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_50051@rel:R25-11#48be7eb5
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

फ़ंक्शन SetParameter [SWS_CRYPT_50052] Upstream: RS_CRYPTO_02102, RS_CRYPTO_02107, RS_CRYPTO_02108, RS_CRYPTO_02111

virtual ara::core::Result< void > SetParameter (ara::core::StringView parameterName, std::uint64_t value) noexcept=0;

Set a parameter of the key agreement identified by parameterName.

Header-Datei#include "ara/crypto/cryp/key_agreement_private_ctx.h"
Scopeclass ara::crypto::cryp::KeyAgreementPrivateCtx
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Parameter (in)

ParameterBeschreibung
parameterNamean identifier of the parameter
valuean unsigned integer containing the value of the parameter

Rückgabewert

TypBeschreibung
ara::core::Result< void >an empty result on success or an error

Fehler

FehlercodeBeschreibung
ara::crypto::CryptoErrc::kUnsupportedrollback_semantics if the context does not support the parameter
ara::crypto::CryptoErrc::kInvalidArgumentrollback_semantics if the provided parameter value is invalid

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

Record
AUTOSAR/AP/record/SWS_CRYPT_50052
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50052@rel:R25-11#8ca3228e
Content hash
8ca3228e
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50052
Status: valid/unmigrated Version: rel:R25-11#6e0df952 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_50052@rel:R25-11#6e0df952
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

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

टाइप उपनाम Sptr [SWS_CRYPT_21301] Upstream: RS_CRYPTO_02104

using Sptr = std::shared_ptr<KeyAgreementPrivateCtx>;

Smart pointer of this interface.

Header-Datei#include "ara/crypto/cryp/key_agreement_private_ctx.h"
Scopeclass ara::crypto::cryp::KeyAgreementPrivateCtx
SymbolSptr

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

Record
AUTOSAR/AP/record/SWS_CRYPT_21301
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_21301@rel:R25-11#8e9d98d2
Content hash
8e9d98d2
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_21301
Status: valid/unmigrated Version: rel:R25-11#c13d652e 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_21301@rel:R25-11#c13d652e
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#e2ebb07f2026-09-30
  • R19-11rel:R19-11#c18950c82026-10-14
  • R20-11rel:R20-11#65fb94fe2026-10-14
  • R21-11rel:R21-11#65fb94fe2026-10-14
  • R22-11rel:R22-11#23c185892026-10-14
  • R23-11rel:R23-11#abfd06b32026-10-14
  • R24-11rel:R24-11#abfd06b32026-10-14
  • R25-11rel:R25-11#c13d652e2026-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