فئة ara::crypto::cryp::KeyDerivationFunctionCtx

[SWS_CRYPT_21500] Upstream: RS_CRYPTO_02103

class KeyDerivationFunctionCtx :               public CryptoContext {...};

Key Derivation Function interface.

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

دليل المستخدممولَّد بالذكاء الاصطناعي

يشتق المفاتيح المتماثلة بأمان من المفاتيح الأساسية ومعلمات السياق القابلة للتهيئة.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 0339805a1afd المصدر أسئلة مفتوحة (1)

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يشتق المفاتيح المتماثلة بأمان من المفاتيح الأساسية ومعلمات السياق القابلة للتهيئة.

تُستخدم الواجهة ara::crypto::cryp::KeyDerivationFunctionCtx لاشتقاق مفاتيح متماثلة جديدة من مادة مفاتيح موجودة ومعلمات سياق قابلة للتهيئة مثل قيم التمليح (Salts) أو العدادات [SWS_CRYPT_21515]. وقبل توليد المفاتيح باستخدام DeriveKey، يجب تهيئة السياق عبر SetKey باستخدام مفتاح أو KeySlot وتهيئته اختياريًا عبر SetParameter [SWS_CRYPT_21525]. وكشرط أمني جوهري، لا يجوز إجراء الاشتقاق إلا إذا كانت مادة المفتاح المصدر مصرحًا بها صراحةً لعمليات KDF، وكانت أعلام الاستخدام المطلوبة للمفتاح الهدف متوافقة.

السياق

تُوفّر الفئة ara::crypto::cryp::KeyDerivationFunctionCtx واجهة لدوال اشتقاق المفاتيح (Key Derivation Functions، KDF) في وحدة التشفير في AUTOSAR Adaptive. وتتمثل مهمتها الرئيسية في اشتقاق مفاتيح متماثلة جديدة من مادة مفاتيح محددة ومعلمات سياق قابلة للتهيئة [SWS_CRYPT_21515].

تشمل أطراف التفاعل النموذجية خدمات التطبيق المُستدعية، ومادة المصدر الأساسية في هيئة SymmetricKey [SWS_CRYPT_21525] أو KeySlot [SWS_CRYPT_50010]، بالإضافة إلى نتيجة الاشتقاق في شكل SymmetricKey::Sptr [SWS_CRYPT_21515] جديد. ويمكن تمرير معلمات تشفير إضافية كمناطق ذاكرة أو أعداد صحيحة أو مفاتيح مساعدة [SWS_CRYPT_50007] [SWS_CRYPT_50008] [SWS_CRYPT_50009].

دورة الحياة

يتم التحكم في دورة حياة المثيلات وملكيتها عبر المؤشر الذكي محدد النوع ara::crypto::cryp::KeyDerivationFunctionCtx::Sptr [SWS_CRYPT_21501]. ويُرجّح أن يتم إنشاء مثيل تنفيذ ملموس عبر مصنع متخصص (Factory) أو عبر CryptoProvider المختص، نظرًا لأن الفئة تُعرّف واجهة افتراضية بحتة. سؤال Q-8ba3d498c9921ab1 (مفتوح)

يكون السياق المنشأ حديثًا في حالة غير مكتملة في البداية. ولا يصبح السياق جاهزًا للحساب إلا بعد التعيين الناجح لمفتاح عبر SetKey [SWS_CRYPT_21525] [SWS_CRYPT_50010] وتعيين معلمات KDF المطلوبة عبر SetParameter [SWS_CRYPT_50007] [SWS_CRYPT_50008] [SWS_CRYPT_50009]. وفيما يتعلق بالتزامن، فإن دوال الواجهة مُعلنة بأنها آمنة خيطيًا وآمنة من الاستثناءات ([SWS_CRYPT_21515]، [SWS_CRYPT_21525]، [SWS_CRYPT_50007]).

مسار الاستخدام

يتضمن تسلسل الاستدعاء النموذجي لاشتقاق المفاتيح ثلاث مراحل متتالية:

تعيين المفتاح الأساسي: يتم تكوين مادة المفتاح المصدرية عبر SetKey. وهنا يمكن تمرير إما كائن مفتاح موجود (SymmetricKey::Sptr) [SWS_CRYPT_21525] أو موضع تخزين مفاتيح دائم (KeySlot::Sptr) [SWS_CRYPT_50010].
تكوين معلمات السياق: تُحدد القيم الخاصة بـ KDF مثل الملح (Salt)، أو متجهات التهيئة، أو عدادات التكرار عبر SetParameter. وتُدعم مخازن الذاكرة المؤقتة (ReadOnlyMemRegion) [SWS_CRYPT_50007]، والأعداد الصحيحة بعرض 64 بت (std::uint64_t) [SWS_CRYPT_50008]، والمفاتيح المتماثلة الإضافية (SymmetricKey::Sptr) [SWS_CRYPT_50009].
اشتقاق المفتاح الهدف: ينفذ استدعاء DeriveKey الحساب التشفيري [SWS_CRYPT_21515]. تتوقع الطريقة معرف الخوارزمية المستهدفة (AlgId) بالإضافة إلى شارات الاستخدام المسموح بها (AllowedUsageFlags)، وتُرجع SymmetricKey::Sptr في حالة النجاح.

مخطط تسلسلي: تسلسل الاستدعاء النموذجي لاشتقاق مفتاح متماثل عبر KeyDerivationFunctionCtx. المصادر: [SWS_CRYPT_21525]، [SWS_CRYPT_50007]، [SWS_CRYPT_21515].

سيناريوهات الأخطاء

تشير طرائق الواجهة إلى حالات الخطأ عبر ara::core::Result باستخدام رموز خطأ محددة:

تهيئة غير مكتملة: إذا تم استدعاء DeriveKey دون تكوين كافٍ، يفشل الاستدعاء مع ara::crypto::CryptoErrc::kUninitializedContext [SWS_CRYPT_21515]. وإذا كان KeySlot المعين فارغاً في وقت التنفيذ، يتم الإبلاغ عن ara::crypto::CryptoErrc::kEmptyKeySlot [SWS_CRYPT_21515].
انتهاك حقوق الاستخدام: يجب أن يسمح المفتاح المصدري بالعملية kAllowKeyDerivation، وإلا سيتم إطلاق ara::crypto::CryptoErrc::kUsageViolation ([SWS_CRYPT_21525]، [SWS_CRYPT_21515]، [SWS_CRYPT_50009]). وإذا كان الهدف يتضمن kAllowPlaintextExport، فيجب أن يشتمل المفتاح المصدري بالإضافة إلى ذلك على kAllowDerivedPlaintextExport، وإلا سينتج عن ذلك أيضاً kUsageViolation [SWS_CRYPT_21515].
عدم التوافق والوسائط غير الصالحة: تُرجع الخوارزمية المستهدفة غير المدعومة UnknownIdentifier، وتولد شارات الاستخدام غير المتوافقة مع بعضها البعض ara::crypto::CryptoErrc::kIncompatibleArguments [SWS_CRYPT_21515]. وتستجيب SetKey لكائنات المفاتيح أو مواضع KeySlots غير المناسبة للسياق بإرجاع ara::crypto::CryptoErrc::kIncompatibleObject ([SWS_CRYPT_21525]، [SWS_CRYPT_50010]). تؤدي قيم المعلمات غير الصالحة إلى ara::crypto::CryptoErrc::kInvalidArgument ([SWS_CRYPT_50007]، [SWS_CRYPT_50008]).
وظائف واجهة غير مدعومة: إذا كان تطبيق محدد يدعم حصرياً KeySlot أو حصرياً SymmetricKey، فإن استدعاء SetKey الآخر في كل حالة يؤدي إلى ara::crypto::CryptoErrc::kUnsupported ([SWS_CRYPT_21525]، [SWS_CRYPT_50010]). كما تُنتج أسماء المعلمات غير المعروفة في SetParameter أيضاً kUnsupported ([SWS_CRYPT_50007]، [SWS_CRYPT_50008]، [SWS_CRYPT_50009]).
تعارضات الموارد: إذا كان هناك مورد تشفير مطلوب للحساب محجوزاً، تشير DeriveKey إلى رمز الخطأ ara::crypto::CryptoErrc::kBusyResource [SWS_CRYPT_21515].

تم تنظيم هذا الدليل بواسطة ذكاء اصطناعي. تستند جميع الإفادات الفنية حصرياً إلى مواصفات AUTOSAR Adaptive (الإصدار R25-11).

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

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

DeriveKey SetKey SetParameter

أسماء الأنواع البديلة

Sptr

مخطط الفئة

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

عرض التفاصيل

اختر عنصرًا من المخطط.

لا توجد بيانات عناصر لهذا الإصدار

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

DeriveKey دالة

Derive a symmetric key from the provided key material and provided context configuration, e.g., salt, context, IV, iteration count.

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

SetKey دالة 2

Configure the context to use the provided key.

التحميلات الزائدة SetKey 2

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

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

SetParameter دالة 3

Set a parameter of the KDF identified by parameterName.

التحميلات الزائدة SetParameter 3

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

SWS_CRYPT_50007

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

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

SWS_CRYPT_50009

أسماء الأنواع البديلة

Sptr اسم نوع بديل

Smart pointer of the interface.

using Sptr = std::shared_ptr<KeyDerivationFunctionCtx>;

انقر على عنصر لعرض علاقاته.

الفئة الأساسيةالمشتقةيستخدممستخدم بواسطةالوراثةمحذوف اعتبارًا منيظهر فيلا توجد علاقات في هذه الفئةالدوالتعليق الذكاء الاصطناعيفتح صفحة الفئةتعذر تحميل صفحة الفئة.تغيير الترتيبتغيير العرضتغيير عرض المخططالأقساممدة القراءةمراجع SWSالمخططاتإعادة إلى الوسطغيّر الترتيب أو اسحب إلى شريط العنوانفك الإرساء – العرض في المحتوىنقل إلى العمود الأوسطإرساء كتبويب في شريط العنوانالعناصرنموذج الذكاء الاصطناعيفتح ملف التدقيقالملففتح النسخة المختصرةفتح النسخة المتوسطةفتح النسخة الكاملةاستعادة العرض الافتراضيتمت استعادة العرض الافتراضيتراجعإغلاق العرض التفصيليالتوقيعمعلومات عامةالقيمآخر تغيير حتى الإصدار المحددالتغيير التالي بعدهانقر: اختيار الإصدارلا يمكن الإفلات هنا: اسحب إلى شريط العنوان للتثبيت، أو إلى العمود الأوسط لإلغاء التثبيت.جديدمعدَّلدون تغييرمحذوفغير مُدرجالتغييراتلا تغيير في المحتوىلأول مرة فيحُذف فيلا تتوفر بيانات الإصدارات.جارٍ تحميل بيانات الإصدارات …النصالصياغة غير مسجلة في هذا الإصدارمرِّر فوق خلية أو انقرها: المقارنة مع الإصدار المحدد · انقر رأس إصدار: اختيار الإصداراختيار الإصدارالبياناتالإصدارالعنصرإصدار واحد فقط بصياغةموجود في PDF، لم يُستورد النص بعدالتُقط النص لأول مرةدون تغيير منذ {rel}ألوان الإصداراتأقدم إصدارأحدث إصدار

توثيق الدوال

دالة DeriveKey [SWS_CRYPT_21515] Upstream: RS_CRYPTO_02102, RS_CRYPTO_02107, RS_CRYPTO_02108, RS_CRYPTO_02111, RS_CRYPTO_02115

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

Derive a symmetric key from the provided key material and provided context configuration, e.g., salt, context, IV, iteration count.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: ad7de7f8f0b6 المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تشتق الدالة DeriveKey للفئة ara::crypto::cryp::KeyDerivationFunctionCtx مفتاحاً متماثلاً جديداً بشكل متزامن من مادة المفتاح المتوفرة وكذلك المعلمات المحفوظة في السياق مثل قيمة Salt أو متجه التهيئة (IV) أو عداد التكرار [SWS_CRYPT_21515].

الاستخدام

عند الاستدعاء، يتم تمرير مُعرّف خوارزمية التشفير المطلوبة عبر targetAlgId وكذلك رايات الاستخدام المسموح بها عبر allowedUsage [SWS_CRYPT_21515]. وكقيمة إرجاع، توفر الدالة بشكل متزامن ara::core::Result<SymmetricKey::Sptr>، والذي يوفر عند التنفيذ الناجح مؤشراً ذكياً يشير إلى كائن المفتاح المتماثل المُنشأ [SWS_CRYPT_21515].

معالجة الأخطاء

إذا فشل إنشاء المفتاح، تضمن الدالة دلالات التراجع وتُرجع رمز خطأ ملائماً في ara::core::Result [SWS_CRYPT_21515]:

UnknownIdentifier: يتم الإبلاغ عنه في حال كانت القيمة الممررة لـ targetAlgId غير مدعومة [SWS_CRYPT_21515].
ara::crypto::CryptoErrc::kIncompatibleArguments: تحدث إذا كانت رايات الاستخدام المحددة في allowedUsage غير متوافقة مع الخوارزمية المستهدفة [SWS_CRYPT_21515].
ara::crypto::CryptoErrc::kUninitializedContext: لم تتم تهيئة السياق بشكل كافٍ قبل اشتقاق المفتاح [SWS_CRYPT_21515].
ara::crypto::CryptoErrc::kBusyResource: هناك مورد لازم لاشتقاق المفتاح مشغول [SWS_CRYPT_21515].
ara::crypto::CryptoErrc::kEmptyKeySlot: إن KeySlot الذي تم تكوينه للعملية فارغ حالياً [SWS_CRYPT_21515].
ara::crypto::CryptoErrc::kUsageViolation: تحدث إذا كان إذن استخدام مفتاح المصدر لا يتضمن kAllowKeyDerivation، أو إذا كان الهدف يطلب kAllowPlaintextExport بينما لا يسمح المصدر بـ kAllowDerivedPlaintextExport [SWS_CRYPT_21515].

التزامن وسياق التنفيذ

تم تحديد الدالة كـ noexcept، وتوفر أماناً من الاستثناءات (exception safe)، وهي مصممة لتكون thread-safe للاستدعاء المتزامن [SWS_CRYPT_21515].

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

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

Parameter (in)

Parameter	Beschreibung
targetAlgId	the identifier of the target symmetric crypto algorithm
allowedUsage	the flags that define a list of allowed usages in which the target key can be used.

Rückgabewert

Typ	Beschreibung
ara::core::Result<SymmetricKey::Sptr >	result containing a shared pointer to the created symmetric key object or an error

Fehler

Fehlercode	Beschreibung
UnknownIdentifier	if targetAlgId has an unsupported value
ara::crypto::CryptoErrc::kIncompatibleArguments	rollback_semantics if the allowedUsage of the derived key is incompatible with the targetAlgId.
ara::crypto::CryptoErrc::kUninitializedContext	rollback_semantics if the context has not been sufficiently initialized
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 source key does not include kAllowKey Derivation
ara::crypto::CryptoErrc::kUsageViolation	rollback_semantics if the allowedUsage of the target key includes kAllowPlaintext Export but the allowed usage of the source key does not include k AllowDerivedPlaintextExport

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

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

Status: valid/unmigrated Version: rel:R25-11#9b38f620 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_21515@rel:R25-11#9b38f620

Recorded Revisions (8):

R25-11rel:R25-11#4792442a2026-09-30
R19-11rel:R19-11#d747dcdf2026-10-14
R20-11rel:R20-11#20ca9f5b2026-10-14
R21-11rel:R21-11#4e7c875e2026-10-14
R22-11rel:R22-11#1edafd582026-10-14
R23-11rel:R23-11#09e184cc2026-10-14
R24-11rel:R24-11#f4962bb42026-10-14
R25-11rel:R25-11#9b38f6202026-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_21525] 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.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 3738ec7c9403 المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

الاستخدام

تُستخدم الطريقة SetKey لتهيئة KeyDerivationFunctionCtx باستخدام مادة المفتاح المتماثل [SWS_CRYPT_21525] المقدمة كـ key. يتم تنفيذ الدالة بشكل متزامن وتشير إلى نتيجة العملية عبر نوع الإرجاع ara::core::Result<void> [SWS_CRYPT_21525].

التزامن وأمان التنفيذ

تم تزويد الواجهة بالمحدد noexcept وتصنيفها على أنها آمنة من الاستثناءات (exception-safe) [SWS_CRYPT_21525]. بالإضافة إلى ذلك، تم تحديد التنفيذ ليكون آمنًا بالنسبة للخيوط (thread-safe)، بحيث يمكن إجراء الاستدعاء بأمان حتى في البيئات المتزامنة [SWS_CRYPT_21525].

معالجة الأخطاء

في حالة حدوث خطأ، لا يتم إرجاع حالة نجاح فارغة، بل رمز خطأ مطابق، مع تحديد دلالات التراجع (rollback_semantics) لجميع حالات الخطأ [SWS_CRYPT_21525]:

ara::crypto::CryptoErrc::kIncompatibleObject: كائن المفتاح المُمرَّر غير متوافق مع السياق المتماثل [SWS_CRYPT_21525].
ara::crypto::CryptoErrc::kUsageViolation: الاستخدام المسموح به للمفتاح لا يتضمن الإذن kAllowKey Derivation [SWS_CRYPT_21525].
ara::crypto::CryptoErrc::kUnsupported: السياق المحدد يدعم حصريًا التعيين عبر KeySlot [SWS_CRYPT_21525].

تفاعل

إذا كان تنفيذ السياق الأساسي لا يدعم التعيين المباشر لـ SymmetricKey::Sptr، أو إذا كان المفتاح سيتم الحصول عليه بدلاً من ذلك من فتحة تخزين في وقت اشتقاق المفتاح، فإن التحميل الزائد البديل لـ SetKey باستخدام KeySlot::Sptr يكون متاحًا [SWS_CRYPT_50010].

تم إنشاء ملاحظة الاستخدام هذه آليًا استنادًا إلى مواصفة AUTOSAR R25-11.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

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

Parameter (in)

Parameter	Beschreibung
key	the source key-material

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 Derivation
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_21525
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_21525@rel:R25-11#4c6349c5
Content hash: 4c6349c5
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_21525

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

Recorded Revisions (7):

R25-11rel:R25-11#a05f5b632026-09-30
R20-11rel:R20-11#33ea902d2026-10-14
R21-11rel:R21-11#46a880c32026-10-14
R22-11rel:R22-11#fed116fd2026-10-14
R23-11rel:R23-11#3143ac902026-10-14
R24-11rel:R24-11#db6fdd502026-10-14
R25-11rel:R25-11#eca8e8d82026-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_50010] 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 derivation is performed.

مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: aa74de7c29b5 المصدر

مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

تُهيئ الطريقة الظاهرية SetKey السياق KeyDerivationFunctionCtx لاستخدام مفتاح مخزن في KeySlot مُمرر، بمجرد إجراء اشتقاق المفتاح [SWS_CRYPT_50010]. وتستقبل الدالة كمعامل مؤشرًا ذكيًا KeySlot::Sptr، يشير إلى فتحة تحتوي على مفتاح متماثل [SWS_CRYPT_50010].

يتم الاستدعاء بشكل متزامن ومحدد بأنه آمن من الاستثناءات (exception safe) وغير ملقٍ لها (noexcept) [SWS_CRYPT_50010]. تُعيد الدالة ara::core::Result<void>، والذي يكون فارغًا في حالة النجاح أو يغلف رمز خطأ مناسب في حالة الفشل [SWS_CRYPT_50010]. في حالة حدوث خطأ، يتم الحفاظ على الحالة السابقة عبر دلالات التراجع (Rollback) [SWS_CRYPT_50010]:

ara::crypto::CryptoErrc::kIncompatibleObject: يُعاد إذا كان keySlot المقدم غير متوافق مع السياق الحالي [SWS_CRYPT_50010].
ara::crypto::CryptoErrc::kUnsupported: يحدث عندما يدعم السياق الفعلي حصريًا تعيين SymmetricKey [SWS_CRYPT_50010].

تم تصنيف الطريقة بأنها آمنة للخيوط (thread-safe) للوصول المتزامن من عدة خيوط [SWS_CRYPT_50010]. فيما يتعلق بالتفاعل، تُستخدم العملية كبديل للتحميل الزائد لـ SetKey مع SymmetricKey::Sptr، والذي يستقبل مادة المفتاح مباشرة بدلاً من مرجع الفتحة [SWS_CRYPT_21525].

تم إنشاء ملاحظة الاستخدام هذه تلقائيًا بناءً على مواصفة AUTOSAR.

دليل المنفِّذ قيد الإعداد (التعقيد I2)

Header-Datei	#include "ara/crypto/cryp/key_derivation_function_ctx.h"
Scope	class ara::crypto::cryp::KeyDerivationFunctionCtx
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_50010
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_50010@rel:R25-11#676da837
Content hash: 676da837
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50010

Status: valid/unmigrated Version: rel:R25-11#8eb8c6c4 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_50010@rel:R25-11#8eb8c6c4

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

دالة SetParameter [SWS_CRYPT_50007] 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 KDF identified by parameterName.

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

Parameter (in)

Parameter	Beschreibung
parameterName	an identifier of the parameter
value	an input buffer containing the value of the parameter

Rückgabewert

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

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kUnsupported	rollback_semantics if the context does not support the parameter
ara::crypto::CryptoErrc::kInvalidArgument	rollback_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_50007
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_50007@rel:R25-11#5aa94ee1
Content hash: 5aa94ee1
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50007

Status: valid/unmigrated Version: rel:R25-11#4c314faf 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_50007@rel:R25-11#4c314faf

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

دالة SetParameter [SWS_CRYPT_50008] 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 KDF identified by parameterName.

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

Parameter (in)

Parameter	Beschreibung
parameterName	an identifier of the parameter
value	an unsigned integer containing the value of the parameter

Rückgabewert

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

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kUnsupported	rollback_semantics if the context does not support the parameter
ara::crypto::CryptoErrc::kInvalidArgument	rollback_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_50008
Status: valid/unmigrated
Version: AUTOSAR/AP/record/SWS_CRYPT_50008@rel:R25-11#4f4d1ef2
Content hash: 4f4d1ef2
Source: https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50008

Status: valid/unmigrated Version: rel:R25-11#26b90c19 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_50008@rel:R25-11#26b90c19

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

دالة SetParameter [SWS_CRYPT_50009] Upstream: RS_CRYPTO_02102, RS_CRYPTO_02107, RS_CRYPTO_02108, RS_CRYPTO_02111

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

Set a parameter of the KDF identified by parameterName.

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

Parameter (in)

Parameter	Beschreibung
parameterName	an identifier of the parameter
value	SymmetricKey being used as the input parameter

Rückgabewert

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

Fehler

Fehlercode	Beschreibung
ara::crypto::CryptoErrc::kUnsupported	rollback_semantics if the context does not support the parameter
ara::crypto::CryptoErrc::kIncompatibleObject	rollback_semantics if the provided key is incompatible with this context
ara::crypto::CryptoErrc::kUsageViolation	rollback_semantics if the allowed usage of the key does not include kAllowKey Derivation

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

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

Status: valid/unmigrated Version: rel:R25-11#92b1f35c 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_50009@rel:R25-11#92b1f35c

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_21501] Upstream: RS_CRYPTO_02103

using Sptr = std::shared_ptr<KeyDerivationFunctionCtx>;

Smart pointer of the interface.

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

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

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

Status: valid/unmigrated Version: rel:R25-11#6ebb94e3 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_21501@rel:R25-11#6ebb94e3

Recorded Revisions (8):

R25-11rel:R25-11#4fb24cfc2026-09-30
R19-11rel:R19-11#e5d0fc6d2026-10-14
R20-11rel:R20-11#c13472492026-10-14
R21-11rel:R21-11#c13472492026-10-14
R22-11rel:R22-11#461242d92026-10-14
R23-11rel:R23-11#aa4dc94a2026-10-14
R24-11rel:R24-11#aa4dc94a2026-10-14
R25-11rel:R25-11#6ebb94e32026-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::KeyDerivationFunctionCtx

دليل المستخدممولَّد بالذكاء الاصطناعي

السياق

دورة الحياة

مسار الاستخدام

سيناريوهات الأخطاء

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

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

أسماء الأنواع البديلة

مخطط الفئة

عرض التفاصيل

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

أسماء الأنواع البديلة

توثيق الدوال

دالة DeriveKey [SWS_CRYPT_21515] Upstream: RS_CRYPTO_02102, RS_CRYPTO_02107, RS_CRYPTO_02108, RS_CRYPTO_02111, RS_CRYPTO_02115

الاستخدام

معالجة الأخطاء

التزامن وسياق التنفيذ

Parameter (in)

Rückgabewert

Fehler

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة SetKey [SWS_CRYPT_21525] 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_50010] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02003

Parameter (in)

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة SetParameter [SWS_CRYPT_50007] Upstream: RS_CRYPTO_02102, RS_CRYPTO_02107, RS_CRYPTO_02108, RS_CRYPTO_02111

Parameter (in)

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة SetParameter [SWS_CRYPT_50008] Upstream: RS_CRYPTO_02102, RS_CRYPTO_02107, RS_CRYPTO_02108, RS_CRYPTO_02111

Parameter (in)

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

دالة SetParameter [SWS_CRYPT_50009] Upstream: RS_CRYPTO_02102, RS_CRYPTO_02107, RS_CRYPTO_02108, RS_CRYPTO_02111

Parameter (in)

Rückgabewert

Fehler

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents:

توثيق أسماء الأنواع البديلة

اسم نوع بديل Sptr [SWS_CRYPT_21501] Upstream: RS_CRYPTO_02103

Recorded Revisions (8):

Requirement Text as-of this release:

Curation Decisions:

Reachable Artifacts & Dependents: