Java

Se cambió el nombre de nuestra biblioteca de cifrado del lado del cliente por el de SDK de cifrado de AWS bases de datos. En esta guía para desarrolladores, se sigue proporcionando información sobre el cliente de cifrado de DynamoDB.

En este tema se explica cómo instalar y usar la versión 3.x de la biblioteca de cifrado del cliente de Java para DynamoDB. Para obtener más información sobre la programación con el SDK AWS de cifrado de bases de datos para DynamoDB, consulte los ejemplos de Java en el repositorio -dynamodb en aws-database-encryption-sdk. GitHub

nota

Los siguientes temas se centran en la versión 3.x de la biblioteca de cifrado del cliente de Java para DynamoDB.

Nuestra biblioteca de cifrado del cliente pasó a llamarse SDK de cifrado de bases de datos de AWS. El SDK AWS de cifrado de bases de datos sigue siendo compatible con las versiones antiguas de DynamoDB Encryption Client.

Temas

• Requisitos previos
• Instalación
• Uso de la biblioteca de cliente de Java
• Ejemplos de Java
• Agregar la versión 3.x a una tabla existente
• Migrar a la versión 3.x

Requisitos previos

Antes de instalar la versión 3.x de la biblioteca de cifrado del cliente de Java para DynamoDB, 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).

AWS SDK for Java 2.x

El SDK AWS de cifrado de bases de datos para DynamoDB requiere el módulo DynamoDB Enhanced Client del. AWS SDK for Java 2.x Puede instalar todo el SDK o solo este módulo.

Para obtener información sobre cómo actualizar su versión de AWS SDK for Java, consulte Migración de la versión 1.x a la 2.x del. AWS SDK for Java

AWS SDK for Java Está disponible a través de Apache Maven. Puede declarar una dependencia para todo AWS SDK for Java el dynamodb-enhanced módulo o solo para él.

Instálelo AWS SDK for Java con Apache Maven

• Para importar todo AWS SDK for Java como una dependencia declárelo en el archivo pom.xml.

• Para crear una dependencia solo para el módulo Amazon DynamoDB en el AWS SDK for Java, siga las instrucciones para especificar módulos concretos. Establece el groupId para y el para.software.amazon.awssdk artifactID dynamodb-enhanced

  nota

  Si usa el anillo de AWS KMS claves o el anillo de claves AWS KMS jerárquico, también necesita crear una dependencia para el módulo. AWS KMS Establece el groupId en software.amazon.awssdk y el artifactID en kms.

Instalación

Puede instalar la versión 3.x de la biblioteca de cifrado del cliente de Java para DynamoDB de las siguientes maneras.

Con Apache Maven

El Cliente de encriptación de Amazon DynamoDB para Java está disponible en Apache Maven con la siguiente definición de dependencias.

<dependency>
  <groupId>software.amazon.cryptography</groupId>
  <artifactId>aws-database-encryption-sdk-dynamodb</artifactId>
  <version>version-number</version>
</dependency>

Uso de Gradle Kotlin

Puede usar Gradle para declarar una dependencia en el Cliente de encriptación de Amazon DynamoDB para Java añadiendo lo siguiente a la sección de dependencias de su proyecto de Gradle.

implementation("software.amazon.cryptography:aws-database-encryption-sdk-dynamodb:version-number")

Manualmente

Para instalar la biblioteca de cifrado del lado del cliente de Java para DynamoDB, clone o descargue el repositorio -dynamodb. aws-database-encryption-sdk GitHub

Tras instalar el SDK, comience por consultar el código de ejemplo de esta guía y los ejemplos de Java del repositorio -dynamodb de. aws-database-encryption-sdk GitHub