Mit Java eine Verbindung zu Neptune herstellen und SPARQL mit Signature Version 4 signieren (RDF4Jund Jena)

In diesem Abschnitt wird gezeigt, wie Sie mithilfe von Apache Jena mit Signature Version 4-Authentifizierung eine Verbindung zu Neptune herstellen. RDF4J

Voraussetzungen

• Java 8 oder höher.

• Apache Maven 3.3 oder höher.

  Informationen zur Installation dieser Voraussetzungen auf einer EC2 Instance, auf der Amazon Linux ausgeführt wird, finden Sie unterVoraussetzungen für Amazon Linux EC2.

• IAM-Anmeldeinformationen zum Signieren der Anfragen. Weitere Informationen finden Sie unter Using the Default Credential Provider Chain in AWS SDK for Java Leitfaden für Entwickler.

  Anmerkung

  Wenn Sie temporäre Anmeldeinformationen verwenden, laufen diese nach einem angegebenen Intervall ab, , einschließlich des Sitzungs-Tokens.

  Sie müssen Ihren Sitzungs-Token aktualisieren, wenn Sie neue Anmeldeinformationen anfragen. Weitere Informationen finden Sie unter Verwenden temporärer Sicherheitsanmeldedaten zur Anforderung von Zugriff auf AWS Ressourcen im IAMBenutzerhandbuch.

• Wählen Sie für die Variable SERVICE_REGION eine der folgenden Einstellungen aus, um die Region Ihrer Neptune-DB-Instance anzugeben:

  • USA Ost (Nord-Virginia):   us-east-1

  • USA Ost (Ohio):   us-east-2

  • USA West (Nordkalifornien):   us-west-1

  • USA West (Oregon):   us-west-2

  • Kanada (Zentral):   ca-central-1

  • Südamerika (São Paulo):   sa-east-1

  • Europa (Stockholm):   eu-north-1

  • Europa (Spanien): eu-south-2

  • Europa (Irland):   eu-west-1

  • Europa (London):   eu-west-2

  • Europa (Paris):   eu-west-3

  • Europa (Frankfurt):   eu-central-1

  • Naher Osten (Bahrain):   me-south-1

  • Naher Osten (UAE): me-central-1

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

  • Afrika (Kapstadt):   af-south-1

  • Asien-Pazifik (Hongkong):   ap-east-1

  • Asien-Pazifik (Tokio):   ap-northeast-1

  • Asien-Pazifik (Seoul):   ap-northeast-2

  • Asien-Pazifik (Osaka): ap-northeast-3

  • Asien-Pazifik (Singapur):   ap-southeast-1

  • Asien-Pazifik (Sydney):   ap-southeast-2

  • Asien-Pazifik (Jakarta): ap-southeast-3

  • Asien-Pazifik (Mumbai):   ap-south-1

  • China (Peking):   cn-north-1

  • China (Ningxia):   cn-northwest-1

  • AWS GovCloud (US-West): us-gov-west-1

  • AWS GovCloud (US-Ost): us-gov-east-1

Um eine Verbindung zu Neptune herzustellen, indem Sie entweder RDF4J oder Apache Jena mit Signature Version 4-Signatur verwenden

1. Klonen Sie das Beispiel-Repository von. GitHub

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

2. Wechseln Sie in das geklonte Verzeichnis.

   cd amazon-neptune-sparql-java-sigv4

3. Überprüfen Sie den Branch mit dem neuesten Tag auf die neueste Version des Projekts.

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

4. Geben Sie einen der folgenden Befehle ein, um den Beispielcode zu kompilieren und auszuführen.

   Ersetzen your-neptune-endpoint mit dem Hostnamen oder der IP-Adresse Ihrer Neptune-DB-Instance. Der Standard-Port ist 8182.

   Anmerkung

   Informationen zum Ermitteln des Hostnamens Ihrer Neptune-DB-Instance finden Sie im Abschnitt Verbinden mit Amazo-Neptune-Endpunkten.

   Eclipse RDF4J

   Geben Sie Folgendes ein, um das RDF4J Beispiel auszuführen.

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

   Apache Jena

   Geben Sie Folgendes ein, um das Apache Jena-Beispiel auszuführen.

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

5. Informationen zum Anzeigen des Quellcodes für dieses Beispiel finden Sie in den Beispielen im src/main/java/com/amazonaws/neptune/client/-Verzeichnis.

Fügen Sie dem Abschnitt <dependencies> Ihrer pom.xml das amazon-neptune-sigv4-signer Maven-Paket hinzu, um den SigV4-Signaturtreiber in Ihrer eigenen Java-Anwendung zu verwenden. Es wird empfohlen, die Beispiele als Ausgangspunkt zu verwenden.