DEENESPTFRRUARHIKOZHNL

نطاق أسماء apext::com::secoc

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

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

تحديد واجهات لإدارة قيم الحداثة ومعالجة الأخطاء لقنوات الاتصال المؤمنة.

يحدد فضاء الأسماء الواجهة الخاصة بالشركة المصنعة لإدارة قيم الحداثة في إطار Secure Onboard Communication (SecOC) لصالح Communication Management في AUTOSAR Adaptive Platform (SWS Communication Management §C.1 «Header: apext/com/secoc/fvm.h»). ويتم التحكم في دورة حياة وتهيئة Freshness Value Manager بالكامل بواسطة إدارة الاتصالات، والتي تستعلم عن قيم الحداثة عند عمليات الإرسال المكونة عبر الواجهة ([SWS_CM_11272]). وفي حالة عدم توفر قيم الحداثة مؤقتًا، تُجرى محاولات إعادة منضبطة حتى حد معين قبل إسقاط الرسائل الخاطئة. وبشكل تكميلي، يوفر فضاء الأسماء نطاق خطأ خاصًا به ورموز خطأ موحدة لتشخيص الأخطاء ومعالجة الاستثناءات.

السياق

يحدد فضاء الأسماء apext::com::secoc واجهات معيارية لتوسيعات المنصة (Platform Extension Interfaces) داخل المجموعة الوظيفية Communication Management (ara::com) في AUTOSAR Adaptive Platform (SWS Communication Management §C.1 «Header: apext/com/secoc/fvm.h»). والهدف من واجهات التوسيع هذه هو تمكين الشركات المصنعة للمعدات الأصلية (OEMs) وموردي المكدسات البرمجية من توفير Freshness Value Manager (FVM) مخصص يقوم بإنشاء وإدارة والتحقق من قيم الحداثة المطلوبة لصد هجمات إعادة التشغيل (Replay Attacks) لصالح Secure Onboard Communication (SecOC).

يتفاعل فضاء الأسماء بشكل أساسي مع ثلاثة أدوار: إدارة الاتصالات (ara::com)، وتعريف الواجهة القياسي (FVM) متضمنًا حوامل البيانات مثل FVContainer ([SWS_CM_11286]، [SWS_CM_11344])، بالإضافة إلى تطبيق FVM المحدد للشركة المصنعة للسيارة أو مورد المكدس. تفسير: يُفترض أن مكتبة FVM المخصصة للشركة المصنعة ترتبط في إطار تكامل النظام كمكتبة ثابتة أو ديناميكية، نظرًا لأن المواصفة تحدد الواجهة الوظيفية ولكنها تترك صيغة التكامل مفتوحة وفقًا لكل مكدس. سؤال Q-256aef3d6698cc3f (مفتوح)

SecOcKontext AraCom Communication Management (ara::com) SecOcExt Platform Extension Interface (apext::com::secoc) AraCom->SecOcExt verwaltet Lebenszyklus ruft FVM::Initialize AraCom->SecOcExt fragt Frische ab (FVM::GetTxFreshness) FvmImpl OEM / Stack-Vendor FVM-Implementierung FvmImpl->SecOcExt implementiert FVM-Interface

مخطط السياق: دمج فضاء الأسماء apext::com::secoc بين Communication Management وتطبيق FVM المحدد من الشركة المصنعة. المصادر: [SWS_CM_11272]، SWS Communication Management §C.1 «Header: apext/com/secoc/fvm.h».

دورة الحياة

تتم إدارة دورة حياة تطبيق FVM بالكامل بواسطة إدارة الاتصالات ara::com ([SWS_CM_11272]). ولا تقوم التطبيقات ونُسخ الخدمة بإنشاء أو إدارة مكون FVM مباشرةً.

يتم التشغيل بشكل حتمي أثناء تهيئة مكدس الاتصالات من خلال استدعاء API المكتبة apext::com::secoc::FVM::Initialize ([SWS_CM_11273]). وإذا تعذر إكمال التهيئة بشكل صحيح من جانب الشركة المصنعة، تشير طبقة FVM إلى حالة الخطأ هذه عبر رمز الخطأ المحدد kFVInitializeFailed ([SWS_CM_11342]). وبعد استدعاء التهيئة الناجح، يظل Freshness Value Manager في حالة التشغيل النشطة ويجيب على الطلبات المتزامنة لقيم حداثة الإرسال والاستقبال.

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

ينقسم مسار الاستخدام العادي إلى تأمين الإرسال والتحقق من استقبال الرسائل:

  • رسائل الإرسال: إذا كانت الرسالة مهيأة للإرسال عبر SecOC، فسيتم التعامل معها كرسالة موثقة ([SWS_CM_11274]). ويتم التأمين بترتيب ثابت بعد اكتمال جميع حسابات حماية E2E ([SWS_CM_11274]). وإذا كان تكوين واجهة الخدمة يحتوي على سمة freshnessValueId، تستدعي إدارة الاتصالات apext::com::secoc::FVM::GetTxFreshness ([SWS_CM_11274]، [SWS_CM_11275]). ويتم توفير قيمة الحداثة في بنية FVContainer، والتي تحتفظ بطول البتات في السمة length وبالقيمة نفسها ([SWS_CM_11286]، [SWS_CM_11344]).
  • آلية إعادة محاولة الإرسال: يحتفظ النظام لكل رسالة مؤمنة بـ Authentication Build Counter ([SWS_CM_11275]). بعد التوليد الناجح، يُعاد تعيين العداد إلى 0. إذا أرجع GetTxFreshness الخطأ القابل للإصلاح kFVNotAvailable أو فشل حساب Authenticator، يُزاد العداد وتُعاد محاولة الإنشاء ([SWS_CM_11275]). وإذا وصل العداد إلى العتبة SecOCAuthenticationBuildAttempts، تُستبعد الرسالة ([SWS_CM_11275]).
  • رسائل الاستقبال: عند ورود رسائل SecOC مع تفعيل التحقق (الخاصية securedRxVerification بقيمة صحيح أو غير معينة)، يُستخرج الـ Authenticator ويتم التحقق من صحة الرسالة قبل فحوصات E2E عن طريق إعادة حساب MAC ([SWS_CM_11276]، SWS Communication Management §8.1 «SecOC secure channel reception»). أما إذا كانت قيمة securedRxVerification مضبوطة على خطأ، فيتم تجاوز التحقق (Bypass) وتُعالج الرسالة دون فحص ([SWS_CM_11372]).
تسلسل تأمين الرسائل أثناء الإرسالCommunication Management (ara::com)FVM (apext::com::secoc)Use Case: حماية E2E والتحضيرإنهاء حساب E2EAuthentic Message bereitstellenUse Case: Frischewert-AbfrageGetTxFreshness(freshnessValueId, ...)altErfolgإرجاع FVContainer مع قيمة الحداثةAuthenticator berechnenSecOC-Nachricht versendenAuthentication Build Counter = 0kFVNotAvailableFehler kFVNotAvailable meldenAuthentication Build Counter inkrementierenWiederholversuch bis Schwellwert

مخطط تسلسلي: تسلسل الاستدعاء وإعادة المحاولة عند تأمين رسالة إرسال باستخدام FVM. المصادر: [SWS_CM_11274]، [SWS_CM_11275].

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

تتم معالجة حالات الخطأ داخل واجهة FVM عبر نطاق الأخطاء الآمن نوعيًا ComSecOcFvmErrorDomain، والذي يمكن استرداد مثيل له عبر GetComSecOcFvmErrorDomain ([SWS_CM_12521]). تم تحديد رموز الخطأ في نوع التعداد ComSecOcFvmErrc ([SWS_CM_11342]):

  • kFVNotAvailable (الرمز 1): قيمة الحداثة المطلوبة غير متاحة مؤقتًا. يشير هذا إلى Communication Management بوجود خطأ قابل للإصلاح، مما يطلق محاولات إعادة الإرسال وفقًا لبروتوكول الإرسال ([SWS_CM_11275]، [SWS_CM_11342]).
  • kFVInitializeFailed (الرمز 2): فشلت تهيئة Freshness Value Manager ([SWS_CM_11342]).

عبر الدالة المساعدة MakeErrorCode ([SWS_CM_12522])، يمكن تغليف رموز الخطأ مع بيانات إضافية خاصة بالشركة المصنعة (SupportDataType) داخل كائنات ara::core::ErrorCode نظامية. وبالنسبة للاستدعاءات المتزامنة الفاشلة في البيئات المعتمدة على الاستثناءات، تتوفر فئة الاستثناء ComSecOcFvmException.

يستند هذا الدليل إلى مواصفة AUTOSAR Adaptive Platform R25-11 (Communication Management). تستند جميع الإقرارات حصريًا إلى مراجع المواصفات والتوثيق المحددة.

خريطة المواضيع

الفئات

4
ComSecOcFvmErrorDomainComSecOcFvmExceptionFVContainerFVM

الدوال

2
GetComSecOcFvmErrorDomainMakeErrorCode

الأنواع والثوابت

1
ComSecOcFvmErrc

مخطط الفئة

Abgerundete Rahmen = Namespace- bzw. Klassen-Scopes; hohle Dreieckspfeile = Vererbung (zeigt zur Basisklasse); graue Boxen = namespace-fremde bzw. externe Basisklassen. Klicken öffnet die jeweilige Klassen- bzw. cppreference-Seite.

G cluster_ns apext::com::secoc napext__com__secoc__ComSecOcFvmErrorDomain ComSecOcFvmErrorDomain next_ara__core__ErrorDomain ara::core::ErrorDomain napext__com__secoc__ComSecOcFvmErrorDomain->next_ara__core__ErrorDomain napext__com__secoc__ComSecOcFvmException ComSecOcFvmException next_ara__core__Exception ara::core::Exception napext__com__secoc__ComSecOcFvmException->next_ara__core__Exception napext__com__secoc__FVContainer «struct» FVContainer napext__com__secoc__FVM FVM

عرض التفاصيل

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

الفئات

ComSecOcFvmErrorDomain فئة

Defines a class representing the SecOc Freshness Value Manager error domain

يرث من ara::core::ErrorDomain

ComSecOcFvmException فئة

Defines a class for exceptions to be thrown by the SecOc Freshness Value Manager

يرث من ara::core::Exception

FVContainer فئة

A container to hold the length of freshness value in bits and the freshness value itself

FVM فئة

A freshness value management interface to be implemented by the OEM/stack vendor

الدوال

GetComSecOcFvmErrorDomain دالة

Returns a reference to the apext::com::secoc::ComSecOcFvmErrorDomain object

constexpr const ara::core::ErrorDomain & GetComSecOcFvmErrorDomain () noexcept;
MakeErrorCode دالة

Creates an instance of ara::core::ErrorCode

constexpr ara::core::ErrorCode MakeErrorCode (apext::com::secoc::Com SecOcFvmErrc errorCode, ara::core::ErrorDomain::SupportDataType data) noexcept;

الأنواع والثوابت

ComSecOcFvmErrc تعداد

Defines the error codes for the apext::com::secoc::ComSecOcFvmErrorDomain

enum class ComSecOcFvmErrc : ara::core::ErrorDomain::CodeType {...};

التعدادات

تعداد ComSecOcFvmErrc [SWS_CM_11342] Upstream: RS_AP_00130

enum class ComSecOcFvmErrc :          ara::core::ErrorDomain::CodeType {...};

Defines the error codes for the apext::com::secoc::ComSecOcFvmErrorDomain

Header-Datei#include "apext/com/secoc/fvm_error_domain.h"
Forwarding-Header#include "apext/com/com_fwd.h"
Scopenamespace apext::com::secoc
SymbolComSecOcFvmErrc
Basistypara::core::ErrorDomain::CodeType

Werte

EnumeratorBeschreibung
kFVNotAvailable=1 Freshness Value not available
kFVInitializeFailed=2 Initialization of Freshness Value Manager failed

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

Record
AUTOSAR/AP/record/SWS_CM_11342
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_11342@rel:R25-11#5b3ed122
Content hash
5b3ed122
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_11342
Status: valid/unmigrated Version: rel:R25-11#7146e1f4 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_CM_11342@rel:R25-11#7146e1f4
Point-in-Time History:
Recorded Revisions (7):
  • R25-11rel:R25-11#50596d252026-09-30
  • R20-11rel:R20-11#9e1f02d92026-10-14
  • R21-11rel:R21-11#9e1f02d92026-10-14
  • R22-11rel:R22-11#e70607272026-10-14
  • R23-11rel:R23-11#0578ae272026-10-14
  • R24-11rel:R24-11#0c1f38782026-10-14
  • R25-11rel:R25-11#7146e1f42026-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

توثيق الدوال الحرة

دالة GetComSecOcFvmErrorDomain [SWS_CM_12521] Upstream: RS_AP_00120, RS_AP_00130

constexpr const ara::core::ErrorDomain & GetComSecOcFvmErrorDomain () noexcept;

Returns a reference to the apext::com::secoc::ComSecOcFvmErrorDomain object

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

الاستخدام

تُستخدم الدالة غير العضو GetComSecOcFvmErrorDomain لجلب مرجع إلى كائن نطاق الأخطاء الخاص بـ Freshness Value Management (FVM) لـ SecOC وفقًا لـ [SWS_CM_12521]. تم تعريف الدالة في مساحة الاسم apext::com::secoc ويجب تضمينها عبر ملف الترويسة apext/com/secoc/fvm_error_domain.h (AUTOSAR_AP_SWS_CommunicationManagement §C.2.2.1.1 «GetComSecOcFvmErrorDomain»). ولا تقبل أية معلمات وتُرجع بشكل متزامن مرجعًا ثابتًا من النوع const ara::core::ErrorDomain & إلى الكائن المفرد (Singleton) apext::com::secoc::ComSecOcFvmErrorDomain.

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

أُعلن عن الدالة على أنها noexcept وحُددت بأنها آمنة تمامًا من الاستثناءات (exception safe) [SWS_CM_12521]. ولا تحدث أية أخطاء تشغيل عند الاستدعاء، ولا يتم طرح استثناءات ولا إنشاء رموز أخطاء. وبدلاً من ذلك، يُستخدم نطاق الخطأ المُرجع كمرجع للمطورين لمطابقة رموز الأخطاء الخاصة بـ FVM بشكل فريد ضمن معالجة أخطاء SecOC.

التزامن والقيود

بصفتها دالة constexpr عديمة الحالة وبدون آثار جانبية، فمن المرجح أن يكون الاستدعاء متزامنًا وقابلاً لمعاودة الدخول دون قيود. سؤال Q-16d96e7f64bca93f (مفتوح) ووفقًا للمواصفة، لا توجد شروط ترتيب أو قيود فيما يتعلق بسياق الاستدعاء [SWS_CM_12521].

تفاعل

يستند التعريف إلى المتطلبين RS_AP_00120 وكذلك RS_AP_00130 [SWS_CM_12521]. وبينما تنص المواصفة أساسًا على مساحة الاسم apext::com::secoc، يرد في موضع آخر أيضًا التحديد ara::com::secoc::GetComSecOcFvmErrorDomain (AUTOSAR_AP_SWS_CommunicationManagement ص. 598)؛ ومن المرجح أن يمثل ذلك تباينًا تحريريًا ضمن إطار توسعات Adaptive. سؤال Q-b49307e7cc69a94b (مفتوح)

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

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

Header-Datei#include "apext/com/secoc/fvm_error_domain.h"
Scopenamespace apext::com::secoc
Exception-Sicherheitexception safe

Rückgabewert

TypBeschreibung
const ara::core::ErrorDomain &Reference to the apext::com::secoc:: ComSecOcFvmErrorDomain object

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

Record
AUTOSAR/AP/record/SWS_CM_12521
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_12521@rel:R25-11#9b5dc9e4
Content hash
9b5dc9e4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_12521
Status: valid/unmigrated Version: rel:R25-11#8e770345 Versionshistorie & Revisions (1 transition, 5 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_CM_12521@rel:R25-11#8e770345
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#61e04edc2026-09-30
  • R22-11rel:R22-11#149eb8902026-10-14
  • R23-11rel:R23-11#2dfcc3f12026-10-14
  • R24-11rel:R24-11#40d4bc762026-10-14
  • R25-11rel:R25-11#8e7703452026-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

دالة MakeErrorCode [SWS_CM_12522] Upstream: RS_AP_00120, RS_AP_00121, RS_AP_00130

constexpr ara::core::ErrorCode MakeErrorCode (apext::com::secoc::Com SecOcFvmErrc errorCode, ara::core::ErrorDomain::SupportDataType data) noexcept;

Creates an instance of ara::core::ErrorCode

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

الاستخدام

تُستخدم الدالة apext::com::secoc::MakeErrorCode لإنشاء مثيل من ara::core::ErrorCode لمجال خطأ Freshness Value Management (SecOC) وفقًا لـ [SWS_CM_12522] (AUTOSAR_AP_SWS_CommunicationManagement §C.2.2.1.2 «MakeErrorCode»). يتم الاستدعاء بشكل متزامن. وتتطلب الدالة كمعلمات كود خطأ errorCode من النوع apext::com::secoc::ComSecOcFvmErrc بالإضافة إلى بيانات إضافية خاصة بالشركة المصنعة data من النوع ara::core::ErrorDomain::SupportDataType [SWS_CM_12522]. وتُرجع كائن ara::core::ErrorCode المُهيأ بالكامل [SWS_CM_12522].

معالجة الأخطاء والتزامن

تم تحديد الدالة على أنها noexcept وexception safe، بحيث يضمن الاستدعاء عدم إطلاق أي استثناءات [SWS_CM_12522]. لم يتم تحديد رسائل خطأ وقت تشغيل معينة مثل DET أو DEM لدالة البناء هذه [SWS_CM_12522]. وبسبب التأهيل constexpr، يُفترض أنه يمكن تنفيذ إنشاء كود الخطأ بالفعل في وقت الترجمة عند تمرير تعبيرات ثابتة. سؤال Q-a96337508ba6ecdd (مفتوح)

تفاعل

تتوفر الدالة عبر ملف الرأس apext/com/secoc/fvm_error_domain.h في مساحة الاسم apext::com::secoc [SWS_CM_12522]. وهي تطابق في بنيتها مصانع أكواد الأخطاء ذات الصلة في إدارة الاتصالات:

إشعار استخدام مُولد تلقائيًا استنادًا إلى مواصفة AUTOSAR R25-11.

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

Header-Datei#include "apext/com/secoc/fvm_error_domain.h"
Scopenamespace apext::com::secoc
Exception-Sicherheitexception safe

Parameter (in)

ParameterBeschreibung
errorCodeError code number.
dataVendor defined data associated with the error

Rückgabewert

TypBeschreibung
ara::core::ErrorCodeAn ara::core::ErrorCode object.

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

Record
AUTOSAR/AP/record/SWS_CM_12522
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CM_12522@rel:R25-11#845f4fb6
Content hash
845f4fb6
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_CommunicationManagement.pdf#nameddest=SWS_CM_12522
Status: valid/unmigrated Version: rel:R25-11#12f48f61 Versionshistorie & Revisions (1 transition, 5 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_CM_12522@rel:R25-11#12f48f61
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#208bfd1b2026-09-30
  • R22-11rel:R22-11#fd00e04d2026-10-14
  • R23-11rel:R23-11#5a8150df2026-10-14
  • R24-11rel:R24-11#2565df5c2026-10-14
  • R25-11rel:R25-11#12f48f612026-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