Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Utilisez cette rubrique pour migrer votre bibliothèque AWS CloudHSM PKCS #11 du SDK client 3 vers le SDK client 5. Pour connaître les avantages de la migration, voirAvantages du SDK AWS CloudHSM client 5.
Dans AWS CloudHSM, les applications client exécutent des opérations cryptographiques à l'aide du kit de développement logiciel (SDK) AWS CloudHSM client. Le SDK client 5 est le SDK principal auquel de nouvelles fonctionnalités et un support de plateforme continuent d'être ajoutés.
Pour consulter les instructions de migration pour tous les fournisseurs, voirMigration du SDK AWS CloudHSM client 3 vers le SDK client 5.
Préparez-vous en faisant face aux changements les plus importants
Passez en revue ces modifications majeures et mettez à jour votre application dans votre environnement de développement en conséquence.
Les mécanismes d'enroulement ont changé
| Mécanisme du SDK client 3 | Mécanisme équivalent du SDK client 5 |
|---|---|
|
|
|
|
|
|
|
|
|
|
ECDH
Dans le SDK client 3, vous pouvez utiliser ECDH et spécifier un KDF. Cette fonctionnalité n'est actuellement pas disponible dans le SDK client 5. Si votre application a besoin de cette fonctionnalité, veuillez contacter l'assistance
Les poignées de touches sont désormais spécifiques à la session
Pour utiliser correctement les descripteurs de clé dans le SDK client 5, vous devez obtenir des descripteurs de clé chaque fois que vous exécutez une application. Si vous avez des applications existantes qui utiliseront les mêmes descripteurs de clé au cours de différentes sessions, vous devez modifier votre code pour obtenir le descripteur de clé à chaque exécution de l'application. Pour plus d'informations sur la récupération des descripteurs de touches, consultez cet exemple AWS CloudHSM PKCS #11
Migrer vers le SDK client 5
Suivez les instructions de cette section pour migrer du SDK client 3 vers le SDK client 5.
Note
Amazon Linux, Ubuntu 16.04, Ubuntu 18.04, CentOS 6, CentOS 8 et RHEL 6 ne sont actuellement pas pris en charge avec le SDK client 5. Si vous utilisez actuellement l'une de ces plateformes avec le SDK client 3, vous devrez en choisir une autre lors de la migration vers le SDK client 5.
-
Désinstallez la bibliothèque PKCS #11 pour le SDK client 3.
$sudo yum remove cloudhsm-client-pkcs11 -
Désinstallez le démon client pour le SDK client 3.
$sudo yum remove cloudhsm-clientNote
Les configurations personnalisées doivent être réactivées.
-
Installez la bibliothèque PKCS #11 du SDK client en suivant les étapes décrites dans. Installation de la bibliothèque PKCS #11 pour le SDK AWS CloudHSM client 5
-
Le SDK client 5 introduit un nouveau format de fichier de configuration et un outil d'amorçage en ligne de commande. Pour démarrer votre bibliothèque PKCS #11 du SDK client 5, suivez les instructions répertoriées dans le guide de l'utilisateur ci-dessous. Amorcez le SDK client
-
Dans votre environnement de développement, testez votre application. Mettez à jour votre code existant pour corriger les modifications importantes avant votre migration finale.
Rubriques en relation
