클래스 ara::idsm::ReportingModeProvider

클래스 ara::idsm::ReportingModeProvider은(는) Intrusion Detection System Manager에서 보안 관련 이벤트의 Reporting Mode를 쿼리하고 설정하기 위한 메커니즘을 제공합니다 [SWS_AIDSM_10600]. 인스턴스화는 모델링된 PPort에 대한 ara::core::InstanceSpecifier을(를) 통해 스레드 안전하게 수행됩니다 [SWS_AIDSM_10601]. 런타임 시 메서드 GetReportingMode 및 SetReportingMode은(는) 구성된 이벤트의 모드를 읽고 변경할 수 있도록 합니다. 이러한 메서드는 스레드 안전하지 않으므로 동시 접근 시 외부에서 동기화해야 합니다. 알 수 없는 이벤트 ID의 경우 메서드는 IdsmErrc::kUnknownEventId 오류를 반환합니다.

자세히 ›

컨텍스트

클래스 ara::idsm::ReportingModeProvider은(는) 헤더 ara/idsm/reporting_mode_provider.h에 정의되어 있으며, Adaptive 모듈 idsm 내에서 Intrusion Detection System Manager(IdsM)를 위한 Reporting Mode의 제공 및 동적 제어 역할을 합니다 [SWS_AIDSM_10600]. 네트워크로 연결된 차량 아키텍처에서 IdsM은 보안 관련 이벤트(Security Events)를 모니터링합니다. ReportingModeProvider을(를) 통해 애플리케이션 또는 담당 플랫폼 서비스는 구성된 보안 이벤트를 처리하여 이벤트가 IdsM 시스템에 보고되는 방식을 확인하거나 설정할 수 있습니다. 아키텍처에 대한 바인딩은 인스턴스화 시 지정되는 모델링된 PPort를 통해 수행됩니다 [SWS_AIDSM_10601].

수명 주기

이 클래스는 final(으)로 선언되어 있어 [SWS_AIDSM_10600] 상속 또는 다형성 특수화가 배제됩니다. 객체 생성은 명시적 생성자 ReportingModeProvider(const ara::core::InstanceSpecifier& instance)을(를) 통해 수행됩니다 [SWS_AIDSM_10601]. 매개변수 instance을(를) 통해 구체적으로 모델링된 PPort로의 바인딩이 설정됩니다 [SWS_AIDSM_10601]. 해석: 전달된 인스턴스 지정자는 아마도 IdsM 서비스를 위해 AUTOSAR 모델에 구성된 인터페이스 배포를 참조할 것으로 보입니다. 질문 Q-a7c5bdfa7e2ba42b (열림)

동시성과 관련하여 생성자는 스레드 안전(thread-safe)한 것으로 지정되어 있습니다 [SWS_AIDSM_10601]. 반면에 Reporting Mode를 읽고 쓰기 위한 두 운영 메서드는 명시적으로 스레드 안전하지 않음(not thread-safe)으로 표시되어 있습니다 [SWS_AIDSM_10602], [SWS_AIDSM_10603]. 여러 스레드가 ReportingModeProvider의 동일한 인스턴스에 병렬로 접근하는 경우, 호출자는 이 접근을 외부에서 동기화해야 합니다. 인스턴스의 수명 주기는 일반적으로 객체를 생성, 관리하고 상호작용이 끝난 후 소멸시키는 사용하는 애플리케이션의 수명에 결합됩니다.

사용 경로

일반적인 사용은 초기화, 현재 상태 쿼리 및 필요에 따른 Reporting Mode 조정으로 나뉩니다.

먼저 애플리케이션은 해당 InstanceSpecifier을(를) 지정하여 지정된 포트에 대한 공급자를 인스턴스화합니다 [SWS_AIDSM_10601]. 그런 다음 메서드 GetReportingMode을(를) 사용하여 구성된 특정 이벤트에 대한 현재 Reporting Mode를 쿼리할 수 있습니다 [SWS_AIDSM_10602]. 이 메서드는 모드를 캡슐화하거나 발생한 오류를 알리는 ara::core::Result<ReportingModeType>을(를) 반환합니다 [SWS_AIDSM_10602].

보안 상황 또는 진단 구성에 따라 수정이 필요한 경우 SetReportingMode이(가) 호출됩니다 [SWS_AIDSM_10603]. 이 호출은 식별자 eventId 및 새 reportingMode을(를) 수신하고 ara::core::Result<void>을(를) 반환합니다 [SWS_AIDSM_10603]. 애플리케이션은 구성 변경이 성공적으로 완료되었는지 확인하기 위해 결과를 검사합니다.

시퀀스 다이어그램: 공급자를 통해 Reporting Mode를 쿼리하고 업데이트하기 위한 일반적인 사용 경로. 출처: [SWS_AIDSM_10601], [SWS_AIDSM_10602], [SWS_AIDSM_10603]

오류 시나리오

클래스의 모든 메서드는 noexcept(으)로 선언되어 있습니다 [SWS_AIDSM_10601], [SWS_AIDSM_10602], [SWS_AIDSM_10603]. 따라서 오류 처리는 C++ 예외 없이 AUTOSAR 고유의 오류 모델을 통해 완전히 수행됩니다 ara::core::Result.

GetReportingMode을(를) 통한 조회 [SWS_AIDSM_10602]와(과) SetReportingMode을(를) 통한 설정 [SWS_AIDSM_10603] 모두 전달된 eventId이(가) 구성된 보안 이벤트와 일치해야 한다는 점을 전제 조건으로 합니다. 알 수 없거나 시스템에 등록되지 않은 이벤트 식별자가 전달되면 작업이 실패하고 Result에 오류 코드 IdsmErrc::kUnknownEventId이(가) 포함됩니다 [SWS_AIDSM_10602], [SWS_AIDSM_10603]. 호출하는 컴포넌트는 값에 접근하기 전에 Result을(를) 평가해야 하며 오류 발생 시 적절한 오류 처리 또는 로깅을 시작해야 합니다.