类 ara::crypto::cryp::PrivateKey

接口 ara::crypto::cryp::PrivateKey 定义了 AUTOSAR Adaptive 中非对称私钥的通用接口，主要通过共享指针别名 PrivateKey::Sptr 进行管理 [SWS_CRYPT_22501]。其核心函数 GetPublicKey() 允许将关联的公钥作为 PublicKey::Sptr 获取，以便为加密对接操作提供该公钥 [SWS_CRYPT_22511]。此获取操作被指定为线程安全且异常安全，没有标准化错误码，其中潜在错误可能以实现特定的方式通过返回类型 ara::core::Result 指示（解释）。 问题 (未决)

更多 ›

上下文

接口 ara::crypto::cryp::PrivateKey 在 AUTOSAR Adaptive Platform 中充当 crypto 模块内非对称私钥的泛化接口。它在头文件 ara/crypto/cryp/cryobj/private_key.h 中声明，并直接继承自基接口 CryptoObject。作为非对称密码系统的核心组件，PrivateKey 封装了用于生成数字签名或非对称解密过程等加密操作所需的机密密钥材料。

除了基类 CryptoObject 之外，主要交互方尤其包括对应的公钥接口 PublicKey 以及消费加密服务和应用例程。虽然私钥必须始终保密，但该接口允许通过成员函数 GetPublicKey() 直接提供关联的公钥 [SWS_CRYPT_22511]。通过这种方式，实现了私钥与其数学对等物之间固定的类型关联关系。

上下文图：PrivateKey 在加密对象模型中的嵌入及其与对应 PublicKey 的关系。来源：[SWS_CRYPT_22501]、[SWS_CRYPT_22511]

生命周期

接口 PrivateKey 的实例通过类型化智能指针 PrivateKey::Sptr 进行管理和传递，该智能指针被定义为 std::shared_ptr<PrivateKey> 的类型别名 [SWS_CRYPT_22501]。该共享指针确保了共享所有权并通过引用计数实现自动资源管理，从而在最后一个引用失效时立即释放受保护的密钥材料。

由于 PrivateKey 是包含如 GetPublicKey() 等纯虚方法的抽象接口 [SWS_CRYPT_22511]，应用程序无法直接实例化该类。PrivateKey::Sptr 具体实例的创建和提供大概率通过 Adaptive 系统的专用工厂、密钥管理组件或加密提供程序进行（解释）。 问题 Q-f0f9fe2258fac168 (未决)该接口本身没有定义离散的内部状态或状态转换。

在并发方面，接口为其核心成员函数 GetPublicKey() 显式指定了线程安全性（thread-safe）[SWS_CRYPT_22511]。这允许多个执行流并发、免同步地读取访问同一密钥实例以获取对应的公钥。

使用路径

PrivateKey 的典型使用路径包括接收私钥以及随后提取对应的公钥以用于验证、注册或通信目的：

1. 获取密钥：消费软件组件以 PrivateKey::Sptr 形式接收非对称私钥的有效实例 [SWS_CRYPT_22501]。
2. 检索配对密钥：如果下游工作流需要对应的公钥，则组件在该实例上调用成员函数 GetPublicKey() [SWS_CRYPT_22511]。
3. 处理结果：该调用返回 ara::core::Result<PublicKey::Sptr> [SWS_CRYPT_22511]。应用程序检查结果对象是否成功，并在成功执行时解包指针 PublicKey::Sptr。
4. 后续使用：获取的公钥随后可以传输给外部通信伙伴或传递给本地验证例程。据推测，公钥的派生在内部可能直接根据私钥的数学密钥参数进行（解释）。 问题 Q-464000dc5d638649 (未决)

错误场景

对于无误的集成，GetPublicKey() 的错误特性和边界条件具有决定性意义：

• 标准化错误：根据规范，函数 GetPublicKey() 未定义标准化错误码 [SWS_CRYPT_22511]。
• 错误通道：尽管未指定标准化错误，返回类型 ara::core::Result 仍会传递潜在的失败。如果在内部密钥派生或对象创建期间发生错误，结果对象大概率可能包含底层加密驱动程序的实现特定错误码（解释）。 问题 Q-4af6390594d9c5e1 (未决)
• 异常安全性：该函数被显式归类为异常安全（exception safe），并带有标识符 noexcept [SWS_CRYPT_22511]。因此，调用方无需捕获 C++ 异常。
• 前置与后置条件：成功调用的前置条件是有效且未释放的 PrivateKey 实例。在成功的情况下，接口保证返回在数学上与私钥完全对应的 PublicKey::Sptr 作为后置条件 [SWS_CRYPT_22511]。