classe ara::crypto::Formatter

L'interface ara::crypto::Formatter permet la conversion et la sérialisation thread-safe de données cryptographiques entre les formats bruts, DER et PEM [SWS_CRYPT_50197]. Après la définition du format cible et la détermination de la taille de tampon requise, la méthode Convert transfère les données sources dans le tampon de sortie préparé [SWS_CRYPT_50198]. Une condition essentielle pour une exécution réussie est une mémoire cible suffisamment dimensionnée ainsi que la conformité formelle des données d'entrée avec le format source configuré.

plus ›

Contexte

L'interface ara::crypto::Formatter définit dans le module crypto l'interface uniforme pour le formatage, la transformation et la sérialisation des structures de données cryptographiques. Sa tâche principale consiste à convertir des données utiles et des objets cryptographiques entre des représentations telles que des données brutes pures (kFormatRawValueOnly), des codages ASN.1-DER (kFormatDerEncoded) ainsi que des formats textuels PEM (kFormatPemEncoded) en tenant compte d'un identifiant d'algorithme (AlgId) [SWS_CRYPT_50197]. Ici, le Formatter agit comme un lien entre les objets cryptographiques et les tampons mémoire en lisant les données via ReadOnlyMemRegion et en les restituant dans ReadWriteMemRegion [SWS_CRYPT_50198].

Cycle de vie

Puisque ara::crypto::Formatter est déclarée comme une interface purement virtuelle, elle fournit, pour le référencement et la gestion du cycle de vie, l'alias de type de pointeur intelligent canonique Sptr, qui est défini comme std::shared_ptr<Formatter> [SWS_CRYPT_50191]. En pratique, les instances concrètes de l'interface devraient être fournies via des méthodes de fabrique de composants cryptographiques de niveau supérieur. Question Q-99e96992d02b9c13 (ouverte) Après sa création, un Formatter se trouve d'abord dans un état initial non configuré, avant d'être préparé pour les conversions par des appels de configuration.

En ce qui concerne l'environnement d'exécution, l'interface garantit une sécurité totale vis-à-vis des exceptions (exception safe) grâce à l'utilisation systématique de noexcept et au traitement des erreurs via des types Result [SWS_CRYPT_50197], [SWS_CRYPT_50198], [SWS_CRYPT_50199]. Toutes les fonctions membres sont en outre spécifiées comme thread-safe [SWS_CRYPT_50197], [SWS_CRYPT_50198], [SWS_CRYPT_50199]. Cela permet l'accès parallèle en lecture et en transformation de plusieurs threads à une instance partagée de Formatter, tant qu'aucune reconfiguration concurrente n'a lieu.

Parcours d'utilisation

L'utilisation régulière de ara::crypto::Formatter suit une séquence fixe de paramétrage, de vérification de capacité et de transformation :

1. Configuration du format : le format d'entrée attendu (inputFormat), le format de sortie souhaité (outputFormat) ainsi que l'identifiant d'algorithme (algId) des données à traiter sont définis de manière contraignante via SetFormatConfiguration [SWS_CRYPT_50197].
2. Détermination de la taille : avant la conversion proprement dite, l'application appelle GetExportSize afin de déterminer la taille exacte en mémoire, en octets, requise par l'objet sérialisé sous la configuration actuelle [SWS_CRYPT_50199]. Cela permet l'allocation sur mesure de la mémoire cible.
3. Conversion des données : pour finir, Convert transforme les données sources issues d'une ReadOnlyMemRegion vers le tampon cible ReadWriteMemRegion conformément à la configuration effectuée [SWS_CRYPT_50198].

Diagramme de séquence : séquence de conversion typique, de la sélection du format à la transformation proprement dite, en passant par la détermination de la taille du tampon. Sources : [SWS_CRYPT_50197], [SWS_CRYPT_50199], [SWS_CRYPT_50198]

Scénarios d'erreur

Les méthodes de ara::crypto::Formatter signalent les états d'erreur de manière déterministe via des valeurs de retour de type ara::core::Result. Des sémantiques de rollback claires sont par ailleurs définies pour les opérations échouées :

• Formats non pris en charge : si l'implémentation sous-jacente ne prend pas en charge la paire de conversion spécifiée ou l'identifiant d'algorithme, SetFormatConfiguration renvoie le code d'erreur ara::crypto::CryptoErrc::kUnsupportedFormat [SWS_CRYPT_50197].
• Données d'entrée non valides : si les données brutes transmises dans le tampon ne correspondent pas au format configuré ou sont syntaxiquement non valides, Convert échoue avec ara::crypto::CryptoErrc::kInvalidArgument [SWS_CRYPT_50198].
• Tampon cible insuffisant : si la ReadWriteMemRegion fournie est trop petite pour le résultat sérialisé, Convert s'interrompt avec ara::crypto::CryptoErrc::kInsufficientCapacity [SWS_CRYPT_50198]. Ce problème peut être évité de manière ciblée par une interrogation préalable via GetExportSize [SWS_CRYPT_50199].
• Préconfiguration manquante : bien qu'aucun code d'erreur standardisé ne soit répertorié pour GetExportSize [SWS_CRYPT_50199], une configuration valide via SetFormatConfiguration doit vraisemblablement avoir été établie au préalable afin qu'une détermination de taille ou une conversion cohérente puisse être effectuée. Question Q-e7cf4306bc7cfb49 (ouverte)