clase ara::crypto::Formatter

La interfaz ara::crypto::Formatter permite la conversión y serialización seguras para subprocesos de datos criptográficos entre formatos en bruto, DER y PEM [SWS_CRYPT_50197]. Tras definir el formato de destino y determinar el tamaño de búfer requerido, el método Convert transfiere los datos de origen al búfer de salida preparado [SWS_CRYPT_50198]. Un requisito esencial para una ejecución correcta es una memoria de destino suficientemente dimensionada, así como la coincidencia formal de los datos de entrada con el formato de origen configurado.

más ›

Contexto

La interfaz ara::crypto::Formatter define en el módulo crypto la interfaz uniforme para el formateo, la transformación y la serialización de estructuras de datos criptográficos. Su tarea principal consiste en convertir datos útiles y objetos criptográficos entre representaciones tales como datos en bruto puros (kFormatRawValueOnly), codificaciones DER de ASN.1 (kFormatDerEncoded) y formatos PEM basados en texto (kFormatPemEncoded) teniendo en cuenta un identificador de algoritmo (AlgId) [SWS_CRYPT_50197]. En este proceso, el formateador actúa como enlace entre los objetos criptográficos y los búferes de memoria, leyendo datos a través de ReadOnlyMemRegion y emitiéndolos en ReadWriteMemRegion [SWS_CRYPT_50198].

Ciclo de vida

Dado que ara::crypto::Formatter está declarada como una interfaz puramente virtual, proporciona para su referenciación y gestión del ciclo de vida el alias de tipo de puntero inteligente canónico Sptr, definido como std::shared_ptr<Formatter> [SWS_CRYPT_50191]. En la práctica, las instancias concretas de la interfaz deberían proporcionarse a través de métodos de fábrica de componentes criptográficos de nivel superior. Pregunta Q-99e96992d02b9c13 (abierta) Tras su creación, un formateador se encuentra inicialmente en un estado inicial no configurado antes de prepararse para las transformaciones mediante llamadas de configuración.

En cuanto al entorno de ejecución, la interfaz garantiza una total seguridad frente a excepciones (exception safe) mediante el uso consecuente de noexcept y la gestión de errores a través de tipos de resultado [SWS_CRYPT_50197], [SWS_CRYPT_50198], [SWS_CRYPT_50199]. Asimismo, todas las funciones miembro están especificadas como seguras para subprocesos (thread-safe) [SWS_CRYPT_50197], [SWS_CRYPT_50198], [SWS_CRYPT_50199]. Esto permite el acceso paralelo de lectura y transformación de múltiples subprocesos a una instancia de formateador compartida, siempre que no se produzcan reconfiguraciones simultáneas.

Ruta de uso

El uso habitual de ara::crypto::Formatter sigue una secuencia fija de parametrización, comprobación de capacidad y transformación:

1. Configuración del formato: Mediante SetFormatConfiguration se definen de manera vinculante el formato de entrada esperado (inputFormat), el formato de salida deseado (outputFormat) y el identificador de algoritmo (algId) de los datos que se van a procesar [SWS_CRYPT_50197].
2. Determinación del tamaño: Antes de la conversión propiamente dicha, la aplicación invoca a GetExportSize para determinar el tamaño exacto de memoria en bytes que requiere el objeto serializado con la configuración actual [SWS_CRYPT_50199]. Esto permite la asignación a medida de la memoria de destino.
3. Conversión de datos: Finalmente, Convert transforma los datos de origen de una ReadOnlyMemRegion en el búfer de destino ReadWriteMemRegion de acuerdo con la configuración establecida [SWS_CRYPT_50198].

Diagrama de secuencia: Secuencia típica de conversión, desde la selección del formato y la determinación del tamaño del búfer hasta la transformación propiamente dicha. Fuentes: [SWS_CRYPT_50197], [SWS_CRYPT_50199], [SWS_CRYPT_50198]

Escenarios de error

Los métodos de ara::crypto::Formatter señalizan estados de error de forma determinista mediante valores de retorno de tipo ara::core::Result. Para las operaciones fallidas, se contemplan semánticas de reversión claras:

• Formatos no compatibles: Si la implementación subyacente no admite el par de transformación especificado o el identificador de algoritmo, SetFormatConfiguration devuelve el código de error ara::crypto::CryptoErrc::kUnsupportedFormat [SWS_CRYPT_50197].
• Datos de entrada no válidos: Si los datos en bruto pasados en el búfer no se corresponden con el formato configurado o son sintácticamente no válidos, Convert falla con ara::crypto::CryptoErrc::kInvalidArgument [SWS_CRYPT_50198].
• Búfer de destino insuficiente: Si la ReadWriteMemRegion proporcionada es demasiado pequeña para el resultado serializado, Convert se interrumpe con ara::crypto::CryptoErrc::kInsufficientCapacity [SWS_CRYPT_50198]. Este problema puede evitarse deliberadamente mediante una consulta previa a través de GetExportSize [SWS_CRYPT_50199].
• Falta de preconfiguración: Aunque no se detallan códigos de error estandarizados para GetExportSize [SWS_CRYPT_50199], presumiblemente debe haberse establecido de forma obligatoria una configuración válida previa mediante SetFormatConfiguration para que pueda llevarse a cabo una determinación coherente del tamaño o una conversión. Pregunta Q-e7cf4306bc7cfb49 (abierta)