클래스 ara::crypto::x509::X509DN

인터페이스 ara::crypto::x509::X509DN은 암호화 모듈 내에서 직렬화 가능한 데이터 구조로서 X.509 Distinguished Name을 캡슐화하고 제공하는 역할을 합니다. 별칭 Sptrc을 통해 인스턴스의 공유 불변 소유권이 std::shared_ptr<const X509DN>로 실현됩니다 [SWS_CRYPT_40401]. 핵심 메서드 ToString()는 RFC 4514에 따라 전체 이름을 형식화하며 스레드 안전하고 표준화된 오류 코드 없이 작동합니다 [SWS_CRYPT_40411]. 호출자는 결과를 ara::core::Result<ara::core::String>으로 수신하며 후속 처리 전에 유효성을 확인해야 합니다.

자세히 ›

컨텍스트

추상 인터페이스 ara::crypto::x509::X509DN은 AUTOSAR Adaptive Platform의 crypto 모듈 내에서 X.509 표준에 따른 Distinguished Name(DN)을 나타냅니다. ara::crypto::Serializable의 상속을 통해 클래스는 직렬화 가능한 암호화 데이터 구조로서 타입 계층에 임베드됩니다. 인터페이스의 주요 작업은 인증서, 인증서 소유자(Subject) 또는 인증서 발급자(Issuer)의 이름 구조를 소프트웨어적으로 캡슐화하는 것입니다. 여기서 핵심적인 역할은 정규화된 텍스트 표현을 제공하는 것입니다. [SWS_CRYPT_40411]에 따라 메서드 ToString()는 RFC 4514 사양에 따른 문자열로 전체 Distinguished Name을 내보냅니다. 기본 Distinguished Name에 비표준 속성이 포함되어 있는 경우 해당 속성에 대해 각각의 OID(Object Identifier)가 사용됩니다 [SWS_CRYPT_40411].

수명 주기

ara::crypto::x509::X509DN은 ToString()과 같은 순수 가상 메서드를 포함하는 추상 C++ 인터페이스이므로 애플리케이션 개발자가 직접 인스턴스화하지 않습니다. 페이로드는 공개 생성자를 명시하지 않으며 구체적인 인스턴스 생성은 아마도 암호화 서브시스템의 상위 컴포넌트 또는 인증서 파서에 의해 수행될 것으로 보입니다. 질문 Q-108d7589869c7370 (열림)

공유 및 장기적인 접근을 위해 인터페이스는 타입 지정자 Sptrc을 std::shared_ptr<const X509DN>의 별칭으로 정의합니다 [SWS_CRYPT_40401]. 상수 공유 포인터의 사용은 소유권 및 접근 개념을 강조합니다. X509DN의 인스턴스는 외부적으로 불변(immutable)입니다. 여러 소비자가 읽기 접근 시 동기화 오버헤드 없이 동일한 Distinguished Name 표현을 안전하고 상태 없이 공유할 수 있습니다. 동시성과 관련하여 핵심 메서드 ToString()는 명시적으로 스레드 안전(thread-safe)으로 선언되어 있습니다 [SWS_CRYPT_40411]. 따라서 동일한 공유 포인터를 통하거나 서로 다른 스레드에 걸친 병렬 호출이 외부 락 없이 허용됩니다. 또한 사양은 이 호출에 대해 완벽한 예외 안전성(exception safe)을 보장합니다 [SWS_CRYPT_40411].

사용 경로

전형적인 사용 경로는 로깅, 인증 또는 신원 확인을 위해 형식화된 Distinguished Name을 읽고 추가 처리하는 데 중점을 둡니다. 애플리케이션은 일반적으로 ara::crypto::x509::X509DN::Sptrc 타입의 포인터를 수신합니다 [SWS_CRYPT_40401].

이 인스턴스에서 호출자는 ToString() 메서드를 실행합니다 [SWS_CRYPT_40411]. 호출은 noexcept 방식으로 수행되며 ara::core::Result<ara::core::String>을 반환합니다 [SWS_CRYPT_40411]. 성공적으로 평가되면 Result 객체에는 RFC 4514에 따라 형식화된 문자열이 포함되며, 예를 들어 CN=...과 같은 속성-값 쌍의 표준화된 형식이나 독점 속성의 경우 OID를 사용하는 형식으로 포함됩니다 [SWS_CRYPT_40411]. 그런 다음 애플리케이션은 결과 문자열을 추출하여 애플리케이션별 검사, 비교 또는 감사 로그에 추가로 사용할 수 있습니다.

오류 시나리오

ara::crypto::x509::X509DN과의 상호작용에서 오류 처리는 명확하고 최소한의 디자인이 특징입니다. ToString()이 반환 타입 ara::core::Result<ara::core::String>를 사용하지만 사양은 함수가 표준화된 오류 코드를 정의하지 않음을 명시적으로 명시합니다 [SWS_CRYPT_40411]. 이는 정규 사양 컨텍스트에서 직렬화 프로세스에 대한 기술적 거부 이유나 유효성 검사 오류가 제공되지 않음을 의미합니다.

또한 함수가 noexcept 및 예외 안전(exception safe)으로 명시되어 있으므로 [SWS_CRYPT_40411] 동기식 C++ 예외는 배제됩니다. 그럼에도 불구하고 반환된 ara::core::Result 내에서 오류 상태가 발생하는 경우 이는 결과 문자열 할당 시의 메모리 부족과 같은 플랫폼 또는 구현별 원인에 기인할 가능성이 높습니다. 질문 Q-10477dd7d77e3b78 (열림) 따라서 호출자는 AUTOSAR가 이를 위한 도메인별 오류 상수를 지정하지 않더라도 값을 압축 해제하기 전에 Result에 유효한 값이 포함되어 있는지 또는 오류가 포함되어 있는지 항상 확인해야 합니다.