Connessione a Neptune tramite Java SPARQL e con Signature Version 4 Signing RDF4J (e Jena)

Questa sezione mostra come connettersi a Neptune utilizzando uno RDF4J o Apache Jena con autenticazione Signature Version 4.

Prerequisiti

• Java 8 o versione successiva.

• Apache Maven 3.3 o versione successiva.

  Per informazioni sull'installazione di questi prerequisiti su un'EC2istanza che esegue Amazon Linux, consultaPrerequisiti su Amazon Linux EC2.

• Le credenziali IAM per firmare le richieste. Per ulteriori informazioni, consulta Using the Default Credential Provider Chain in AWS SDK for Java Guida per gli sviluppatori.

  Nota

  Se utilizzi credenziali temporanee, queste scadono dopo un intervallo specificato, comprensivo del token di sessione.

  Devi aggiornare il token di sessione quando richiedi le nuove credenziali. Per ulteriori informazioni, vedere Utilizzo di credenziali di sicurezza temporanee per richiedere l'accesso a AWS Risorse nella Guida per l'IAMutente.

• Imposta la variabile SERVICE_REGION su uno dei valori seguenti per indicare la regione dell'istanza database Neptune:

  • Stati Uniti orientali (Virginia settentrionale): us-east-1

  • Stati Uniti orientali (Ohio): us-east-2

  • Stati Uniti occidentali (California settentrionale): us-west-1

  • Stati Uniti occidentali (Oregon): us-west-2

  • Canada (Centrale): ca-central-1

  • Sud America (San Paolo): sa-east-1

  • Europa (Stoccolma): eu-north-1

  • Europa (Spagna): eu-south-2

  • Europa (Irlanda): eu-west-1

  • Europa (Londra): eu-west-2

  • Europa (Parigi): eu-west-3

  • Europa (Francoforte): eu-central-1

  • Medio Oriente (Bahrein): me-south-1

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

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

  • Africa (Città del Capo): af-south-1

  • Asia Pacifico (Hong Kong): ap-east-1

  • Asia Pacifico (Tokyo): ap-northeast-1

  • Asia Pacifico (Seoul): ap-northeast-2

  • Asia Pacifico (Osaka): ap-northeast-3

  • Asia Pacifico (Singapore): ap-southeast-1

  • Asia Pacifico (Sydney): ap-southeast-2

  • Asia Pacifico (Giacarta): ap-southeast-3

  • Asia Pacifico (Mumbai): ap-south-1

  • Cina (Pechino): cn-north-1

  • Cina (Ningxia): cn-northwest-1

  • AWS GovCloud (Stati Uniti occidentali): us-gov-west-1

  • AWS GovCloud (Stati Uniti orientali): us-gov-east-1

Per connettersi a Neptune utilizzando uno RDF4J o Apache Jena con firma Signature Version 4

1. Clona il repository di esempio da. GitHub

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

2. Passa alla directory clonata.

   cd amazon-neptune-sparql-java-sigv4

3. Scarica la versione più recente del progetto controllando il ramo con il tag più recente.

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

4. Inserisci uno dei seguenti comandi per compilare ed eseguire il codice di esempio.

   Replace (Sostituisci) your-neptune-endpoint con il nome host o l'indirizzo IP dell'istanza DB di Neptune. La porta predefinita è 8182.

   Nota

   Per informazioni su come trovare il nome host dell'istanza database Neptune, consulta la sezione Connessione agli endpoint Amazon Neptune.

   Eclipse RDF4J

   Inserisci quanto segue per eseguire l'RDF4Jesempio.

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

   Apache Jena

   Immetti quanto segue per eseguire l'esempio di Apache Jena.

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

5. Per visualizzare il codice sorgente dell'esempio, consulta gli esempi disponibili nella directory src/main/java/com/amazonaws/neptune/client/.

Per utilizzare il driver di firma SigV4 nella tua applicazione Java, aggiungi il pacchetto Maven amazon-neptune-sigv4-signer alla sezione <dependencies> di pom.xml. Ti consigliamo di usare gli esempi come punto di partenza.