пространство имён apext::com::secoc

Пространство имён определяет специфичный для производителя интерфейс для управления значениями свежести в рамках Secure Onboard Communication (SecOC) для AUTOSAR Adaptive Platform Communication Management (SWS Communication Management §C.1 «Header: apext/com/secoc/fvm.h»). Жизненный цикл и инициализация Freshness Value Manager полностью управляются диспетчером связи, который запрашивает значения свежести через интерфейс при сконфигурированных процессах отправки ([SWS_CM_11272]). При временной недоступности значений свежести выполняются контролируемые повторные попытки вплоть до заданного порогового значения, прежде чем ошибочные сообщения будут отброшены. Дополнительно пространство имён предоставляет собственный домен ошибок и стандартизированные коды ошибок для диагностики и обработки исключений.

больше ›

Контекст

Пространство имён apext::com::secoc определяет нормативные интерфейсы расширений платформы (Platform Extension Interfaces) внутри функционального кластера Communication Management (ara::com) AUTOSAR Adaptive Platform (SWS Communication Management §C.1 «Header: apext/com/secoc/fvm.h»). Цель этих интерфейсов расширения состоит в том, чтобы позволить OEM-производителям и поставщикам стеков предоставлять адаптированный Freshness Value Manager (FVM), который генерирует, администрирует и верифицирует значения свежести для Secure Onboard Communication (SecOC), необходимые для защиты от атак повторного воспроизведения.

Пространство имён взаимодействует в основном с тремя ролями: диспетчером связи (ara::com), стандартизированным определением интерфейса (FVM) вместе с носителями данных, такими как FVContainer ([SWS_CM_11286], [SWS_CM_11344]), а также конкретной реализацией FVM автопроизводителя или поставщика стека. Интерпретация: предполагается, что специфичная для производителя библиотека FVM подключается в рамках системной интеграции как статическая или динамическая библиотека, поскольку спецификация задаёт функциональный интерфейс, оставляя форму интеграции на усмотрение конкретного стека. Вопрос Q-256aef3d6698cc3f (открытый)

Контекстная диаграмма: интеграция пространства имён apext::com::secoc между Communication Management и специфичной для производителя реализацией FVM. Источники: [SWS_CM_11272], SWS Communication Management §C.1 «Header: apext/com/secoc/fvm.h».

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

Управление жизненным циклом реализации FVM полностью контролируется диспетчером связи ara::com ([SWS_CM_11272]). Приложения и экземпляры служб не создают компонент FVM и не управляют им напрямую.

Ввод в эксплуатацию происходит детерминированно во время инициализации коммуникационного стека путём вызова библиотечного API apext::com::secoc::FVM::Initialize ([SWS_CM_11273]). Если инициализация со стороны производителя не может быть завершена корректно, уровень FVM сигнализирует об этом состоянии ошибки через определённый код ошибки kFVInitializeFailed ([SWS_CM_11342]). После успешного вызова инициализации Freshness Value Manager остаётся в активном рабочем состоянии и отвечает на синхронные запросы значений свежести для отправки и приёма.

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

Обычный путь использования делится на защиту отправки и верификацию приёма сообщений:

• Отправляемые сообщения: если сообщение сконфигурировано для отправки через SecOC, оно обрабатывается как аутентичное сообщение ([SWS_CM_11274]). Защита выполняется в строго определённом порядке после завершения всех вычислений защиты E2E ([SWS_CM_11274]). Если конфигурация сервисного интерфейса содержит атрибут freshnessValueId, диспетчер связи вызывает apext::com::secoc::FVM::GetTxFreshness ([SWS_CM_11274], [SWS_CM_11275]). Значение свежести предоставляется в структуре FVContainer, которая хранит битовую длину в атрибуте length и само значение ([SWS_CM_11286], [SWS_CM_11344]).
• Механизм повтора при отправке: для каждого защищённого сообщения система ведёт Authentication Build Counter ([SWS_CM_11275]). После успешной генерации счётчик сбрасывается в 0. Если GetTxFreshness возвращает устранимую ошибку kFVNotAvailable или вычисление аутентификатора завершается неудачно, счётчик инкрементируется, и формирование повторяется ([SWS_CM_11275]). Если счётчик достигает порогового значения SecOCAuthenticationBuildAttempts, сообщение отбрасывается ([SWS_CM_11275]).
• Входящие сообщения: для входящих сообщений SecOC с активной верификацией (атрибут securedRxVerification со значением «истина» или не задан) извлекается аутентификатор (Authenticator) и сообщение верифицируется перед E2E-проверками путем пересчета MAC ([SWS_CM_11276], SWS Communication Management §8.1 «SecOC secure channel reception»). Если же атрибут securedRxVerification установлен в значение «ложь», верификация обходится (Bypass) и сообщение обрабатывается без проверки ([SWS_CM_11372]).

Диаграмма последовательности: процесс вызова и повторных попыток при защите исходящего сообщения с помощью FVM. Источники: [SWS_CM_11274], [SWS_CM_11275].

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

Ошибочные ситуации в рамках интерфейса FVM обрабатываются через типобезопасный домен ошибок ComSecOcFvmErrorDomain, экземпляр которого можно получить через GetComSecOcFvmErrorDomain ([SWS_CM_12521]). Коды ошибок определены в типе перечисления ComSecOcFvmErrc ([SWS_CM_11342]):

• kFVNotAvailable (код 1): требуемое значение свежести временно недоступно. Это сигнализирует Communication Management об устранимой ошибке, что инициирует повторные попытки согласно протоколу отправки ([SWS_CM_11275], [SWS_CM_11342]).
• kFVInitializeFailed (код 2): инициализация Freshness Value Manager завершилась сбоем ([SWS_CM_11342]).

С помощью вспомогательной функции MakeErrorCode ([SWS_CM_12522]) коды ошибок вместе с дополнительными данными от производителя (SupportDataType) можно инкапсулировать в стандартные объекты ara::core::ErrorCode. Для неудачных синхронных вызовов в средах на основе исключений предусмотрен класс исключений ComSecOcFvmException.