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

Интерфейс ara::crypto::x509::X509DN служит для инкапсуляции и предоставления X.509 Distinguished Name в качестве сериализуемой структуры данных внутри криптографического модуля. Через псевдоним Sptrc реализуется совместное неизменяемое владение экземплярами как std::shared_ptr<const X509DN> [SWS_CRYPT_40401]. Центральный метод ToString() форматирует полное имя согласно RFC 4514 и работает потокобезопасно, а также без стандартизированных кодов ошибок [SWS_CRYPT_40411]. Вызывающие компоненты получают результат в виде ara::core::Result<ara::core::String>, который перед дальнейшей обработкой необходимо проверить на валидность.

больше ›

Контекст

Абстрактный интерфейс ara::crypto::x509::X509DN представляет внутри модуля crypto AUTOSAR Adaptive Platform имя Distinguished Name (DN) в соответствии со стандартом X.509. За счет наследования от ara::crypto::Serializable класс встроен в иерархию типов как сериализуемая криптографическая структура данных. Основная задача интерфейса состоит в программной инкапсуляции структур имен сертификатов, субъектов сертификатов (Subjects) или центров сертификации (Issuers). Центральную роль при этом играет предоставление нормированного текстового представления: согласно [SWS_CRYPT_40411], метод ToString() экспортирует полное Distinguished Name в виде символьной строки в соответствии со спецификацией RFC 4514. Если базовое Distinguished Name содержит нестандартизированные атрибуты, для этих атрибутов используется соответствующий Object Identifier (OID) [SWS_CRYPT_40411].

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

Поскольку ara::crypto::x509::X509DN представляет собой абстрактный интерфейс C++ с чисто виртуальными методами, такими как ToString(), создание экземпляров разработчиками приложений напрямую не выполняется. Полезная нагрузка не специфицирует открытого конструктора; создание конкретных экземпляров, вероятно, осуществляется вышестоящими компонентами или парсерами сертификатов криптографической подсистемы. Вопрос Q-108d7589869c7370 (открытый)

Для совместного и долговременного доступа интерфейс определяет спецификатор типа Sptrc как псевдоним для std::shared_ptr<const X509DN> [SWS_CRYPT_40401]. Использование константного shared pointer подчеркивает концепцию владения и доступа: экземпляры X509DN являются неизменяемыми (immutable) извне. Несколько потребителей могут безопасно и без сохранения состояния разделять одно и то же представление Distinguished Name без каких-либо затрат на синхронизацию при операциях чтения. С точки зрения параллелизма центральный метод ToString() явно объявлен потокобезопасным (thread-safe) [SWS_CRYPT_40411]. Таким образом, параллельные вызовы через один и тот же shared pointer или из разных потоков допустимы без внешних блокировок. Кроме того, спецификация гарантирует для этого вызова полную безопасность исключений (exception safe) [SWS_CRYPT_40411].

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

Типичный сценарий использования сосредоточен на считывании и дальнейшей обработке отформатированного Distinguished Name для протоколирования, аутентификации или проверки подлинности. Приложение обычно получает указатель типа ara::crypto::x509::X509DN::Sptrc [SWS_CRYPT_40401].

На этом экземпляре вызывающая сторона выполняет метод ToString() [SWS_CRYPT_40411]. Вызов выполняется noexcept и возвращает ara::core::Result<ara::core::String> [SWS_CRYPT_40411]. При успешной обработке объект Result содержит строку, отформатированную согласно RFC 4514, например в стандартизированной форме пар «атрибут-значение», таких как CN=..., или с использованием OID для проприетарных атрибутов [SWS_CRYPT_40411]. Затем приложение может извлечь результирующую строку и использовать ее далее для специфических проверок, сравнений или журналов аудита.

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

При взаимодействии с ara::crypto::x509::X509DN обработка ошибок отличается лаконичным, минималистичным дизайном. Хотя ToString() использует тип возвращаемого значения ara::core::Result<ara::core::String>, спецификация явно определяет, что функция не задает стандартизированных кодов ошибок [SWS_CRYPT_40411]. Это означает, что в контексте штатной спецификации не предусмотрено функциональных причин отклонения или ошибок валидации для процесса сериализации.

Поскольку функция дополнительно специфицирована как noexcept и как exception safe [SWS_CRYPT_40411], синхронные исключения C++ исключены. Если в возвращаемом ara::core::Result все же возникают ошибочные состояния, они, вероятно, обусловлены платформенно- или реализационно-зависимыми причинами, такими как нехватка памяти при выделении результирующей строки. Вопрос Q-10477dd7d77e3b78 (открытый) Поэтому вызывающие стороны перед распаковкой значения всегда должны проверять, содержит ли Result допустимое значение или ошибку, даже если AUTOSAR не задает для этого предметно-ориентированных констант ошибок.