DEENESPTFRRUARHIKOZHNL

类 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

用户指南人工智能生成

提供用于证书验证的 OCSP 响应状态以及其中包含的证书。
AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: 79f06589ab79 来源 未决问题(2)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

提供用于证书验证的 OCSP 响应状态以及其中包含的证书。

接口 ara::crypto::x509::OcspResponse 封装了 AUTOSAR Adaptive 中用于检查证书状态的 OCSP 查询响应。调用方通常首先通过 GetResponseStatus() [SWS_CRYPT_50130] 检查响应状态,随后使用 GetCertificates() 获取所包含的证书 [SWS_CRYPT_50131]。通过指向不可变实例(Sptrc)的共享智能指针以并发安全且异常安全的方式进行访问 [SWS_CRYPT_40802]。

上下文

接口 ara::crypto::x509::OcspResponse 在 AUTOSAR Adaptive Platform 的模块 crypto 中封装了符合在线证书状态协议(OCSP)的响应数据。其主要职责是为应用程序和安全功能提供 X.509 证书的有效性及撤销状态。与静态证书撤销列表(CRL)相比,OCSP 允许向验证服务及时查询单个证书的状态。

在加密架构中,该接口充当身份验证服务或 TLS 协议栈等调用组件的信息源。它提供用于查询 OCSP 消息的上层响应状态 [SWS_CRYPT_50130] 以及读取响应中传输的证书 [SWS_CRYPT_50131] 的方法。通过这种方式,通信伙伴可以直接验证证书链的有效性。

生命周期

作为纯虚接口,ara::crypto::x509::OcspResponse 未定义任何公共构造函数或自带的工厂方法。实例化通常在平台内部通过解析所接收 OCSP 响应原始数据的加密栈驱动程序和提供程序组件完成(Interpretation: 具体实例由底层 X.509 提供程序创建)。 问题 Q-30d53aa886333cbc (未决)

为了分发和管理实例,该类将类型别名 Sptrc 指定为 std::shared_ptr<const OcspResponse> [SWS_CRYPT_40802]。通过该智能指针建立了具有严格只读访问权限的共享所有权关系。对象的生命周期通过共享指针的引用计数进行管理,并在最后一个引用释放时自动终止。

在并发性和容错方面,方法 GetResponseStatus [SWS_CRYPT_50130] 与 GetCertificates [SWS_CRYPT_50131] 被声明为异常安全(exception safe)和线程安全(thread-safe)。由于通过 Sptrc [SWS_CRYPT_40802] 仅授予常量访问权限,多个线程可以并发访问同一个 OCSP 响应实例,而无需外部锁。

使用路径

评估 OCSP 响应的典型流程包括检查状态以及随后获取嵌入的证书:

  1. 查询状态:调用方首先调用 GetResponseStatus() [SWS_CRYPT_50130]。该方法返回一个 ara::core::Result<OcspResponseStatus>,指示响应是成功生成还是存在协议错误。
  2. 检查结果:应用程序检查 Result 对象。仅当 OCSP 响应被标记为成功时,评估后续有效负载数据才有意义。
  3. 获取证书:随后,应用程序调用 GetCertificates() [SWS_CRYPT_50131]。此时将返回一个封装了 OCSP 响应中所包含全部证书的 ara::core::Result<ara::core::Vector<Certificate::Sptrc>>。
  4. 执行验证:提取的证书推测用于验证 OCSP 响应的签名或响应程序的证书链(Interpretation: 证书支持 OCSP 数据的真实性检查)。 问题 Q-4f4a5f1b72358a1f (未决)
OcspResponse 的典型使用路径应用OcspResponseGetResponseStatus()Result<OcspResponseStatus>optStatus erfolgreichGetCertificates()Result<Vector<Certificate::Sptrc>>

时序图:查询 OCSP 响应状态并检索所包含证书的典型顺序。来源:[SWS_CRYPT_50130]、[SWS_CRYPT_50131]。

错误场景

该接口的两个方法均使用 ara::core::Result 作为同步返回类型,并带有标识符 noexcept,从而排除了抛出同步 C++ 异常的可能性 [SWS_CRYPT_50130] [SWS_CRYPT_50131]。

对于 GetResponseStatus() [SWS_CRYPT_50130] 和 GetCertificates() [SWS_CRYPT_50131],AUTOSAR 规范未显式定义标准化错误码。可能的错误原因(例如解析错误或平台内部内存瓶颈)将通过 ara::core::Result 的错误对象进行特定于实现的报告。前置条件是存在 OcspResponse::Sptrc [SWS_CRYPT_40802] 类型的有效指针,因为通过空指针访问会导致未定义行为。

本指南由 AI 基于 crypto 模块的 AUTOSAR 规范 R25-11 生成。

成员图

类图

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

G nara__crypto__x509__OcspResponse358 OcspResponse + GetCertificates() + GetResponseStatus()

详细视图

请在大纲中选择一个条目。

方法

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;

类型别名

Sptrc 类型别名

Shared smart pointer of the interface.

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

方法文档

函数 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.

AI 生成 未审核 模型: gemini-3.8-flash-medium · 推理强度: medium · 温度: 不可控 · 提示词: 6d5761e60511 来源 未决问题(1)
译自德文指南gemini-3.8-flash-low · 2026-10-13 · 德文原文

使用

接口 ara::crypto::x509::OcspResponse([SWS_CRYPT_50131])的方法 GetCertificates 用于同步检索接收到的 OCSP 响应中嵌入的所有证书。该调用在 OcspResponse 的实例上无参数进行,通过头文件 ara/crypto/x509/ocsp_response.h([SWS_CRYPT_50131])。作为返回值,该函数提供一个 ara::core::Result<ara::core::Vector<Certificate::Sptrc>>([SWS_CRYPT_50131]),在成功执行时提供一个包含指向所含证书对象的智能指针的向量。

错误处理

根据规范,该函数未定义标准化错误代码([SWS_CRYPT_50131])。解释:通过在返回类型 ara::core::Result 中的封装,调用方可能仍须检查是否存在任何实现特定的错误状态,尽管 AUTOSAR 未为此方法规定规范化错误([SWS_CRYPT_50131])。 问题 Q-d37b6b547d25b17f (未决)

并发性与限制

接口定义将 GetCertificates 标明为 const 以及 noexcept([SWS_CRYPT_50131])。此外,该函数被指定为 thread-safe 和 exception-safe([SWS_CRYPT_50131])。因此,调用方可以从多个线程并发地并行执行该方法,而无需外部同步机制。

该文本根据 AUTOSAR 规范自动生成。

实现者指南即将推出(复杂度 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#ff428e1d
Content hash
ff428e1d
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

函数 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#243c8183
Content hash
243c8183
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

类型别名文档

类型别名 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#4c50cc0a
Content hash
4c50cc0a
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