Kit SDK de chiffrement AWS pour Java - AWS Encryption SDK

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.

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 leKit SDK de chiffrement AWS pour Java, voir leaws-encryption-sdkjavarepository surGitHub. Pour la documentation de l'API, consultez le Javadoc pour le Kit SDK de chiffrement AWS pour Java.

Prérequis

Avant d'installer le kit Kit SDK de chiffrement AWS pour Java, assurez-vous de remplir les conditions prérequises 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

Le kit Kit SDK de chiffrement AWS pour Java exige Bouncy Castle.

  • Les versions Kit SDK de chiffrement AWS pour Java 1.6.1 et ultérieures utilisent Bouncy Castle pour sérialiser et désérialiser des objets de chiffrement. 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, veuillez consulter la documentation BC FIPS, en particulier les guides de l'utilisateur et les PDF de stratégie de sécurité.

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

Si vous n'avez pas Bouncy Castle, accédez aux dernières versions de Bouncy Castle pour télécharger le fichier de fournisseur correspondant à votre JDK. Vous pouvez également utiliserApache Mavenpour obtenir l'artefact du fournisseur standard Bouncy Castle (bcprov-ext-jdk15 sur) ou l'artefact de Bouncy Castle FIPS (bc-fips).

AWS SDK for Java (Facultatif)

LeKit SDK de chiffrement AWS pour Javane requiert pas leAWS SDK for Java. Cependant, leAWS SDK for Javaest obligatoire pour utiliserAWS Key Management Service(AWS KMS) en tant que fournisseur de clés principales. Il est également obligatoire pour certains des exemples de code Java du présent guide.

Début duKit SDK de chiffrement AWS pour Javaversion 2.4.0, laKit SDK de chiffrement AWS pour Javaprend en charge les versions 1.x et 2.x duAWS SDK for Java.AWS Encryption SDKcode pour leAWS SDK for Java1.x et 2.x sont interopérables. Par exemple, vous pouvez chiffrer les données avecAWS Encryption SDKcode qui prend en chargeAWS SDK for Java1.x et déchiffrez-le à l'aide d'un code qui prend en chargeAWS SDK for Java 2.x(ou vice versa). Versions duKit SDK de chiffrement AWS pour Javaprise en charge antérieure à 2.4.0 uniquementAWS SDK for Java1.x. Pour plus d'informations sur la mise à jour de votre version duAWS Encryption SDK, voirMigration versAWS Encryption SDKVersions 2.0.h/24, j/7et version ultérieure.

Lorsque vous mettez à jour votreKit SDK de chiffrement AWS pour Javadu code duAWS SDK for Java1.x àAWS SDK for Java 2.x, remplacez les références à laAWSKMSinterfacedansAWS SDK for Java1.x avec des références auKmsClientinterfacedansAWS SDK for Java 2.x. Mettez également à jour votre code pour utiliser leAWS KMS- objets liés dans lekmssdkv2espace de noms, au lieu de l'espace de nomskmsespace de noms.

Pour installer le AWS SDK for Java, utilisez Apache Maven.

Pour plus de modifications, voirQu'est-ce qui est différent entre leAWS SDK for Java1.x et 2.xdans leAWS SDK for Java 2.xManuel du développeur

Exemples Java dans leAWS Encryption SDKUtilisez le manuel du développeurAWS SDK for Java 2.x.

Installation

Vous pouvez installer le kit Kit SDK de chiffrement AWS pour Java de l'une des manières suivantes :

Manuellement

Pour installerKit SDK de chiffrement AWS pour Java, clonez ou téléchargez leaws-encryption-sdkjava GitHubrepository.

Utilisation d'Apache Maven

Kit SDK de chiffrement AWS pour Java 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>2.0.0</version> </dependency>

Après avoir installé le kit SDK, commencez en regardant leexemple de code Javadans ce guide et dans leJavadoc surGitHub.