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

Интерфейс ara::crypto::cryp::WriteableKeySlot служит в AUTOSAR Adaptive доступной для записи абстракцией для мест хранения ключей в CryptoProvider. Экземпляры не могут быть скопированы или перемещены ([SWS_CRYPT_50170], [SWS_CRYPT_50168]), а адресуются через тип умного указателя Sptr [SWS_CRYPT_50172]. С помощью потокобезопасного метода Clear() содержимое ключевого слота очищается, причем в случае таких ошибок, как kBusyResource или kUnsupported, применяется семантика отката [SWS_CRYPT_30405].

больше ›

Контекст

Интерфейс ara::crypto::cryp::WriteableKeySlot определяет в AUTOSAR Adaptive Platform доступное для записи место хранения криптографических ключей в контексте CryptoProvider. Он напрямую наследуется от базового интерфейса KeySlot и представляет собой стандартизированную абстракцию для целенаправленной очистки управляемых ключевых слотов и контроля их жизненного цикла. В качестве ключевых участников взаимодействия выступают приложения криптографического стека в роли потребителей, а также конкретный CryptoProvider, управляющий привязкой к физическому или логическому хранилищу ключей. При этом создание конкретных экземпляров, вероятно, осуществляется с помощью вышестоящих фабричных методов или методов провайдера, поскольку интерфейс функционирует как чисто абстрактный базовый класс. Вопрос Q-5c3b13bb35c3ff53 (открытый)

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

Модель ресурсов и владения ara::crypto::cryp::WriteableKeySlot строго запрещает дублирование ссылок на ключи через семантику значений. С этой целью как конструктор копирования [SWS_CRYPT_50170], так и конструктор перемещения [SWS_CRYPT_50171] явно удалены (=delete). Точно так же удаленные объявления оператора присваивания копированием [SWS_CRYPT_50168] и оператора присваивания перемещением [SWS_CRYPT_50169] исключают любое последующее присваивание.

Передача по ссылке и совместное управление вместо этого осуществляются через определенный псевдоним типа умного указателя Sptr, выраженный как std::shared_ptr<WriteableKeySlot> [SWS_CRYPT_50172]. Уничтожение экземпляра защищено виртуальным деструктором по умолчанию, который специфицирован как безопасный относительно исключений (exception safe) и не генерирует исключений (noexcept=default) [SWS_CRYPT_50167]. Это обеспечивает безопасное полиморфное освобождение через указатели на интерфейс. С точки зрения состояния слот может быть занят или пуст. Заполнение слота, вероятно, происходит через отдельные интерфейсы CryptoProvider, тогда как очистка реализуется через потокобезопасный метод Clear() [SWS_CRYPT_30405]. Вопрос Q-72dfcb17eb3e2d25 (открытый)

Диаграмма состояний: переходы состояний содержимого ключа посредством Clear() и обработка ошибок. Источники: [SWS_CRYPT_30405]

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

Основной путь использования сосредоточен на контролируемом сбросе или удалении сохраненного ключевого материала:

• Получение ссылки: вызывающая сторона обращается к экземпляру через общий указатель типа WriteableKeySlot::Sptr [SWS_CRYPT_50172].
• Вызов удаления: путем вызова чисто виртуального метода Clear() запускается операция удаления для текущего содержимого ключевого слота [SWS_CRYPT_30405]. Поскольку метод является потокобезопасным, вызов может происходить и в параллельных контекстах [SWS_CRYPT_30405].
• Проверка результата: операция возвращает ara::core::Result<void> [SWS_CRYPT_30405]. Если ключевой слот уже был пуст ранее или содержимое было удалено без ошибок, результат представляет успешное состояние с пустым значением [SWS_CRYPT_30405].

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

Метод Clear() объявлен как безопасный относительно исключений и noexcept; ошибочные ситуации передаются согласно модели ошибок AUTOSAR Adaptive через ara::core::Result [SWS_CRYPT_30405]. Возможные коды ошибок включают:

• ara::crypto::CryptoErrc::kUnsupported: возникает, если конкретная реализация ключевого слота не поддерживает удаление [SWS_CRYPT_30405]. Для этого случая интерфейс гарантирует семантику отката, благодаря чему состояние остается неизменным [SWS_CRYPT_30405].
• ara::crypto::CryptoErrc::kBusyResource: возвращается, если операция удаления временно не может быть выполнена [SWS_CRYPT_30405]. Обычно это вызывается конкурирующим доступом к аппаратно привязанным ресурсам памяти. Вопрос (открытый) В этом случае семантика отката также гарантирует отсутствие частичных изменений [SWS_CRYPT_30405].