As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Conectar-se a bancos de dados do Amazon Neptune usando a autenticação do IAM com Java e SPARQL
<a name="iam-auth-connecting-sparql-java"></a>

Esta seção mostra como se conectar ao Neptune usando J RDF4 ou Apache Jena com a autenticação Signature Version 4.

**Pré-requisitos**
+ Java 8 ou posterior.
+ Apache Maven 3.3 ou posterior.

  Para obter informações sobre como instalar esses pré-requisitos em uma instância do EC2 executando o Amazon Linux, consulte [Pré-requisitos para conectar bancos de dados do Amazon Neptune usando a autenticação do IAM](iam-auth-connect-prerq.md).
+ Credenciais do IAM para assinar as solicitações. Para obter mais informações, consulte [Using the Default Credential Provider Chain](https://docs.aws.amazon.com/sdk-for-java/v1/developer-guide/credentials.html#credentials-default) no *Guia do desenvolvedor do AWS SDK para Java *.
**nota**  
Se você estiver usando credenciais temporárias, elas expirarão após um intervalo especificado, *incluindo o token de sessão*.  
Você deve atualizar o seu token de sessão ao solicitar novas credenciais. Para obter mais informações, consulte Como [usar credenciais de segurança temporárias para solicitar acesso a AWS recursos](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_credentials_temp_use-resources.html) no *Guia do usuário do IAM*.
+ Defina a variável `SERVICE_REGION` como um dos seguintes, indicando a região da instância de banco de dados do Neptune:
  + Leste dos EUA (Norte da Virgínia): `us-east-1`
  + Leste dos EUA (Ohio): `us-east-2`
  + Oeste dos EUA (N. da Califórnia): `us-west-1`
  + Oeste dos EUA (Oregon): `us-west-2`
  + Canadá (Central): `ca-central-1`
  + Oeste do Canadá (Calgary): `ca-west-1`
  + América do Sul (São Paulo): `sa-east-1`
  + Europa (Estocolmo): `eu-north-1`
  + Europa (Espanha): `eu-south-2`
  + Europa (Irlanda): `eu-west-1`
  + Europa (Londres): `eu-west-2`
  + Europa (Paris): `eu-west-3`
  + Europa (Frankfurt): `eu-central-1`
  + Oriente Médio (Bahrein): `me-south-1`
  + Oriente Médio (Emirados Árabes Unidos): `me-central-1`
  + Israel (Tel Aviv):   `il-central-1`
  + África (Cidade do Cabo): `af-south-1`
  + Ásia-Pacífico (Hong Kong): `ap-east-1`
  + Ásia-Pacífico (Tóquio): `ap-northeast-1`
  + Ásia-Pacífico (Seul): `ap-northeast-2`
  + Ásia-Pacífico (Osaka): `ap-northeast-3`
  + Ásia-Pacífico (Singapura): `ap-southeast-1`
  + Ásia-Pacífico (Sydney): `ap-southeast-2`
  + Ásia-Pacífico (Jacarta): `ap-southeast-3`
  + Ásia-Pacífico (Melbourne): `ap-southeast-4`
  + Ásia-Pacífico (Malásia): `ap-southeast-5`
  + Ásia-Pacífico (Mumbai): `ap-south-1`
  + Ásia-Pacífico (Hyderabad): `ap-south-2`
  + China (Pequim): `cn-north-1`
  + China (Ningxia): `cn-northwest-1`
  + AWS GovCloud (Oeste dos EUA): `us-gov-west-1`
  + AWS GovCloud (Leste dos EUA): `us-gov-east-1`

**Para se conectar ao Neptune usando J RDF4 ou Apache Jena com assinatura Signature Version 4**

1. Clone o repositório de amostra de. GitHub

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

1. Altere no diretório clonado.

   ```
   cd amazon-neptune-sparql-java-sigv4
   ```

1. Obtenha a versão mais recente do projeto marcando a ramificação com a última tag.

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

1. Digite um dos comandos a seguir para compilar e executar o código de exemplo.

   {{your-neptune-endpoint}}Substitua pelo nome do host ou endereço IP da sua instância de banco de dados Neptune. A porta padrão é 8182.
**nota**  
Para obter informações sobre como localizar o nome do host da instância de banco de dados do Neptune, consulte a seção [Conectar-se a endpoints do Amazon Neptune](feature-overview-endpoints.md).

**Eclipse J RDF4**  
Digite o seguinte para executar o exemplo RDF4 J.

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

**Apache Jena**  
Digite o seguinte para executar o Apache Jena de exemplo.

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

1. Para visualizar o código-fonte do exemplo, consulte os exemplos no diretório `src/main/java/com/amazonaws/neptune/client/`.

Para usar o driver de assinatura SigV4 no seu próprio aplicativo Java, adicione o pacote Maven `amazon-neptune-sigv4-signer` à seção `<dependencies>` do `pom.xml`. Recomendamos que você use os exemplos como um ponto de partida.