Conexión a Neptune mediante Java y SPARQL con Signature Version 4 Signing (RDF4Jy Jena)

En esta sección se muestra cómo conectarse a Neptune mediante la autenticación Signature Version 4 RDF4J o Apache Jena con Signature Version 4.

Requisitos previos

• Java 8 o superior.

• Apache Maven 3.3 o superior.

  Para obtener información sobre la instalación de estos requisitos previos en una EC2 instancia que ejecute Amazon Linux, consulteRequisitos previos en Amazon Linux EC2.

• Credenciales de IAM para firmar las solicitudes. Para obtener más información, consulte Uso de la cadena de proveedores de credenciales predeterminada en AWS SDK for Java Guía para desarrolladores.

  nota

  Si utiliza las credenciales temporales, caducan después de un intervalo especificado, incluido el token de sesión.

  Tiene que actualizar el token de sesión cuando solicite nuevas credenciales. Para obtener más información, consulte Uso de credenciales de seguridad temporales para solicitar acceso a AWS Recursos de la Guía IAM del usuario.

• Establezca la variable SERVICE_REGION en una de las siguientes e indique la región de su instancia de base de datos de Neptune:

  • Este de EE. UU. (Norte de Virginia): us-east-1

  • Este de EE. UU. (Ohio): us-east-2

  • Oeste de EE. UU. (Norte de California): us-west-1

  • Oeste de EE. UU. (Oregón): us-west-2

  • Canadá (centro): ca-central-1

  • América del Sur (São Paulo): sa-east-1

  • Europa (Estocolmo): eu-north-1

  • Europa (España): eu-south-2

  • Europa (Irlanda): eu-west-1

  • Europa (Londres): eu-west-2

  • Europa (París): eu-west-3

  • Europa (Fráncfort): eu-central-1

  • Medio Oriente (Baréin): me-south-1

  • Oriente Medio (UAE): me-central-1

  • Israel (Tel Aviv):   il-central-1

  • África (Ciudad del Cabo): af-south-1

  • Asia Pacífico (Hong Kong): ap-east-1

  • Asia-Pacífico (Tokio): ap-northeast-1

  • Asia-Pacífico (Seúl): ap-northeast-2

  • Asia-Pacífico (Osaka): ap-northeast-3

  • Asia-Pacífico (Singapur): ap-southeast-1

  • Asia-Pacífico (Sídney): ap-southeast-2

  • Asia-Pacífico (Yakarta): ap-southeast-3

  • Asia-Pacífico (Bombay): ap-south-1

  • China (Pekín): cn-north-1

  • China (Ningxia): cn-northwest-1

  • AWS GovCloud (EEUU-Oeste): us-gov-west-1

  • AWS GovCloud (EEUU-Este): us-gov-east-1

Para conectarse a Neptune mediante la firma Signature Version 4 RDF4J o Apache Jena

1. Clona el repositorio de muestras desde. GitHub

   git clone https://github.com/aws/amazon-neptune-sparql-java-sigv4.git

2. Cambie al directorio clonado.

   cd amazon-neptune-sparql-java-sigv4

3. Obtenga la versión más reciente del proyecto al revisar la ramificación con la etiqueta más reciente.

   git checkout $(git describe --tags `git rev-list --tags --max-count=1`)

4. Introduzca uno de los siguientes comandos para compilar y ejecutar el código de ejemplo.

   Reemplazar your-neptune-endpoint con el nombre de host o la dirección IP de su instancia de base de datos de Neptune. El puerto predeterminado es 8182.

   nota

   Para obtener información acerca de cómo encontrar el nombre de host de la instancia de base de datos de Neptune, consulte la sección Conexión a los puntos de conexión de Amazon Neptune.

   Eclipse RDF4J

   Introduzca lo siguiente para ejecutar el RDF4J ejemplo.

   mvn compile exec:java \
       -Dexec.mainClass="com.amazonaws.neptune.client.rdf4j.NeptuneRdf4JSigV4Example" \
       -Dexec.args="https://your-neptune-endpoint:port"

   Apache Jena

   Para ejecutar el ejemplo de Apache Jena, introduzca lo siguiente.

   mvn compile exec:java \
       -Dexec.mainClass="com.amazonaws.neptune.client.jena.NeptuneJenaSigV4Example" \
       -Dexec.args="https://your-neptune-endpoint:port"

5. Para ver el código fuente del ejemplo, consulte los ejemplos del directorio src/main/java/com/amazonaws/neptune/client/.

Para utilizar el controlador de firma SigV4 en su propia aplicación de Java, añada el paquete de Maven amazon-neptune-sigv4-signer a la sección <dependencies> del archivo pom.xml. Recomendamos que utilice los ejemplos como punto de partida.