DEENESPTFRRUARHIKOZHNL

क्लास ara::diag::SovdAuthorization

[SWS_DM_01490] Upstream: RS_Diag_04268

class SovdAuthorization {...};

Class to implement the SOVD Authorization interfaces in the application.

Header-Datei#include "ara/diag/sovd_authorization.h"
Forwarding-Header#include "ara/diag/diag_fwd.h"
Scopenamespace ara::diag

उपयोगकर्ता गाइडएआई जनित

ऐप्लिकेशन्स को SOVD टोकन्स को मान्य करने के साथ-साथ प्राधिकरण और टोकन URL प्रदान करने में सक्षम बनाता है।
एआई-जनित असत्यापित मॉडल: gemini-3.8-flash-medium · प्रयास: medium · तापमान: नियंत्रित नहीं किया जा सकता · प्रॉम्प्ट: 49d1f84283f8 उद्गम खुले प्रश्न (2)
जर्मन मार्गदर्शिका से अनूदितgemini-3.8-flash-low · 2026-10-13 · जर्मन मूल

ऐप्लिकेशन्स को SOVD टोकन्स को मान्य करने के साथ-साथ प्राधिकरण और टोकन URL प्रदान करने में सक्षम बनाता है।

वर्ग ara::diag::SovdAuthorization का उपयोग अनुप्रयोगों द्वारा Diagnostic Server ([SWS_DM_01490]) के प्रति SOVD प्राधिकरण इंटरफ़ेस लागू करने के लिए किया जाता है। यह प्राधिकरण और टोकन एंडपॉइंट्स के लिए पुनर्निर्देशन URLs निर्धारित करने के साथ-साथ एक्सेस टोकन के सत्यापन के लिए विधियाँ प्रदान करता है ([SWS_DM_01483])। इंस्टेंटिएशन के बाद Offer() के साथ संदेश प्राप्ति को स्पष्ट रूप से सक्रिय किया जाना चाहिए, और सत्यापन परिणाम प्रदान किए जाने के बाद पास की गई प्रमाणीकरण वस्तु का पुनः उपयोग नहीं किया जाना चाहिए।

संदर्भ

वर्ग ara::diag::SovdAuthorization Service-Oriented Vehicle Diagnostics (SOVD) के लिए प्राधिकरण और प्रमाणीकरण तंत्र प्रदान करने हेतु एडेप्टिव अनुप्रयोग इंटरफ़ेस उपलब्ध कराता है ([SWS_DM_01490])। निदान आर्किटेक्चर के भीतर, यह Diagnostic Management (DM) के Diagnostic Server और वाहन अनुप्रयोग के व्यक्तिगत प्राधिकरण तर्क के बीच मध्यस्थता करता है (SWS Diagnostics §7.3.3.2 “SOVD Request Validation and Verification”)। जब कोई बाहरी SOVD क्लाइंट क्लाइंट सत्यापन या टोकन पुनर्प्राप्ति के लिए एंडपॉइंट्स की क्वेरी करता है, तो Diagnostic Server लक्ष्य URLs निर्धारित करने के लिए इन अनुरोधों को अनुप्रयोग को अग्रेषित करता है ([SWS_DM_01471], [SWS_DM_01472])। HTTP प्राधिकरण हेडर वाले आने वाले निदान अनुरोधों के लिए, यह वर्ग टोकन की वैधता की जाँच करता है और सौंपी गई एक्सेस भूमिकाओं को परिभाषित करता है ([SWS_DM_01470])। किसी प्राधिकरण सर्वर (जैसे OAuth 2.0) के विरुद्ध वास्तविक सत्यापन बाहरी नेटवर्क प्रोटोकॉल के माध्यम से अनुप्रयोग-विशिष्ट व्याख्या के रूप में होने की संभावना है, क्योंकि AUTOSAR यहाँ स्थानीय अनुप्रयोग हैंडओवर बिंदु का मानकीकरण करता है। प्रश्न Q-6ce702103e4966c7 (खुला)

SovdAuthContext client SOVD-Client dm Diagnostic Server (DM) client->dm SOVD-Request dm->client HTTP 307 / SOVD-Response handler SovdAuthorization (Anwendung) dm->handler Get*Url() / ValidateAuthorization() authserver Autorisierungs-Server (extern/OAuth 2.0) handler->authserver Token-Validierung (Interpretation)

संदर्भ आरेख: SOVD क्लाइंट, Diagnostic Server (DM), SovdAuthorization और बाहरी प्राधिकरण सेवा के बीच परस्पर क्रिया। स्रोत: [SWS_DM_01470], [SWS_DM_01471], [SWS_DM_01472], SWS Diagnostics §7.3.3.2.1 “SOVD – Authorization”

जीवनचक्र

ara::diag::SovdAuthorization का इंस्टेंटिएशन स्पष्ट रूप से कंस्ट्रक्टर के माध्यम से ara::core::InstanceSpecifier और समवर्ती मोड ConcurrencyType निर्दिष्ट करके किया जाता है ([SWS_DM_01489])। InstanceSpecifier को मैनिफ़ेस्ट में DiagnosticSovdAuthorizationInterface के एक वैध PortPrototype को संदर्भित करना चाहिए। 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 और डिस्ट्रक्टर थ्रेड-सुरक्षित नहीं हैं।

उपयोग पथ

चल रहे संचालन के दौरान दो मुख्य इंटरैक्शन पथ होते हैं: पुनर्निर्देशन URLs का प्रावधान और सक्रिय सत्र टोकन का सत्यापन। यदि कोई 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]) और Future के माध्यम से एक ValidateAuthorizationOutput लौटाता है। महत्वपूर्ण पूर्वशर्त: जैसे ही Future उपलब्ध हो जाता है, अनुप्रयोग को संदर्भित ClientAuthentication ऑब्जेक्ट का पुनः उपयोग नहीं करना चाहिए ([SWS_DM_01483])। DM उसी क्लाइंट के बाद के अनुरोधों को पुनः जाँच किए बिना मैप करने के लिए रिटर्न मानों (वैधता अवधि validUntil और identity) का उपयोग करता है ([SWS_DM_01781], [SWS_DM_01782]), जो विशेष रूप से SOVD संसाधन लॉक्स के लिए आवश्यक है ([SWS_DM_01783])।

SOVD टोकन सत्यापन का अनुक्रमSOVD-ClientDiagnostic Server (DM)SovdAuthorizationClientAuthenticationAuthorization हेडर के साथ SOVD अनुरोधValidateAuthorization(token, metaInfo, clientAuth)टोकन को आंतरिक रूप से या ऑनलाइन सत्यापित करनाRollen als autorisiert setzenFuture ready: ValidateAuthorizationOutputक्लाइंट की पुनः पहचान करना & भूमिकाएं ग्रहण करनाHTTP 200 OK / संसाधन एक्सेस स्वीकृत

अनुक्रम आरेख: ValidateAuthorization और भूमिका असाइनमेंट के माध्यम से टोकन सत्यापन का प्रवाह। स्रोत: [SWS_DM_01469], [SWS_DM_01470], [SWS_DM_01483], SWS Diagnostics §7.3.3.2.1 “SOVD – Authorization”

त्रुटि परिदृश्य

त्रुटियों को 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 के विनिर्देशों पर आधारित है।

सदस्य मानचित्र

कंस्ट्रक्टर और डिस्ट्रक्टर

2

नेस्टेड टाइप

1

क्लास आरेख

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

G nara__diag__SovdAuthorization23 SovdAuthorization + ~SovdAuthorization() + SovdAuthorization() + GetAuthorizationUrl() + GetTokenUrl() + Offer() + StopOffer() + ValidateAuthorization()

विवरण दृश्य

रूपरेखा में कोई प्रविष्टि चुनें।

कंस्ट्रक्टर और डिस्ट्रक्टर

SovdAuthorization फ़ंक्शन

Constructs the port for SOVD Authorization interface.

explicit SovdAuthorization (ara::core::InstanceSpecifier instance Specifier, ConcurrencyType concurrencyType) noexcept;
~SovdAuthorization फ़ंक्शन

Destructor of SovdAuthorization.

virtual ~SovdAuthorization () noexcept;

मेथड

GetAuthorizationUrl फ़ंक्शन

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.

virtual ara::core::Future< ara::core::String > GetAuthorizationUrl (const ara::core::Map< const ara::core::StringView, const ara::core::Vector< const ara::core::StringView > > &queryParameters, const MetaInfo &metaInfo) noexcept=0;
GetTokenUrl फ़ंक्शन

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.

virtual ara::core::Future< ara::core::String > GetTokenUrl (const ara::core::Map< const ara::core::StringView, const ara::core::Vector< const ara::core::StringView > > &queryParameters, const MetaInfo &meta Info) noexcept=0;
Offer फ़ंक्शन

This Offer will enable the DM to forward request messages to this handler.

ara::core::Result< void > Offer () noexcept;
StopOffer फ़ंक्शन

This StopOffer will disable the forwarding of request messages from DM.

void StopOffer () noexcept;
ValidateAuthorization फ़ंक्शन

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.

virtual ara::core::Future< ValidateAuthorizationOutput > Validate Authorization (ara::core::StringView token, const MetaInfo &metaInfo, ClientAuthentication &clientAuthentication) noexcept=0;

नेस्टेड टाइप

मेथड का प्रलेखन

फ़ंक्शन GetAuthorizationUrl [SWS_DM_01485] Upstream: RS_Diag_04268

virtual ara::core::Future< ara::core::String > GetAuthorizationUrl (const ara::core::Map< const ara::core::StringView, const ara::core::Vector< const ara::core::StringView > > &queryParameters, const MetaInfo &metaInfo) noexcept=0;

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.

Header-Datei#include "ara/diag/sovd_authorization.h"
Scopeclass ara::diag::SovdAuthorization
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
queryParametersThe query parameters passed in the request.
metaInfoThe meta information of a diagnostic service port.

Rückgabewert

TypBeschreibung
ara::core::Future<ara::core::String >Returns the URL, that the SOVD client shall use for authorization.

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.

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

Record
AUTOSAR/AP/record/SWS_DM_01485
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01485@rel:R25-11#db27aab7
Content hash
db27aab7
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01485
Status: valid/unmigrated Version: rel:R25-11#d45641ff 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_DM_01485@rel:R25-11#d45641ff
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#8d714d092026-09-30
  • R22-11rel:R22-11#16824a3e2026-10-14
  • R23-11rel:R23-11#76cd545a2026-10-14
  • R24-11rel:R24-11#6525fcf82026-10-14
  • R25-11rel:R25-11#d45641ff2026-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

फ़ंक्शन GetTokenUrl [SWS_DM_01484] Upstream: RS_Diag_04268

virtual ara::core::Future< ara::core::String > GetTokenUrl (const ara::core::Map< const ara::core::StringView, const ara::core::Vector< const ara::core::StringView > > &queryParameters, const MetaInfo &meta Info) noexcept=0;

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.

Header-Datei#include "ara/diag/sovd_authorization.h"
Scopeclass ara::diag::SovdAuthorization
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
queryParametersThe query parameters passed in the request.
metaInfoThe meta information of a diagnostic service port.

Rückgabewert

TypBeschreibung
ara::core::Future<ara::core::String >Returns the URL that the SOVD client shall use to request a token.

Fehler

FehlercodeBeschreibung
This function does not specify any standardized errors.

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

Record
AUTOSAR/AP/record/SWS_DM_01484
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01484@rel:R25-11#730f21d3
Content hash
730f21d3
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01484
Status: valid/unmigrated Version: rel:R25-11#f6a201d9 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_DM_01484@rel:R25-11#f6a201d9
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#7e533d902026-09-30
  • R22-11rel:R22-11#17e901a02026-10-14
  • R23-11rel:R23-11#42f1bade2026-10-14
  • R24-11rel:R24-11#a069b6f52026-10-14
  • R25-11rel:R25-11#f6a201d92026-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

फ़ंक्शन Offer [SWS_DM_01487] Upstream: RS_Diag_04268

ara::core::Result< void > Offer () noexcept;

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 · जर्मन मूल

क्लास ara::diag::SovdAuthorization का सिंक्रोनस मेंबर फ़ंक्शन Offer संबंधित हैंडलर इंस्टेंस को Diagnostic Management (DM) द्वारा अनुरोध संदेशों के अग्रेषण को सक्रिय करता है [SWS_DM_01487]। यह कोई पैरामीटर स्वीकार नहीं करता है और एक ara::core::Result<void> लौटाता है, जो सफल कॉल की पुष्टि करता है या हुई किसी त्रुटि की रिपोर्ट करता है [SWS_DM_01487]।

त्रुटि प्रबंधन के संबंध में, [SWS_DM_01487] रोलबैक सिमेंटिक्स के साथ DiagOfferErrc से दो ठोस त्रुटि कोड निर्दिष्ट करता है:

  • 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] के साथ संभालता है।

यह पाठ एक AI द्वारा तैयार किया गया था। सभी विवरण विशेष रूप से प्रदान किए गए विनिर्देश अंश पर आधारित हैं।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

Header-Datei#include "ara/diag/sovd_authorization.h"
Scopeclass ara::diag::SovdAuthorization
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< void >Returns nothing or an error.

Fehler

FehlercodeBeschreibung
DiagOfferErrc::kAlreadyOfferedrollback_semantics The service is already offered.
DiagOfferErrc::kConfigurationMismatchrollback_semantics monitor configuration does not match DEXT

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

Record
AUTOSAR/AP/record/SWS_DM_01487
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01487@rel:R25-11#b486b5bf
Content hash
b486b5bf
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01487
Status: valid/unmigrated Version: rel:R25-11#a9605b85 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_DM_01487@rel:R25-11#a9605b85
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#1ee581c62026-09-30
  • R22-11rel:R22-11#d1dad9c62026-10-14
  • R23-11rel:R23-11#853e9a012026-10-14
  • R24-11rel:R24-11#59ae33f32026-10-14
  • R25-11rel:R25-11#a9605b852026-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

फ़ंक्शन SovdAuthorization [SWS_DM_01489] Upstream: RS_Diag_04268, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

explicit SovdAuthorization (ara::core::InstanceSpecifier instance Specifier, ConcurrencyType concurrencyType) noexcept;

Constructs the port for SOVD Authorization interface.

Header-Datei#include "ara/diag/sovd_authorization.h"
Scopeclass ara::diag::SovdAuthorization
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe
Verletzungen (Violations)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)

ParameterBeschreibung
instanceSpecifierInstanceSpecifier to a PortPrototype of a DiagnosticSovdAuthorizationInterface service instance in the manifest.
concurrencyTypeSpecifies 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.

Record
AUTOSAR/AP/record/SWS_DM_01489
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01489@rel:R25-11#d9b5ed2c
Content hash
d9b5ed2c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01489
Status: valid/unmigrated Version: rel:R25-11#c9585cf9 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_DM_01489@rel:R25-11#c9585cf9
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#af23d0c72026-09-30
  • R22-11rel:R22-11#45eb7d512026-10-14
  • R23-11rel:R23-11#97066c872026-10-14
  • R24-11rel:R24-11#07afb8a72026-10-14
  • R25-11rel:R25-11#c9585cf92026-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

फ़ंक्शन StopOffer [SWS_DM_01486] Upstream: RS_Diag_04268

void StopOffer () noexcept;

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 · जर्मन मूल

उपयोग

क्लास ara::diag::SovdAuthorization (हेडर ara/diag/sovd_authorization.h) का मेथड StopOffer 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::diag के भीतर एक स्वतंत्र कार्यान्वयन का प्रतिनिधित्व करता है AUTOSAR_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 के विनिर्देश के आधार पर स्वचालित रूप से जनरेट किया गया था।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I2)

Header-Datei#include "ara/diag/sovd_authorization.h"
Scopeclass ara::diag::SovdAuthorization
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

Rückgabewert

TypBeschreibung
None

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

Record
AUTOSAR/AP/record/SWS_DM_01486
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01486@rel:R25-11#40f65f2d
Content hash
40f65f2d
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01486
Status: valid/unmigrated Version: rel:R25-11#9bb7ae44 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_DM_01486@rel:R25-11#9bb7ae44
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#30189eb12026-09-30
  • R22-11rel:R22-11#14fbd18b2026-10-14
  • R23-11rel:R23-11#31cc13ad2026-10-14
  • R24-11rel:R24-11#ac3ee7ea2026-10-14
  • R25-11rel:R25-11#9bb7ae442026-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

फ़ंक्शन ValidateAuthorization [SWS_DM_01483] Upstream: RS_Diag_04268

virtual ara::core::Future< ValidateAuthorizationOutput > Validate Authorization (ara::core::StringView token, const MetaInfo &metaInfo, ClientAuthentication &clientAuthentication) noexcept=0;

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 क्लाइंट के अनुरोध में एक Authorization HTTP हेडर होता है और उसका टोकन अभी तक मान्य रूप से सत्यापित नहीं हुआ होता है [SWS_DM_01470]। एप्लिकेशन सिस्टम में कॉन्फ़िगर किए गए प्रोटोकॉल (उदाहरण के लिए Resource Server के संदर्भ में OAuth 2.0) के अनुसार पास किए गए ऑथराइजेशन टोकन की जाँच करता है और क्लाइंट को संबंधित भूमिकाएँ सौंपता है [SWS_DM_01483]।

इंटरफ़ेस विनिर्देश में निम्नलिखित पैरामीटर और रिटर्न शामिल हैं SWS Diagnostics §8.52.1.1.3.5 “ValidateAuthorization”:

  • 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]।

यह उपयोग नोट एक AI द्वारा जनरेट किया गया था; केवल AUTOSAR विनिर्देश ही बाध्यकारी है।

इम्प्लीमेंटर गाइड जल्द आएगी (जटिलता I1)

Header-Datei#include "ara/diag/sovd_authorization.h"
Scopeclass ara::diag::SovdAuthorization
Exception-Sicherheitexception safe
Thread-Sicherheitconditional whether the function has to be implemented thread safe or non-thread safe is determined by the ConcurrencyType given in the constructor

Parameter (in)

ParameterBeschreibung
tokenThe authorization token sent by the SOVD client in the HTTP Authorization header.
metaInfoThe meta information of a diagnostic service port.
clientAuthenticationObject 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.

Rückgabewert

TypBeschreibung
ara::core::Future<ValidateAuthorizationOutput >Either ValidateAuthorizationOutput (for a successful validation) or an error code.

Fehler

FehlercodeBeschreibung
DiagSovdErrc::kInvalidAccessTokenrollback_semantics The access token provided by the client is invalid.
DiagSovdErrc::kTemporarilyNotAvailablerollback_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.

Record
AUTOSAR/AP/record/SWS_DM_01483
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01483@rel:R25-11#db9aef53
Content hash
db9aef53
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01483
Status: valid/unmigrated Version: rel:R25-11#3ab745cf 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_DM_01483@rel:R25-11#3ab745cf
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#8a2fbb692026-09-30
  • R22-11rel:R22-11#600c614a2026-10-14
  • R23-11rel:R23-11#0433454d2026-10-14
  • R24-11rel:R24-11#7b10afcc2026-10-14
  • R25-11rel:R25-11#3ab745cf2026-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

फ़ंक्शन ~SovdAuthorization [SWS_DM_01488] Upstream: RS_Diag_04268

virtual ~SovdAuthorization () noexcept;

Destructor of SovdAuthorization.

Header-Datei#include "ara/diag/sovd_authorization.h"
Scopeclass ara::diag::SovdAuthorization
Exception-Sicherheitexception safe
Thread-Sicherheitnot thread-safe

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

Record
AUTOSAR/AP/record/SWS_DM_01488
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01488@rel:R25-11#6baa3c3c
Content hash
6baa3c3c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01488
Status: valid/unmigrated Version: rel:R25-11#4b141c27 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_DM_01488@rel:R25-11#4b141c27
Point-in-Time History:
Recorded Revisions (5):
  • R25-11rel:R25-11#3e0dc97d2026-09-30
  • R22-11rel:R22-11#a7d4ac032026-10-14
  • R23-11rel:R23-11#b65bc1cb2026-10-14
  • R24-11rel:R24-11#05fce8112026-10-14
  • R25-11rel:R25-11#4b141c272026-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