clase ara::crypto::cryp::RandomGeneratorCtx

El método AddEntropy de la clase ara::crypto::cryp::RandomGeneratorCtx sirve para actualizar el estado interno de un generador de números aleatorios (RNG) incorporando valores de entropía adicionales proporcionados [SWS_CRYPT_22914]. La declaración está disponible a través del archivo de cabecera ara/crypto/cryp/random_generator_ctx.h [SWS_CRYPT_22914]. Como parámetro de entrada, la función espera un objeto del tipo ReadOnlyMemRegion denominado entropy, que encapsula el área de memoria con el valor de entropía que se agregará [SWS_CRYPT_22914].

La llamada se ejecuta de forma síncrona (interpretación: la interfaz entrega el resultado directamente sin un tipo de resultado asíncrono). Pregunta Q-6e56e1daaa526bf8 (abierta) El resultado se devuelve como ara::core::Result<void>, que en caso de éxito está vacío si el método es compatible y la entropía pudo incorporarse correctamente [SWS_CRYPT_22914]. Por el contrario, si el contexto concreto del generador de números aleatorios no admite la adición de entropía, la llamada falla y devuelve el código de error ara::crypto::CryptoErrc::kUnsupported con semántica de reversión garantizada [SWS_CRYPT_22914].

En lo relativo a la concurrencia y la seguridad contra fallos, la interfaz está especificada como segura para subprocesos (thread-safe), así como a prueba de excepciones (exception safe), y cuenta con el identificador noexcept [SWS_CRYPT_22914]. Por lo tanto, los llamadores pueden invocar la función de forma segura desde múltiples subprocesos, pero siempre deben evaluar el ara::core::Result devuelto para gestionar una falta de soporte para el suministro de entropía en el contexto correspondiente [SWS_CRYPT_22914].

La función Generate de la interfaz ara::crypto::cryp::RandomGeneratorCtx sirve para llenar un búfer de salida provisto con una secuencia (pseudo)aleatoria [SWS_CRYPT_22915]. Como parámetro de entrada, el método recibe el área de memoria grabable output de tipo ReadWriteMemRegion, en la que se escriben directamente los bytes aleatorios generados [SWS_CRYPT_22915].

En cuanto a la seguridad de ejecución y la concurrencia, el método está declarado como noexcept, se considera exception-safe y está explícitamente especificado como thread-safe [SWS_CRYPT_22915]. Esto permite la invocación concurrente desde múltiples subprocesos.

Manejo de errores

El tipo de retorno ara::core::Result<void> señala el éxito de la operación mediante un resultado vacío o, en caso de error, devuelve un código de error correspondiente con semántica de reversión [SWS_CRYPT_22915]:

• ara::crypto::CryptoErrc::kUninitializedContext: Se produce si la aplicación debe inicializar o alimentar con entropía («seeded») el contexto previamente [SWS_CRYPT_22915].
• ara::crypto::CryptoErrc::kBusyResource: Se devuelve cuando el contexto se ha quedado actualmente sin entropía («out-of-entropy») y, por lo tanto, no puede proporcionar la cantidad solicitada de bytes aleatorios [SWS_CRYPT_22915].

Interacción y delimitación

Mientras que RandomGeneratorCtx::Generate escribe bytes de datos aleatorios sin procesar en búferes [SWS_CRYPT_22915], en el módulo crypt existen otras funciones de generación con un enfoque diferente: así, CryptoProvider::GenerateSymmetricKey [SWS_CRYPT_20721] sirve para instanciar claves simétricas y CryptoProvider::GeneratePrivateKey [SWS_CRYPT_20722] para generar pares de claves asimétricas. Además, el método no debe confundirse con la función homónima Generate de MessageAuthnCodeCtx, que sirve para calcular un digest de MAC [SWS_CRYPT_50029].

usar

El método virtual puro Seed de la interfaz ara::crypto::cryp::RandomGeneratorCtx sirve para establecer el estado interno del generador de números aleatorios (RNG) mediante una región de memoria proporcionada [SWS_CRYPT_22911]. La declaración se realiza en la cabecera ara/crypto/cryp/random_generator_ctx.h con la signatura virtual ara::core::Result<void> Seed(ReadOnlyMemRegion seed) noexcept = 0; [SWS_CRYPT_22911].

Como parámetro de entrada, la función síncrona toma seed del tipo ReadOnlyMemRegion, que contiene la región de memoria con el valor de semilla [SWS_CRYPT_22911]. En caso de ejecución correcta y compatibilidad por parte del contexto, el método devuelve un ara::core::Result<void> vacío [SWS_CRYPT_22911].

Manejo de errores

En caso de error, el ara::core::Result devuelto contiene el código de error correspondiente [SWS_CRYPT_22911]:

• ara::crypto::CryptoErrc::kUnsupported: Se produce si el RandomGeneratorCtx concreto no admite la inicialización con semilla (seeding); para este caso de error se especifica una semántica de reversión [SWS_CRYPT_22911].

Concurrencia y restricciones

La interfaz está declarada como noexcept y clasificada en cuanto a seguridad de ejecución como exception safe y thread-safe [SWS_CRYPT_22911].

Interacción

Como complemento a esta función basada en regiones de memoria, [SWS_CRYPT_22912] define una sobrecarga Seed(SymmetricKey::Sptr seed) que inicializa el estado del RNG mediante una clave simétrica y evalúa restricciones de uso como kAllowRngInit.

El método Seed inicializa el estado interno de un generador de números aleatorios en el contexto de ara::crypto::cryp::RandomGeneratorCtx utilizando una clave simétrica [SWS_CRYPT_22912]. La llamada se realiza de forma síncrona y está especificada como segura para subprocesos y segura ante excepciones (exception safe y noexcept) [SWS_CRYPT_22912]. Como parámetro de entrada sirve un puntero inteligente a una clave (SymmetricKey::Sptr), cuyo valor de clave se adopta como semilla [SWS_CRYPT_22912].

En el tratamiento de errores, la función devuelve un ara::core::Result<void>, que está vacío en caso de éxito [SWS_CRYPT_22912]. Si la operación falla, se aplica una semántica de reversión; esto afecta en particular a los siguientes códigos de error:

• ara::crypto::CryptoErrc::kUsageViolation: Se produce cuando el uso de clave permitido de la clave pasada no incluye el indicador kAllowRngInit [SWS_CRYPT_22912].
• ara::crypto::CryptoErrc::kUnsupported: Se notifica si la instancia de contexto concreta no admite el establecimiento de una semilla mediante una clave simétrica [SWS_CRYPT_22912].

En interacción con la familia de interfaces, esta función representa la variante basada en clave, mientras que la sobrecarga según [SWS_CRYPT_22911] cubre la inicialización mediante una zona de memoria no estructurada (ReadOnlyMemRegion). Debido a la semántica de reversión (rollback), en caso de error el estado interno del generador permanece probablemente en el estado anterior (interpretación). Pregunta Q-970cbedd1843b26a (abierta)