클래스 ara::crypto::cryp::CryptoContext

이 인터페이스는 단일 암호화 객체에 고정 바인딩되지 않는 가변 암호화 컨텍스트를 위한 공통 기본 클래스 역할을 합니다. 순수 가상 메서드 GetAlgId()을(를) 통해 알고리즘 식별자를 ara::core::Result [SWS_CRYPT_20411](으)로 스레드 안전하게 조회할 수 있도록 합니다. 원치 않는 상태 복제를 방지하기 위해 복사 및 이동 연산은 완전히 금지됩니다 [SWS_CRYPT_41003]. 해제는 가상 기본 소멸자를 통해 결정론적이고 안전하게 수행됩니다.

자세히 ›

컨텍스트

인터페이스 ara::crypto::cryp::CryptoContext은(는) AUTOSAR Adaptive Platform의 crypto 모듈 내에서 가변 암호화 컨텍스트(mutable cryptographic contexts)를 위한 기본 추상화를 정의합니다. 정적 암호화 객체와 달리 이러한 컨텍스트는 단일 암호화 객체에 고정적으로 바인딩되지 않습니다. 오히려 암호화 작업 실행 중에 내부 상태가 변경될 수 있는 다양한 암호화 처리 컨텍스트를 위한 공통 기본 클래스 역할을 합니다.

이 기본 인터페이스의 핵심 요소는 순수 가상 멤버 함수 GetAlgId()입니다. 이를 통해 상호작용 파트너는 컨텍스트에 현재 구성된 암호화 알고리즘의 식별자를 조회할 수 있습니다 [SWS_CRYPT_20411]. 해시, 서명 또는 암호화 서비스와 같은 구체적인 암호화 계산 및 변환 컨텍스트는 특정 알고리즘 기능을 제공하기 위해 시스템에서 CryptoContext로부터 파생될 것으로 보입니다. 질문 Q-203d40209cd355fa (열림)

수명 주기

CryptoContext의 수명 주기는 고유한 식별성과 엄격한 소유권 관계를 특징으로 합니다. 컴파일 시점에 제어되지 않는 복제 또는 일관성 없는 컨텍스트 상태 전송을 방지하기 위해 시맨틱 복사 작업은 완전히 금지됩니다. 복사 생성자 [SWS_CRYPT_41003] 및 복사 할당 연산자 [SWS_CRYPT_30214] 모두 명시적으로 삭제(=delete)된 것으로 선언되어 있습니다.

마찬가지로 인터페이스 정의는 컨텍스트의 이동을 금지합니다. 이동 생성자 [SWS_CRYPT_41004] 및 이동 할당 연산자 [SWS_CRYPT_30215] 모두 삭제되어 있습니다(=delete). 따라서 파생 클래스의 인스턴스는 원래 메모리 위치에 영구적으로 유지됩니다. 소멸 및 리소스 해제는 default 및 noexcept(으)로 정의된 가상 소멸자를 통해 결정론적으로 수행됩니다 [SWS_CRYPT_20401]. 이를 통해 파생 컨텍스트 객체를 기본 인터페이스에 대한 포인터를 통해 리소스 누수 없이 안전하게 해제할 수 있습니다.

동시성과 관련하여 GetAlgId()에 대한 요구사항은 명시적으로 스레드 안전성을 지정합니다 [SWS_CRYPT_20411]. 따라서 여러 스레드가 외부 동기화 없이 동일한 컨텍스트의 알고리즘 식별자를 동시에 읽을 수 있습니다.

사용 경로

CryptoContext은(는) 순수 가상 인터페이스이므로 애플리케이션 개발자는 직접 인스턴스를 생성할 수 없습니다. 특화된 컨텍스트 클래스의 인스턴스는 일반적으로 암호화 스택의 팩토리 함수 또는 공급자 컴포넌트를 통해 인스턴스화되어 포인터나 참조를 통해 호출자에게 제공될 것으로 보입니다. 질문 Q-728a7b6dd526eb64 (열림) 기본 인터페이스 수준에서의 일반적인 사용 흐름은 다음 단계로 구성됩니다:

• 제공: 호출자가 암호화 공급자로부터 구성된 컨텍스트에 대한 참조 또는 포인터를 수신합니다.
• 알고리즘 검사: GetAlgId() 호출을 통해 알고리즘 식별자를 조회하고 평가하여 [SWS_CRYPT_20411] 컨텍스트가 요구된 사양을 충족하는지 확인합니다.
• 작업 및 정리: 파생 인터페이스를 통해 알고리즘별 작업을 수행한 후, 가상 소멸자를 통해 컨텍스트가 자동으로 해제됩니다 [SWS_CRYPT_20401].

오류 시나리오

CryptoContext의 오류 처리 개념은 AUTOSAR Adaptive Platform의 일반적인 안전 장애(fail-safe) 설계를 따르며 C++ 예외를 사용하지 않습니다. 메서드 GetAlgId()은(는) 예외 안전(exception safe)(으)로 지정되어 있으며 결과를 ara::core::Result<ara::crypto::AlgIdString> 안에 반환합니다 [SWS_CRYPT_20411]. 알고리즘 ID를 결정하는 동안 오류가 발생하는 경우 이는 Result 객체의 오류 채널을 통해 전달됩니다.

사양에 따르면 GetAlgId()은(는) 표준화된 오류 코드를 정의하지 않습니다 [SWS_CRYPT_20411]. 따라서 호출자는 알고리즘 ID 문자열에 접근하기 전에 주로 Result에 유효한 값이 포함되어 있는지 확인해야 합니다. 객체를 해체할 때 noexcept(으)로 선언된 가상 소멸자는 소멸 중에 예외가 전파되지 않고 정리가 항상 안정적으로 완료되도록 보장합니다 [SWS_CRYPT_20401].