DEENESPTFRRUARHIKOZHNL

klasse ara::diag::SecurityAccess

[SWS_DM_00761] Upstream: RS_Diag_04005

class SecurityAccess {...};

DiagnosticSecurityAccessInterface.

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

User GuideAI-GEGENEREERD

Dient voor het beschikbaar stellen en valideren van seed- en sleutelwaarden voor diagnostische beveiligingstoegangen.
DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 1943cee6c64f Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Dient voor het beschikbaar stellen en valideren van seed- en sleutelwaarden voor diagnostische beveiligingstoegangen.

De klasse ara::diag::SecurityAccess dient voor de applicatiespecifieke implementatie van diagnostische beveiligingstoegangen conform UDS-service 0x27 ([SWS_DM_00762]). Na activering via Offer() ontvangt de handler verzoeken tot het beschikbaar stellen van de seed en valideert deze doorgegeven sleutelwaarden asynchroon ([SWS_DM_00766]). Als niet-kopieerbare en niet-verplaatsbare instantie vereist de interface een expliciete configuratie van het concurrency-gedrag in de constructor, terwijl verwerkingsfouten via gestandaardiseerde UDS-retourcodes aan het diagnosesysteem worden gemeld ([SWS_DM_00765]).

Context

De klasse ara::diag::SecurityAccess vormt in AUTOSAR Adaptive de interface voor de implementatie van de UDS-service 0x27 (SecurityAccess). Deze fungeert als schakel tussen het interne Diagnostic Management (DM) en de applicatiespecifieke authenticatielogica van een adaptieve applicatie. Wanneer een externe diagnosetester een veiligheidsrelevante diagnoseoperatie aanvraagt, verstuurt deze overeenkomstige diagnoseberichten conform ISO 14229-1 naar het voertuig (AUTOSAR_AP_SWS_Diagnostics §4.1 “Limitations of sub-functions of 0x19 ReadDTCInformation”). Het Diagnostic Management ontvangt deze verzoeken en stuurt het seed-verzoek evenals de sleutelvergelijking door naar de geregistreerde instantie van ara::diag::SecurityAccess ([SWS_DM_00766]).

SecurityAccessKontext client Diagnose-Client dm Diagnostic Management (DM) client->dm UDS-Service 0x27 secacc ara::diag::SecurityAccess dm->secacc Weiterleitung app Adaptive Applikation secacc->app Vererbung / Handler

Contextdiagram: inpassing van ara::diag::SecurityAccess tussen diagnosetester, Diagnostic Management en applicatie. Bronnen: [SWS_DM_00762], [SWS_DM_00766], AUTOSAR_AP_SWS_Diagnostics §4.1 “Limitations of sub-functions of 0x19 ReadDTCInformation”

Levenscyclus

De instantiëring vindt plaats via de constructor onder specificatie van een ara::core::InstanceSpecifier en het concurrency-gedrag concurrencyType ([SWS_DM_00762]). De instantie-identificator koppelt het object aan een port-prototype, dat getypeerd moet zijn door een DiagnosticSecurityLevelInterface ([SWS_DM_00762]). De parameter concurrencyType legt bindend vast of de methode-aanroepen thread-safe (kConcurrent) of niet-thread-safe (kNotConcurrent) moeten worden afgehandeld ([SWS_DM_00762]).

Wat betreft de eigendomssemantiek is de klasse ontworpen als uniek exemplaar: zowel copy-constructor ([SWS_DM_01617]) en copy-assignment-operator ([SWS_DM_01615]) als move-constructor ([SWS_DM_01618]) en move-assignment-operator ([SWS_DM_01616]) zijn verwijderd (=delete). Na de aanmaak bevindt de instantie zich in een inactieve toestand totdat deze via Offer() bij het DM wordt geregistreerd ([SWS_DM_00766]). Vóór beëindiging deactiveert StopOffer() het doorsturen van verzoeken ([SWS_DM_00767]). Interpretatie: StopOffer() dient vermoedelijk altijd te worden aangeroepen vóór de vernietiging van het object door de virtuele destructor ([SWS_DM_00763]), om het deregistreren van lopende verzoeken bij het DM te waarborgen. Vraag Q-3bbb715f727e373a (open)

Gebruikspad

De typische gebruiksstroom van een afgeleide handler-implementatie omvat de volgende stappen:

  1. Activering: De applicatie instantieert de afgeleide klasse en roept Offer() aan om het doorsturen van diagnoseverzoeken door het DM te activeren ([SWS_DM_00766]).
  2. Seed-verstrekking: Komt er een diagnoseverzoek voor het genereren van een seed binnen, dan roept het DM de methode GetSeed aan ([SWS_DM_00764]). De applicatie verwerkt de doorgegeven securityAccessDataRecord, houdt rekening met de cancellationHandler en retourneert de berekende seed asynchroon via een ara::core::Future<ara::core::Vector<std::uint8_t>> ([SWS_DM_00764]). De buffer van de overgedragen data-span blijft geldig tot het vervullen van de promise of tot aan annulering ([SWS_DM_00764]).
  3. Sleutelvalidatie: Zodra de diagnosetester de berekende sleutel verzendt, roept het DM CompareKey aan ([SWS_DM_00765]). De applicatie controleert de parameter key en verzendt het resultaat asynchroon via een ara::core::Future<KeyCompareResultType> ([SWS_DM_00765]).
  4. Deactivering: Om het diagnosebedrijf te beëindigen, roept de applicatie StopOffer() aan ([SWS_DM_00767]).
Verloop van de beveiligingsauthenticatie via SecurityAccessAnwendungara::diag::SecurityAccessDiagnostic ManagementUse Case: AktivierungOffer()Dienst registrierenResult<void>Result<void>Use Case: Seed anfordernGetSeed(securityAccessDataRecord, metaInfo, cancellationHandler)Seed generierenFuture<Vector<uint8_t>> (Seed)Use Case: Sleutel verifiërenCompareKey(key, metaInfo, cancellationHandler)Sleutel controlerenFuture<KeyCompareResultType>Use Case: DeaktivierungStopOffer()Dienst deregistrieren

Sequentiediagram: Interactiecyclus van activering via GetSeed en CompareKey tot deactivering. Bronnen: [SWS_DM_00764], [SWS_DM_00765], [SWS_DM_00766], [SWS_DM_00767]

Foutscenario's

Bij het gebruik van ara::diag::SecurityAccess zijn meerdere foutniveaus gespecificeerd:

  • Constructor- en modelschendingen: Kan de InstanceSpecifier in het model niet worden opgelost of verwijst deze niet naar een PortPrototype, dan wordt een InstanceSpecifierMappingIntegrityViolation gemeld ([SWS_DM_00762]). Is de gereferentieerde poort niet getypeerd door een DiagnosticSecurityLevelInterface, dan is er sprake van een PortInterfaceMappingViolation ([SWS_DM_00762]). Ontbreekt het passende gemodelleerde proces tijdens runtime, dan treedt een ProcessMappingViolation op, en bij meervoudig gebruik van dezelfde identifier binnen het proces wordt een InstanceSpecifierAlreadyInUseViolation geactiveerd ([SWS_DM_00762]).
  • Tostandsfouten bij het aanbieden: Een herhaalde aanroep van Offer() bij een reeds actieve serviceaanbieding mislukt en levert de fout DiagOfferErrc::kAlreadyOffered op met rollback-semantiek ([SWS_DM_00766]).
  • Negatieve UDS-terugmeldingen: Mislukt het genereren van de seed of de sleutelcontrole, dan moet de applicatie via DiagUdsNrcErrc een passende Negative Response Code (NRC) conform ISO 14229-1 melden ([SWS_DM_00764], [SWS_DM_00765]).
  • Afbreken van de diagnoseverbinding: Via de parameter cancellationHandler kan de applicatie middels IsCanceled() controleren of het gesprek is afgebroken, of via SetNotifier() een notificatiefunctie voor een annulering registreren ([SWS_DM_00764], [SWS_DM_00765]).
  • Persisteren van mislukte pogingen: Diagnostic Management vereist na elke mislukte poging tot wijziging van het beveiligingsniveau een persistente opslag van de teller, om manipulaties of resets te doorstaan (AUTOSAR_AP_SWS_Diagnostics §4.1 “Limitations of sub-functions of 0x19 ReadDTCInformation”, [SWS_DM_00479]).

Deze handleiding is gebaseerd op de specificatie AUTOSAR Adaptive R25-11 en vat de eisen aan de klasse ara::diag::SecurityAccess samen.

Ledenkaart

Constructors en destructor

2
SecurityAccess~SecurityAccess

Methoden

4
CompareKeyGetSeedOfferStopOffer

Operatoren

1
operator=

Klassendiagram

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

G nara__diag__SecurityAccess583 SecurityAccess + SecurityAccess() + operator=() + ~SecurityAccess() + CompareKey() + GetSeed() + Offer() + StopOffer()

Detailweergave

Kies een item in de inhoudsopgave.

Constructors en destructor

SecurityAccess functie 3

Constructor of SecurityAccess.

Overloads SecurityAccess 3
explicit SecurityAccess (const ara::core::InstanceSpecifier &specifier, ConcurrencyType concurrencyType) noexcept; SWS_DM_00762
SecurityAccess (SecurityAccess &)=delete; SWS_DM_01617
SecurityAccess (SecurityAccess &&) noexcept=delete; SWS_DM_01618
~SecurityAccess functie

Destructor of SecurityAccess .

virtual ~SecurityAccess () noexcept;

Methoden

CompareKey functie

This method is called, when a diagnostic request has been finished, to notify about the outcome.

virtual ara::core::Future< KeyCompareResultType > CompareKey (ara::core::Span< const std::uint8_t > key, const MetaInfo &metaInfo, CancellationHandler cancellationHandler) noexcept=0;
GetSeed functie

Called for any request messsage.

virtual ara::core::Future< ara::core::Vector< std::uint8_t > > GetSeed (ara::core::Span< const std::uint8_t > securityAccessDataRecord, const MetaInfo &metaInfo, CancellationHandler cancellationHandler) noexcept=0;
Offer functie

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

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

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

void StopOffer () noexcept;

Operatoren

operator= functie 2

SecurityAccess shall be a single not assignable instance.

Overloads = 2
SecurityAccess & operator= (SecurityAccess &)=delete; SWS_DM_01615
SecurityAccess & operator= (SecurityAccess &&)=delete; SWS_DM_01616

Documentatie van de methoden

functie CompareKey [SWS_DM_00765] Upstream: RS_AP_00138, RS_Diag_04005, RS_Diag_04170, RS_AP_00119

virtual ara::core::Future< KeyCompareResultType > CompareKey (ara::core::Span< const std::uint8_t > key, const MetaInfo &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

This method is called, when a diagnostic request has been finished, to notify about the outcome.

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 7e880a8e2b3a Herkomst
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Gebruik

De puur virtuele methode CompareKey uit de klasse ara::diag::SecurityAccess [SWS_DM_00765] wordt aan de applicatiezijde geïmplementeerd om de door de client verzonden sleutel bij de UDS-dienst 0x27 (SecurityAccess) te valideren SWS Diagnostics §7.3.2.8.9 “Service 0x27 – SecurityAccess”. Samen met GetSeed vormt deze de basis voor het statische seed-key-mechanisme conform ISO 14229-1 [SWS_DM_00863].

De parameters van de functie omvatten:

  • key: Een ara::core::Span<const std::uint8_t> naar de te controleren sleutelgegevens. De buffer blijft geldig totdat de bijbehorende promise is vervuld of de verwerking via de cancellationHandler wordt geannuleerd [SWS_DM_00765].
  • metaInfo: Meta-informatie van het binnenkomende diagnoseverzoek [SWS_DM_00765].
  • cancellationHandler: Maakt het opvragen van een annulering via cancellationHandler.IsCanceled mogelijk, evenals de registratie van een notificatiefunctie via cancellationHandler.SetNotifier bij annulering van de conversatie [SWS_DM_00765].

Het controleresultaat wordt asynchroon beschikbaar gesteld via ara::core::Future<KeyCompareResultType> [SWS_DM_00765].

Foutafhandeling en wisselwerking

Mislukt de sleutelvergelijking of treedt tijdens de verwerking een fout op, dan moet via de future een passende Negative Response Code (NRC) conform ISO 14229-1 middels DiagUdsNrcErrc worden meegegeven [SWS_DM_00765]. Is de aangevraagde subfunctie voor CompareKey niet geconfigureerd, dan wordt het verzoek beantwoord met NRC 0x12 (kSubFunctionNotSupported) [SWS_DM_00363]. De Diagnostic Server telt mislukte pogingen [SWS_DM_00270] en vergelijkt deze met drempelwaarden [SWS_DM_00271].

Wordt de beveiligingstoegang met succes vrijgegeven, dan werkt de server het beveiligingsniveau intern bij [SWS_DM_00846], reset de teller van mislukte pogingen [SWS_DM_00270] en meldt de beveiligingsgebeurtenis SEV_UDS_SECURITY_ACCESS_SUCCESSFUL aan het IdsM [SWS_DM_02019].

Gelijktijdigheid en beperkingen

De interface is gedeclareerd als noexcept en uitzonderingsveilig (exception safe) [SWS_DM_00765]. De thread-safety is voorwaardelijk (conditional): of de implementatie thread-safe moet zijn, wordt bepaald via de in de constructor van SecurityAccess meegegeven ConcurrencyType [SWS_DM_00765].

Deze gebruiksinstructie is door een AI gegenereerd op basis van de AUTOSAR-specificatie.

Implementer's Guide volgt (complexiteit I2)

Header-Datei#include "ara/diag/security_access.h"
Scopeclass ara::diag::SecurityAccess
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
keyThe key to be validated. Lifetime: Valid until Promise is fulfilled or the processing is cancelled by the cancellationHandler.
metaInfoMetaInfo of the request.
cancellationHandlerThis parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.

Rückgabewert

TypBeschreibung
ara::core::Future< KeyCompareResultType >Result of the key validation.

Fehler

FehlercodeBeschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.

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

Record
AUTOSAR/AP/record/SWS_DM_00765
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00765@rel:R25-11#ea0b7de4
Content hash
ea0b7de4
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00765
Status: valid/unmigrated Version: rel:R25-11#fcff65aa 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_DM_00765@rel:R25-11#fcff65aa
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#d4d3823f2026-09-30
  • R19-11rel:R19-11#4bf18d9e2026-10-14
  • R20-11rel:R20-11#52ff58612026-10-14
  • R21-11rel:R21-11#42d7f4462026-10-14
  • R22-11rel:R22-11#94736e912026-10-14
  • R23-11rel:R23-11#cbc123ea2026-10-14
  • R24-11rel:R24-11#e09a76d52026-10-14
  • R25-11rel:R25-11#fcff65aa2026-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

functie GetSeed [SWS_DM_00764] Upstream: RS_AP_00138, RS_Diag_04005, RS_Diag_04170, RS_AP_00119

virtual ara::core::Future< ara::core::Vector< std::uint8_t > > GetSeed (ara::core::Span< const std::uint8_t > securityAccessDataRecord, const MetaInfo &metaInfo, CancellationHandler cancellationHandler) noexcept=0;

Called for any request messsage.

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: d92bef6dc534 Herkomst
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Gebruik

De puur virtuele methode ara::diag::SecurityAccess::GetSeed wordt door de diagnoseserver-instantie aangeroepen zodra een UDS-verzoek voor de dienst 0x27 SecurityAccess wordt ontvangen en de verzonden subfunctiewaarde overeenkomt met de geconfigureerde requestSeedId [SWS_DM_00863]. Dit maakt deel uit van de standaardconforme implementatie van de dienst 0x27 conform ISO 14229-1 [SWS_DM_00236].

De aanroep draagt de door de diagnoseclient verstrekte nuttige gegevens over via de parameter securityAccessDataRecord (als ara::core::Span), de contextinformatie in metaInfo evenals een object van het type CancellationHandler [SWS_DM_00764]. Heeft de client geen gegevens verzonden, dan wordt de data-span leeg overgedragen [SWS_DM_00863]. De overgedragen gegevens blijven geldig totdat de bijbehorende promise is vervuld of de verwerking wordt geannuleerd [SWS_DM_00764].

Asynchrone semantiek en concurrency

De functie levert asynchroon een ara::core::Future<ara::core::Vector<std::uint8_t>> op, die de gegenereerde seed bevat [SWS_DM_00764]. Via de cancellationHandler kan de applicatie middels IsCanceled controleren of de conversatie is geannuleerd, of via SetNotifier een notificatie registreren [SWS_DM_00764]. Ook een statisch seed-mechanisme conform ISO 14229-1 moet aan de applicatiezijde in GetSeed worden geïmplementeerd SWS Diagnostics §7.3.2.8.9 “Service 0x27 – SecurityAccess”.

Wat betreft concurrency is de methode voorwaardelijk thread-safe: of de implementatie thread-safe moet zijn, wordt bepaald via de ConcurrencyType die aan de constructor van SecurityAccess wordt meegegeven SWS Diagnostics §8.24.2.1.3.2 “GetSeed”.

Foutafhandeling

Kan er geen geldige seed worden vastgesteld, dan moet de future met een passende Negative Response Code (NRC) conform ISO 14229-1 via DiagUdsNrcErrc worden afgerond [SWS_DM_00764]. De interface is gedeclareerd als noexcept en uitzonderingsveilig [SWS_DM_00764].

Deze gebruiksinstructie is opgesteld door een AI op basis van de AUTOSAR-specificatie R25-11.

Implementer's Guide volgt (complexiteit I2)

Header-Datei#include "ara/diag/security_access.h"
Scopeclass ara::diag::SecurityAccess
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
securityAccessDataRecordSecurity Access payload, Lifetime: Valid until Promise is fulfilled or the processing is cancelled by the cancellationHandler.
metaInfoMetaInfo of the request.
cancellationHandlerThis parameter is used to • Query the current cancellation status by calling cancellationHandler.IsCanceled. Returns TRUE in case, the current conversation has been cancelled and FALSE otherwise. • Register a notifier function by calling cancellationHandler.SetNotifier. The registered notifier is called if the current conversation is cancelled.

Rückgabewert

TypBeschreibung
ara::core::Future<ara::core::Vector<std::uint8_t > >provided seed

Fehler

FehlercodeBeschreibung
Please use an applicable NRC, as defined in ISO 14229-1, using DiagUdsNrcErrc.

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

Record
AUTOSAR/AP/record/SWS_DM_00764
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00764@rel:R25-11#a5c93c3a
Content hash
a5c93c3a
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00764
Status: valid/unmigrated Version: rel:R25-11#78b36e49 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_DM_00764@rel:R25-11#78b36e49
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#2e6ffe502026-09-30
  • R19-11rel:R19-11#ec261d632026-10-14
  • R20-11rel:R20-11#d20d81e72026-10-14
  • R21-11rel:R21-11#9f3e5c3f2026-10-14
  • R22-11rel:R22-11#b2714bed2026-10-14
  • R23-11rel:R23-11#cb771e7d2026-10-14
  • R24-11rel:R24-11#e4519bf42026-10-14
  • R25-11rel:R25-11#78b36e492026-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

functie Offer [SWS_DM_00766] Upstream: RS_AP_00139, RS_Diag_04005, RS_AP_00119

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

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

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 03e774f47039 Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Gebruik

De methode ara::diag::SecurityAccess::Offer ([SWS_DM_00766]) uit de header ara/diag/security_access.h stelt de Diagnostic Manager (DM) in staat inkomende verzoekberichten (Request Messages) door te sturen naar de geregistreerde handler voor beveiligde toegang. De aanroep vindt synchroon plaats zonder overdrachtparameters en retourneert een ara::core::Result<void>.

Foutafhandeling

In geval van een fout levert het retourobject een foutcode op. Als de dienst al is geregistreerd op de instantie, wordt DiagOfferErrc::kAlreadyOffered geretourneerd ([SWS_DM_00766]). De functie is gedeclareerd als noexcept en garandeert uitzonderingsveiligheid (exception safe).

Gelijktijdigheid en beperkingen

De interface is gespecificeerd als niet thread-veilig (not thread-safe) ([SWS_DM_00766]). Concurrerende aanroepen op dezelfde instantie moeten door de applicatie worden gesynchroniseerd. Interpretatie: meervoudige ongecoördineerde aanroepen worden zonder voorafgaand intrekken van het aanbod vermoedelijk steeds met kAlreadyOffered afgewezen. Vraag Q-848ccd3c78403eea (open)

Samenspel

Het aanbieden van functionaliteit via Offer volgt het uniforme activeringspatroon van AUTOSAR Adaptive-diagnose, zoals dat ook is gedefinieerd voor ServiceValidation ([SWS_DM_00776]) of DoIPGroupIdentification ([SWS_DM_00725]). Ondanks naamgelijkheid met communicatie-interfaces betreft het een diagnosespecifieke implementatie, die niet mag worden verward met ara::com (SWS Diagnostics §7.3.4.1.2 “Monitors”).

Deze tekst is gegenereerd door een AI op basis van de specificatie AUTOSAR R25-11.

Implementer's Guide volgt (complexiteit I1)

Header-Datei#include "ara/diag/security_access.h"
Scopeclass ara::diag::SecurityAccess
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.

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

Record
AUTOSAR/AP/record/SWS_DM_00766
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00766@rel:R25-11#7fbff022
Content hash
7fbff022
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00766
Status: valid/unmigrated Version: rel:R25-11#00210900 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_DM_00766@rel:R25-11#00210900
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#56ad395b2026-09-30
  • R19-11rel:R19-11#d015c3bb2026-10-14
  • R20-11rel:R20-11#5653979a2026-10-14
  • R21-11rel:R21-11#d5a352932026-10-14
  • R22-11rel:R22-11#4dd706ea2026-10-14
  • R23-11rel:R23-11#898492102026-10-14
  • R24-11rel:R24-11#6e0b7b5e2026-10-14
  • R25-11rel:R25-11#002109002026-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

functie SecurityAccess [SWS_DM_00762] Upstream: RS_AP_00137, RS_Diag_04005, RS_AP_00170, RS_AP_00171, RS_AP_00172, RS_AP_00173

explicit SecurityAccess (const ara::core::InstanceSpecifier &specifier, ConcurrencyType concurrencyType) noexcept;

Constructor of SecurityAccess.

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 6e8a7c45e17d Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Gebruik

De expliciete constructor initialiseert een instantie van ara::diag::SecurityAccess synchroon en uitzonderingsveilig ([SWS_DM_00762]). Hij neemt als parameters een referentie naar een ara::core::InstanceSpecifier en een ConcurrencyType in ontvangst. De parameter specifier moet refereren aan een gemodelleerde PortPrototype die is getypeerd door een DiagnosticSecurityLevelInterface. Via concurrencyType wordt vastgelegd of de callback-methoden van de interface gelijktijdig (kConcurrent) of niet-gelijktijdig (kNotConcurrent) worden afgehandeld.

Foutafhandeling

De functie is gedeclareerd met noexcept ([SWS_DM_00762]). Bij foutieve configuraties van de modellering kunnen de volgende violations optreden:

  • InstanceSpecifierMappingIntegrityViolation: De InstanceSpecifier kan in de uitvoeringscontext niet worden opgelost of verwijst niet naar een PortPrototype.
  • PortInterfaceMappingViolation: De gerefereerde PortPrototype is niet getypeerd als DiagnosticSecurityLevelInterface.
  • ProcessMappingViolation: Voor de instantie-identifier bestaat tijdens runtime geen passend gemodelleerd proces.
  • InstanceSpecifierAlreadyInUseViolation: De InstanceSpecifier wordt binnen het proces al gebruikt.

Interpretatie: het optreden van een dergelijke schending leidt framework-intern vermoedelijk tot een runtime-afbreking of een veiligheidsafhandeling, aangezien de constructor geen foutcodes via een retourwaarde meldt. Vraag Q-de6e36dc7947326e (open)

Gelijktijdigheid en beperkingen

De constructor zelf is gespecificeerd als thread-safe ([SWS_DM_00762]). Copy- en move-constructors evenals de bijbehorende toekenningsoperatoren zijn expliciet verwijderd ([SWS_DM_01617], [SWS_DM_01618], [SWS_DM_01615], [SWS_DM_01616]); een instantie kan zodoende noch worden gekopieerd noch worden verplaatst. De bij de constructor doorgegeven concurrencyType bepaalt of de virtuele methoden GetSeed ([SWS_DM_00764]) en CompareKey ([SWS_DM_00765]) thread-safe ter beschikking moeten worden gesteld. De destructor is daarentegen niet thread-safe ([SWS_DM_00763]).

Samenspel

Na de instantiëring moet de applicatie Offer ([SWS_DM_00766]) aanroepen, zodat de Diagnostic Server (DM) binnenkomende UDS-verzoeken voor de service 0x27 (SWS Diagnostics §7.3.2.8.9 “Service 0x27 – SecurityAccess”, [SWS_DM_00236]) doorstuurt. Bij een passende subfunctie stuurt de server verzoeken door naar GetSeed ([SWS_DM_00863]). Het doorsturen kan met StopOffer ([SWS_DM_00767]) weer worden gedeactiveerd.

Deze gebruiksinstructie is geautomatiseerd gegenereerd op basis van de AUTOSAR-specificatie R25-11.

Implementer's Guide volgt (complexiteit I3)

Header-Datei#include "ara/diag/security_access.h"
Scopeclass ara::diag::SecurityAccess
Exception-Sicherheitexception safe
Thread-Sicherheitthread-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 DiagnosticSecurityLevelPortMapping needs to be typed by a DiagnosticSecurityLevelInterface. 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
specifierInstanceSpecifier to a PortPrototype of a DiagnosticSecurityLevelInterface.
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_00762
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00762@rel:R25-11#3d1e2a29
Content hash
3d1e2a29
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00762
Status: valid/unmigrated Version: rel:R25-11#d28cef1a 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_DM_00762@rel:R25-11#d28cef1a
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#043c5c7d2026-09-30
  • R19-11rel:R19-11#7b2a44bb2026-10-14
  • R20-11rel:R20-11#7227b8b52026-10-14
  • R21-11rel:R21-11#7227b8b52026-10-14
  • R22-11rel:R22-11#63feab942026-10-14
  • R23-11rel:R23-11#00b457c22026-10-14
  • R24-11rel:R24-11#9298af8d2026-10-14
  • R25-11rel:R25-11#d28cef1a2026-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

functie SecurityAccess [SWS_DM_01617] Upstream: RS_AP_00147

SecurityAccess (SecurityAccess &)=delete;

SecurityAccess shall be a single not copy-able instance.

Header-Datei#include "ara/diag/security_access.h"
Scopeclass ara::diag::SecurityAccess

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

Record
AUTOSAR/AP/record/SWS_DM_01617
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01617@rel:R25-11#6a135ff7
Content hash
6a135ff7
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01617
Status: valid/unmigrated Version: rel:R25-11#d3831de3 Versionshistorie & Revisions (1 transition, 4 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_01617@rel:R25-11#d3831de3
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#3fb7c46d2026-09-30
  • R23-11rel:R23-11#50f56be22026-10-14
  • R24-11rel:R24-11#177a95552026-10-14
  • R25-11rel:R25-11#d3831de32026-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

functie SecurityAccess [SWS_DM_01618] Upstream: RS_AP_00147

SecurityAccess (SecurityAccess &&) noexcept=delete;

Move constructor of SecurityAccess.

Header-Datei#include "ara/diag/security_access.h"
Scopeclass ara::diag::SecurityAccess

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

Record
AUTOSAR/AP/record/SWS_DM_01618
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01618@rel:R25-11#eaa2e1b7
Content hash
eaa2e1b7
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01618
Status: valid/unmigrated Version: rel:R25-11#99b5fc60 Versionshistorie & Revisions (1 transition, 4 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_01618@rel:R25-11#99b5fc60
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#b7a6da4b2026-09-30
  • R23-11rel:R23-11#f9d976f12026-10-14
  • R24-11rel:R24-11#99b5fc602026-10-14
  • R25-11rel:R25-11#99b5fc602026-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

functie StopOffer [SWS_DM_00767] Upstream: RS_Diag_04005

void StopOffer () noexcept;

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

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: cc611929a4e2 Herkomst
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Gebruik

De lidfunctie StopOffer van de klasse ara::diag::SecurityAccess (header ara/diag/security_access.h) dient ertoe het doorsturen van binnenkomende verzoekberichten vanuit Diagnostic Management (DM) naar de instantie te deactiveren [SWS_DM_00767]. De aanroep vindt synchroon plaats, accepteert geen parameters en levert geen retourwaarde op (void) [SWS_DM_00767].

Foutafhandeling

De functie is gedeclareerd met noexcept en geclassificeerd als uitzonderingsveilig (exception safe) [SWS_DM_00767]. Er worden noch foutcodes noch C++-excepties gerapporteerd; wangedrag of een uitzonderingstoestand bij de deregistratie is niet voorzien in de interfacespecificatie [SWS_DM_00767].

Gelijktijdigheid en beperkingen

Volgens de specificatie is StopOffer niet thread-safe (not thread-safe) [SWS_DM_00767]. Indien meerdere threads van een Adaptive Application gelijktijdig toegang hebben tot dezelfde instantie van ara::diag::SecurityAccess, moet de aanroep extern worden gesynchroniseerd.

Samenspel

De methode maakt deel uit van een module-overstijgend functiepatroon binnen DM. Vergelijkbare StopOffer-methoden bestaan voor tal van andere diagnoseservices zoals:

Hoewel de naamgeving is ontleend aan het aanbieden van services in ara::com, betreft het een zelfstandige diagnose-implementatie voor de besturing van de berichtenstroom binnen ara::diag AUTOSAR_AP_SWS_Diagnostics §7.3.4.1.2 “Monitors”.

Deze gebruiksinstructie is geautomatiseerd gegenereerd op basis van de AUTOSAR-specificatie voor R25-11.

Implementer's Guide volgt (complexiteit I2)

Header-Datei#include "ara/diag/security_access.h"
Scopeclass ara::diag::SecurityAccess
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_00767
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00767@rel:R25-11#1811b9db
Content hash
1811b9db
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00767
Status: valid/unmigrated Version: rel:R25-11#942cb137 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_DM_00767@rel:R25-11#942cb137
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#f72493482026-09-30
  • R19-11rel:R19-11#78ac458e2026-10-14
  • R20-11rel:R20-11#d7a868c22026-10-14
  • R21-11rel:R21-11#84fad67f2026-10-14
  • R22-11rel:R22-11#8e125bd42026-10-14
  • R23-11rel:R23-11#70d9a1082026-10-14
  • R24-11rel:R24-11#4b26aa9f2026-10-14
  • R25-11rel:R25-11#942cb1372026-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

functie operator= [SWS_DM_01615] Upstream: RS_AP_00147

SecurityAccess & operator= (SecurityAccess &)=delete;

SecurityAccess shall be a single not assignable instance.

Header-Datei#include "ara/diag/security_access.h"
Scopeclass ara::diag::SecurityAccess

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

Record
AUTOSAR/AP/record/SWS_DM_01615
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01615@rel:R25-11#1469eb7c
Content hash
1469eb7c
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01615
Status: valid/unmigrated Version: rel:R25-11#860bde59 Versionshistorie & Revisions (1 transition, 4 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_01615@rel:R25-11#860bde59
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#b9674d212026-09-30
  • R23-11rel:R23-11#2062081c2026-10-14
  • R24-11rel:R24-11#860bde592026-10-14
  • R25-11rel:R25-11#860bde592026-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

functie operator= [SWS_DM_01616] Upstream: RS_AP_00147

SecurityAccess & operator= (SecurityAccess &&)=delete;

Move assignment operator of SecurityAccess.

Header-Datei#include "ara/diag/security_access.h"
Scopeclass ara::diag::SecurityAccess

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

Record
AUTOSAR/AP/record/SWS_DM_01616
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01616@rel:R25-11#79d53def
Content hash
79d53def
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01616
Status: valid/unmigrated Version: rel:R25-11#7c8f632b Versionshistorie & Revisions (1 transition, 4 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_01616@rel:R25-11#7c8f632b
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#362e1d632026-09-30
  • R23-11rel:R23-11#340c00fd2026-10-14
  • R24-11rel:R24-11#7c8f632b2026-10-14
  • R25-11rel:R25-11#7c8f632b2026-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

functie ~SecurityAccess [SWS_DM_00763] Upstream: RS_AP_00134, RS_Diag_04005

virtual ~SecurityAccess () noexcept;

Destructor of SecurityAccess .

DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 34fedca7e76c Herkomst Open vragen (1)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

De virtuele destructor ~SecurityAccess [SWS_DM_00763] beëindigt de levenscyclus van een instantie van de serviceklasse ara::diag::SecurityAccess in de module Diagnostics AUTOSAR_AP_SWS_Diagnostics §8.24.2.1.1.3 “Destructor”. De interface wordt beschikbaar gesteld via de header #include "ara/diag/security_access.h" [SWS_DM_00763]. De uitvoering vindt synchroon plaats, waarbij de functie noch overdrachtsparameters accepteert noch een retourwaarde oplevert [SWS_DM_00763].

Wat betreft de foutafhandeling is de operatie geclassificeerd als exception safe en gedeclareerd met noexcept [SWS_DM_00763]. Deze genereert bijgevolg geen excepties. Specifieke foutcodes en foutmeldingen aan ontwikkelings- of diagnose-foutmanagers (DET of DEM) zijn voor de vernietiging van het object niet voorzien in de specificatie [SWS_DM_00763].

Met betrekking tot concurrency is de functie uitdrukkelijk geclassificeerd als not thread-safe [SWS_DM_00763]. Vernietiging van het object mag nooit gelijktijdig plaatsvinden met aanroepen van andere methoden op dezelfde instantie. Als interpretatie geldt: het zal waarschijnlijk noodzakelijk zijn om voorafgaand aan de vernietiging alle lopende diagnose- en beveiligingstoegangsactiviteiten van deze instantie ordentelijk af te ronden, aangezien gelijktijdige toegangen tot ongedefinieerd gedrag leiden. Vraag Q-12c13e3eebd9e574 (open)

In samenspel met het platform dient de functie voor het realiseren van de upstream-requirements RS_AP_00134 en RS_Diag_04005 AUTOSAR_AP_SWS_Diagnostics §8.24.2.1.1.3 “Destructor”.

Automatisch gegenereerde gebruiksinstructie op basis van de specificatie AUTOSAR Adaptive R25-11.

Implementer's Guide volgt (complexiteit I1)

Header-Datei#include "ara/diag/security_access.h"
Scopeclass ara::diag::SecurityAccess
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_00763
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_00763@rel:R25-11#43c0524b
Content hash
43c0524b
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_00763
Status: valid/unmigrated Version: rel:R25-11#8b163b56 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_DM_00763@rel:R25-11#8b163b56
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#98bb90f72026-09-30
  • R19-11rel:R19-11#1b925c952026-10-14
  • R20-11rel:R20-11#fdb51c102026-10-14
  • R21-11rel:R21-11#5d5e7b7a2026-10-14
  • R22-11rel:R22-11#c67efa4a2026-10-14
  • R23-11rel:R23-11#fccf37df2026-10-14
  • R24-11rel:R24-11#8b163b562026-10-14
  • R25-11rel:R25-11#8b163b562026-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