класс ara::crypto::x509::CertificateValidationResult

Интерфейс ara::crypto::x509::CertificateValidationResult предоставляет результат валидации сертификата X.509 и обычно управляется как неизменяемый Sptrc [SWS_CRYPT_50093]. Через его методы приложение запрашивает общий статус, определяет полную цепочку сертификатов с конечным сертификатом в позиции 0 или изолирует сертификат, вызвавший сбой. Если проверка прошла успешно, вызов для определения ошибочного сертификата завершается сбоем с кодом ошибки ara::crypto::CryptoErrc::kNoSuchValue [SWS_CRYPT_50095]. При этом все методы интерфейса спроектированы как потокобезопасные и исключение-безопасные.

больше ›

Контекст

Интерфейс ara::crypto::x509::CertificateValidationResult инкапсулирует результат операции валидации сертификата X.509 в рамках модуля Adaptive crypto. Его основная обязанность заключается в предоставлении вызывающим приложениям структурированного и согласованного результата проверки. Он охватывает как агрегированный статус валидации пути сертификации, так и доступ к задействованным объектам сертификатов. Выступая посредником между внутренними механизмами криптографической верификации и критически важными для безопасности приложениями, класс обеспечивает дифференцированный анализ иерархий сертификатов. В число его ключевых партнеров по взаимодействию входят экземпляры Certificate::Sptrc, которые либо формируются в виде полной цепочки сертификатов, либо в случае ошибки указываются в качестве причины сбоя.

Жизненный цикл

Будучи чисто виртуальным интерфейсом, CertificateValidationResult не определяет собственных открытых конструкторов. Время жизни и отношения владения в значительной степени управляются типизированным умным указателем Sptrc, который определен как std::shared_ptr<const CertificateValidationResult> [SWS_CRYPT_50093]. Этот константный указатель реализует разделяемую неизменяемую модель владения: после завершения валидации сертификата результирующий объект предоставляется в виде немодифицируемого снимка состояния. Создание и инициализация конкретных экземпляров, по всей видимости, осуществляются внутри высокоуровневыми функциями валидации бэкенда платформы. Вопрос Q-a5580dcf443b0905 (открытый) Поскольку все функции-члены объявлены как const, а также noexcept и явно специфицированы как потокобезопасные и исключение-безопасные ([SWS_CRYPT_50094], [SWS_CRYPT_50095], [SWS_CRYPT_50096]), несколько потоков могут обращаться к одному и тому же экземпляру параллельно и без дополнительных мер синхронизации до тех пор, пока не будет освобождена последняя ссылка.

Путь использования

Типичный сценарий использования начинается после получения экземпляра CertificateValidationResult::Sptrc из предшествующей проверки сертификата. Вызывающие компоненты выполняют оценку в стандартизированной последовательности:

• Сначала приложение вызывает GetValidationStatus(), чтобы запросить базовый результат валидации сертификата в виде CertificateValidationStatus [SWS_CRYPT_50094].
• Если валидация прошла успешно, клиент вызывает GetCertificateChain() для получения цепочки сертификатов, найденной в процессе проверки, в виде ara::core::Vector<Certificate::Sptrc> [SWS_CRYPT_50096]. Согласно спецификации, эта цепочка на позиции индекса 0 всегда начинается с конечного сертификата (Leaf Certificate) [SWS_CRYPT_50096].
• Если же валидация пути завершилась сбоем, вызывающий компонент вызывает GetFailedCertificate() для целенаправленного определения того сертификата, который вызвал ошибку валидации [SWS_CRYPT_50095].

Диаграмма последовательности: типичный процесс запроса статуса валидации, цепочки сертификатов и причины ошибки. Источники: [SWS_CRYPT_50094], [SWS_CRYPT_50095], [SWS_CRYPT_50096]

Сценарии ошибок

Управление ошибками интерфейса опирается на ara::core::Result, при этом все вызовы соблюдают гарантию noexcept и являются исключение-безопасными:

• Успешная валидация и GetFailedCertificate(): если проверка завершилась успешно (возвращаемое значение kValid), ни один сертификат не вызвал сбоя. В этом состоянии вызов GetFailedCertificate() завершается сбоем с кодом ошибки ara::crypto::CryptoErrc::kNoSuchValue [SWS_CRYPT_50095]. Приложения должны интерпретировать эту ошибку как логическое подтверждение безошибочной цепочки или привязывать вызов к отрицательному статусу.
• Специфичные для реализации ошибки статуса: для GetValidationStatus() не определены стандартизированные коды ошибок, однако ошибки реализации инкапсулируются в возвращаемом ara::core::Result [SWS_CRYPT_50094].
• Запрос цепочки сертификатов: GetCertificateChain() также не специфицирует стандартизированных кодов ошибок [SWS_CRYPT_50096]; возможные внутренние состояния ошибок сигнализируются через результирующий ara::core::Result.