Paso 2: configuración de la aplicación

Configuración de su aplicación y adición de las dependencias necesarias.

1. Puede descargar la aplicación Java de ejemplo clonando el repositorio de Github con el siguiente comando.

   git clone https://github.com/aws-samples/amazon-keyspaces-examples.git

2. Después de descargar el repositorio de Github, descomprima el archivo descargado y navegue hasta el directorio resources del archivo application.conf.

   1. Configuración de aplicaciones

      En este paso, configurará el complemento de autenticación SigV4. Puede utilizar el siguiente ejemplo en su aplicación. Si aún no lo ha hecho, debe generar sus claves de acceso de IAM (un ID de clave de acceso y una clave de acceso secreta) y guardarlas en su archivo de configuración de AWS o como variables de entorno. Para obtener instrucciones detalladas, consulte Credenciales requeridas por el AWS CLI complemento SigV4 de Amazon Keyspaces o por el plugin Amazon Keyspaces para los controladores de cliente de Cassandra AWS SDK. Actualice la región de AWS y el punto de conexión del servicio para Amazon Keyspaces según sea necesario. Para obtener información acerca de más puntos de conexión del servicio, consulte Puntos de conexión de servicio para Amazon Keyspaces. Sustituya la ubicación, el nombre y la contraseña del almacén de confianza por los suyos propios.

      datastax-java-driver {
        basic.contact-points = ["cassandra.aws-region.amazonaws.com:9142"]
        basic.load-balancing-policy.local-datacenter = "aws-region"
        advanced.auth-provider {
          class = software.aws.mcs.auth.SigV4AuthProvider
          aws-region = "aws-region"
        }
        advanced.ssl-engine-factory {
          class = DefaultSslEngineFactory
          truststore-path = "truststore_locationtruststore_name.jks"
          truststore-password = "truststore_password;"
        }
      }

   2. Agregue la dependencia del módulo STS.

      Esto incorpora la posibilidad de utilizar un WebIdentityTokenCredentialsProvider que devuelva las credenciales de AWS que la aplicación debe proporcionar para que la cuenta de servicio pueda asumir el rol de IAM. Para hacerlo, siga este ejemplo.

              <dependency>
                  <groupId>com.amazonaws</groupId>
                  <artifactId>aws-java-sdk-sts</artifactId>
                  <version>1.11.717</version> 
              </dependency>

   3. Agregue la dependencia de SigV4.

      Este paquete implementa el complemento de autenticación SigV4 que se necesita para autenticarse en Amazon Keyspaces.

              <dependency>
                  <groupId>software.aws.mcs</groupId>
                  <artifactId>aws-sigv4-auth-cassandra-java-driver-plugin</artifactId>
                  <version>4.0.3</version> 
              </dependency>

3. Agregue la dependencia de registro.

   Sin registros, es imposible solucionar los problemas de conexión. En este tutorial, utilizamos slf4j como marco de registro y empleamos logback.xml para almacenar la salida del registro. Establecemos el nivel de registro en debug para establecer la conexión. Puede utilizar el siguiente ejemplo para agregar la dependencia.

           <dependency>
               <groupId>org.slf4j</groupId>
               <artifactId>slf4j-api</artifactId>
               <version>2.0.5</version> 
           </dependency>

   Puede utilizar el siguiente fragmento de código para configurar el registro.

   <configuration>
       <appender name="STDOUT" class="ch.qos.logback.core.ConsoleAppender">
           
           <encoder>
               <pattern>%d{HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
           </encoder>
       </appender>
   
       <root level="debug">
           <appender-ref ref="STDOUT" />
       </rootv
   </configuration>

   nota

   El nivel de debug es necesario para investigar los errores de conexión. Una vez que se haya conectado correctamente a Amazon Keyspaces desde su aplicación, podrá cambiar el nivel de registro a info o warning según sea necesario.