يعمل كمصنع مركزي لإنشاء وإدارة السياقات وخوارزميات التشفير وكائنات المفاتيح.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 0bf253450f85المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
يعمل كمصنع مركزي لإنشاء وإدارة السياقات وخوارزميات التشفير وكائنات المفاتيح.
تعمل الفئة كمصنع مركزي لتوفير الأوليات التشفيرية وكذلك لإنشاء وإدارة المفاتيح والسياقات التشفيرية ([SWS_CRYPT_20742]، [SWS_CRYPT_20721]). ولا تقبل المثيلات النسخ أو النقل، وتتم إدارتها عبر مؤشرات مشتركة ([SWS_CRYPT_20701]، [SWS_CRYPT_41005]). وتُعاد الأخطاء، مثل الخوارزميات غير المتوافقة أو استنفاد الموارد، بطريقة آمنة من حيث النوع عبر ara::core::Result ([SWS_CRYPT_30098]).
السياق
تشكل الفئة ara::crypto::cryp::CryptoProvider الواجهة المركزية لتوفير العمليات وخوارزميات التشفير في مكدس AUTOSAR Adaptive. وبصفتها طبقة تجريد، فإنها تجمع التطبيقات الملموسة للأوليات التشفيرية بالإضافة إلى الوصول إلى المفاتيح وبنى التخزين. وفي معمارية النظام النموذجية، يعمل CryptoProvider كوسيط ومصنع بين منطق التطبيق ومخازن المفاتيح الدائمة وسياقات المعالجة المتخصصة. وتطلب التطبيقات عبر الموفر سياقات متخصصة للتشفير المتناظر ([SWS_CRYPT_20742])، أو التشفير غير المتناظر ([SWS_CRYPT_20750]، [SWS_CRYPT_20751])، أو التواقيع الرقمية ([SWS_CRYPT_20756]، [SWS_CRYPT_20757])، أو دوال التلبيد ([SWS_CRYPT_20747])، أو مصادقة الرسائل ([SWS_CRYPT_20746])، أو إجراءات تبادل المفاتيح ([SWS_CRYPT_20758]، [SWS_CRYPT_20752]). وفي الوقت نفسه، يتفاعل الموفر مع فتحات المفاتيح الأساسية لإنشاء مثيلات من المفاتيح المخزنة ([SWS_CRYPT_20762]، [SWS_CRYPT_20764]).
تمتلك مثيلات CryptoProvider دلالات صارمة فيما يتعلق بعمليات النسخ والنقل: فكل من منشئ النسخ ([SWS_CRYPT_41005]) ومنشئ النقل ([SWS_CRYPT_41006]) بالإضافة إلى معاملات التعيين المقابلة ([SWS_CRYPT_30216]، [SWS_CRYPT_30217]) محذوفة صراحةً (delete). لذلك، تتم إدارة دورة حياة المثيل عادةً عبر مراجع أو ملكية مشتركة، والتي تم تعريف الاسم المستعار للنوع CryptoProvider::Sptr لها بناءً على std::shared_ptr ([SWS_CRYPT_20701]). وتتم عملية التنظيف عبر المدمر الافتراضي القياسي ([SWS_CRYPT_20710]). وقد تم تحديد جميع دوال واجهة الموفر بأنها آمنة من الاستثناءات (exception safe) وآمنة خيطيًا (thread-safe)، مما يسمح بالوصول المتزامن من عدة خيوط دون تزامن خارجي على مستوى الموفر.
مسار الاستخدام
يتضمن مسار الاستخدام النموذجي توفير المفتاح، وإنشاء مثيل لسياق التشفير المناسب، ثم إجراء التحويلات لاحقًا. أولاً، يقوم التطبيق بإنشاء أو استيراد مادة المفتاح المطلوبة. ولهذا الغرض، يوفر CryptoProvider دوال مثل GenerateSymmetricKey ([SWS_CRYPT_20721])، أو GeneratePrivateKey ([SWS_CRYPT_20722])، أو ImportPublicKey ([SWS_CRYPT_20732])، أو التحميل من فتحة مفتاح موجودة ([SWS_CRYPT_20762]، [SWS_CRYPT_20763]). وبناءً على الخوارزمية، يمكن تحديد الأذونات الافتراضية عبر GetDefaultAllowedUsage ([SWS_CRYPT_20955]). وفي الخطوة التالية، ينشئ التطبيق السياق المعني عبر دوال المصنع، على سبيل المثال AuthCipherCtx ([SWS_CRYPT_20745]) أو SignerPrivateCtx ([SWS_CRYPT_20756]). بالإضافة إلى ذلك، يوفر الموفر بيانات عشوائية عبر GenerateRandomData ([SWS_CRYPT_30098]) أو قيمة عداد متزايدة باطراد عبر GetSecureCounter ([SWS_CRYPT_20098]). وللتبادل الآمن، يمكن تصدير مادة المفتاح بشكل محمي باستخدام ExportSecuredKey ([SWS_CRYPT_20728]).
تُبلغ دوال CryptoProvider عن الأخطاء عبر نوع الإرجاع ara::core::Result بقيم من ara::crypto::CryptoErrc. وتُطبق دلالات التراجع في حالة العمليات الفاشلة. وتتضمن سيناريوهات الخطأ الأساسية ما يلي:
معلمات غير صالحة أو غير متوافقة: إذا تم تمرير معرّف خوارزمية غير مدعوم، تُرجع دوال إنشاء السياق والمفاتيح CryptoErrc::kUnknownIdentifier ([SWS_CRYPT_20741]، [SWS_CRYPT_20742]، [SWS_CRYPT_20721]). وإذا لم تتطابق الخوارزمية مع الأوّلية المتوقعة (مثل خوارزمية غير متناظرة عند طلب دالة تلبيد) أو لم تتوافق أعلام الاستخدام مع التكوين، يحدث CryptoErrc::kInvalidArgument أو CryptoErrc::kIncompatibleArguments ([SWS_CRYPT_20747]، [SWS_CRYPT_20722]، [SWS_CRYPT_50132]).
أخطاء تخزين المفاتيح وتنسيقها: عند التحميل عبر فتحات المفاتيح، تؤدي الفتحة غير المجهزة إلى CryptoErrc::kEmptyKeySlot، بينما تسبب أنواع المفاتيح الغريبة أو غير الصحيحة CryptoErrc::kIncompatibleObject ([SWS_CRYPT_20762]، [SWS_CRYPT_20764]). وتؤدي تنسيقات التسلسل الخاطئة إلى CryptoErrc::kUnsupportedFormat ([SWS_CRYPT_50014]، [SWS_CRYPT_20732]).
اختناقات الموارد والسعة: إذا استُنفد مولد الأرقام العشوائية مؤقتًا أو تم حظر مورد أجهزة، يُعاد CryptoErrc::kBusyResource ([SWS_CRYPT_30098]، [SWS_CRYPT_20721]، [SWS_CRYPT_20098]). وفي حالة المخازن المؤقتة للوجهة ذات الأبعاد غير الكافية لبيانات التعريف أو عمليات تصدير المفاتيح، تُبلغ الواجهة عن CryptoErrc::kInsufficientCapacity ([SWS_CRYPT_50015]، [SWS_CRYPT_20728]).
ميزات غير مدعومة: إذا كانت الميزات الاختيارية مثل تحديد هوية الموفر، أو العداد الآمن، أو RNG القياسي غير مدعومة من قِبل تطبيق موفر ملموس، فسيتم الإبلاغ عن الخطأ CryptoErrc::kUnsupported ([SWS_CRYPT_50015]، [SWS_CRYPT_20098]، [SWS_CRYPT_30098]).
يستند هذا الدليل حصريًا إلى تعريف واجهة ara::crypto::cryp::CryptoProvider لـ AUTOSAR R25-11.
The interface shall format the data referenced by the specified key, securely wrap this payload and serialize the secured payload into the provided output buffer. The format shall be specified implicitly by the AlgId. The formatted payload shall be wrapped according to the specified algId using the kek; if kek is not provided, ExportSecuredKey shall apply a key-encryption-key implictly defined by the algId or the default key-encryption-key of the CryptoProvider.
Generate a new public/private key pair and return the private key. The public key can be retrieved via the function PrivateKey::GetPublicKey() The allowed usage flags of the Public Key are set based on the allowed usage of the PrivateKey: • kAllowDataDecryption --> kAllowDataEncryption • kAllowSigGeneration --> kAllowSigVerification • kAllowKeyAgreement --> kAllowKeyAgreement • kAllowKeyUnwrapping --> kAllowKeyWrapping Additionally, the allowed usage: • kAllowPlaintextExport • kAllowPersist are set for the public key.
Get a CryptoProvider specific default set of allowedUsages for the provided AlgId. The returned allowedUsages shall not contain kAllowPlaintextExport, kAllowPersist and kAllowSecuredExport.
Get the current value of the secure counter of this CryptoProvider. The current counter value is guaranteed to be stricly larger than any previously returned counter value.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 11ce33c6da44المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم الطريقة CreateAuthCipherCtx لإنشاء سياق للتشفير المتماثل الموثق ([SWS_CRYPT_20745]). وهي معرفة كواجهة افتراضية بحتة في الفئة ara::crypto::cryp::CryptoProvider وتُضمَّن عبر ملف الرأس ara/crypto/cryp/crypto_provider.h ([SWS_CRYPT_20745]).
الاستخدام والدلالات
يُمرَّر كمعلمة إدخال algId، والذي يحدد الخوارزمية التشفيرية الهدف ([SWS_CRYPT_20745]). تعمل الدالة بشكل متزامن ولا تطلق استثناءات (noexcept) ([SWS_CRYPT_20745]). وعند التنفيذ بنجاح، تُرجع ara::core::Result مع مؤشر ذكي إلى المثيل المنشأ AuthCipherCtx::Sptr ([SWS_CRYPT_20745]).
معالجة الأخطاء
في حالة الخطأ، يُرجع رمز خطأ مطابق في ara::core::Result مع دلالات التراجع ([SWS_CRYPT_20745]):
ara::crypto::CryptoErrc::kInvalidArgument: إذا كان algId لا يحدد خوارزمية لتشفير تدفقي متماثل موثق ([SWS_CRYPT_20745]).
ara::crypto::CryptoErrc::kUnknownIdentifier: إذا مُرِّرت قيمة غير مدعومة لـ algId ([SWS_CRYPT_20745]).
التزامن
استدعاء CreateAuthCipherCtx آمن بالنسبة للخيوط (thread-safe) ومحدد بأنه آمن من الاستثناءات (exception safe) ([SWS_CRYPT_20745]).
أُنشئ هذا النص تلقائياً. جميع العبارات الفنية مدعومة بأدلة من المواصفات.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 7d14bb93ecbaالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُستخدم الطريقة CreateDecryptorPrivateCtx للواجهة ara::crypto::cryp::CryptoProvider لإنشاء سياق لفك التشفير غير المتماثل باستخدام مفتاح خاص وفقاً لـ [SWS_CRYPT_20751]. تتوقع الدالة كمعلمة إدخال algId، والذي يحدد معرف خوارزمية التشفير أو فك التشفير غير المتماثل المطلوبة. التفسير: من المرجح أن يُنفَّذ الاستدعاء بشكل متزامن، لأن التوقيع يُرجع مباشرةً ara::core::Result، والذي يحتوي في حالة النجاح على مؤشر ذكي إلى السياق المُنشأ (DecryptorPrivateCtx::Sptr) [SWS_CRYPT_20751]. سؤال Q-45d1c4a1b2133f4c (مفتوح)
معالجة الأخطاء
إذا تعذر إنشاء السياق، يُنقل الخطأ في ara::core::Result المُعاد. وإذا مُرِّرت قيمة غير مدعومة للمعلمة algId، ينتج عن ذلك على وجه التحديد رمز الخطأ ara::crypto::CryptoErrc::kUnknownIdentifier مع دلالات التراجع [SWS_CRYPT_20751].
التزامن والقيود
عُرِّفت الدالة على أنها noexcept وتضمن أمان الاستثناءات (exception safe) [SWS_CRYPT_20751]. وبالنسبة للوصول المتزامن من خيوط متعددة، حُددت الطريقة بأنها آمنة بالنسبة للخيوط (thread-safe) [SWS_CRYPT_20751]. وبما أن التوقيع معلن في الرأس ara/crypto/cryp/crypto_provider.h كطريقة افتراضية بحتة، فإن التجسيد الملموس يقع على عاتق تنفيذ الموفر المعني [SWS_CRYPT_20751].
أُنشئت ملاحظة الاستخدام هذه تلقائياً وتستند حصرياً إلى بيانات المواصفات من إصدار AUTOSAR Adaptive R25-11.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: f47db9d84d9aالمصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تنتمي طريقة الواجهة الافتراضية البحتة CreateEncryptorPublicCtx إلى الفئة ara::crypto::cryp::CryptoProvider وتُعلن عبر ملف الرأس ara/crypto/cryp/crypto_provider.h[SWS_CRYPT_20750]. وتتمثل مهمتها في إنشاء مثيل لسياق جديد لعمليات التشفير غير المتماثل باستخدام مفتاح عام [SWS_CRYPT_20750].
الاستخدام: يتم الاستدعاء بشكل متزامن مع تحديد المعلمة algId من النوع AlgId، والتي تحدد معرف خوارزمية التشفير أو فك التشفير غير المتماثل المطلوبة [SWS_CRYPT_20750]. تُرجع الطريقة النتيجة في ara::core::Result، والذي يوفر في حالة النجاح مؤشراً ذكياً من النوع EncryptorPublicCtx::Sptr إلى السياق المنشأ [SWS_CRYPT_20750].
معالجة الأخطاء: إذا كانت الوسيطة algId تحتوي على قيمة خوارزمية غير مدعومة، يفشل الاستدعاء ويُرجع في ara::core::Result رمز الخطأ ara::crypto::CryptoErrc::kUnknownIdentifier[SWS_CRYPT_20750]. حُددت دلالات تراجع صريحة لحالة الخطأ هذه [SWS_CRYPT_20750].
التزامن والأمان من الاستثناءات: أُعلنت الواجهة على أنها noexcept، وتُعتبر آمنة من الاستثناءات (exception safe)، وحُددت صراحةً بأنها آمنة بالنسبة للخيوط (thread-safe) [SWS_CRYPT_20750].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي بناءً على المواصفة.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: d5d380ddf0c0المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم الطريقة CreateHashFunctionCtx لإنشاء مثيل لسياق تجزئة تشفيري ([SWS_CRYPT_20747]). وتُوفَّر كواجهة افتراضية بحتة للفئة ara::crypto::cryp::CryptoProvider عبر الرأس ara/crypto/cryp/crypto_provider.h.
الاستخدام والمعلمات
يتم الاستدعاء بشكل متزامن ويتوقع كمعلمة إدخال algId (من النوع AlgId)، والذي يحدد الخوارزمية التشفيرية المطلوبة ([SWS_CRYPT_20747]). وكقيمة إرجاع، تُرجع الدالة ara::core::Result<HashFunctionCtx::Sptr>، والذي يحتوي في حالة النجاح على مؤشر ذكي إلى السياق المنشأ.
معالجة الأخطاء
إذا فشل الإنشاء، يحتوي ara::core::Result على رمز خطأ مطابق مع دلالات التراجع ([SWS_CRYPT_20747]):
ara::crypto::CryptoErrc::kInvalidArgument: يُرجع إذا كان algId الممرر محدداً لنوع خوارزمية آخر غير دالة التجزئة ([SWS_CRYPT_20747]).
ara::crypto::CryptoErrc::kUnknownIdentifier: يحدث إذا مُرِّر معرف غير مدعوم لـ algId ([SWS_CRYPT_20747]).
التزامن والقيود
أُعلنت الدالة على أنها noexcept وحُددت بأنها آمنة من الاستثناءات («exception safe») ([SWS_CRYPT_20747]). بالإضافة إلى ذلك، فإن الاستدعاء آمن بالنسبة للخيوط («thread-safe»)، بحيث يُسمح بالاستدعاءات المتزامنة من خيوط متعددة على نفس المثيل من CryptoProvider ([SWS_CRYPT_20747]).
تم توليد هذا النص بواسطة ذكاء اصطناعي بناءً على المواصفة R25-11.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: f0aaacbed75dالمصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم الدالة CreateKeyAgreementPrivateCtx للفئة ara::crypto::cryp::CryptoProvider لإنشاء سياق مفتاح خاص للاتفاق على المفاتيح (KeyAgreementPrivateCtx) وفقاً لـ [SWS_CRYPT_20758]. ويتم توفير التصريح عبر ملف الترويسة #include "ara/crypto/cryp/crypto_provider.h".
الاستخدام والاستدعاء
تتوقع الدالة المتزامنة كمعلمة تمرير المُعرّف algId من النوع AlgId، والذي يحدد خوارزمية التشفير المطلوبة للاتفاق على المفاتيح (Key-Agreement). وكقيمة إرجاع، تُرجع الدالة ara::core::Result<KeyAgreementPrivateCtx::Sptr>، والذي يغلّف في حالة النجاح مؤشراً ذكياً يشير إلى مثيل السياق المُنشأ حديثاً [SWS_CRYPT_20758].
معالجة الأخطاء
إذا فشل إنشاء المثيل، فإن ara::core::Result المُرجع يحتوي على رمز خطأ بدلالات التراجع [SWS_CRYPT_20758]:
ara::crypto::CryptoErrc::kInvalidArgument: تحدث إذا حددت الوسيطة algId خوارزمية تشفير تختلف عن إجراءات الاتفاق على المفاتيح.
ara::crypto::CryptoErrc::kUnknownIdentifier: يتم إرجاعه في حال تضمن المُعرّف algId قيمة غير مدعومة.
التزامن والأمان
تم التصريح عن الواجهة كـ noexcept وتحديدها على أنها آمنة من الاستثناءات (exception safe). بالإضافة إلى ذلك، تم تحديد الاستدعاء على أنه آمن بالنسبة للخيوط (thread-safe)، بحيث يُسمح بالاستدعاءات المتزامنة على نفس مثيل CryptoProvider[SWS_CRYPT_20758].
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا استنادًا إلى مواصفات AUTOSAR R25-11.
Create a key-decapsulator private context of a Key Encapsulation Mechanism (KEM).
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 29715a46f6b0المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُستخدم الدالة CreateKeyDecapsulatorPrivateCtx للواجهة ara::crypto::cryp::CryptoProvider لإنشاء سياق خاص لفك تغليف المفاتيح لآلية Key Encapsulation Mechanism (KEM) [SWS_CRYPT_20753]. تتوقع كمعلمة إدخال algId من النوع AlgId، والذي يحدد خوارزمية تشفير KEM المطلوبة [SWS_CRYPT_20753]. تعمل الدالة بشكل متزامن وترجع النتيجة في ara::core::Result<KeyDecapsulatorPrivateCtx::Sptr>، والذي يغلف في حالة النجاح مؤشرًا ذكيًا إلى السياق الذي تم إنشاء مثيله حديثًا [SWS_CRYPT_20753].
معالجة الأخطاء
إذا حدث خطأ أثناء إنشاء السياق، يتم الإبلاغ عنه عبر ara::core::Result مع دلالات التراجع [SWS_CRYPT_20753]:
ara::crypto::CryptoErrc::kInvalidArgument: تحدد الوسيطة algId خوارزمية تشفيرية ليست آلية KEM غير متماثلة [SWS_CRYPT_20753].
ara::crypto::CryptoErrc::kUnknownIdentifier: تحتوي الوسيطة algId على قيمة غير مدعومة [SWS_CRYPT_20753].
التزامن وأمان التنفيذ
تم التصريح عن الواجهة كـ noexcept وتحديدها على أنها آمنة من الاستثناءات (exception safe) [SWS_CRYPT_20753]. بالإضافة إلى ذلك، تم تصميم التنفيذ ليكون آمن مسار المعالجة (thread-safe) [SWS_CRYPT_20753].
تستند ملاحظة الاستخدام هذه إلى مواصفة AUTOSAR Adaptive R25-11.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: a0b8a7f1dfa2المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم الدالة CreateKeyDerivationFunctionCtx للفئة ara::crypto::cryp::CryptoProvider لإنشاء سياق تنفيذ لدوال اشتقاق المفاتيح ([SWS_CRYPT_20748]). يتم تمرير المُعرّف algId من النوع AlgId كمعلمة إدخال، والذي يحدد الخوارزمية التشفيرية المستهدفة المطلوبة. يرجع الاستدعاء المتزامن ara::core::Result، والذي يوفر عند التنفيذ الناجح مؤشرًا ذكيًا إلى السياق الذي تم إنشاؤه (KeyDerivationFunctionCtx::Sptr) ([SWS_CRYPT_20748]).
إذا حدث خطأ أثناء إنشاء المثيل، يتم إرجاع النتيجة مع رمز خطأ مطابق بموجب دلالات التراجع ([SWS_CRYPT_20748]):
ara::crypto::CryptoErrc::kInvalidArgument: تحدد الوسيطة algId خوارزمية تشفيرية لا تمثل دالة اشتقاق مفاتيح ([SWS_CRYPT_20748]).
ara::crypto::CryptoErrc::kUnknownIdentifier: يحتوي المُعرّف المُمرر algId على قيمة غير مدعومة ([SWS_CRYPT_20748]).
تم التصريح عن الواجهة كدالة افتراضية بحتة، وتم تحديدها كـ noexcept وتصنيفها بشكل ملزم كـ thread-safe وكذلك exception safe ([SWS_CRYPT_20748]). يتم التضمين عبر ملف الرأس #include "ara/crypto/cryp/crypto_provider.h". تعالج الدالة المتطلبات ذات الأولوية الأعلى [RS_CRYPTO_02103] و[RS_AP_00144].
تم إنشاء ملاحظة الاستخدام هذه آليًا بواسطة ذكاء اصطناعي وتستند إلى مواصفات AUTOSAR Adaptive Platform R25-11.
Create a key-encapsulator public context of a Key Encapsulation Mechanism (KEM).
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: efe36f596de1المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُستخدم الطريقة CreateKeyEncapsulatorPublicCtx للواجهة ara::crypto::cryp::CryptoProvider لإنشاء سياق عام لآلية تغليف المفاتيح (Key Encapsulation Mechanism - KEM) [SWS_CRYPT_20752]. ولهذا الغرض يجب تضمين ملف الرأس #include "ara/crypto/cryp/crypto_provider.h"[SWS_CRYPT_20752]. يتم الاستدعاء بشكل متزامن: يُمرَّر كمعلمة إدخال algId، والذي يحدد الخوارزمية التشفيرية الهدف لـ KEM. وعند التنفيذ بنجاح، تُرجع الطريقة مؤشراً ذكياً إلى السياق المنشأ (KeyEncapsulatorPublicCtx::Sptr)، مغلفاً في ara::core::Result[SWS_CRYPT_20752].
معالجة الأخطاء
إذا حدث خطأ أثناء الإنشاء، تُطبَّق دلالات التراجع ويحتوي ara::core::Result على رمز خطأ محدد من ara::crypto::CryptoErrc[SWS_CRYPT_20752]:
ara::crypto::CryptoErrc::kInvalidArgument: يُرجع إذا كانت الوسيطة algId تحدد خوارزمية تشفيرية ليست KEM غير متماثل [SWS_CRYPT_20752].
ara::crypto::CryptoErrc::kUnknownIdentifier: يُبلَّغ عنه إذا كانت الوسيطة algId تحتوي على قيمة غير مدعومة [SWS_CRYPT_20752].
التزامن والأمان
تم التصريح عن دالة الواجهة باستخدام noexcept وتصنيفها على أنها آمنة من الاستثناءات (exception safe) وآمنة بالنسبة للخيوط (thread-safe) [SWS_CRYPT_20752]. وبالتالي، يمكن استدعاؤها بأمان من سياقات متزامنة دون مزامنة خارجية [SWS_CRYPT_20752].
تستند ملاحظة الاستخدام هذه إلى مواصفة AUTOSAR Adaptive R25-11.
Create a symmetric message authentication code context.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 9f61171ea583المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تتطلب الطريقة الافتراضية البحتة CreateMessageAuthnCodeCtx للواجهة ara::crypto::cryp::CryptoProvider ملف الرأس ara/crypto/cryp/crypto_provider.h وتُستخدم للإنشاء المتزامن لسياق رموز مصادقة الرسائل المتماثلة (Message Authentication Codes) [SWS_CRYPT_20746]. وتستقبل الدالة كقيمة إدخال المعلمة algId من النوع AlgId، والتي تحدد خوارزمية التشفير الهدف [SWS_CRYPT_20746]. وعند التنفيذ بنجاح، تُرجع الطريقة ara::core::Result<MessageAuthnCodeCtx::Sptr>، والذي يغلف مؤشراً ذكياً إلى مثيل السياق المنشأ حديثاً [SWS_CRYPT_20746].
معالجة الأخطاء
في حالة الخطأ، يوفر كائن النتيجة المُعاد رموز خطأ محددة مع دلالات التراجع [SWS_CRYPT_20746]:
ara::crypto::CryptoErrc::kInvalidArgument: تحدد الوسيطة algId خوارزمية تشفيرية ليست رمز مصادقة رسائل متماثلاً [SWS_CRYPT_20746].
ara::crypto::CryptoErrc::kUnknownIdentifier: مُرِّر معرف غير معروف أو غير مدعوم للوسيطة algId[SWS_CRYPT_20746].
التزامن وأمان التنفيذ
زوِّدت الواجهة بالمحدد noexcept وتضمن أماناً كاملاً من الاستثناءات (exception safe) [SWS_CRYPT_20746]. علاوة على ذلك، حُددت الدالة صراحةً بأنها آمنة بالنسبة للخيوط (thread-safe)، بحيث يمكن إجراء الاستدعاءات بشكل متوازٍ ودون مزامنة خارجية من خيوط متزامنة [SWS_CRYPT_20746].
تم توليد ملاحظة الاستخدام هذه تلقائياً بناءً على المواصفة.
The interface shall create a protected key import context.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: cc2e3e31c614المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُستخدم الواجهة CreateProtectedKeyImportCtx للفئة ara::crypto::cryp::CryptoProvider (المعرفة في ara/crypto/cryp/crypto_provider.h) للإنشاء المتزامن لسياق استيراد المفاتيح المحمي ([SWS_CRYPT_50017]). يتم تمرير معرف خوارزمية التغليف المطلوبة عبر معلمة الإدخال algId ([SWS_CRYPT_50017]). عند نجاح إنشاء النسخة، تُرجع الطريقة ara::core::Result، يوفر مؤشراً ذكياً ProtectedKeyImportCtx::Sptr إلى السياق المُنشأ ([SWS_CRYPT_50017]).
معالجة الأخطاء
إذا فشل الإنشاء، تُرجع الطريقة رمز خطأ مع دلالات التراجع في ara::core::Result ([SWS_CRYPT_50017]):
ara::crypto::CryptoErrc::kInvalidArgument: يحدث عندما تكون خوارزمية التشفير المحددة بواسطة algId غير مدعومة للتغليف من قِبل CryptoProvider ([SWS_CRYPT_50017]).
ara::crypto::CryptoErrc::kUnknownIdentifier: يتم الإبلاغ عنه عندما تحتوي الوسيطة algId على قيمة معرف غير معروفة أو غير مدعومة ([SWS_CRYPT_50017]).
التزامن والقيود
تم التصريح عن الطريقة الافتراضية البحتة كـ noexcept، وتوفر أمان الاستثناءات ومحددة صراحةً على أنها آمنة بالنسبة لمؤشرات الترابط (thread-safe) ([SWS_CRYPT_50017]). وبالتالي يمكن استدعاؤها بشكل متوازٍ من عدة مؤشرات ترابط دون مزامنة خارجية ([SWS_CRYPT_50017]).
تم توليد إشعار الاستخدام هذا آليًا استنادًا إلى مواصفة AUTOSAR Adaptive R25-11.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 64bbceaa10dfالمصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم الطريقة CreateRandomGeneratorCtx لإنشاء سياق لمولدات الأرقام العشوائية (Random Number Generator, RNG) داخل الفئة ara::crypto::cryp::CryptoProvider[SWS_CRYPT_20741].
الاستخدام وسياق الاستدعاء
تُستدعى الدالة بشكل متزامن وتتطلب ملف الرأس ara/crypto/cryp/crypto_provider.h[SWS_CRYPT_20741]:
المعلمات: يُمرَّر algId من النوع AlgId، والذي يحدد خوارزمية RNG المطلوبة. وإذا لم يُحدد algId معين، تُرجع الطريقة RNG الافتراضي [SWS_CRYPT_20741].
قيمة الإرجاع:ara::core::Result<RandomGeneratorCtx::Sptr> يحتوي في حالة النجاح على مؤشر مشترك إلى المثيل المنشأ من RandomGeneratorCtx[SWS_CRYPT_20741].
معالجة الأخطاء
لا تطلق الطريقة استثناءات (noexcept) وحُددت بأنها آمنة من الاستثناءات [SWS_CRYPT_20741]. وإذا فشلت العملية، يُرجع ara::core::Result رمز خطأ:
ara::crypto::CryptoErrc::kUnknownIdentifier: يحدث عندما تحتوي وسيطة algId على قيمة غير مدعومة (مع دلالات التراجع) [SWS_CRYPT_20741].
التزامن والقيود
صُنِّفت الطريقة على أنها آمنة بالنسبة للخيوط (thread-safe)، بحيث يُسمح بالاستدعاءات المتوازية عبر نفس المثيل من CryptoProvider[SWS_CRYPT_20741].
أُنشئت ملاحظة الاستخدام هذه تلقائياً وتستند حصرياً إلى بيانات مواصفات AUTOSAR Adaptive R25-11.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: b425000c991dالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم الدالة CreateSignerPrivateCtx للفئة ara::crypto::cryp::CryptoProvider لإنشاء سياق لعمليات التوقيع باستخدام مفتاح خاص ([SWS_CRYPT_20756]).
الاستخدام والمعلمات: يتطلب الاستدعاء تضمين ملف الترويسة ara/crypto/cryp/crypto_provider.h. وتُحدد خوارزمية التوقيع التشفيرية المستهدفة عبر معلمة الإدخال algId. وفي حالة النجاح، تُرجع الدالة عبر نوع الإرجاع ara::core::Result<SignerPrivateCtx::Sptr> مؤشراً ذكياً يشير إلى مثيل السياق المُنشأ ([SWS_CRYPT_20756]). التفسير: نظراً لأن الدالة تُرجع ara::core::Result مباشرةً، فمن المرجح أن يُنفَّذ الاستدعاء بشكل متزامن. سؤال Q-8480f3cf5cef5f49 (مفتوح)
التزامن والأمان: تم تحديد الدالة على أنها آمنة بالنسبة للخيوط (thread-safe) وآمنة من الاستثناءات (exception safe)، وتم التصريح عنها باستخدام noexcept ([SWS_CRYPT_20756]). وبالتالي، يمكن استدعاؤها من سياقات متزامنة دون مزامنة إضافية.
معالجة الأخطاء: في حالة حدوث خطأ، توفر النتيجة رمز خطأ من النوع ara::crypto::CryptoErrc مع دلالات التراجع ([SWS_CRYPT_20756]):
ara::crypto::CryptoErrc::kInvalidArgument: تحدث إذا حددت الوسيطة algId خوارزمية تشفيرية تختلف عن التوقيع باستخدام مفتاح خاص ([SWS_CRYPT_20756]).
ara::crypto::CryptoErrc::kUnknownIdentifier: تحدث إذا احتوت algId على قيمة غير معروفة أو غير مدعومة ([SWS_CRYPT_20756]).
تم إنشاء هذا النص بواسطة ذكاء اصطناعي وهو مخصص كدليل إرشادي. والمستند المرجعي الملزم هو مواصفة AUTOSAR.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: e2de1e3ea197المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُستخدم الطريقة الافتراضية CreateSymmetricCipherCtx للواجهة ara::crypto::cryp::CryptoProvider لإنشاء سياق لعمليات التشفير المتماثل ([SWS_CRYPT_20742]). وتُضمَّن عبر ملف الرأس #include "ara/crypto/cryp/crypto_provider.h" ([SWS_CRYPT_20742]).
تتوقع الدالة كمعلمة إدخال algId من النوع AlgId، والذي يحدد معرف خوارزمية التشفير الهدف المطلوبة ([SWS_CRYPT_20742]). يتم الاستدعاء بشكل متزامن ويُرجع كنتيجة ara::core::Result<SymmetricCipherCtx::Sptr>، والذي يوفر في حالة النجاح مؤشراً ذكياً إلى مثيل السياق المُنشأ حديثاً ([SWS_CRYPT_20742]).
معالجة الأخطاء
إذا فشل الإنشاء، يحتوي ara::core::Result المُعاد على رمز خطأ مطابق ([SWS_CRYPT_20742]):
ara::crypto::CryptoErrc::kUnknownIdentifier: يُبلَّغ عنه مع دلالات التراجع، إذا كانت القيمة الممررة لـ algId تشير إلى خوارزمية غير مدعومة ([SWS_CRYPT_20742]).
التزامن والقيود
أُعلنت الدالة على أنها noexcept وحُددت صراحةً بأنها آمنة من الاستثناءات (exception safe) ([SWS_CRYPT_20742]). بالإضافة إلى ذلك، فإن الاستدعاء آمن بالنسبة للخيوط (thread-safe)، بحيث يُسمح بإنشاء السياقات بشكل متوازٍ عبر نفس مثيل CryptoProvider ([SWS_CRYPT_20742]).
أُنشئت ملاحظة الاستخدام هذه تلقائياً. تستند جميع البيانات حصرياً إلى حالة مواصفات AUTOSAR بالإصدار R25-11.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 81927eb57ee6المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُستخدم الطريقة CreateSymmetricKeyWrapperCtx للفئة ara::crypto::cryp::CryptoProvider لإنشاء سياق لخوارزميات Key-Wrap المتماثلة ([SWS_CRYPT_20743]). يتم تمرير algId كمعلمة إدخال، والتي تحدد خوارزمية التشفير الهدف بشكل فريد ([SWS_CRYPT_20743]). الاستدعاء متزامن ويُرجع في حالة النجاح ara::core::Result، يغلف مؤشراً ذكياً إلى السياق المُنشأ (SymmetricKeyWrapperCtx::Sptr) ([SWS_CRYPT_20743]).
معالجة الأخطاء
إذا فشل الإنشاء، تُرجع الدالة كائن الخطأ داخل ara::core::Result ([SWS_CRYPT_20743]):
ara::crypto::CryptoErrc::kUnknownIdentifier: يتم الإبلاغ عنه عندما تحتوي الوسيطة algId على قيمة غير مدعومة؛ حيث تسري دلالات التراجع ([SWS_CRYPT_20743]).
التزامن والقيود
تم التصريح عن الواجهة كـ noexcept، وتُعتبر آمنة من حيث الاستثناءات (exception safe) وآمنة بالنسبة لمؤشرات الترابط (thread-safe) ([SWS_CRYPT_20743]). وبالتالي يمكن استدعاؤها بأمان من سياقات متزامنة، بشرط أن تكون algId المقدمة مدعومة من قِبل CryptoProvider الأساسي ([SWS_CRYPT_20743]).
تم إنشاء ملاحظة الاستخدام هذه تلقائياً وتستند حصرياً إلى بيانات المواصفة من AUTOSAR R25-11.
Create a signature verification public key context.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 6459db29afbfالمصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام وسياق الاستدعاء
يتم التصريح عن الدالة الافتراضية الصرفة CreateVerifierPublicCtx للفئة ara::crypto::cryp::CryptoProvider عبر ملف الترويسة ara/crypto/cryp/crypto_provider.h[SWS_CRYPT_20757]. وتُستخدم لإنشاء سياق للتحقق من التوقيع باستخدام المفاتيح العامة (التحقق من توقيع المفتاح العام) بشكل متزامن [SWS_CRYPT_20757].
يمرر المستدعي عبر المعلمة algId (من النوع AlgId) مُعرّف خوارزمية التوقيع التشفيرية المطلوبة [SWS_CRYPT_20757]. وفي حالة النجاح، تُرجع الدالة ara::core::Result، والذي يحتوي على مؤشر ذكي يشير إلى سياق التحقق المُنشأ (VerifierPublicCtx::Sptr) [SWS_CRYPT_20757].
معالجة الأخطاء
في حالة حدوث خطأ، تسري دلالات التراجع، وينقل ara::core::Result الناتج رمز خطأ ملائماً [SWS_CRYPT_20757]:
ara::crypto::CryptoErrc::kInvalidArgument: يتم الإبلاغ عنه إذا حددت الوسيطة algId خوارزمية تشفيرية غير مخصصة للتحقق من التوقيع باستخدام المفاتيح العامة [SWS_CRYPT_20757].
ara::crypto::CryptoErrc::kUnknownIdentifier: يتم الإبلاغ عنه إذا تم تمرير مُعرّف غير معروف أو غير مدعوم للمعلمة algId[SWS_CRYPT_20757].
التزامن والقيود
تم التصريح عن الدالة كـ noexcept، وهي آمنة تماماً من الاستثناءات (exception safe) ومحددة صراحةً على أنها آمنة بالنسبة للخيوط (thread-safe) [SWS_CRYPT_20757]. وبالتالي، يُسمح بالاستدعاءات المتوازية من سياقات تنفيذ متعددة دون مزامنة خارجية.
تستند ملاحظة الاستخدام هذه إلى مواصفات إصدار AUTOSAR Adaptive R25-11.
The interface shall format the data referenced by the specified key, securely wrap this payload and serialize the secured payload into the provided output buffer. The format shall be specified implicitly by the AlgId. The formatted payload shall be wrapped according to the specified algId using the kek; if kek is not provided, ExportSecuredKey shall apply a key-encryption-key implictly defined by the algId or the default key-encryption-key of the CryptoProvider.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 7d1aacdfd90aالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُصدّر الطريقة ExportSecuredKey للواجهة ara::crypto::cryp::CryptoProvider كائن مفتاح تشفيري إلى تنسيق مؤمّن ومتسلسل [SWS_CRYPT_20728]. يتم إعداد كائن المفتاح الممرر key وفقًا للتنسيق المحدد ضمنيًا بواسطة algId، ويُغلّف تشفيريًا («wrapped») ويُسلسل إلى ذاكرة التخزين المؤقت للإخراج resultBuffer[SWS_CRYPT_20728]. ومن أجل التغليف، يمكن اختياريًا تمرير مفتاح تشفير المفاتيح (kek)؛ وإذا لم يتم توفير kek، تعتمد الطريقة على KEK محدد ضمنيًا بواسطة algId أو على KEK الافتراضي الخاص بـ CryptoProvider [SWS_CRYPT_20728].
صُنِّفت الدالة على أنها thread-safe وexception safe ورُوِّست بـ noexcept[SWS_CRYPT_20728]. التفسير: بما أن التوقيع يرجع مباشرةً ara::core::Result دون أنواع إرجاع غير متزامنة مثل Futures، فمن المرجح أن تُنفَّذ عملية الحزم والتسلسل بأكملها بشكل متزامن في سياق المتصل. سؤال Q-3fb89afcc9300695 (مفتوح)
عند الاكتمال بنجاح، يُرجع ara::core::Result<std::size_t> المُعاد عدد البايتات المكتوبة في resultBuffer[SWS_CRYPT_20728]. وإذا فشلت العملية، تُطبَّق دلالات التراجع (Rollback) ويُبلَّغ عن أحد الأخطاء التالية [SWS_CRYPT_20728]:
ara::crypto::CryptoErrc::kInvalidArgument: يتعذر حزم كائن المفتاح (مثل الحجم غير صالح أو النوع غير مناسب) أو لم يُمرَّر kek متوقع إلزامي [SWS_CRYPT_20728].
ara::crypto::CryptoErrc::kUsageViolation: الاستخدام المسموح به لـ key أو kek غير متوافق مع الخوارزمية المحددة [SWS_CRYPT_20728].
ara::crypto::CryptoErrc::kIncompatibleArguments: kek الممرر غير متوافق مع خوارزمية التصدير [SWS_CRYPT_20728].
ara::crypto::CryptoErrc::kInsufficientCapacity: المخزن المؤقت للإخراج resultBuffer صغير جداً بالنسبة للنتيجة [SWS_CRYPT_20728].
ara::crypto::CryptoErrc::kBusyResource: أحد الموارد المطلوبة للتصدير مشغول [SWS_CRYPT_20728].
أُنشئ هذا النص بواسطة ذكاء اصطناعي ويستند إلى حالة مواصفات AUTOSAR بالإصدار R25-11.
an output buffer the securely exported key is written to
kek
an optional key-encryption-key to be be used for wrapping the secured payload. Only used if the used algorithm does not determine the used key (e.g., based on configuration).
Generate a new public/private key pair and return the private key. The public key can be retrieved via the function PrivateKey::GetPublicKey() The allowed usage flags of the Public Key are set based on the allowed usage of the PrivateKey: • kAllowDataDecryption --> kAllowDataEncryption • kAllowSigGeneration --> kAllowSigVerification • kAllowKeyAgreement --> kAllowKeyAgreement • kAllowKeyUnwrapping --> kAllowKeyWrapping Additionally, the allowed usage: • kAllowPlaintextExport • kAllowPersist are set for the public key.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: c90dae237830المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُنشئ الدالة GeneratePrivateKey للفئة ara::crypto::cryp::CryptoProvider (المُعلنة في ara/crypto/cryp/crypto_provider.h) بشكل متزامن زوج مفاتيح غير متماثل جديد وتُرجع المفتاح الخاص المُنشأ كـ PrivateKey::Sptr داخل ara::core::Result[SWS_CRYPT_20722]. ولا يتم إرجاع المفتاح العام المقابل مباشرة، بل يمكن استرداده لاحقًا عبر الدالة PrivateKey::GetPublicKey() للمفتاح الناتج [SWS_CRYPT_20722].
عند الاستدعاء، تُحدد المعلمة algId خوارزمية التشفير، بينما تُحدد privateKeyAllowedUsage أنواع التحويل المسموح بها للمفتاح الخاص [SWS_CRYPT_20722]. ويتم تعيين رايات الاستخدام المسموح بها للمفتاح العام استنادًا إلى أذونات المفتاح الخاص على النحو التالي [SWS_CRYPT_20722]:
kAllowDataDecryption يؤدي إلى kAllowDataEncryption
kAllowSigGeneration يؤدي إلى kAllowSigVerification
kAllowKeyAgreement يؤدي إلى kAllowKeyAgreement
kAllowKeyUnwrapping يؤدي إلى kAllowKeyWrapping
بالإضافة إلى ذلك، يتم تعيين رايات الاستخدام kAllowPlaintextExport وkAllowPersist تلقائيًا للمفتاح العام [SWS_CRYPT_20722].
فيما يتعلق بالتزامن والتنفيذ، تم تحديد الدالة على أنها thread-safe وexception-safe [SWS_CRYPT_20722]. وإذا حدث خطأ أثناء إنشاء المفتاح، تتم معالجة النتيجة بدلالات تراجع (Rollback) [SWS_CRYPT_20722]. ويمكن إرجاع أكواد الأخطاء التالية:
ara::crypto::CryptoErrc::kUnknownIdentifier، إذا تم تمرير خوارزمية غير مدعومة لـ algId،
ara::crypto::CryptoErrc::kIncompatibleArguments، إذا كانت رايات privateKeyAllowedUsage المحددة غير متوافقة مع الخوارزمية أو نوع المفتاح المحدد،
ara::crypto::CryptoErrc::kBusyResource، إذا كان التوليد غير ممكن مؤقتًا بسبب انشغال الموارد مؤقتًا [SWS_CRYPT_20722].
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا استنادًا إلى مواصفات AUTOSAR Adaptive R25-11.
virtual ara::core::Result< void > GenerateRandomData (ReadWriteMem Region randomData) noexcept=0;
Fill the provided output data buffer randomData with random data.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 405a308cad1eالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم الطريقة الافتراضية البحتة GenerateRandomData للواجهة ara::crypto::cryp::CryptoProvider لملء نطاق ذاكرة وفره المستدعي ببيانات عشوائية تشفيرية [SWS_CRYPT_30098]. ويوجد التصريح في ملف الترويسة ara/crypto/cryp/crypto_provider.h.
يتم تمرير randomData من النوع ReadWriteMem Region كمعلمة إخراج، والذي يمثل المخزن المؤقت المراد ملؤه ويحدد حجمه عدد بايتات العشوائية المُولدة [SWS_CRYPT_30098]. تفسير: نظرًا لأن الدالة تستخدم مباشرة ara::core::Result<void> كنوع إرجاع وليس كائن Future، فمن المرجح أن يتم توليد البيانات بشكل متزامن وحاجب (blocking) [SWS_CRYPT_30098]. سؤال Q-315c0492dcf7f37d (مفتوح) وتكون قيمة الإرجاع فارغة في حالة النجاح أو تحتوي على رمز خطأ مطابق في حالة الخطأ [SWS_CRYPT_30098].
إذا حدثت مشكلة أثناء التنفيذ، يُطبق أسلوب دلالي للتراجع، بحيث لا تتبقى أي حالات جزئية أو غير صالحة [SWS_CRYPT_30098]. وتتحدد حالات الخطأ التالية:
ara::crypto::CryptoErrc::kBusyResource: يمتلك مولد الأرقام العشوائية (RNG) الأساسي حاليًا إنتروبيا غير كافية ولا يمكنه توفير المقدار المطلوب من بايتات العشوائية [SWS_CRYPT_30098].
ara::crypto::CryptoErrc::kUnsupported: لا يدعم التنفيذ الفعلي لـ CryptoProvider أي مولد أرقام عشوائية قياسي [SWS_CRYPT_30098].
فيما يتعلق بالتزامن والمتانة، تم تحديد الطريقة كـ thread-safe وexception safe[SWS_CRYPT_30098]. وبذلك يمكن لعدة خيوط استدعاء الدالة بالتوازي، ويضمن تحديد noexcept عدم إطلاق أي استثناءات C++ عبر حدود الواجهة.
تم توليد ملاحظة الاستخدام هذه تلقائيًا على أساس مواصفة AUTOSAR.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 202931831493المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تتوفر الدالة الافتراضية الصرفة GenerateSymmetricKey عبر الواجهة ara::crypto::cryp::CryptoProvider (ملف الترويسة #include "ara/crypto/cryp/crypto_provider.h") وتُستخدم لإنشاء مفتاح متماثل جديد [SWS_CRYPT_20721]. ويتوقع الاستدعاء المتزامن كمعامل algId مُعرّف خوارزمية التشفير المتماثل الهدف، وكـ allowedUsage رايات بت تُحدد أنواع التحويل المسموح بها للمفتاح الذي تم إنشاؤه [SWS_CRYPT_20721]. وعند التنفيذ بنجاح، تُرجع الدالة ara::core::Result يحتوي على SymmetricKey::Sptr، أي مؤشر مشترك إلى كائن المفتاح المتماثل المُنشأ حديثًا [SWS_CRYPT_20721].
معالجة الأخطاء
إذا حدث خطأ أثناء إنشاء المفتاح، فإنه يُنقل في ara::core::Result. وتُطبق دلالة التراجع (Rollback) على جميع حالات الخطأ المحددة [SWS_CRYPT_20721]:
ara::crypto::CryptoErrc::kUnknownIdentifier: يُبلّغ عنه إذا تم تمرير قيمة غير مدعومة لـ algId[SWS_CRYPT_20721].
ara::crypto::CryptoErrc::kIncompatibleArguments: يحدث إذا كانت رايات allowedUsage المحددة غير متوافقة مع خوارزمية algId المختارة أو نوع المفتاح [SWS_CRYPT_20721].
ara::crypto::CryptoErrc::kBusyResource: يشير إلى أنه لا يمكن إجراء العملية مؤقتًا بسبب انشغال الموارد مؤقتًا [SWS_CRYPT_20721].
التزامن والقيود
أُعلنت العملية كـ noexcept وتمتلك خاصيتي الأمان من حيث الاستثناءات (exception safe) والأمان الخيطي (thread-safe) [SWS_CRYPT_20721]. ولذلك يمكن استدعاؤها بشكل متزامن من عدة خيوط، مع إمكانية حدوث الخطأ kBusyResource عند الحمل العالي للنظام للإشارة إلى اختناقات مؤقتة [SWS_CRYPT_20721].
تم توليد ملاحظة الاستخدام هذه تلقائياً بناءً على المواصفة.
Get a CryptoProvider specific default set of allowedUsages for the provided AlgId. The returned allowedUsages shall not contain kAllowPlaintextExport, kAllowPersist and kAllowSecuredExport.
Get the current value of the secure counter of this CryptoProvider. The current counter value is guaranteed to be stricly larger than any previously returned counter value.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: cd7a957c648fالمصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تستعلم الطريقة GetSecureCounter() للفئة ara::crypto::cryp::CryptoProvider (المصرح عنها في #include "ara/crypto/cryp/crypto_provider.h") عن قيمة العداد الحالية للعداد المؤمّن لنسخة المزود [SWS_CRYPT_20098]. تعمل الدالة بشكل متزامن ولا تتطلب أي معلمات تمرير [SWS_CRYPT_20098]. في حالة النجاح، تُرجع عبر ara::core::Result<SecureCounter> البنية SecureCounter، والتي تتكون من قيمتين غير موقعتين بحجم 64 بت (LSQW للكلمة الرباعية الأقل أهمية وMSQW للكلمة الرباعية الأكثر أهمية) [SWS_CRYPT_20098]. ويضمن ذلك أن تكون كل قيمة عداد مُرجعة أكبر تمامًا وبشكل صارم من جميع القيم المقدمة سابقًا عبر هذه النسخة [SWS_CRYPT_20098].
إذا تعذر تحديد قيمة العداد، يفشل الاستدعاء ويُرجع رمز خطأ مع دلالات التراجع في كائن النتيجة [SWS_CRYPT_20098]:
ara::crypto::CryptoErrc::kUnsupported: الـ CryptoProvider المحدد لا يدعم عدادًا مؤمّنًا [SWS_CRYPT_20098].
ara::crypto::CryptoErrc::kBusyResource: هناك مورد مطلوب للوصول إلى العداد أو تحديثه مشغول حاليًا [SWS_CRYPT_20098].
فيما يتعلق بالتزامن والمتانة، تم تحديد الدالة على أنها آمنة بالنسبة للخيوط (thread-safe) وتم التصريح عنها على أنها آمنة من الاستثناءات (exception safe) باستخدام noexcept[SWS_CRYPT_20098]. وبالتالي، يُسمح بالاستدعاءات المتوازية من عدة خيوط دون مزامنة خارجية، مع بقاء الرتابة الصارمة لقيم العداد المقدمة مضمونة [SWS_CRYPT_20098].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي وهو بمثابة دليل إرشادي فقط. وتُعتبر المواصفة الرسمية هي الملزمة حصريًا.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 56f03864743dالمصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُستخدم الطريقة ImportPrivateKey للفئة ara::crypto::cryp::CryptoProvider للاستيراد المتزامن لمفتاح خاص متسلسل [SWS_CRYPT_50132]. عند الاستدعاء، يتم تمرير البيانات المفيدة عبر نطاق الذاكرة serialized (ReadOnlyMemRegion)، بالإضافة إلى قيود الاستخدام المطلوبة (allowedUsage) وتنسيق التسلسل (formatId). المعلمة algId اختيارية (ara::core::Optional<AlgId>) ولا يلزم تعيينها إلا إذا كان التنسيق المحدد لا يحدد خصائص المفتاح المطلوبة بشكل فريد بحد ذاته [SWS_CRYPT_50132]. كقيمة إرجاع، تُرجع الدالة ara::core::Result<PrivateKey::Sptr>، والذي يحتوي في حالة النجاح على مؤشر مشترك (shared pointer) إلى كائن المفتاح المُنشأ.
معالجة الأخطاء
في حالة حدوث خطأ، تضمن الطريقة تطبيق دلالات التراجع [SWS_CRYPT_50132]. يمكن إرجاع رموز الخطأ التالية عبر Result:
InvalidArgument: البيانات المتسلسلة في serialized لا تتوافق مع التنسيق المحدد [SWS_CRYPT_50132].
ara::crypto::CryptoErrc::kIncompatibleArguments: المعلمات allowedUsage الممررة غير متوافقة مع algId[SWS_CRYPT_50132].
ara::crypto::CryptoErrc::kUnsupported: الدالة غير مدعومة من المزوّد المحدد [SWS_CRYPT_50132].
ara::crypto::CryptoErrc::kBusyResource: لا يمكن تنفيذ العملية مؤقتًا بسبب انشغال الموارد [SWS_CRYPT_50132].
ara::crypto::CryptoErrc::kUnsupportedFormat: لا يتم دعم formatId لنوع الكائن هذا [SWS_CRYPT_50132].
التزامن والقيود
تم الإعلان عن الواجهة كـ noexcept وتوفر أمان الاستثناءات (exception safe) وأمان الخيوط (thread-safe) [SWS_CRYPT_50132]. وبالتالي يمكن إجراء الاستدعاءات بالتوازي من خيوط مختلفة.
تم توليد هذا النص بواسطة نظام ذكاء اصطناعي استنادًا إلى مواصفة AUTOSAR.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 2c89087292ccالمصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُستخدم الطريقة ImportPublicKey لاستيراد مفتاح عام متسلسل إلى ara::crypto::cryp::CryptoProvider المعني [SWS_CRYPT_20732]. يتم الاستدعاء بشكل متزامن ويُرجع ara::core::Result<PublicKey::Sptr>، والذي يحتوي في حالة النجاح على مؤشر ذكي إلى كائن المفتاح المنشأ [SWS_CRYPT_20732].
serialized: نطاق ذاكرة ReadOnlyMemRegion يوفر البيانات الأولية للمفتاح المتسلسل.
allowedUsage: رايات الاستخدام المسموح بها (AllowedUsageFlags) للمفتاح المستورد.
formatId: معرف تنسيق التسلسل (FormatId).
algId: معرف خوارزمية اختياري (ara::core::Optional<AlgId>). وهو ليس ضرورياً إذا كان تنسيق التسلسل يحدد بالفعل خصائص المفتاح بشكل فريد.
معالجة الأخطاء
إذا حدث خطأ أثناء المعالجة، فإنه يُغلَّف في ara::core::Result المُعاد. تم تحديد رموز الخطأ التالية [SWS_CRYPT_20732]:
InvalidArgument: البيانات الممررة في serialized لا تتوافق مع التنسيق المحدد.
ara::crypto::CryptoErrc::kIncompatibleArguments: رايات الاستخدام allowedUsage غير متوافقة مع algId.
ara::crypto::CryptoErrc::kUnsupportedFormat: formatId المحدد غير مدعوم لنوع الكائن هذا.
ara::crypto::CryptoErrc::kUnsupported: الوظيفة المطلوبة غير مدعومة بواسطة CryptoProvider.
ara::crypto::CryptoErrc::kBusyResource: يتعذر تنفيذ العملية مؤقتاً.
التزامن والأمان
أُعلنت الطريقة على أنها noexcept، وتُعتبر آمنة من الاستثناءات (Exception-safe)، وحُددت وفقاً للمواصفات على أنها آمنة بالنسبة للخيوط (Thread-safe) [SWS_CRYPT_20732]. تتبع حالات الخطأ دلالات تراجع محددة [SWS_CRYPT_20732].
أُنشئ هذا النص بواسطة نظام ذكاء اصطناعي ويستند حصرياً إلى بيانات المواصفات من الإصدار R25-11.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 46a4ead0d7caالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُستخدم الدالة ImportSymmetricKey للواجهة ara::crypto::cryp::CryptoProvider لاستيراد مفتاح متماثل متسلسل [SWS_CRYPT_50014]. وكنتيجة معادة، فإنها تُرجع ara::core::Result<SymmetricKey::Sptr> يوفر مؤشرًا ذكيًا إلى كائن المفتاح الذي تم إنشاؤه حديثًا في حالة النجاح [SWS_CRYPT_50014]. ونظرًا لعدم استخدام نوع إرجاع غير متزامن مثل Future، فمن المرجح أن يتم التنفيذ بشكل متزامن. سؤال Q-720a495b07c4f31d (مفتوح)
algId (ara::core::Optional<AlgId>): معرّف خوارزمية اختياري؛ ولا يُعد مطلوبًا إذا كان تنسيق التسلسل المحدد يحدد بالفعل جميع الخصائص المطلوبة للمفتاح بشكل فريد.
معالجة الأخطاء والشروط الحدية
تم تحديد الدالة كـ thread-safe وexception safe[SWS_CRYPT_50014]. في حالة حدوث خطأ، يضمن التنفيذ دلالات التراجع ويُرجع كود خطأ مطابقًا في ara::core::Result[SWS_CRYPT_50014]:
InvalidArgument: البيانات الثنائية المُمررة في serialized لا تتوافق مع التنسيق المحدد.
ara::crypto::CryptoErrc::kIncompatibleArguments: أعلام allowedUsage المحددة غير متوافقة مع algId المحددة.
ara::crypto::CryptoErrc::kUnsupported: الدالة غير مدعومة من قِبل المثيل الفعلي لـ CryptoProvider.
ara::crypto::CryptoErrc::kUnsupportedFormat: التنسيق المحدد غير مدعوم لنوع المفتاح هذا.
ara::crypto::CryptoErrc::kBusyResource: يتعذر تنفيذ العملية في الوقت الحالي بسبب انشغال الموارد مؤقتًا.
تم إنشاء ملاحظة الاستخدام هذه آليًا بناءً على مواصفة AUTOSAR R25-11.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 933cf21dc7b3المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تحمل الدالة LoadPrivateKey للواجهة ara::crypto::cryp::CryptoProvider مفتاحًا خاصًا من فتحة مفاتيح مُقدّمة ([SWS_CRYPT_20764]). يتم تنفيذ الاستدعاء بشكل متزامن ويقبل كمعلمة مؤشرًا مشتركًا إلى المورد المصدر (keySlot). في حالة النجاح، توفر الدالة مؤشرًا مشتركًا إلى كائن المفتاح المحمل (PrivateKey::Sptr)، والذي يتم إرجاعه داخل ara::core::Result ([SWS_CRYPT_20764]).
معالجة الأخطاء
إذا حدث خطأ أثناء العملية، تسري دلالات التراجع ويحتوي ara::core::Result على رمز خطأ محدد ([SWS_CRYPT_20764]):
ara::crypto::CryptoErrc::kIncompatibleObject: المورد الأساسي ينتمي إلى CryptoProvider آخر غير متوافق أو يحتوي على نوع مفتاح مختلف ([SWS_CRYPT_20764]).
ara::crypto::CryptoErrc::kBusyResource: لا يمكن تنفيذ العملية مؤقتًا ([SWS_CRYPT_20764]).
التزامن والأمان
تصنف المواصفة الدالة على أنها thread-safe وexception safe؛ وقد صُرح عن التوقيع بأنه noexcept ([SWS_CRYPT_20764]). يمكن لعدة خيوط معالجة (threads) استدعاء الطريقة بشكل متوازٍ، ولكن يتعين عليها في حال حدوث تعارضات مؤقتة على الموارد معالجة إمكانية إرجاع kBusyResource.
تم إنشاء ملاحظة الاستخدام هذه تلقائيًا بناءً على المواصفة.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: bd65058963fbالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تحمل الدالة LoadPublicKey للواجهة ara::crypto::cryp::CryptoProvider مفتاحًا عامًا من مساحة تخزين المفاتيح المُقدّمة [SWS_CRYPT_20763]. تتوقع كمعلمة keySlotKeySlot::Sptr، والذي يشير إلى مساحة التخزين التي تحتوي على المفتاح المراد تحميله [SWS_CRYPT_20763]. كقيمة مرجعة، توفر الدالة ara::core::Result<PublicKey::Sptr>، والذي يحتوي في حالة النجاح على مؤشر مشترك إلى كائن المفتاح العام المحمل [SWS_CRYPT_20763]. من المرجح أن يشير التوفير المباشر لقيمة Result إلى سلوك استدعاء متزامن. سؤال Q-e0d2480909b1398a (مفتوح)
معالجة الأخطاء
إذا فشلت عملية التحميل، يحتوي ara::core::Result على رمز خطأ مطابق من النطاق ara::crypto::CryptoErrc، مع تحديد دلالات التراجع لجميع حالات الخطأ المحددة [SWS_CRYPT_20763]:
ara::crypto::CryptoErrc::kEmptyKeySlot: يحدث عندما يكون KeySlot المُمرر فارغًا [SWS_CRYPT_20763].
ara::crypto::CryptoErrc::kIncompatibleObject: يتم إرجاعه إذا كان المورد الأساسي ينتمي إلى CryptoProvider آخر غير متوافق أو يحتوي على نوع مفتاح مختلف [SWS_CRYPT_20763].
ara::crypto::CryptoErrc::kBusyResource: يحدث إذا تعذر تنفيذ العملية مؤقتًا، نظرًا لأن المورد مشغول لسبب آخر [SWS_CRYPT_20763].
التزامن والأمان
تم التصريح عن الدالة بـ noexcept وتحديدها كـ Exception-safe [SWS_CRYPT_20763]. فيما يتعلق بالتزامن، تم تصنيف العملية صراحةً على أنها Thread-safe، مما يجعل الاستدعاءات المتوازية من عدة خيوط معالجة مسموحًا بها [SWS_CRYPT_20763].
تم إنشاء ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي بناءً على المواصفة.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: fa5c0e3150ceالمصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُستخدم الدالة الافتراضية البحتة LoadSymmetricKey للفئة ara::crypto::cryp::CryptoProvider لتحميل مفتاح متماثل من مساحة تخزين مفاتيح مُقدّمة [SWS_CRYPT_20762]. تقبل الدالة كمعلمة مؤشرًا مشتركًا إلى مساحة التخزين المعنية (keySlot) وترجع بشكل متزامن ara::core::Result<SymmetricKey::Sptr>، والذي يوفر عند التنفيذ الناجح مؤشرًا مشتركًا إلى كائن المفتاح المحمل [SWS_CRYPT_20762].
فيما يتعلق بالتزامن وأمان التنفيذ، تم تحديد الدالة كـ thread-safe وكذلك exception safe وتم التصريح عنها بـ noexcept[SWS_CRYPT_20762].
في حالة حدوث خطأ أثناء التحميل، ترجع الدالة عبر كائن النتيجة رموز خطأ محددة من النطاق ara::crypto::CryptoErrc مع دلالات تراجع محددة [SWS_CRYPT_20762]:
ara::crypto::CryptoErrc::kEmptyKeySlot: يحدث عندما يكون KeySlot المُمرر فارغًا [SWS_CRYPT_20762].
ara::crypto::CryptoErrc::kIncompatibleObject: يتم إرجاعه إذا كان المورد الأساسي ينتمي إلى Crypto-Provider آخر غير متوافق أو يحتوي على نوع مفتاح مختلف [SWS_CRYPT_20762].
ara::crypto::CryptoErrc::kBusyResource: يشير إلى أنه لا يمكن تنفيذ العملية مؤقتًا [SWS_CRYPT_20762].
تم إنشاء هذا النص بواسطة نظام ذكاء اصطناعي ويستند حصريًا إلى المواصفة.
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني