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 لتنفيذ إجراءات الاتفاق على المفاتيح التشفيرية استناداً إلى مفتاح خاص محلي والمفتاح العام لطرف مقابل [SWS_CRYPT_21312]. وبعد تعيين المفتاح الخاص والمعلمات الاختيارية، تحسب الطريقة AgreeKey سراً مشتركاً وتُرجعه ككائن مفتاح متماثل. ويتمثل قيد أساسي في التهيئة الكاملة قبل التنفيذ، حيث يؤدي غياب المعلمات أو نقص الأذونات لـ kAllowKeyAgreement إلى الإلغاء مع رموز الأخطاء المقابلة [SWS_CRYPT_21312]. وقد صُممت جميع العمليات لتكون آمنة بالنسبة للخيوط.

السياق

تُستخدم الواجهة ara::crypto::cryp::KeyAgreementPrivateCtx في وحدة crypto الخاصة بـ Adaptive Platform لتنفيذ إجراءات الاتفاق على المفاتيح غير المتماثلة (Key Agreement). وتكمن مسؤوليتها المركزية في حساب مفتاح متماثل مشترك من مفتاح خاص محلي والمفتاح العام لشريك اتصال [SWS_CRYPT_21312]. وباعتبارها سياق تشفير متخصصاً، تتفاعل الفئة مع تجريدات مفاتيح وتخزين متعددة: حيث يمكن ربط المفتاح الخاص إما مباشرةً ككائن 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 على مؤشرات مشتركة (Shared Pointers)؛ وتوفر المواصفة الاسم المستعار للنوع 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 كذاكرة وسيطة (buffer) 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 وتضمن دلالات التراجع (rollback semantics) [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].

تم إنشاء دليل الفئة هذا بواسطة نظام autodocs استناداً إلى مواصفة AUTOSAR برقم R25-11.

خريطة الأعضاء

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

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 · الأصل الألماني

تنفذ الدالة AgreeKey للفئة ara::crypto::cryp::KeyAgreementPrivateCtx خوارزمية اتفاق على المفاتيح باستخدام مفتاح خاص والمفتاح العام للطرف المقابل لإنشاء مفتاح متماثل مشترك [SWS_CRYPT_21312]. ويتم تمرير المفتاح العام للطرف المقابل (otherSideKey)، ومُعرّف الخوارزمية المتماثلة المستهدفة (targetAlgId)، بالإضافة إلى رايات الاستخدام المسموح بها (allowedUsage) كمعلمات [SWS_CRYPT_21312]. وعند التنفيذ الناجح، يتم إرجاع ara::core::Result مع SymmetricKey::Sptr، والذي يحتوي على السر المشترك المحسوب [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].

أُنشئ هذا النص بواسطة ذكاء اصطناعي وهو مخصص للإرشاد التقني.

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#2e1cd086
Content hash
2e1cd086
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 سياق الاتفاق على المفتاح الخاص ara::crypto::cryp::KeyAgreementPrivateCtx لاستخدام المفتاح الخاص الممرر [SWS_CRYPT_21313]. ويتم الاستدعاء بشكل متزامن ويمرر عبر المعامل key مؤشرًا ذكيًا (PrivateKey::Sptr) إلى كائن المفتاح المصدر [SWS_CRYPT_21313].

في حالة الخطأ، تُرجع الدالة 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]. وعلى غرار السياقات ذات الصلة في بنية التشفير — مثل فك تغليف المفاتيح [SWS_CRYPT_21413] أو إنشاء التوقيع [SWS_CRYPT_23515] أو اشتقاق المفاتيح [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#7964c3a1
Content hash
7964c3a1
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>. في حالة الخطأ، تنطبق دلالات التراجع (Rollback) لأكواد الخطأ التالية [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.

دليل المنفِّذ قيد الإعداد (التعقيد 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#578877cf
Content hash
578877cf
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#9ed02948
Content hash
9ed02948
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#246a6183
Content hash
246a6183
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#2c1bc5b9
Content hash
2c1bc5b9
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