clase ara::crypto::cryp::PrivateKey

La interfaz ara::crypto::cryp::PrivateKey define la interfaz general para claves privadas asimétricas en AUTOSAR Adaptive y se gestiona principalmente a través del alias de puntero compartido PrivateKey::Sptr [SWS_CRYPT_22501]. Su función central GetPublicKey() permite obtener la clave pública asociada como PublicKey::Sptr para ponerla a disposición de operaciones asociadas criptográficas [SWS_CRYPT_22511]. Esta obtención está especificada como segura para hilos y segura frente a excepciones sin códigos de error estandarizados; es de suponer que los posibles errores se señalen de manera específica de la implementación a través del tipo de retorno ara::core::Result (interpretación). Pregunta (abierta)

más ›

Contexto

La interfaz ara::crypto::cryp::PrivateKey actúa en AUTOSAR Adaptive Platform como interfaz generalizada para claves privadas asimétricas dentro del módulo crypto. Está declarada en el archivo de cabecera ara/crypto/cryp/cryobj/private_key.h y deriva directamente de la interfaz base CryptoObject. Como componente central del sistema criptográfico asimétrico, PrivateKey encapsula el material de clave confidencial necesario para operaciones criptográficas tales como la generación de firmas digitales o procedimientos de descifrado asimétrico.

Entre los participantes de interacción primarios se encuentran, además de la clase base CryptoObject, en particular la correspondiente interfaz de clave pública PublicKey, así como servicios criptográficos consumidores y rutinas de aplicación. Mientras que la clave privada debe mantenerse siempre en secreto, la interfaz permite, mediante la función miembro GetPublicKey(), la puesta a disposición directa de la clave pública asociada [SWS_CRYPT_22511]. De este modo se hace realidad una relación fija vinculada al tipo entre la clave privada y su contraparte matemática.

Diagrama de contexto: incrustación de PrivateKey en el modelo de objetos criptográficos y relación con el PublicKey correspondiente. Fuentes: [SWS_CRYPT_22501], [SWS_CRYPT_22511]

Ciclo de vida

La gestión y transferencia de instancias de la interfaz PrivateKey se realiza a través del puntero inteligente tipificado PrivateKey::Sptr, definido como alias de tipo para std::shared_ptr<PrivateKey> [SWS_CRYPT_22501]. Este puntero compartido garantiza una propiedad compartida y una gestión automática de recursos mediante conteo de referencias, de modo que el material de clave protegido se libera en cuanto se extingue la última referencia.

Dado que PrivateKey representa una interfaz abstracta con métodos puramente virtuales como GetPublicKey() [SWS_CRYPT_22511], las aplicaciones no pueden instanciar la clase directamente. Es de suponer que la creación y provisión de instancias concretas de PrivateKey::Sptr se realice a través de fábricas especializadas, componentes de gestión de claves o proveedores criptográficos del sistema Adaptive (interpretación). Pregunta Q-f0f9fe2258fac168 (abierta) La propia interfaz no define estados internos discretos ni transiciones de estado.

En lo relativo a la concurrencia, la interfaz especifica explícitamente seguridad de hilos (thread-safe) para la función miembro central GetPublicKey() [SWS_CRYPT_22511]. Esto permite que múltiples hilos de ejecución tengan acceso de lectura concurrente y libre de sincronización a la misma instancia de clave para obtener la clave pública correspondiente.

Ruta de uso

La ruta de uso típica de PrivateKey comprende la recepción de la clave privada y la posterior extracción de la clave pública correspondiente para fines de validación, registro o comunicación:

1. Obtención de la clave: el componente de software consumidor recibe una instancia válida de una clave privada asimétrica en forma de un PrivateKey::Sptr [SWS_CRYPT_22501].
2. Obtención de la clave asociada: cuando se necesita la clave pública correspondiente para un flujo de trabajo posterior, el componente invoca la función miembro GetPublicKey() en la instancia [SWS_CRYPT_22511].
3. Procesamiento del resultado: la invocación devuelve un ara::core::Result<PublicKey::Sptr> [SWS_CRYPT_22511]. La aplicación comprueba el éxito del objeto de resultado y, en caso de ejecución satisfactoria, desempaqueta el puntero PublicKey::Sptr.
4. Uso posterior: la clave pública obtenida puede transmitirse a continuación a interlocutores de comunicación externos o transferirse a rutinas de verificación locales. Es de suponer que internamente la derivación de la clave pública se realice directamente a partir de los parámetros matemáticos de la clave privada (interpretación). Pregunta Q-464000dc5d638649 (abierta)

Escenarios de error

Para una integración libre de errores, las propiedades de error y las condiciones de contorno de GetPublicKey() son determinantes:

• Errores estandarizados: según la especificación, la función GetPublicKey() no define códigos de error estandarizados [SWS_CRYPT_22511].
• Canal de error: aunque no se definen errores estandarizados, el tipo de retorno ara::core::Result transporta fallos potenciales. En caso de que se produzca un error durante la derivación interna de la clave o la creación del objeto, es de suponer que el objeto de resultado contenga códigos de error específicos de la implementación de los controladores criptográficos subyacentes (interpretación). Pregunta Q-4af6390594d9c5e1 (abierta)
• Seguridad frente a excepciones: la función está clasificada explícitamente como segura frente a excepciones (exception safe) y provista del identificador noexcept [SWS_CRYPT_22511]. Por lo tanto, los invocadores no necesitan capturar excepciones de C++.
• Precondiciones y poscondiciones: la precondición para una invocación satisfactoria es una instancia válida y no liberada de PrivateKey. Como poscondición, la interfaz garantiza en caso de éxito la devolución de un PublicKey::Sptr que se corresponde matemáticamente de forma exacta con la clave privada [SWS_CRYPT_22511].