clase ara::crypto::x509::X509DN

La interfaz ara::crypto::x509::X509DN sirve para encapsular y proporcionar un X.509 Distinguished Name como estructura de datos serializable dentro del módulo criptográfico. A través del alias Sptrc, se implementa la propiedad compartida e inmutable de las instancias como std::shared_ptr<const X509DN> [SWS_CRYPT_40401]. El método central ToString() formatea el nombre completo según RFC 4514 y opera de forma segura para hilos, así como sin códigos de error estandarizados [SWS_CRYPT_40411]. Los invocadores reciben el resultado como ara::core::Result<ara::core::String>, el cual debe comprobarse en cuanto a validez antes del procesamiento posterior.

más ›

Contexto

La interfaz abstracta ara::crypto::x509::X509DN representa dentro del módulo crypto de AUTOSAR Adaptive Platform un Distinguished Name (DN) según el estándar X.509. Mediante la herencia de ara::crypto::Serializable, la clase queda incrustada en la jerarquía de tipos como estructura de datos criptográfica serializable. La tarea principal de la interfaz consiste en encapsular a nivel de software estructuras de nombres de certificados, titulares de certificados (Subjects) o emisores de certificados (Issuers). Un papel central lo asume aquí la provisión de una representación textual normalizada: según [SWS_CRYPT_40411], el método ToString() exporta el Distinguished Name completo como cadena de caracteres de acuerdo con la especificación RFC 4514. Si el Distinguished Name subyacente incluyera atributos no estandarizados, se recurre para dichos atributos al respectivo Object Identifier (OID) [SWS_CRYPT_40411].

Ciclo de vida

Dado que ara::crypto::x509::X509DN se trata de una interfaz abstracta de C++ con métodos puramente virtuales como ToString(), la instanciación no la realizan directamente los desarrolladores de aplicaciones. El payload no especifica ningún constructor público; es de suponer que la creación de instancias concretas la lleven a cabo componentes de nivel superior o analizadores sintácticos de certificados del subsistema criptográfico. Pregunta Q-108d7589869c7370 (abierta)

Para el acceso compartido y de larga duración, la interfaz define el especificador de tipo Sptrc como un alias de std::shared_ptr<const X509DN> [SWS_CRYPT_40401]. El uso de un puntero compartido constante subraya el concepto de propiedad y acceso: las instancias de X509DN son externamente inmutables (immutable). Varios consumidores pueden compartir de forma segura y sin estado la misma representación de un Distinguished Name, sin que se generen sobrecargas de sincronización en los accesos de lectura. En cuanto a la concurrencia, el método central ToString() está declarado explícitamente como seguro para subprocesos (thread-safe) [SWS_CRYPT_40411]. Por lo tanto, las llamadas paralelas a través del mismo puntero compartido o entre diferentes subprocesos están permitidas sin bloqueos externos. Además, la especificación asegura para esta llamada total seguridad frente a excepciones (exception safe) [SWS_CRYPT_40411].

Ruta de uso

La ruta de uso típica se centra en la lectura y el procesamiento posterior del Distinguished Name formateado para el registro, la autenticación o la verificación de identidad. Una aplicación suele recibir un puntero de tipo ara::crypto::x509::X509DN::Sptrc [SWS_CRYPT_40401].

Sobre esta instancia, el llamador ejecuta el método ToString() [SWS_CRYPT_40411]. La llamada se realiza noexcept y devuelve un ara::core::Result<ara::core::String> [SWS_CRYPT_40411]. En caso de una evaluación exitosa, el objeto Result contiene la cadena de caracteres formateada según RFC 4514, por ejemplo en la forma estandarizada de pares atributo-valor como CN=... o utilizando OID en el caso de atributos propietarios [SWS_CRYPT_40411]. A continuación, la aplicación puede extraer la cadena resultante y reutilizarla para comprobaciones específicas de la aplicación, comparaciones o registros de auditoría.

Escenarios de error

En la interacción con ara::crypto::x509::X509DN, el tratamiento de errores se caracteriza por un diseño claro y mínimo. Aunque ToString() utiliza el tipo de retorno ara::core::Result<ara::core::String>, la especificación establece explícitamente que la función no define códigos de error estandarizados [SWS_CRYPT_40411]. Esto significa que en el contexto regular de la especificación no se contemplan motivos de rechazo funcionales ni errores de validación para el proceso de serialización.

Dado que la función además está especificada como noexcept y como exception safe [SWS_CRYPT_40411], quedan descartadas las excepciones C++ síncronas. Si a pesar de ello se producen estados de error dentro del ara::core::Result devuelto, es de suponer que estos se deban a causas específicas de la plataforma o de la implementación, tales como cuellos de botella de memoria durante la asignación de la cadena de resultado. Pregunta Q-10477dd7d77e3b78 (abierta) Por lo tanto, antes de desempaquetar el valor, los llamadores siempre deben comprobar si el Result contiene un valor válido o un error, incluso si AUTOSAR no predetermina constantes de error específicas del dominio para ello.