클래스 ara::crypto::cryp::PrivateKey

인터페이스 ara::crypto::cryp::PrivateKey은(는) AUTOSAR Adaptive의 비대칭 개인 키를 위한 일반 인터페이스를 정의하며 주로 공유 포인터 별칭 PrivateKey::Sptr을(를) 통해 관리됩니다[SWS_CRYPT_22501]. 이 인터페이스의 핵심 함수 GetPublicKey()은(는) 암호화 파트너 작업에 제공할 수 있도록 연관된 공개 키를 PublicKey::Sptr(으)로 검색할 수 있게 해줍니다[SWS_CRYPT_22511]. 이 검색은 표준화된 오류 코드 없이 스레드 안전 및 예외 안전으로 지정되어 있으며, 발생 가능한 모든 오류는 반환 타입 ara::core::Result을(를) 통해 구현별로 전달될 것으로 보입니다(해석). 질문 (열림)

자세히 ›

컨텍스트

인터페이스 ara::crypto::cryp::PrivateKey은(는) AUTOSAR Adaptive Platform의 crypto 모듈 내에서 비대칭 개인 키를 위한 일반화된 인터페이스로 기능합니다. 헤더 파일 ara/crypto/cryp/cryobj/private_key.h에 선언되어 있으며 기본 인터페이스 CryptoObject에서 직접 파생됩니다. 비대칭 암호화 시스템의 핵심 컴포넌트로서 PrivateKey은(는) 디지털 서명 생성 또는 비대칭 복호화 절차와 같은 암호화 작업에 필요한 기밀 키 자료를 캡슐화합니다.

기본 클래스 CryptoObject 외에도 해당하는 공개 키 인터페이스 PublicKey 및 이를 사용하는 암호화 서비스와 애플리케이션 루틴이 주요 상호작용 파트너에 속합니다. 개인 키는 항상 비밀로 유지되어야 하지만, 인터페이스는 멤버 함수 GetPublicKey()을(를) 통해 연관된 공개 키 [SWS_CRYPT_22511]의 직접적인 제공을 가능하게 합니다. 이러한 방식으로 개인 키와 그 수학적 대응물 간의 고정된 타입 관련 관계가 실현됩니다.

컨텍스트 다이어그램: 암호화 객체 모델 내 PrivateKey의 임베딩 및 해당 PublicKey와의 관계. 출처: [SWS_CRYPT_22501], [SWS_CRYPT_22511]

수명 주기

인터페이스 PrivateKey 인스턴스의 관리 및 전달은 std::shared_ptr<PrivateKey>의 타입 별칭으로 정의된 타입화된 스마트 포인터 PrivateKey::Sptr을 통해 수행됩니다 [SWS_CRYPT_22501]. 이 공유 포인터는 공유 소유권과 참조 카운팅을 통한 자동 리소스 관리를 보장하므로, 마지막 참조가 사라지는 즉시 보호된 키 자료가 해제됩니다.

PrivateKey은 GetPublicKey()과 같은 순수 가상 메서드를 포함하는 추상 인터페이스이므로 [SWS_CRYPT_22511], 애플리케이션이 클래스를 직접 인스턴스화할 수 없습니다. PrivateKey::Sptr의 구체적인 인스턴스 생성 및 제공은 아마도 Adaptive 시스템의 전문화된 팩토리, 키 관리 컴포넌트 또는 암호화 프로바이더를 통해 수행될 것으로 보입니다(해석). 질문 Q-f0f9fe2258fac168 (열림) 인터페이스 자체는 개별 내부 상태나 상태 전이를 정의하지 않습니다.

동시성과 관련하여 인터페이스는 핵심 멤버 함수 GetPublicKey()에 대해 스레드 안전성(thread-safe)을 명시적으로 규정합니다 [SWS_CRYPT_22511]. 이를 통해 여러 실행 스레드가 해당 공개 키를 얻기 위해 동일한 키 인스턴스에 동기화 없이 동시에 읽기 접근할 수 있습니다.

사용 경로

PrivateKey의 전형적인 사용 경로는 개인 키의 수신과 유효성 검사, 등록 또는 통신 목적을 위한 해당 공개 키의 후속 추출을 포함합니다:

1. 키 획득: 소비하는 소프트웨어 컴포넌트는 PrivateKey::Sptr 형태의 비대칭 개인 키의 유효한 인스턴스를 수신합니다 [SWS_CRYPT_22501].
2. 파트너 키 조회: 후속 워크플로를 위해 해당 공개 키가 필요한 경우 컴포넌트는 인스턴스에서 멤버 함수 GetPublicKey()을 호출합니다 [SWS_CRYPT_22511].
3. 결과 처리: 호출은 ara::core::Result<PublicKey::Sptr>을 반환합니다 [SWS_CRYPT_22511]. 애플리케이션은 결과 객체의 성공 여부를 확인하고 성공적으로 실행된 경우 포인터 PublicKey::Sptr의 압축을 풉니다.
4. 추가 사용: 획득한 공개 키는 이후 외부 통신 파트너에게 전송되거나 로컬 검증 루틴으로 전달될 수 있습니다. 공개 키의 파생은 내부적으로 개인 키의 수학적 키 매개변수에서 직접 수행될 것으로 보입니다(해석). 질문 Q-464000dc5d638649 (열림)

오류 시나리오

오류 없는 통합을 위해 GetPublicKey()의 오류 특성 및 경계 조건이 결정적입니다:

• 표준화된 오류: 사양에 따르면 GetPublicKey() 함수는 표준화된 오류 코드를 정의하지 않습니다 [SWS_CRYPT_22511].
• 오류 채널: 표준화된 오류가 정의되어 있지 않지만 반환 타입 ara::core::Result은 잠재적인 실패를 전달합니다. 내부 키 파생 또는 객체 생성 중에 오류가 발생하는 경우 결과 객체에는 기본 암호화 드라이버의 구현별 오류 코드가 포함될 것으로 보입니다(해석). 질문 Q-4af6390594d9c5e1 (열림)
• 예외 안전성: 이 함수는 명시적으로 예외 안전(exception safe)으로 분류되어 있으며 식별자 noexcept이 부여되어 있습니다 [SWS_CRYPT_22511]. 따라서 호출자는 C++ 예외를 포착할 필요가 없습니다.
• 사전 및 사후 조건: 성공적인 호출을 위한 사전 조건은 유효하고 해제되지 않은 PrivateKey 인스턴스입니다. 사후 조건으로서 인터페이스는 성공 시 개인 키와 수학적으로 정확히 일치하는 PublicKey::Sptr의 반환을 보장합니다 [SWS_CRYPT_22511].