Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
SDK de cifrado de AWS para Java
En este tema se explica cómo instalar y utilizar el SDK de cifrado de AWS para Java. Para obtener detalles sobre la programación con SDK de cifrado de AWS para Java, consulte el aws-encryption-sdk-java
Requisitos previos
Antes de instalarlo SDK de cifrado de AWS para Java, asegúrese de cumplir los siguientes requisitos previos.
- Un entorno de desarrollo de Java
-
Necesitará Java 8 o una versión posterior. En el sitio web de Oracle, vaya a la página de descargas de Java SE
y, a continuación, descargue e instale el Java SE Development Kit (JDK). Si utiliza el JDK de Oracle, también debe descargar e instalar los archivos de políticas de jurisdicción de seguridad ilimitada de la extensión de criptografía de Java (JCE)
. - Bouncy Castle
-
SDK de cifrado de AWS para Java Requiere Bouncy Castle.
-
SDK de cifrado de AWS para Java las versiones 1.6.1 y posteriores utilizan Bouncy Castle para serializar y deserializar objetos criptográficos. Puede utilizar Bouncy Castle o Bouncy Castle FIPS
para cumplir este requisito. Si necesita ayuda para instalar y configurar el FIPS de Bouncy Castle, consulte la documentación del FIPS de BC , especialmente las guías de usuario y la política de seguridad. PDFs -
Las versiones anteriores SDK de cifrado de AWS para Java utilizan la API de criptografía de Bouncy Castle para Java. Este requisito solo se cumple con el Bouncy Castle que no es de FIPS.
Si no tienes Bouncy Castle, ve a Descargar Bouncy Castle para Java para
descargar el archivo del proveedor correspondiente a tu JDK. También puedes usar Apache Maven para obtener el artefacto para el proveedor estándar de Bouncy Castle (bcprov-ext-jdk15on ) o el artefacto para Bouncy Castle FIPS (bc-fips). -
- AWS SDK for Java
-
Versión 3. x de los SDK de cifrado de AWS para Java requiere el AWS SDK for Java 2.x, incluso si no usas AWS KMS llaveros.
Versión 2. x o una versión anterior de SDK de cifrado de AWS para Java no requiere la AWS SDK for Java. Sin embargo, AWS SDK for Java es necesario para usar AWS Key Management Service
(AWS KMS) como proveedor de claves maestras. A partir de la SDK de cifrado de AWS para Java versión 2.4.0, SDK de cifrado de AWS para Java es compatible con las versiones 1.x y 2.x de. AWS SDK for Java AWS Encryption SDK el código de la AWS SDK for Java 1.x y la 2.x es interoperable. Por ejemplo, puede cifrar los datos con un AWS Encryption SDK código compatible con la versión AWS SDK for Java 1.x y descifrarlos con un código compatible AWS SDK for Java 2.x (o viceversa). Las versiones anteriores a la 2.4.0 SDK de cifrado de AWS para Java solo admiten la versión 1.x. AWS SDK for Java Para obtener información sobre cómo actualizar su versión de AWS Encryption SDK, consulte. Migración de su AWS Encryption SDK Al actualizar el SDK de cifrado de AWS para Java código de la versión AWS SDK for Java 1.x a AWS SDK for Java 2.x, sustituya las referencias a la
AWSKMS
interfaz de la versión AWS SDK for Java 1.x por las referencias a laKmsClient
interfazde. AWS SDK for Java 2.xNo SDK de cifrado de AWS para Java es compatible con la KmsAsyncClient
interfaz.Además, actualice el código para usar los objetos relacionados al AWS KMS en el espacio de nombres de kmssdkv2
, en lugar del espacio de nombres dekms
.Para instalar AWS SDK for Java, utilice Apache Maven.
-
Para importar todo el AWS SDK for Java como una dependencia declárelo en el archivo
pom.xml
. -
Para crear una dependencia solo para el AWS KMS módulo de la AWS SDK for Java versión 1.x, siga las instrucciones para especificar determinados módulos y establezca el
artifactId
valor.aws-java-sdk-kms
-
Para crear una dependencia solo para el AWS KMS módulo de la versión AWS SDK for Java 2.x, siga las instrucciones para especificar módulos concretos. Establece el
groupId
ensoftware.amazon.awssdk
y elartifactId
enkms
.
Para ver más cambios, consulta las diferencias entre la versión AWS SDK for Java 1.x y la 2.x en la AWS SDK for Java 2.x Guía para desarrolladores.
Los ejemplos de Java de la Guía AWS Encryption SDK para desarrolladores utilizan el. AWS SDK for Java 2.x
-
Instalación
Instale la versión más reciente de SDK de cifrado de AWS para Java.
nota
Todas las versiones SDK de cifrado de AWS para Java anteriores a la 2.0.0 se encuentran en esta end-of-supportfase.
Puede actualizar de forma segura desde la versión 2.0.x y versiones posteriores a la última versión de SDK de cifrado de AWS para Java sin cambios en el código ni en los datos. Sin embargo, nuevas características de seguridad que se introdujeron en la versión 2.0.x no son compatibles con versiones anteriores. Para actualizar desde versiones anteriores a la 1.7.x a la versión 2.0.x y posteriores, primero debe actualizar a la última versión 1.x de AWS Encryption SDK. Para obtener más información, consulte Migrar su AWS Encryption SDK.
Puede instalarlo de SDK de cifrado de AWS para Java las siguientes maneras.
- Manualmente
-
Para instalarlo SDK de cifrado de AWS para Java, clone o descargue el aws-encryption-sdk-java
GitHubrepositorio. - Con Apache Maven
-
SDK de cifrado de AWS para Java Está disponible a través de Apache Maven
con la siguiente definición de dependencia. <dependency> <groupId>com.amazonaws</groupId> <artifactId>aws-encryption-sdk-java</artifactId> <version>3.0.0</version> </dependency>
Después de instalar el SDK, comience consultando el ejemplo de código Java de esta guía y el Javadoc