DEENESPTFRRUARHIKOZHNL

struct ara::diag::SovdAuthorization::ValidateAuthorizationOutput

[SWS_DM_01927] Upstream: RS_Diag_04268

struct ValidateAuthorizationOutput {...};

Return type for ValidateAuthorization().

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

User GuideAI-GEGENEREERD

Bundelt het resultaat van een SOVD-autorisatiecontrole met clientidentiteit en geldigheidsduur voor caching.
DOOR AI GEGENEREERD ongecontroleerd Model: gemini-3.8-flash-medium · Inspanning: medium · Temperatuur: niet regelbaar · Prompt: 6613e74c168c Herkomst Open vragen (2)
vertaald uit de Duitse handleidinggemini-3.8-flash-low · 2026-10-13 · Duits origineel

Bundelt het resultaat van een SOVD-autorisatiecontrole met clientidentiteit en geldigheidsduur voor caching.

De structuur ara::diag::SovdAuthorization::ValidateAuthorizationOutput dient als retourtype van de autorisatiecontrole ValidateAuthorization() in de module diag [SWS_DM_01927]. Deze verzendt de optionele clientidentiteit voor herkenning en handhaving van toegang tot tijdelijke resources zoals routines of vergrendelingen [SWS_DM_01819], evenals het geldigheidstijdstip voor het cachen van de validatie [SWS_DM_01820]. Blijft het identiteitsveld leeg, dan vervalt de toegang tot beveiligde resources zodra het overgedragen token verloopt of ongeldig wordt [SWS_DM_01819].

Context

De structuur ara::diag::SovdAuthorization::ValidateAuthorizationOutput fungeert als gestandaardiseerd retourtype voor de operatie ValidateAuthorization() in de module diag van het AUTOSAR Adaptive Platform [SWS_DM_01927] AUTOSAR_AP_SWS_Diagnostics §8.52.2 “Struct: ValidateAuthorizationOutput”. Deze dient als interface-element tussen de applicatieve autorisatielogica en het Diagnostic Management bij servicegeoriënteerde diagnosetoegangen (SOVD). Zodra een externe diagnose-client via een SOVD-token toegang wil verkrijgen tot voertuigresources, vraagt het Diagnostic Management een validatie aan. De structuur verstuurt twee centrale resultaten van deze controle: een optioneel identificatiekenmerk van de client (identity) [SWS_DM_01819] en het geldigheidstijdstip voor het cachen van de autorisatie (validUntil) [SWS_DM_01820].

Levenscyclus

Als datastructuur (Plain Struct) heeft ValidateAuthorizationOutput een transiënte levenscyclus [SWS_DM_01927]. Deze wordt geïnstantieerd door de applicatiespecifieke implementatie van de autorisatiecontrole, gevuld met de validatieresultaten en per waarde (Return-by-Value resp. move-semantiek) overgedragen aan het aanroepende Diagnostic Management. De structuur houdt haar datavelden identity van het type ara::core::Optional<ara::core::String> [SWS_DM_01819] en validUntil van het type std::chrono::system_clock::time_point [SWS_DM_01820] vast als directe membervariabelen. Het object zelf bezit geen interne toestanden of toestandsovergangen, maar bepaalt via het veld validUntil direct de levensduur van de in het Diagnostic Management aangehouden autorisatietoestand (caching) [SWS_DM_01820]. Wat betreft gelijktijdigheid wordt de instantie vermoedelijk thread-lokaal binnen de validatie-aanroep aangemaakt; een gelijktijdige schrijftoegang tot dezelfde structuur is niet gespecificeerd (Interpretatie: bescherming tegen datacraces berust bij de aanroepende omgeving). Vraag Q-0579316b13023b31 (open) Na evaluatie door het framework eindigt de levenscyclus van de structuurinstantie regulier bij het verlaten van de scope.

Gebruikspad

Het typische verloop voor het gebruik van ValidateAuthorizationOutput is onderverdeeld in de volgende stappen:

  • Verzoek ontvangen: Een externe client verzendt een SOVD-diagnoseverzoek met een beveiligingstoken naar het Diagnostic Management.
  • Validatie aanvragen: Het Diagnostic Management stuurt het token via ValidateAuthorization() door naar de applicatiespecifieke autorisatie-instantie.
  • Retourwaarde aanmaken: De applicatie controleert het token, instantieert ValidateAuthorizationOutput en stelt validUntil in op het tijdstip tot wanneer deze autorisatie hergebruikt mag worden [SWS_DM_01820] AUTOSAR_AP_SWS_Diagnostics §8.52.2.1.2 “validUntil”.
  • Identiteit toewijzen: Voorziet het beveiligingsconcept in herkenning, dan stelt de applicatie het optionele veld identity in (bijv. client_id, sub of een combinatie) [SWS_DM_01819] AUTOSAR_AP_SWS_Diagnostics §8.52.2.1.1 “identity”.
  • Resultaat evalueren: Het Diagnostic Management neemt de struct over, buffert het validatieresultaat tot validUntil en wijst tijdelijke resources (zoals actieve diagnoseroutines of vergrendelingen) toe aan de overgedragen identiteit [SWS_DM_01819] [SWS_DM_01820].
Validierung von SOVD-ZugriffstokensSOVD-ClientDiagnostic ManagementSovdAuthorization-HandlerDiagnoseverzoek met tokenValidateAuthorization(token)Erzeuge ValidateAuthorizationOutputValidateAuthorizationOutput(identity, validUntil)Cache Token bis validUntilKoppel bronnen aan identityDiagnoseantwort

Sequentiediagram: Validatieverloop en teruggave van ValidateAuthorizationOutput voor autorisatiecontrole en buffering. Bronnen: [SWS_DM_01819], [SWS_DM_01820], [SWS_DM_01927].

Foutscenario's

Hoewel ValidateAuthorizationOutput als eenvoudig datatype geen eigen foutcodes of excepties opwerpt, leiden foutieve of onvolledige toewijzingen tot operationele fouten:

  • Ontbrekende clientidentiteit bij tokenvernieuwing: Wordt identity niet ingevuld (lege optioneel), dan heeft de client uitsluitend toegang tot tijdelijke resources zolang hetzelfde token aanwezig is en validUntil niet is verlopen [SWS_DM_01819]. Vernieuwt de client een verlopen token, dan kan het Diagnostic Management hem zonder ingestelde identiteit niet herkennen; de toegang tot actieve routines of bestaande vergrendelingen gaat verloren [SWS_DM_01819].
  • Ongeldige of verlopen tijdstempel: Ligt het in validUntil doorgegeven tijdstip reeds in het verleden, dan vindt vermoedelijk direct geen caching in het Diagnostic Management plaats (Interpretatie: Elk volgend clientverzoek dwingt een nieuwe validatie-aanroep af). Vraag Q-c715941f9302fd13 (open)
  • Identiteitsbotsing: als de autorisatietoepassing per ongeluk identieke identiteitsstrings voor verschillende clients retourneert, beschouwt Diagnostic Management deze als identiek [SWS_DM_01819], wat kan leiden tot het onbevoegd overnemen van vergrendelingen en tijdelijke resources.

Deze handleiding is samengesteld door een AI op basis van de specificatie AUTOSAR Adaptive Platform R25-11 (module diag).

UML-klassendiagram

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

G nara__diag__SovdAuthorization__ValidateAuthorizationOutput846 «struct» ValidateAuthorizationOutput + identity + validUntil

Constanten

identity variabele

Identity of the client. This identity string if present will be used to re-identify a client even if it uses a new token (e.g. because the old one expired) so that it has access to the temporary resources (e.g. running routines, locks, etc.). If the identity string is the same as one returned earlier, the client will be considered identical. Depending on the security concept it could be for example the ’client_id’, the ’sub’, or a combination of both. If the identity string is not provided, the client will only have access to the temporary resources as long as it provides the same access token and validUntil is not yet expired.

validUntil variabele

Time until this validation may be reused. The point in time until which the authentication state may be reused if the same token is provided by the client (caching).

Documentatie van constanten / variabelen

variabele identity [SWS_DM_01819] Upstream: RS_Diag_04268

ara::core::Optional<ara::core::String> identity;

Identity of the client. This identity string if present will be used to re-identify a client even if it uses a new token (e.g. because the old one expired) so that it has access to the temporary resources (e.g. running routines, locks, etc.). If the identity string is the same as one returned earlier, the client will be considered identical. Depending on the security concept it could be for example the ’client_id’, the ’sub’, or a combination of both. If the identity string is not provided, the client will only have access to the temporary resources as long as it provides the same access token and validUntil is not yet expired.

Header-Datei#include "ara/diag/sovd_authorization.h"
Scopestruct ara::diag::SovdAuthorization::ValidateAuthorizationOutput
Symbolidentity
Typara::core::Optional< ara::core::String >

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

Record
AUTOSAR/AP/record/SWS_DM_01819
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01819@rel:R25-11#ee76277f
Content hash
ee76277f
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01819
Status: valid/unmigrated Version: rel:R25-11#4cf57b0a 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_01819@rel:R25-11#4cf57b0a
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#8dd343072026-09-30
  • R23-11rel:R23-11#7d3b6a842026-10-14
  • R24-11rel:R24-11#4cf57b0a2026-10-14
  • R25-11rel:R25-11#4cf57b0a2026-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

variabele validUntil [SWS_DM_01820] Upstream: RS_Diag_04268

std::chrono::system_clock::time_point validUntil;

Time until this validation may be reused. The point in time until which the authentication state may be reused if the same token is provided by the client (caching).

Header-Datei#include "ara/diag/sovd_authorization.h"
Scopestruct ara::diag::SovdAuthorization::ValidateAuthorizationOutput
SymbolvalidUntil
Typstd::chrono::system_clock::time_point

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

Record
AUTOSAR/AP/record/SWS_DM_01820
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_DM_01820@rel:R25-11#78ef7cbf
Content hash
78ef7cbf
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Diagnostics.pdf#nameddest=SWS_DM_01820
Status: valid/unmigrated Version: rel:R25-11#bd4ad359 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_01820@rel:R25-11#bd4ad359
Point-in-Time History:
Recorded Revisions (4):
  • R25-11rel:R25-11#530250dc2026-09-30
  • R23-11rel:R23-11#bd4ad3592026-10-14
  • R24-11rel:R24-11#bd4ad3592026-10-14
  • R25-11rel:R25-11#bd4ad3592026-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