DEENESPTFRRUARHIKOZHNL

classe ara::crypto::x509::OcspResponse

[SWS_CRYPT_50129] Upstream: RS_CRYPTO_02306

class OcspResponse {...};

Interface of OcspResponse.

Header-Datei#include "ara/crypto/x509/ocsp_response.h"
Forwarding-Header#include "ara/crypto/crypto_fwd.h"
Scopenamespace ara::crypto::x509

Guide utilisateurGÉNÉRÉ PAR IA

Fournit le statut d'une réponse OCSP pour la vérification de certificats ainsi que les certificats contenus dans celle-ci.
GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 79f06589ab79 Provenance Questions ouvertes (2)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

Fournit le statut d'une réponse OCSP pour la vérification de certificats ainsi que les certificats contenus dans celle-ci.

L'interface ara::crypto::x509::OcspResponse encapsule la réponse d'une requête OCSP destinée à la vérification du statut de certificat dans AUTOSAR Adaptive. Typiquement, les appelants vérifient d'abord le statut de la réponse via GetResponseStatus() [SWS_CRYPT_50130] et récupèrent ensuite les certificats contenus au moyen de GetCertificates() [SWS_CRYPT_50131]. L'accès s'effectue de manière sûre vis-à-vis de la concurrence et des exceptions par l'intermédiaire de pointeurs intelligents partagés (shared smart pointers) sur des instances immuables (Sptrc) [SWS_CRYPT_40802].

Contexte

L'interface ara::crypto::x509::OcspResponse encapsule, dans le module crypto d'AUTOSAR Adaptive Platform, les données d'une réponse conforme au protocole OCSP (Online Certificate Status Protocol). Sa responsabilité principale consiste à mettre à la disposition des applications et des fonctions de sécurité le statut de validité et de révocation des certificats X.509. Contrairement aux listes de révocation de certificats (CRL) statiques, OCSP permet une interrogation rapide du statut de certificats individuels auprès d'un service de validation.

Dans l'architecture cryptographique, l'interface agit comme source d'informations pour les composants appelants, tels que les services d'authentification ou les piles de protocoles TLS. Elle fournit des méthodes pour interroger le statut global de la réponse du message OCSP [SWS_CRYPT_50130] ainsi que pour extraire les certificats transportés dans la réponse [SWS_CRYPT_50131]. De cette manière, les partenaires de communication peuvent vérifier immédiatement la validité des chaînes de certificats.

Cycle de vie

En tant qu'interface purement virtuelle, ara::crypto::x509::OcspResponse ne définit aucun constructeur public ni aucune méthode de fabrique propre. L'instanciation a généralement lieu de manière interne à la plateforme via les composants de pilote et de fournisseur de la pile cryptographique, qui analysent les données brutes reçues de la réponse OCSP (interprétation : les instances concrètes sont créées par les fournisseurs X.509 sous-jacents). Question Q-30d53aa886333cbc (ouverte)

Pour la transmission et la gestion des instances, la classe spécifie l'alias de type Sptrc comme std::shared_ptr<const OcspResponse> [SWS_CRYPT_40802]. Ce pointeur intelligent établit une relation de possession partagée avec un accès strict en lecture. La durée de vie de l'objet est régie par le comptage de références du shared pointer et prend fin automatiquement dès que la dernière référence est libérée.

Sur le plan de la concurrence et de la tolérance aux fautes, les méthodes GetResponseStatus [SWS_CRYPT_50130] et GetCertificates [SWS_CRYPT_50131] sont déclarées sûres vis-à-vis des exceptions (exception safe) et sûres au niveau des threads (thread-safe). Puisqu'un accès exclusivement constant est octroyé via Sptrc [SWS_CRYPT_40802], plusieurs threads peuvent accéder en parallèle et sans verrous externes à la même instance de réponse OCSP.

Parcours d'utilisation

Le déroulement typique de l'évaluation d'une réponse OCSP comprend la vérification du statut et la récupération consécutive des certificats intégrés :

  1. Interroger le statut : l'appelant appelle d'abord GetResponseStatus() [SWS_CRYPT_50130]. La méthode renvoie un ara::core::Result<OcspResponseStatus> indiquant si la réponse a été générée avec succès ou si une erreur de protocole est survenue.
  2. Vérifier le résultat : l'application examine l'objet Result. L'évaluation d'autres données utiles n'est pertinente que si la réponse OCSP est marquée comme réussie.
  3. Obtenir les certificats : l'application appelle ensuite GetCertificates() [SWS_CRYPT_50131]. Un ara::core::Result<ara::core::Vector<Certificate::Sptrc>> est alors renvoyé, encapsulant tous les certificats contenus dans la réponse OCSP.
  4. Effectuer la vérification : les certificats extraits servent probablement à valider la signature de la réponse OCSP ou la chaîne de certificats du répondeur (interprétation : les certificats participent à la vérification de l'authenticité des données OCSP). Question Q-4f4a5f1b72358a1f (ouverte)
Chemin d'utilisation typique d'une OcspResponseApplicationOcspResponseGetResponseStatus()Result<OcspResponseStatus>optStatus erfolgreichGetCertificates()Result<Vector<Certificate::Sptrc>>

Diagramme de séquence : séquence typique pour l'interrogation du statut de la réponse OCSP et la récupération des certificats contenus. Sources : [SWS_CRYPT_50130], [SWS_CRYPT_50131].

Scénarios d'erreur

Les deux méthodes de l'interface utilisent ara::core::Result comme type de retour synchrone et sont munies de l'identificateur noexcept, ce qui exclut la levée d'exceptions C++ synchrones [SWS_CRYPT_50130] [SWS_CRYPT_50131].

Pour GetResponseStatus() [SWS_CRYPT_50130] et GetCertificates() [SWS_CRYPT_50131], la spécification AUTOSAR ne définit explicitement aucun code d'erreur standardisé. Les causes d'erreur potentielles – telles que des erreurs d'analyse syntaxique ou des pénuries de mémoire internes à la plateforme – sont signalées de manière spécifique à l'implémentation via l'objet d'erreur de ara::core::Result. L'existence d'un pointeur valide de type OcspResponse::Sptrc [SWS_CRYPT_40802] constitue une condition préalable, car un accès via un pointeur nul provoquerait un comportement indéfini.

Ce guide a été généré par une IA sur la base de la spécification AUTOSAR R25-11 pour le module crypto.

Carte des membres

Diagramme de classes

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

G nara__crypto__x509__OcspResponse358 OcspResponse + GetCertificates() + GetResponseStatus()

Vue détaillée

Sélectionnez une entrée dans le plan.

Méthodes

Get the certificates contained in the OCSP response.

virtual ara::core::Result< ara::core::Vector< Certificate::Sptrc > > GetCertificates () const noexcept=0;

Get the OCSP response status.

virtual ara::core::Result< OcspResponseStatus > GetResponseStatus () const noexcept=0;

Alias de type

Sptrc alias de type

Shared smart pointer of the interface.

using Sptrc = std::shared_ptr<const OcspResponse>;

Documentation des méthodes

fonction GetCertificates [SWS_CRYPT_50131] Upstream: RS_CRYPTO_02306

virtual ara::core::Result< ara::core::Vector< Certificate::Sptrc > > GetCertificates () const noexcept=0;

Get the certificates contained in the OCSP response.

GÉNÉRÉ PAR IA non vérifié Modèle : gemini-3.8-flash-medium · Effort : medium · Température : non réglable · Prompt : 6d5761e60511 Provenance Questions ouvertes (1)
traduit du guide allemandgemini-3.8-flash-low · 2026-10-13 · Original allemand

Utilisation

La méthode GetCertificates de l'interface ara::crypto::x509::OcspResponse ([SWS_CRYPT_50131]) sert à la récupération synchrone de tous les certificats intégrés dans une réponse OCSP reçue. L'appel s'effectue sans paramètre sur une instance de OcspResponse via l'en-tête ara/crypto/x509/ocsp_response.h ([SWS_CRYPT_50131]). En valeur de retour, la fonction fournit un ara::core::Result<ara::core::Vector<Certificate::Sptrc>> ([SWS_CRYPT_50131]) qui met à disposition, en cas d'exécution réussie, un vecteur contenant des pointeurs intelligents vers les objets certificats contenus.

Gestion des erreurs

Conformément à la spécification, la fonction ne définit aucun code d'erreur standardisé ([SWS_CRYPT_50131]). Interprétation : en raison de l'encapsulation dans le type de retour ara::core::Result, un appelant devrait néanmoins devoir vérifier d'éventuels états d'erreur spécifiques à l'implémentation, bien qu'AUTOSAR ne prévoie aucune erreur normalisée pour cette méthode ([SWS_CRYPT_50131]). Question Q-d37b6b547d25b17f (ouverte)

Concurrence et restrictions

La définition d'interface désigne GetCertificates comme const ainsi que noexcept ([SWS_CRYPT_50131]). De plus, la fonction est spécifiée comme thread-safe et exception-safe ([SWS_CRYPT_50131]). Les appelants peuvent donc exécuter la méthode en parallèle de manière concurrente depuis plusieurs threads, sans que des mécanismes de synchronisation externes ne soient nécessaires.

Ce texte a été généré automatiquement sur la base des spécifications AUTOSAR.

Guide de l'implémenteur à venir (complexité I1)

Header-Datei#include "ara/crypto/x509/ocsp_response.h"
Scopeclass ara::crypto::x509::OcspResponse
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::Result<ara::core::Vector<Certificate::Sptrc > >A Vector containing the certificates contained in the OCSP response.

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_CRYPT_50131
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50131@rel:R25-11#64156991
Content hash
64156991
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50131
Status: valid/unmigrated Version: rel:R25-11#dbb9122d Versionshistorie & Revisions (1 transition)
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_CRYPT_50131@rel:R25-11#dbb9122d
Point-in-Time History:
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

fonction GetResponseStatus [SWS_CRYPT_50130] Upstream: RS_CRYPTO_02306

virtual ara::core::Result< OcspResponseStatus > GetResponseStatus () const noexcept=0;

Get the OCSP response status.

Header-Datei#include "ara/crypto/x509/ocsp_response.h"
Scopeclass ara::crypto::x509::OcspResponse
Exception-Sicherheitexception safe
Thread-Sicherheitthread-safe

Rückgabewert

TypBeschreibung
ara::core::Result< OcspResponseStatus >The OCSP response status.

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_CRYPT_50130
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_50130@rel:R25-11#12e34d14
Content hash
12e34d14
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_50130
Status: valid/unmigrated Version: rel:R25-11#4ececdd1 Versionshistorie & Revisions (1 transition)
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_CRYPT_50130@rel:R25-11#4ececdd1
Point-in-Time History:
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

Documentation des alias de type

alias de type Sptrc [SWS_CRYPT_40802] Upstream: RS_CRYPTO_02306

using Sptrc = std::shared_ptr<const OcspResponse>;

Shared smart pointer of the interface.

Header-Datei#include "ara/crypto/x509/ocsp_response.h"
Scopeclass ara::crypto::x509::OcspResponse
SymbolSptrc

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

Record
AUTOSAR/AP/record/SWS_CRYPT_40802
Status
valid/unmigrated
Version
AUTOSAR/AP/record/SWS_CRYPT_40802@rel:R25-11#89654292
Content hash
89654292
Source
https://www.autosar.org/fileadmin/standards/R25-11/AP/AUTOSAR_AP_SWS_Cryptography.pdf#nameddest=SWS_CRYPT_40802
Status: valid/unmigrated Version: rel:R25-11#2a890aa7 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_CRYPT_40802@rel:R25-11#2a890aa7
Point-in-Time History:
Recorded Revisions (8):
  • R25-11rel:R25-11#9b089d122026-09-30
  • R19-11rel:R19-11#a479fd722026-10-14
  • R20-11rel:R20-11#e7a38ae12026-10-14
  • R21-11rel:R21-11#e7a38ae12026-10-14
  • R22-11rel:R22-11#3b79a0252026-10-14
  • R23-11rel:R23-11#b03460092026-10-14
  • R24-11rel:R24-11#fcfb189f2026-10-14
  • R25-11rel:R25-11#2a890aa72026-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