클래스 ara::crypto::Serializable

인터페이스 ara::crypto::Serializable은(는) 암호화 객체를 포맷별 바이트 시퀀스로 공개 내보내기하기 위한 통일된 표준을 정의합니다. 애플리케이션은 사전에 GetExportSize()을(를) 통해 필요한 버퍼 크기를 결정한 후, ExportPublicly()을(를) 통해 제공된 버퍼로 실제 직렬화를 수행합니다[SWS_CRYPT_10711]. 모든 작업은 예외 안전(exception-safe)하고 스레드 안전(thread-safe)하며, 키 내보내기에는 반드시 kAllowPlaintextExport 권한이 필요하고 오류에는 항상 롤백 시맨틱이 적용됩니다[SWS_CRYPT_50006].

자세히 ›

컨텍스트

인터페이스 ara::crypto::Serializable은(는) 표준화된 바이트 표현으로 변환될 수 있는 crypto 모듈의 암호화 객체에 대한 추상 계약을 정의합니다. 순수 인터페이스로서 포맷 식별자(FormatId)에 의해 지정된 출력 포맷으로 객체를 직렬화하는 기능을 캡슐화합니다[SWS_CRYPT_10711]. 일반적인 상호작용 파트너에는 키나 인증서와 같은 암호화 아티팩트를 영구적으로 저장하거나, 통신 채널을 통해 전송하거나, 일반 텍스트로 교환해야 하는 애플리케이션 또는 플랫폼 컴포넌트가 포함됩니다. 이 인터페이스는 포맷 및 보안 제약을 고려하여 내보내기가 통제된 방식으로 수행되도록 보장합니다.

수명 주기

ara::crypto::Serializable은(는) 순수 가상 메서드를 갖는 순수 가상 인터페이스이므로 클래스 자체의 인스턴스화 로직을 갖지 않습니다. 수명과 생성은 인터페이스를 구현하는 파생된 구체적인 암호화 클래스에 전적으로 의존합니다. 인터페이스의 두 지정된 메서드인 GetExportSize() [SWS_CRYPT_50006] 및 ExportPublicly() [SWS_CRYPT_10711]은(는) const(으)로 선언되어 있으며 직렬화 시 객체의 내부 상태를 변경하지 않습니다. 사양에 따르면 작업은 예외 안전(exception safe) 및 스레드 안전(thread-safe)하도록 설계되어 있으므로[SWS_CRYPT_10711], [SWS_CRYPT_50006] 동일한 객체 인스턴스에 대한 병렬 읽기 접근이 허용됩니다.

사용 경로

내보내기의 일반적인 흐름은 크기 결정 및 실제 직렬화의 2단계 시퀀스로 나뉩니다. 버퍼 오버플로나 실패하는 할당을 방지하기 위해 호출자는 사전에 메서드 GetExportSize()을(를) 통해 원하는 대상 포맷에 대해 정확히 필요한 버퍼 크기(바이트 단위)를 쿼리합니다[SWS_CRYPT_50006]. 성공적인 응답 후 호출자는 ReadWriteMemRegion 타입의 쓰기 가능한 메모리 영역을 제공합니다. 대부분의 구현에서 이 메모리 영역은 결정된 바이트 수에 따라 동적으로 할당되거나 사전 예약된 메모리 풀에서 제공될 것으로 추정됩니다. 질문 Q-0c04ba0a352f0a37 (열림)

이어진 단계에서 애플리케이션은 ExportPublicly()을(를) 호출하고 제공된 버퍼와 앞서 선택한 FormatId을(를) 모두 전달합니다[SWS_CRYPT_10711]. 객체는 전달된 메모리 영역으로 페이로드를 직렬화하고, 성공 시 반환 타입 ara::core::Result<std::size_t> 내에서 실제로 기록된 바이트 수를 반환합니다[SWS_CRYPT_10711].

시퀀스 다이어그램: 크기 쿼리 및 후속 내보내기를 통한 객체 직렬화의 일반적인 호출 순서. 출처: [SWS_CRYPT_50006], [SWS_CRYPT_10711]

오류 시나리오

인터페이스의 작업은 반환 타입 ara::core::Result을(를) 통해 오류 상태를 알리며, 지정된 모든 오류는 엄격한 롤백 시맨틱(rollback_semantics)을 보장합니다[SWS_CRYPT_10711], [SWS_CRYPT_50006]. 호출이 실패하더라도 전체 시스템은 일관된 상태로 유지됩니다. 다음과 같은 오류 케이스가 정의되어 있습니다:

• ara::crypto::CryptoErrc::kUnsupportedFormat: 구체적인 객체 유형에 대해 지정된 FormatId이(가) 지원되지 않는 경우 GetExportSize() [SWS_CRYPT_50006] 및 ExportPublicly() [SWS_CRYPT_10711] 모두에 의해 반환됩니다.
• ara::crypto::CryptoErrc::kInsufficientCapacity: 전달된 ReadWriteMemRegion 버퍼의 용량이 직렬화된 데이터에 충분하지 않은 경우 ExportPublicly()에서 발생합니다[SWS_CRYPT_10711].
• ara::crypto::CryptoErrc::kUnsupported: 특정 객체에 대해 원칙적으로 내보내기가 지원되지 않는 경우 ExportPublicly()에 의해 보고됩니다[SWS_CRYPT_10711].
• ara::crypto::CryptoErrc::kUsageViolation: 객체가 사용 규칙상 일반 텍스트 내보내기를 허용하지 않는 키인 경우(허용된 사용에 kAllowPlaintextExport이(가) 포함되지 않음) ExportPublicly()에서 발생합니다[SWS_CRYPT_10711].