clase ara::crypto::x509::CertificateValidationResult

La interfaz ara::crypto::x509::CertificateValidationResult proporciona el resultado de una validación de certificados X.509 y normalmente se gestiona como un Sptrc inmutable [SWS_CRYPT_50093]. Mediante sus métodos, la aplicación consulta el estado global, determina la cadena de certificados completa con el certificado hoja en la posición 0 o aísla el certificado fallido. Si la comprobación fue correcta, la llamada para determinar el certificado erróneo falla con el código de error ara::crypto::CryptoErrc::kNoSuchValue [SWS_CRYPT_50095]. Todos los métodos de la interfaz están diseñados para ser seguros para subprocesos y seguros frente a excepciones.

más ›

Contexto

La interfaz ara::crypto::x509::CertificateValidationResult encapsula el resultado de un proceso de validación de certificados X.509 dentro del módulo Adaptive crypto. Su responsabilidad principal consiste en poner a disposición de las aplicaciones llamadoras un resultado de comprobación estructurado y consistente. Este abarca tanto el estado de validación agregado de la ruta de certificación como el acceso a los objetos de certificado implicados. Como intermediario entre los mecanismos internos de verificación criptográfica y las aplicaciones críticas para la seguridad, la clase permite una evaluación diferenciada de jerarquías de certificados. Entre sus interlocutores principales se cuentan instancias de Certificate::Sptrc, que se componen como una cadena completa de certificados o bien, en caso de error, se identifican como causantes del fallo.

Ciclo de vida

Como interfaz puramente virtual, CertificateValidationResult no define constructores públicos propios. El ciclo de vida y las relaciones de propiedad se controlan principalmente mediante el puntero inteligente tipificado Sptrc, que está definido como std::shared_ptr<const CertificateValidationResult> [SWS_CRYPT_50093]. Este puntero constante establece un modelo de propiedad compartida e inmutable: tras finalizar una validación de certificado, el objeto de resultado se pone a disposición como una instantánea inmodificable. La creación e inicialización de instancias concretas debería llevarse a cabo internamente mediante funciones de validación de nivel superior del backend de la plataforma. Pregunta Q-a5580dcf443b0905 (abierta) Puesto que todas las funciones miembro están declaradas como const y noexcept y están especificadas explícitamente como thread-safe y exception-safe ([SWS_CRYPT_50094], [SWS_CRYPT_50095], [SWS_CRYPT_50096]), varios subprocesos pueden acceder de forma concurrente y sin medidas de sincronización adicionales a la misma instancia hasta que se libere la última referencia.

Ruta de uso

Una ruta de uso típica se inicia tras recibir una instancia de CertificateValidationResult::Sptrc procedente de una comprobación de certificados previa. Los llamadores llevan a cabo la evaluación en una secuencia estandarizada:

• En primer lugar, la aplicación llama a GetValidationStatus() para consultar el resultado básico de la validación del certificado como CertificateValidationStatus [SWS_CRYPT_50094].
• Si la validación fue correcta, el cliente llama a GetCertificateChain() para recuperar la cadena de certificados encontrada durante el proceso de comprobación como ara::core::Vector<Certificate::Sptrc> [SWS_CRYPT_50096]. Conforme a la especificación, esta cadena siempre comienza en la posición de índice 0 con el certificado hoja (Leaf Certificate) [SWS_CRYPT_50096].
• Por el contrario, si la validación de la ruta ha fallado, el llamador invoca GetFailedCertificate() para determinar de manera selectiva aquel certificado que ha provocado el error de validación [SWS_CRYPT_50095].

Diagrama de secuencia: flujo típico para consultar el estado de validación, la cadena de certificados y la causa del error. Fuentes: [SWS_CRYPT_50094], [SWS_CRYPT_50095], [SWS_CRYPT_50096]

Escenarios de error

La gestión de errores de la interfaz se basa en ara::core::Result, cumpliendo todas las llamadas la garantía noexcept y siendo seguras frente a excepciones:

• Validación correcta y GetFailedCertificate(): si la comprobación ha finalizado correctamente (valor de retorno kValid), ningún certificado ha provocado un fallo. En este estado, la llamada a GetFailedCertificate() falla con el código de error ara::crypto::CryptoErrc::kNoSuchValue [SWS_CRYPT_50095]. Las aplicaciones deben interpretar este error como una confirmación lógica de una cadena sin errores o vincular la llamada a un estado negativo.
• Errores de estado específicos de la implementación: para GetValidationStatus() no se definen códigos de error estandarizados; no obstante, los errores específicos de la implementación se encapsulan en el ara::core::Result devuelto [SWS_CRYPT_50094].
• Consulta de la cadena de certificados: GetCertificateChain() tampoco especifica códigos de error estandarizados [SWS_CRYPT_50096]; eventuales estados de error internos se señalizan a través del ara::core::Result resultante.