يتيح للتطبيقات التحقق من صحة رموز SOVD المميزة بالإضافة إلى توفير عناوين URL الخاصة بالتفويض والرموز المميزة.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 49d1f84283f8المصدرأسئلة مفتوحة (2)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
يتيح للتطبيقات التحقق من صحة رموز SOVD المميزة بالإضافة إلى توفير عناوين URL الخاصة بالتفويض والرموز المميزة.
يخدم الصنف ara::diag::SovdAuthorization التطبيقات في تنفيذ واجهات تفويض SOVD تجاه Diagnostic Server ([SWS_DM_01490]). ويوفر طرقاً لتحديد عناوين URL لإعادة التوجيه لنقاط نهاية التفويض والرموز المميزة وكذلك للتحقق من رموز الوصول المميزة ([SWS_DM_01483]). يجب تنشيط استقبال الرسائل صراحةً بعد إنشاء المثيل باستخدام Offer()، ولا يجوز استخدام كائن المصادقة الممرر بعد توفير نتيجة التحقق من الصحة.
السياق
توفر الفئة ara::diag::SovdAuthorization واجهة التطبيق التكيفية لإتاحة آليات التخويل والمصادقة لـ Service-Oriented Vehicle Diagnostics (SOVD) ([SWS_DM_01490]). وضمن بنية Diagnostics، تتوسط بين Diagnostic Server الخاص بـ Diagnostic Management (DM) ومنطق التخويل الفردي لتطبيق المركبة (SWS Diagnostics §7.3.3.2 «SOVD Request Validation and Verification»). وعندما يستعلم عميل SOVD خارجي عن نقاط نهاية للتحقق من العميل أو لاسترداد الرموز المميزة، يمرر Diagnostic Server هذه الطلبات إلى التطبيق لتحديد عناوين URL الهدف ([SWS_DM_01471]، [SWS_DM_01472]). وفي حالة طلبات التشخيص الواردة التي تحتوي على ترويسة تخويل HTTP، تتحقق الفئة من صلاحية الرمز المميز وتحدد أدوار الوصول المنقولة ([SWS_DM_01470]). ومن المرجح، كتفسير خاص بالتطبيق، أن يتم التحقق الفعلي عبر خادم تخويل (مثل OAuth 2.0) باستخدام بروتوكولات شبكة خارجية، نظراً لأن AUTOSAR توحد قياسياً نقطة التسليم المحلية للتطبيق هنا. سؤال Q-6ce702103e4966c7 (مفتوح)
يتم إنشاء مثيل من ara::diag::SovdAuthorization بشكل صريح عبر المنشئ مع تحديد ara::core::InstanceSpecifier وكذلك نمط التزامن ConcurrencyType ([SWS_DM_01489]). ويجب أن يشير InstanceSpecifier في البيان (manifest) إلى PortPrototype صالح لـ DiagnosticSovdAuthorizationInterface. ويحدد ConcurrencyType (kConcurrent أو kNotConcurrent) ما إذا كان يجب تصميم دوال رد النداء المنفذة في التطبيق لتكون آمنة بالنسبة للخيوط ([SWS_DM_01483]، [SWS_DM_01484]، [SWS_DM_01485]).
بعد الإنشاء، لا يمرر Diagnostic Server الطلبات إلا بعد أن يستدعي التطبيق الدالة Offer() بنجاح ([SWS_DM_01487]). تفسير: يُرجح أن يتم تجاهل الطلبات التي تصل قبل Offer() من قِبل الخادم أو رفضها بخطأ. سؤال Q-84330742a61f91a7 (مفتوح) ولإنهاء تمرير الطلبات، يستدعي التطبيق StopOffer() ([SWS_DM_01486]). وأخيراً، يتم تحرير الكائن عبر الهادم الافتراضي ([SWS_DM_01488]). وتعتبر الاستدعاءات الإدارية SovdAuthorization، Offer، StopOffer والهادم غير آمنة بالنسبة للخيوط.
مسار الاستخدام
أثناء التشغيل، يظهر مسارا تفاعل رئيسيان: توفير عناوين URL لإعادة التوجيه والتحقق من صلاحية رموز الجلسات النشطة المميزة. إذا أرسل عميل SOVD استعلاماً للتحقق من العميل أو لطلب رمز مميز، يستدعي DM الدالة GetAuthorizationUrl() ([SWS_DM_01485]) أو GetTokenUrl() ([SWS_DM_01484]). يقيّم التطبيق queryParameters الممررة وكذلك metaInfo ويعيد عنوان URL الهدف بشكل غير متزامن كـ ara::core::Future<ara::core::String>، وعندئذ يستجيب DM بـ HTTP 307 (Temporary Redirect) ([SWS_DM_01471]، [SWS_DM_01472]).
إذا تضمن طلب SOVD لاحق ترويسة HTTP-Authorization جديدة أو معدلة، يستدعي Diagnostic Server الدالة ValidateAuthorization() ([SWS_DM_01470]، [SWS_DM_01483]). يتحقق التطبيق من صحة token الممرر، ويعين أدوار الأذونات المقابلة للكائن المشار إليه ara::diag::ClientAuthentication ([SWS_DM_01469]) ويعيد ValidateAuthorizationOutput عبر Future. شرط مسبق هام: بمجرد أن يصبح Future متاحاً، لا يُسمح للتطبيق بعد ذلك باستخدام كائن ClientAuthentication المشار إليه ([SWS_DM_01483]). يستخدم DM قيم الإرجاع (فترة الصلاحية validUntil وidentity) لتعيين الطلبات اللاحقة للعميل نفسه دون إعادة فحص ([SWS_DM_01781]، [SWS_DM_01782])، وهو أمر ضروري تحديداً لأقفال موارد SOVD ([SWS_DM_01783]).
تُمثل الأخطاء عبر ara::core::Result أو داخل ara::core::Future المُعاد:
أخطاء التهيئة والنمذجة: إذا فشل إنشاء المثيل، يتم الإبلاغ عن انتهاكات، مثل InstanceSpecifierMappingIntegrityViolation (عنصر نموذج غير صالح)، أو PortInterfaceMappingViolation (نوع واجهة خاطئ)، أو ProcessMappingViolation (مرجع عملية مفقود) أو InstanceSpecifierAlreadyInUseViolation ([SWS_DM_01489]).
أخطاء التقديم عند Offer: يُرجع Offer() في حالة الخطأ DiagOfferErrc::kAlreadyOffered، إذا كانت الخدمة نشطة بالفعل، أو DiagOfferErrc::kConfigurationMismatch، إذا لم يتطابق التكوين مع بيانات DEXT ([SWS_DM_01487]).
أخطاء التحقق من صحة الرمز المميز: إذا تعذر التحقق من صحة رمز مميز، يُرجع ValidateAuthorization() عبر الـ Future DiagSovdErrc::kInvalidAccessToken (رمز مميز غير صالح) أو DiagSovdErrc::kTemporarilyNotAvailable (على سبيل المثال، إذا تعذر الوصول إلى خادم المصادقة للتحقق عبر الإنترنت) ([SWS_DM_01483]).
تحديد عنوان URL: لم يتم تحديد رموز أخطاء قياسية لـ GetAuthorizationUrl() وGetTokenUrl() ([SWS_DM_01484]، [SWS_DM_01485]).
يستند هذا الدليل حصرياً إلى مواصفات إصدار AUTOSAR R25-11.
Get the URL that the SOVD client shall use for authorization. The SOVD client will be redirected to that URL. If OAuth 2.0 is used, this would be the URL to look up the Authorization Server’s authorize endpoint.
Get the URL that the SOVD client shall use to request a token. The SOVD client will be redirected to that URL. If OAuth 2.0 is used, this would be the URL to look up the Authorization Server’s token endpoint.
This function validates the authorization token sent by the SOVD client. The application shall validate the authorization token according to the authorization protocol used in the system and then according to the outcome set the respective roles as authorized in the clientAuthentication that is passed as parameter. If OAuth 2.0 is used, this would implement the validation that is supposed to happen in the Resource Server.
Get the URL that the SOVD client shall use for authorization. The SOVD client will be redirected to that URL. If OAuth 2.0 is used, this would be the URL to look up the Authorization Server’s authorize endpoint.
Get the URL that the SOVD client shall use to request a token. The SOVD client will be redirected to that URL. If OAuth 2.0 is used, this would be the URL to look up the Authorization Server’s token endpoint.
This Offer will enable the DM to forward request messages to this handler.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 0834519262c7المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
تُفعّل الدالة العضو المتزامنة Offer للفئة ara::diag::SovdAuthorization إعادة توجيه رسائل الطلب بواسطة Diagnostic Management (DM) إلى مثيل المعالج المقترن [SWS_DM_01487]. وهي لا تقبل أي معلمات وتُرجع ara::core::Result<void> يؤكد نجاح الاستدعاء أو يُبلغ عن خطأ حدث [SWS_DM_01487].
فيما يتعلق بمعالجة الأخطاء، يُحدد [SWS_DM_01487] رمزي خطأ محددين من DiagOfferErrc مع دلالات التراجع (Rollback):
DiagOfferErrc::kAlreadyOffered: يحدث عندما تكون الخدمة معروضة بالفعل لهذا المثيل [SWS_DM_01487].
DiagOfferErrc::kConfigurationMismatch: يُبلغ عن عدم تطابق التكوين مع بيانات وصف DEXT [SWS_DM_01487].
فيما يتعلق بخصائص التنفيذ، تم الإعلان عن الاستدعاء بأنه آمن من الاستثناءات (exception safe)، ولكنه يُعد غير آمن مؤشريًا (not thread-safe) [SWS_DM_01487]. ولذلك، لا يجوز استدعاء الدالة بشكل متزامن للمثيل نفسه.
في التفاعل مع DM، تتوافق الدالة مع نمط التوفير العام لواجهات تشخيص AUTOSAR Adaptive، كما يُستخدم أيضًا للروتينات العامة أو خدمات DoIP (على سبيل المثال [SWS_DM_00557] أو [SWS_DM_00725] أو [SWS_DM_00809]). وطالما لم يتم تسجيل معالج عبر Offer، فلن يُعيد DM توجيه الطلبات إلى التطبيق أو يخدمها بقيم بديلة محددة مسبقًا [SWS_DM_01487]، [SWS_DM_01525]، [SWS_DM_01527].
تم إنشاء هذا النص بواسطة ذكاء اصطناعي. تستند جميع المعلومات حصريًا إلى مقتطف المواصفة المقدم.
InstanceSpeci- InstanceSpecifier either cannot be resolved in the model in the fierMappingIn- context of your executable, or it refers to a model element other tegrityViolation than a PortPrototype. PortInterfaceMap- A PortPrototype that is referenced by a pingViolation DiagnosticSovdAuthorizationPortMapping needs to be typed by a DiagnosticSovdAuthorizationInterface. ProcessMappingVio- Matching InstanceRef exists, but no matching (modelled) Process lation found that matches the (runtime) process. InstanceSpecifier- Violation message that is sent in case a constructor in the ara AlreadyInUseViola- framework was called with an InstanceSpecifier already in use in tion this process.
Parameter (in)
Parameter
Beschreibung
instanceSpecifier
InstanceSpecifier to a PortPrototype of a DiagnosticSovdAuthorizationInterface service instance in the manifest.
concurrencyType
Specifies if the interface is implemented as thread safe ( kConcurrent) or non-thread safe (kNotConcurrent).
Request a governed re-review of this record. The record is not changed immediately.
This StopOffer will disable the forwarding of request messages from DM.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: c318a30e32adالمصدرأسئلة مفتوحة (1)
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
الاستخدام
تُستخدم الطريقة StopOffer من الفئة ara::diag::SovdAuthorization (ملف الترويسة ara/diag/sovd_authorization.h) لمنع إعادة توجيه طلبات التشخيص الواردة من Diagnostic Management (DM) إلى خدمة التخويل [SWS_DM_01486]. تمتلك الدالة التوقيع void StopOffer() noexcept. ولا تقبل أي معلمات ولا تُرجع أي قيمة إلى المستدعي [SWS_DM_01486].
معالجة الأخطاء والتزامن
تم تحديد الدالة على أنها آمنة من الاستثناءات (exception safe) ولا تطلق أي استثناءات [SWS_DM_01486]. لم يتم توفير أكواد أخطاء محددة أو رسائل خطأ إلى DET أو DEM لهذا الاستدعاء. وفيما يخص التزامن، تم تصنيف الطريقة على أنها غير آمنة لمؤشرات الترابط (not thread-safe) [SWS_DM_01486]. وإذا كانت هناك مؤشرات ترابط متعددة تستخدم سياق المثيل نفسه، فيجب مزامنة الوصول بواسطة التطبيق المستدعي. تفسير: يُرجح أن يحدث الاستدعاء خصوصًا أثناء الإيقاف المنظم للتطبيق أو عند سحب الاستعداد للتخويل مؤقتًا. سؤال Q-6c81f2dc7ee903ca (مفتوح)
تفاعل
يتبع المفهوم نمط التصميم العام للواجهات في تشخيص AUTOSAR Adaptive: تم اختيار التسمية StopOffer استنادًا إلى واجهات الخدمة الخاصة بـ ara::com، ولكنها تمثل تنفيذًا مستقلًا داخل ara::diagAUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 «Monitors». وتوجد دلالات التعطيل نفسها على مستوى الوحدة في العديد من واجهات المنافذ الأخرى، على سبيل المثال في GenericRoutine[SWS_DM_00558]، وAuthentication[SWS_DM_01131]، وCommunicationControl[SWS_DM_00810]، بالإضافة إلى Monitor[SWS_DM_01089].
تم إنشاء ملاحظة الاستخدام هذه آليًا بناءً على مواصفة AUTOSAR AP R25-11.
This function validates the authorization token sent by the SOVD client. The application shall validate the authorization token according to the authorization protocol used in the system and then according to the outcome set the respective roles as authorized in the clientAuthentication that is passed as parameter. If OAuth 2.0 is used, this would implement the validation that is supposed to happen in the Resource Server.
مُولَّد بالذكاء الاصطناعيغير مُراجَعالنموذج: gemini-3.8-flash-medium · الجهد: medium · درجة الحرارة: غير قابل للتحكم · الموجّه: 78d8310937f8المصدر
مترجم من الدليل الألمانيgemini-3.8-flash-low · 2026-10-13 · الأصل الألماني
يستدعي خادم التشخيص الطريقة الافتراضية الصرفة ValidateAuthorization عندما يحتوي طلب من عميل SOVD على ترويسة HTTP Authorization ويكون رمزه المميز غير متحقق من صحته بعد [SWS_DM_01470]. ويتحقق التطبيق من صحة رمز التفويض المميز المُمرر وفقاً للبروتوكول المكوّن في النظام (على سبيل المثال OAuth 2.0 في سياق Resource Server) ويخصص الأدوار المقابلة للعميل [SWS_DM_01483].
token (ara::core::StringView): رمز الوصول المميز المنقول من ترويسة HTTP [SWS_DM_01483].
metaInfo (const MetaInfo&): معلومات وصفية لمنفذ خدمة التشخيص [SWS_DM_01483].
clientAuthentication (ClientAuthentication&): الكائن الذي يعين التطبيق من خلاله الأدوار المصادق عليها لعميل SOVD [SWS_DM_01483]. وبعد تقديم Future المرجع، لا يجوز للتطبيق استخدام هذا المرجع بعد ذلك [SWS_DM_01483].
القيمة المرجعة: ara::core::Future<ValidateAuthorizationOutput>[SWS_DM_01483]. عند التحقق الناجح، يحتوي الهيكل ValidateAuthorizationOutput[SWS_DM_01927] على طابع وقت الصلاحية validUntil[SWS_DM_01820] بالإضافة إلى معرّف العميل identity[SWS_DM_01819].
يعتبر Diagnostic Server الأدوار المخصصة للطلبات ذات الرمز المميز المتطابق مصادقاً عليها حتى الوصول إلى validUntil[SWS_DM_01469] ويتعرف على عميل SOVD مجدداً استناداً إلى الرمز المميز أو الهوية [SWS_DM_01781][SWS_DM_01782]. وتعد إعادة التعرف هذه مطلوبة، من بين أمور أخرى، للعمليات المؤقتة وأقفال SOVD، نظراً لأن العملاء غير المصادق عليهم يُحرمون من الوصول إلى القفل برمز HTTP 401 [SWS_DM_01783].
في حالة الخطأ، يتم حل Future باستخدام DiagSovdErrc::kInvalidAccessToken (رمز مميز غير صالح) أو DiagSovdErrc::kTemporarilyNotAvailable (على سبيل المثال خادم المصادقة غير متاح مؤقتاً) [SWS_DM_01483]. حُددت الدالة بأنها noexcept وآمنة من الاستثناءات؛ أما ما إذا كان يجب أن يكون التنفيذ آمناً بالنسبة للخيوط، فيتم التحكم فيه عبر ConcurrencyType المُمرر في الدالة الإنشائية [SWS_DM_01483].
تم توليد ملاحظة الاستخدام هذه بواسطة ذكاء اصطناعي؛ وتعتبر مواصفة AUTOSAR وحدها ملزمة.
conditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor
Parameter (in)
Parameter
Beschreibung
token
The authorization token sent by the SOVD client in the HTTP Authorization header.
metaInfo
The meta information of a diagnostic service port.
clientAuthentication
Object used by the application to report the authenticated state of the SOVD client. After the returned Future is ready, the referenced object shall not be used any more by the application.
rollback_semantics The request currently can’t be served, e.g. in case the access token currently can’t be verified (e.g. because online verification is needed and the authentication server can’t be reached).
Request a governed re-review of this record. The record is not changed immediately.
gemini-3.8-flash-low· 2026-10-13 · الأصل الألماني