Kit SDK de chiffrement AWS pour Java

Cette rubrique explique comment installer et utiliser le kit Kit SDK de chiffrement AWS pour Java. Pour plus de détails sur la programmation avec le Kit SDK de chiffrement AWS pour Java, consultez le aws-encryption-sdk-javaréférentiel sur GitHub. Pour la documentation de l'API, consultez le Javadoc pour le Kit SDK de chiffrement AWS pour Java.

Rubriques

• Prérequis

• Installation

• Exemples

Prérequis

Avant d'installer le Kit SDK de chiffrement AWS pour Java, assurez-vous de remplir les conditions préalables suivantes.

Environnement de développement Java

Vous aurez besoin de Java 8 ou version ultérieure. Sur le site web d'Oracle, consultez la page Téléchargements Java SE, puis téléchargez et installez le kit Java SE Development (JDK).

Si vous utilisez le kit JDK Oracle, vous devez également télécharger et installer les fichiers Java Cryptography Extension (JCE) Unlimited Strength Jurisdiction Policy.

Bouncy Castle

Kit SDK de chiffrement AWS pour Java Cela nécessite Bouncy Castle.

• Kit SDK de chiffrement AWS pour Java les versions 1.6.1 et ultérieures utilisent Bouncy Castle pour sérialiser et désérialiser des objets cryptographiques. Vous pouvez utiliser Bouncy Castle ou Bouncy Castle FIPS pour répondre à cette exigence. Pour obtenir de l'aide sur l'installation et la configuration de Bouncy Castle FIPS, consultez la documentation BC FIPS, en particulier les guides de l'utilisateur et la politique de sécurité. PDFs

• Les versions antérieures Kit SDK de chiffrement AWS pour Java utilisent l'API de cryptographie de Bouncy Castle pour Java. Cette exigence n'est satisfaite que par les Bouncy Castle non FIPS.

Si vous n'avez pas Bouncy Castle, rendez-vous sur Télécharger Bouncy Castle pour Java pour télécharger le fichier fournisseur correspondant à votre JDK. Vous pouvez également utiliser Apache Maven pour obtenir l'artefact pour le fournisseur standard de Bouncy Castle (bcprov-ext-jdk15on) ou l'artefact pour Bouncy Castle FIPS (bc-fips).

AWS SDK pour Java

Version 3. x l' Kit SDK de chiffrement AWS pour Java exige AWS SDK for Java 2.x, même si vous n'utilisez pas de AWS KMS porte-clés.

Version 2. x ou une version antérieure du Kit SDK de chiffrement AWS pour Java ne nécessite pas le AWS SDK pour Java. Cependant, AWS SDK pour Java il est nécessaire d'utiliser AWS Key Management Service(AWS KMS) comme fournisseur de clé principale. À partir de la Kit SDK de chiffrement AWS pour Java version 2.4.0, il Kit SDK de chiffrement AWS pour Java prend en charge les versions 1.x et 2.x du. AWS SDK pour Java AWS Encryption SDK le code pour les versions AWS SDK pour Java 1.x et 2.x est interopérable. Par exemple, vous pouvez chiffrer des données avec un AWS Encryption SDK code compatible avec la version AWS SDK pour Java 1.x et les déchiffrer à l'aide d'un code compatible AWS SDK for Java 2.x (ou vice versa). Les versions antérieures à Kit SDK de chiffrement AWS pour Java 2.4.0 ne prennent en charge que la version AWS SDK pour Java 1.x. Pour plus d'informations sur la mise à jour de votre version du AWS Encryption SDK, consultezMigration de votre AWS Encryption SDK.

Lorsque vous mettez à jour votre Kit SDK de chiffrement AWS pour Java code de la AWS SDK pour Java version 1.x à AWS SDK for Java 2.x, remplacez les références à l'AWSKMSinterface de la version AWS SDK pour Java 1.x par des références à l'KmsClientinterface de. AWS SDK for Java 2.x Kit SDK de chiffrement AWS pour Java Ne prend pas en charge l'KmsAsyncClientinterface. Mettez également à jour votre code pour utiliser les objets AWS KMS associés dans l'espace de kmssdkv2 noms, plutôt que dans l'espace de kms noms.

Pour l'installer AWS SDK pour Java, utilisez Apache Maven.

• Pour importer tout le AWS SDK pour Java en tant que dépendance, déclarez-le dans votre fichier pom.xml.

• Pour créer une dépendance uniquement pour le AWS KMS module dans la version AWS SDK pour Java 1.x, suivez les instructions pour spécifier des modules particuliers et définissez la valeur surartifactId. aws-java-sdk-kms

• Pour créer une dépendance uniquement pour le AWS KMS module dans la version AWS SDK pour Java 2.x, suivez les instructions pour spécifier des modules particuliers. Réglez le groupId to software.amazon.awssdk et le artifactId tokms.

Pour plus de modifications, consultez la section Quelles sont les différences entre la version AWS SDK pour Java 1.x et la version 2.x dans le manuel du AWS SDK for Java 2.x développeur.

Les exemples de Java présentés dans le Guide du AWS Encryption SDK développeur utilisent le AWS SDK for Java 2.x.

Installation

Installez la dernière version du Kit SDK de chiffrement AWS pour Java.

Note

Toutes les versions Kit SDK de chiffrement AWS pour Java antérieures à la version 2.0.0 sont en end-of-supportphase.

Vous pouvez effectuer la mise à jour en toute sécurité à partir de la version 2.0. x et versions ultérieures vers la dernière version du Kit SDK de chiffrement AWS pour Java sans aucune modification du code ou des données. Cependant, de nouvelles fonctionnalités de sécurité ont été introduites dans la version 2.0. x ne sont pas rétrocompatibles. Pour effectuer une mise à jour à partir de versions antérieures à 1.7. x vers la version 2.0. x et versions ultérieures, vous devez d'abord effectuer la mise à jour vers la dernière version 1. version x du AWS Encryption SDK. Pour plus de détails, consultez Migration de votre AWS Encryption SDK.

Vous pouvez l'installer Kit SDK de chiffrement AWS pour Java de la manière suivante.

Manuellement

Pour installer le aws-encryption-sdk-java GitHubréférentiel Kit SDK de chiffrement AWS pour Java, le cloner ou le télécharger.

Utilisation d'Apache Maven

Kit SDK de chiffrement AWS pour Java Il est disponible via Apache Maven avec la définition de dépendance suivante.

<dependency>
  <groupId>com.amazonaws</groupId>
  <artifactId>aws-encryption-sdk-java</artifactId>
  <version>3.0.0</version>
</dependency>

Après avoir installé le SDK, commencez par consulter l'exemple de code Java présenté dans ce guide et le Javadoc activé. GitHub