DEENESPTFRRUARHIKOZHNL

فئة ara::crypto::cryp::SymmetricKey

[SWS_CRYPT_23800] Upstream: RS_CRYPTO_02001, RS_CRYPTO_02403

class SymmetricKey :          public CryptoObject {...};

Symmetric Key interface.

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

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

يغلف مفاتيح التشفير المتماثلة ويتحكم في دورة حياتها عبر مؤشرات ذكية مشتركة.
مُولَّد بالذكاء الاصطناعي غير مُراجَع النموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: f71a58d7ce35 المصدر أسئلة مفتوحة (3)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني

يغلف مفاتيح التشفير المتماثلة ويتحكم في دورة حياتها عبر مؤشرات ذكية مشتركة.

تُستخدم الواجهة ara::crypto::cryp::SymmetricKey في AUTOSAR Adaptive كتجريد لمفاتيح التشفير المتماثلة وترث الخصائص الأساسية من CryptoObject. تدير التطبيقات وسياقات التشفير مثيلات المفاتيح بشكل أساسي عبر نوع المؤشر الذكي المعياري Sptr (std::shared_ptr<SymmetricKey>) وفقًا للترويسة ara/crypto/cryp/cryobj/symmetric_key.h [SWS_CRYPT_23801]. تفسير: يُرجَّح أن يتم إنشاء المثيل عبر إجراءات توليد مخصصة لإدارة المفاتيح، حيث يتم تمرير المفتاح لتهيئة خوارزميات التشفير أو MACs. سؤال Q-f76fecc360d2d3a5 (مفتوح) وكنتيجة أساسية، يحدد عداد مراجع المؤشر المشترك (Shared Pointer) دورة الحياة، بحيث لا يتم تدمير كائن المفتاح المغلف إلا بعد تحرير المرجع الأخير [SWS_CRYPT_23801].

السياق

تشكل الفئة ara::crypto::cryp::SymmetricKey في AUTOSAR Adaptive Platform (الإصدار R25-11، الوحدة crypto) الواجهة المركزية لتمثيل مفاتيح التشفير المتماثلة. كجزء أساسي من النظام الفرعي للتشفير، تغلف الواجهة جميع الخصائص المطلوبة لإجراءات التشفير المتماثل. الفئة مشتقة مباشرة من CryptoObject (class SymmetricKey : public CryptoObject) وتنتظم بذلك في التسلسل الهرمي الموحد للكائنات الخاصة بكيانات التشفير في Adaptive Platform. يتم التصريح عن الواجهة في ملف الترويسة ara/crypto/cryp/cryobj/symmetric_key.h [SWS_CRYPT_23801].

تظهر عادةً سياقات التنفيذ التشفيرية وكذلك مثيلات إدارة المفاتيح كأطراف تفاعل. تعمل الواجهة كحلقة وصل بين إنشاء مادة المفتاح أو توفيرها واستخدامها التشغيلي. تفسير: يُرجَّح أن تُستخدم المفاتيح المتماثلة في المقام الأول في إجراءات التشفير المتماثل (مثل تشفير الكتل أو التشفير الانسيابي) وكذلك في رموز مصادقة الرسائل (MAC)، لتأمين السرية وسلامة البيانات على مستوى المركبة. سؤال (مفتوح) ومن خلال التغليف كـ CryptoObject، يُضمن بقاء مادة المفتاح مفصولة عن التحويل التشفيري الفعلي.

دورة الحياة

ترتبط دورة حياة مثيلات ara::crypto::cryp::SymmetricKey ارتباطًا وثيقًا بأنماط إدارة الذاكرة الحديثة في ++C. وفقًا لـ [SWS_CRYPT_23801]، توفر الفئة الاسم المستعار للنوع Sptr، المحدد كـ using Sptr = std::shared_ptr<SymmetricKey>;. عبر هذا المؤشر الذكي المشترك، تتم إدارة دورة حياة كائن الواجهة بعد المراجع والتحكم فيها بشكل حتمي.

تفسير: يُرجَّح أن يتم الإنشاء الفعلي للمثيلات وتهيئتها في الممارسة العملية عبر مولدات مفاتيح متخصصة، أو إجراءات تحميل، أو مكونات إدارة المفاتيح في مكدس التشفير، نظرًا لأن تعريف الواجهة لا يُظهر أي مُنشئات افتراضية عامة لإنشاء مثيلات مباشرة للمفاتيح الخام. سؤال Q-51acf16b99d9ad1b (مفتوح) بمجرد إنشاء مثيل مفتاح كـ Sptr، يمكن إسناده من قِبل عدة مكونات برمجية أو سياقات تشفيرية بشكل متزامن وبملكية مشتركة [SWS_CRYPT_23801].

يتم تحرير الموارد الأساسية تلقائيًا بمجرد تدمير آخر Sptr نشط أو إعادة تعيينه. تفسير: يشير الاشتقاق من CryptoObject إلى أنه يُحتمل أن تكون مادة المفتاح الحساسة محمية بشكل خاص في الذاكرة وممسوحة بشكل آمن (Zeroization) عند تدمير الكائن، وذلك لمنع قراءتها بعد انتهاء دورة حياتها. سؤال (مفتوح) يضمن استخدام std::shared_ptr بالإضافة إلى ذلك أمان مؤشرات الترابط (Thread-Safety) عند إدارة عدادات المراجع، بينما يخضع الوصول إلى كائن المفتاح المشار إليه نفسه لقواعد المزامنة المعتادة للموارد المشتركة.

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

يتبع الاستخدام المنتظم لـ ara::crypto::cryp::SymmetricKey في تطبيق Adaptive مسارًا منظمًا يعتمد على المؤشر الذكي المحدد [SWS_CRYPT_23801]:

  • تضمين ملف الرأس: تقوم المكونة البرمجية المستخدمة أولاً بتضمين ملف الرأس #include "ara/crypto/cryp/cryobj/symmetric_key.h" للحصول على حق الوصول إلى تعريف النوع والاسم المستعار Sptr [SWS_CRYPT_23801].
  • الحصول على المفتاح: يحصل التطبيق على الواجهة في شكل ara::crypto::cryp::SymmetricKey::Sptr [SWS_CRYPT_23801]، على سبيل المثال من عملية سابقة لتوفير المفاتيح.
  • التحقق من الصلاحية: قبل الاستخدام التشغيلي، يتحقق المتصل من أن Sptr المستلم لا يساوي nullptr وأنه يشير إلى CryptoObject سليم.
  • التعيين لسياقات التشفير: يتم تمرير مؤشر المفتاح إلى سياق التشفير المختص لتهيئته لعمليات التشفير أو فك التشفير الوشيكة أو عمليات التحقق من السلامة.
  • التحرير: بعد اكتمال التحويلات أو عند إنهاء سياق التطبيق، يتم التخلص من المؤشر؛ ويتم تدمير المفتاح من خلال الحذف التلقائي لآخر Sptr [SWS_CRYPT_23801].

يستند هذا الدليل إلى مواصفة AUTOSAR Adaptive Platform الإصدار R25-11. وتعتمد البيانات على عناصر المواصفة المشار إليها بالإضافة إلى التفسيرات المحددة على هذا النحو.

مخطط الفئات UML

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

G nara__crypto__cryp__SymmetricKey111 SymmetricKey nara__crypto__cryp__CryptoObject679 CryptoObject nara__crypto__cryp__SymmetricKey111->nara__crypto__cryp__CryptoObject679 nara__crypto__Serializable855 Serializable nara__crypto__cryp__CryptoObject679->nara__crypto__Serializable855

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

Sptr اسم نوع بديل

Shared smart pointer of the interface.

using Sptr = std::shared_ptr<SymmetricKey>;

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

اسم نوع بديل Sptr [SWS_CRYPT_23801] Upstream: RS_CRYPTO_02201

using Sptr = std::shared_ptr<SymmetricKey>;

Shared smart pointer of the interface.

Header-Datei#include "ara/crypto/cryp/cryobj/symmetric_key.h"
Scopeclass ara::crypto::cryp::SymmetricKey
SymbolSptr

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

Record
AUTOSAR/AP/record/SWS_CRYPT_23801
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_23801@rel:R25-11#c8beeaad
Content hash
c8beeaad
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_23801
Status: valid/unmigrated Version: rel:R25-11#882653b8 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_23801@rel:R25-11#882653b8
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#d033faab2026-09-30
  • R19-11rel:R19-11#a0669f0d2026-10-14
  • R20-11rel:R20-11#c490e0a52026-10-14
  • R21-11rel:R21-11#c490e0a52026-10-14
  • R22-11rel:R22-11#b634ae6e2026-10-14
  • R23-11rel:R23-11#cb129b992026-10-14
  • R24-11rel:R24-11#cb129b992026-10-14
  • R25-11rel:R25-11#882653b82026-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