clase ara::crypto::cryp::WriteableKeySlot

La interfaz ara::crypto::cryp::WriteableKeySlot sirve en AUTOSAR Adaptive como abstracción escribible para ubicaciones de almacenamiento de claves en un CryptoProvider. Las instancias no se pueden copiar ni mover ([SWS_CRYPT_50170], [SWS_CRYPT_50168]), sino que se referencian a través del tipo de puntero inteligente Sptr [SWS_CRYPT_50172]. Mediante el método seguro para subprocesos Clear() se borra el contenido de la ranura de clave, aplicándose una semántica de reversión (rollback) en casos de error tales como kBusyResource o kUnsupported [SWS_CRYPT_30405].

más ›

Contexto

La interfaz ara::crypto::cryp::WriteableKeySlot define dentro de AUTOSAR Adaptive Platform un espacio de almacenamiento escribible para claves criptográficas en el contexto de un CryptoProvider. Se deriva directamente de la interfaz base KeySlot y representa una abstracción estandarizada para borrar selectivamente ranuras de claves gestionadas y controlar su ciclo de vida. Como interlocutores de interacción esenciales actúan las aplicaciones de la pila criptográfica como consumidores, así como el CryptoProvider concreto, el cual gestiona la vinculación con el almacenamiento físico o lógico de claves. La creación de instancias concretas presumiblemente se lleva a cabo mediante métodos de fábrica o de proveedor de nivel superior, dado que la interfaz actúa como clase base abstracta pura. Pregunta Q-5c3b13bb35c3ff53 (abierta)

Ciclo de vida

El modelo de recursos y propiedad de ara::crypto::cryp::WriteableKeySlot impide estrictamente la duplicación de referencias a claves mediante semántica por valor. Para este fin, tanto el constructor de copia [SWS_CRYPT_50170] como el constructor de movimiento [SWS_CRYPT_50171] están explícitamente eliminados (=delete). Del mismo modo, las declaraciones eliminadas del operador de asignación por copia [SWS_CRYPT_50168] y del operador de asignación por movimiento [SWS_CRYPT_50169] impiden cualquier asignación posterior.

En su lugar, la transmisión por referencia y la gestión compartida se efectúan mediante el alias de tipo de puntero inteligente definido Sptr, materializado como std::shared_ptr<WriteableKeySlot> [SWS_CRYPT_50172]. La destrucción de la instancia está protegida por un destructor virtual estándar, especificado como seguro frente a excepciones (exception safe) y que no emite excepciones (noexcept=default) [SWS_CRYPT_50167]. Esto permite la liberación polimórfica segura mediante punteros a la interfaz. En cuanto al estado, una ranura puede estar ocupada o vacía. La ocupación de la ranura probablemente tenga lugar mediante interfaces independientes del CryptoProvider, mientras que el vaciado se materializa a través del método seguro para subprocesos Clear() [SWS_CRYPT_30405]. Pregunta Q-72dfcb17eb3e2d25 (abierta)

Diagrama de estados: transiciones de estado del contenido de la clave mediante Clear() y tratamiento de errores. Fuentes: [SWS_CRYPT_30405]

Ruta de uso

La ruta de uso principal se centra en el restablecimiento o borrado controlado del material de clave almacenado:

• Referenciación: el invocador accede a la instancia a través de un puntero compartido del tipo WriteableKeySlot::Sptr [SWS_CRYPT_50172].
• Llamada de borrado: mediante la llamada al método puramente virtual Clear() se inicia el proceso de borrado para el contenido actual de la ranura de clave [SWS_CRYPT_30405]. Dado que el método es seguro para subprocesos, la llamada también puede realizarse en contextos concurrentes [SWS_CRYPT_30405].
• Comprobación del resultado: la operación devuelve un ara::core::Result<void> [SWS_CRYPT_30405]. Si la ranura de clave ya estaba vacía anteriormente o el contenido se eliminó sin errores, el resultado representa un estado satisfactorio con valor vacío [SWS_CRYPT_30405].

Escenarios de error

El método Clear() está declarado como seguro frente a excepciones y noexcept; según el modelo de errores de AUTOSAR Adaptive, las situaciones de error se transmiten a través de ara::core::Result [SWS_CRYPT_30405]. Los posibles códigos de error comprenden:

• ara::crypto::CryptoErrc::kUnsupported: se produce cuando la variante concreta de la ranura de clave no admite el borrado [SWS_CRYPT_30405]. En este caso, la interfaz garantiza una semántica de reversión (rollback), de modo que el estado permanece inalterado [SWS_CRYPT_30405].
• ara::crypto::CryptoErrc::kBusyResource: se devuelve si la operación de borrado no puede llevarse a cabo temporalmente [SWS_CRYPT_30405]. Es probable que esto esté causado típicamente por accesos concurrentes a recursos de memoria vinculados al hardware. Pregunta (abierta) También en este caso, una semántica de reversión (rollback) garantiza que no permanezcan cambios parciales [SWS_CRYPT_30405].