classe ara::crypto::cryp::KeyAgreementPrivateCtx

L'interface ara::crypto::cryp::KeyAgreementPrivateCtx sert à exécuter des procédures d'accord de clés cryptographiques sur la base d'une clé privée locale et de la clé publique d'une contrepartie [SWS_CRYPT_21312]. Après assignation de la clé propre et de paramètres optionnels, la méthode AgreeKey calcule un secret partagé et le renvoie sous la forme d'un objet de clé symétrique. Une contrainte centrale est l'initialisation complète avant l'exécution, car des paramètres manquants ou des autorisations manquantes pour kAllowKeyAgreement entraînent l'interruption avec les codes d'erreur correspondants [SWS_CRYPT_21312]. Toutes les opérations sont ici conçues pour être thread-safe.

plus ›

Contexte

L'interface ara::crypto::cryp::KeyAgreementPrivateCtx sert, dans le module crypto de l'Adaptive Platform, à exécuter des procédures d'accord de clés asymétriques (Key Agreement). Sa responsabilité principale réside dans le calcul d'une clé symétrique partagée à partir d'une clé privée locale et de la clé publique d'un partenaire de communication [SWS_CRYPT_21312]. En tant que contexte crypto spécialisé, la classe interagit avec plusieurs abstractions de clés et d'emplacements : la clé privée propre peut être liée soit directement sous forme d'objet PrivateKey [SWS_CRYPT_21313], soit par référence via un KeySlot [SWS_CRYPT_50053]. La contrepartie fournit sa clé publique sous la forme d'un PublicKey, tandis que le résultat est fourni sous la forme d'un objet SymmetricKey distinct [SWS_CRYPT_21312]. En complément, des paramètres de configuration spécifiques à l'algorithme peuvent être transmis sous forme de zone mémoire ou d'entier [SWS_CRYPT_50051], [SWS_CRYPT_50052].

Diagramme de contexte : interaction de KeyAgreementPrivateCtx avec les clés, les emplacements de clés et l'objet de résultat. Sources : [SWS_CRYPT_21312], [SWS_CRYPT_21313], [SWS_CRYPT_50053].

Cycle de vie

Le cycle de vie et les relations de propriété de KeyAgreementPrivateCtx reposent sur des shared pointers ; la spécification fournit à cet effet l'alias de type KeyAgreementPrivateCtx::Sptr [SWS_CRYPT_21301]. Interprétation : l'instanciation devrait s'effectuer via une fabrique de niveau supérieur d'un CryptoProvider, étant donné que la classe constitue une interface purement virtuelle sans spécification de constructeur. Question Q-22dca518675fba51 (ouverte) Après sa création, l'instance se trouve dans un état initial non opérationnel. Le contexte n'est initialisé que par la configuration d'une clé privée au moyen de SetKey [SWS_CRYPT_21313], [SWS_CRYPT_50053] et l'assignation de tous les paramètres nécessaires au schéma sélectionné [SWS_CRYPT_50051], [SWS_CRYPT_50052].

Si un calcul de clé est déclenché avant l'achèvement de ces étapes de configuration, l'appel échoue [SWS_CRYPT_21312]. En ce qui concerne la concurrence, toutes les fonctions membres sont spécifiées comme thread-safe (thread-safe) ainsi que sûres vis-à-vis des exceptions (exception safe) [SWS_CRYPT_21312], [SWS_CRYPT_21313], [SWS_CRYPT_50051], [SWS_CRYPT_50052], [SWS_CRYPT_50053]. La fonction d'exécution AgreeKey étant déclarée comme const [SWS_CRYPT_21312], le même contexte initialisé peut être utilisé en parallèle pour des accords avec différentes contreparties.

Parcours d'utilisation

L'utilisation pratique s'articule en une séquence de configuration et de calcul :

• Assignation de clé : tout d'abord, l'application lie sa propre clé privée au contexte. Cela s'effectue soit via SetKey(PrivateKey::Sptr) [SWS_CRYPT_21313] pour un objet de clé chargé, soit via SetKey(KeySlot::Sptr) [SWS_CRYPT_50053] pour un emplacement de clé dont le contenu n'est évalué qu'au moment de l'accord.
• Définition des paramètres : si l'algorithme cible requiert des données d'initialisation supplémentaires, celles-ci sont transmises par SetParameter sous forme de tampon ReadOnlyMemRegion [SWS_CRYPT_50051] ou sous forme d'entier 64 bits std::uint64_t [SWS_CRYPT_50052].
• Accord de clé : l'algorithme cryptographique est exécuté avec AgreeKey [SWS_CRYPT_21312]. Le composant appelant transmet la clé publique de la contrepartie (otherSideKey), l'identifiant de l'algorithme cible souhaité (targetAlgId) ainsi que les drapeaux d'utilisation autorisés (allowedUsage).
• Récupération du résultat : en cas d'achèvement réussi, AgreeKey renvoie un objet SymmetricKey contenant le secret partagé calculé [SWS_CRYPT_21312].

Diagramme de séquence : déroulement typique de l'accord de clé, de l'attribution de la clé jusqu'à la génération de la clé symétrique. Sources : [SWS_CRYPT_21312], [SWS_CRYPT_21313], [SWS_CRYPT_50051].

Scénarios d'erreur

Les méthodes de KeyAgreementPrivateCtx renvoient des erreurs via ara::core::Result et garantissent une sémantique de rollback [SWS_CRYPT_21312], [SWS_CRYPT_21313], [SWS_CRYPT_50051], [SWS_CRYPT_50052], [SWS_CRYPT_50053]. Les scénarios d'erreur typiques comprennent :

• CryptoErrc::kUninitializedContext : survient lors de AgreeKey si aucune clé n'a été préalablement définie ou si des paramètres requis sont manquants [SWS_CRYPT_21312].
• CryptoErrc::kIncompatibleObject : est signalé lorsqu'un PrivateKey ou un KeySlot transmis ne correspond pas au type du contexte [SWS_CRYPT_21313], [SWS_CRYPT_50053], ou lorsque la clé de contrepartie otherSideKey est incompatible [SWS_CRYPT_21312].
• CryptoErrc::kUsageViolation : signale que le droit kAllowKeyAgreement n'a pas été accordé pour la clé privée ou pour la clé de contrepartie [SWS_CRYPT_21312], [SWS_CRYPT_21313].
• CryptoErrc::kUnsupported : indique que l'implémentation du contexte prend exclusivement en charge l'autre variante respective de SetKey [SWS_CRYPT_21313], [SWS_CRYPT_50053], ou qu'un nom de paramètre demandé n'est pas pris en charge [SWS_CRYPT_50051], [SWS_CRYPT_50052].
• CryptoErrc::kInvalidArgument : se produit en cas de valeurs invalides dans SetParameter [SWS_CRYPT_50051], [SWS_CRYPT_50052] ou de drapeaux allowedUsage non autorisés pour la clé cible [SWS_CRYPT_21312].
• CryptoErrc::kUnknownIdentifier : est déclenché si l'identifiant targetAlgId est inconnu pour l'algorithme cible [SWS_CRYPT_21312].
• CryptoErrc::kEmptyKeySlot et CryptoErrc::kBusyResource : sont renvoyés par AgreeKey lorsque le KeySlot configuré ne contient aucune clé au moment de l'exécution ou qu'une ressource requise est occupée [SWS_CRYPT_21312].