класс ara::crypto::cryp::SymmetricKey

Интерфейс ara::crypto::cryp::SymmetricKey служит в AUTOSAR Adaptive абстракцией для симметричных криптографических ключей и наследует базовые свойства от CryptoObject. Приложения и криптографические контексты управляют экземплярами ключей преимущественно через стандартизированный тип смарт-указателя Sptr (std::shared_ptr<SymmetricKey>) согласно заголовочному файлу ara/crypto/cryp/cryobj/symmetric_key.h [SWS_CRYPT_23801]. Интерпретация: создание экземпляров, вероятно, осуществляется через специализированные подпрограммы генерации системы управления ключами, при этом ключ передается для конфигурации шифров или MAC. Вопрос Q-f76fecc360d2d3a5 (открытый) В качестве определяющего граничного условия подсчет ссылок Shared Pointer задает время жизни, так что инкапсулированный объект ключа уничтожается только после освобождения последней ссылки [SWS_CRYPT_23801].

больше ›

Контекст

Класс ara::crypto::cryp::SymmetricKey в AUTOSAR Adaptive Platform (Release R25-11, модуль crypto) образует центральный интерфейс для представления симметричных криптографических ключей. Как базовый компонент подсистемы криптографии этот интерфейс инкапсулирует все свойства, необходимые для симметричных криптографических методов. Класс напрямую унаследован от CryptoObject (class SymmetricKey : public CryptoObject) и тем самым встраивается в единую иерархию объектов для криптографических сущностей Adaptive Platform. Интерфейс объявляется в заголовочном файле ara/crypto/cryp/cryobj/symmetric_key.h [SWS_CRYPT_23801].

В качестве партнеров по взаимодействию обычно выступают криптографические контексты выполнения, а также сущности управления ключами. Интерфейс функционирует как связующее звено между созданием или предоставлением ключевого материала и его оперативным применением. Интерпретация: симметричные ключи, вероятно, находят применение в первую очередь в симметричных методах шифрования (например, в блочных или потоковых шифрах), а также в кодах аутентификации сообщений (MAC) для обеспечения конфиденциальности и целостности данных на уровне транспортного средства. Вопрос (открытый) Инкапсуляция в виде CryptoObject гарантирует, что ключевой материал остается отделенным от конкретного криптографического преобразования.

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

Жизненный цикл экземпляров ara::crypto::cryp::SymmetricKey тесно связан с современными шаблонами управления памятью C++. Согласно [SWS_CRYPT_23801], класс предоставляет псевдоним типа Sptr, определенный как using Sptr = std::shared_ptr<SymmetricKey>;. Через этот разделяемый смарт-указатель жизненный цикл интерфейсного объекта управляется детерминированно с подсчетом ссылок.

Интерпретация: фактическое создание и инициализация экземпляров на практике, вероятно, происходят через специализированные генераторы ключей, подпрограммы загрузки или компоненты управления ключами криптографического стека, поскольку определение интерфейса не содержит открытых стандартных конструкторов для прямого создания экземпляров необработанных ключей. Вопрос Q-51acf16b99d9ad1b (открытый) Как только экземпляр ключа создан как Sptr, на него могут параллельно ссылаться несколько программных компонентов или криптографических контекстов на основе совместного владения [SWS_CRYPT_23801].

Освобождение базовых ресурсов происходит автоматически, как только последний активный Sptr уничтожается или сбрасывается. Интерпретация: наследование от CryptoObject позволяет предположить, что чувствительный ключевой материал в памяти защищен особым образом и безопасно очищается (Zeroization) при уничтожении объекта во избежание считывания по истечении времени жизни. Вопрос (открытый) Использование std::shared_ptr также гарантирует потокобезопасность при управлении счетчиками ссылок, тогда как доступ к самому объекту ключа, на который указывает ссылка, подчиняется стандартным правилам синхронизации для совместно используемых ресурсов.

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

Штатное использование ara::crypto::cryp::SymmetricKey в Adaptive-приложении следует структурированному процессу, опирающемуся на определенный смарт-указатель [SWS_CRYPT_23801]:

• Подключение заголовочного файла: сначала использующий программный компонент подключает заголовочный файл #include "ara/crypto/cryp/cryobj/symmetric_key.h" для получения доступа к определению типа и псевдониму Sptr [SWS_CRYPT_23801].
• Получение ключа: приложение получает интерфейс в виде ara::crypto::cryp::SymmetricKey::Sptr [SWS_CRYPT_23801], например, из предшествующего процесса предоставления ключа.
• Проверка валидности: перед оперативным использованием вызывающая сторона проверяет, что полученный Sptr не равен nullptr и указывает на интактный CryptoObject.
• Назначение криптоконтекстам: указатель на ключ передается ответственному криптографическому контексту для его настройки на предстоящие операции шифрования, расшифрования или проверки целостности.
• Освобождение: после завершения преобразований или при выходе из контекста приложения указатель сбрасывается; уничтожение ключа происходит путем автоматического удаления последнего Sptr [SWS_CRYPT_23801].