Usando Oracle Wallet

Para usar o Java e o Driver JDBC Thin 18.3 para se conectar ao Autonomous Database com a Oracle Wallet:

1. Certifique-se de que os pré-requisitos sejam atendidos: Consulte Requisitos de Conexão do Driver JDBC Thin com Wallets (mTLS) para obter mais informações.

2. Verifique a conexão: Você pode usar um programa Java, um servlet ou IDEs para verificar a conexão com o banco de dados. Um teste simples é fazer download de DataSourceSample.java ou UCPSample.java usando amostras de código JDBC e atualizar o URL de conexão para ter o alias de TNS necessário e informar TNS_ADMIN, fornecendo o caminho de tnsnames.ora e os arquivos de wallet. Além disso, no código-fonte de amostra, atualize o nome de usuário e a senha do banco de dados. Por exemplo:

   DB_URL="jdbc:oracle:thin:@dbname_high?TNS_ADMIN=/Users/test/wallet_dbname"

   Observação
   
   Se você estiver usando o Microsoft Active Directory com um banco de dados, no código-fonte de amostra, atualize o nome do usuário com o nome do usuário do Active Directory e atualize a senha com a senha do usuário do Active Directory. Consulte Usar o Microsoft Active Directory com o Autonomous Database para obter mais informações.

3. Defina o local da wallet: O arquivo de propriedades ojdbc.properties é pré-carregado com a propriedade de conexão relacionada à wallet.

   oracle.net.wallet_location=(SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=${TNS_ADMIN})))

   Observação
   
   Você não modifica o arquivo ojdbc.properties. O valor de TNS_ADMIN determina o local da wallet.

4. Compile e Execute: Para obter uma conexão bem-sucedida, compile e execute a amostra. Certifique-se de ter oraclepki.jar , osdt_core.jar e osdt_cert.jar, em classpath. Por exemplo:

   java –classpath
         ./lib/ojdbc8.jar:./lib/ucp.jar:./lib/oraclepki.jar:./lib/osdt_core.jar:./lib/osdt_cert.jar:. UCPSample

Usando o Java KeyStore

Para usar o Java e o Driver JDBC Thin 18.3 para se conectar ao Autonomous Database com o Java KeyStore (JKS), faça o seguinte:

1. Certifique-se de que os pré-requisitos sejam atendidos: Consulte Requisitos de Conexão do Driver JDBC Thin com Wallets (mTLS) para obter mais informações.

2. Pronto para os detalhes do banco de dados: Você pode usar um programa Java, um servlet ou IDEs para verificar a conexão com o banco de dados. Um teste simples é fazer download de DataSourceSample.java ou UCPSample.java em amostras de código JDBC. Nessa amostra, use o URL de conexão, conforme mostrado. Observe que a conexão DB_URL contém o alias de TNS, por exemplo, dbname_high, presente no arquivo tnsnames.ora. Você pode fornecer o caminho do arquivo tnsnames.ora por meio da propriedade TNS_ADMIN, conforme mostrado no URL. Certifique-se de utilizar o nome de usuário e a senha relacionados ao seu banco de dados.

   DB_URL="jdbc:oracle:thin:@dbname_high?TNS_ADMIN=/Users/test/wallet_dbname"

   Observação
   
   Se você estiver usando o Microsoft Active Directory com o Autonomous Database, certifique-se de alterar o código-fonte de amostra para usar o nome do usuário do Active Directory e a senha do usuário do Active Directory. Consulte Usar o Microsoft Active Directory com o Autonomous Database para obter mais informações.

3. Defina ao arquivo ojdbc.properties as propriedades de conexão relacionadas ao JKS. As senhas keyStore e do armazenamento confiável são aquelas especificadas quando você faz download do arquivo .zip das credenciais do cliente.

   Para usar a conectividade SSL em vez da Oracle Wallet, especifique os arquivos de armazenamento de chaves e armazenamento confiável e a senha respectiva no arquivo ojdbc.properties da seguinte forma:

   
   # Properties for using Java KeyStore (JKS)
   oracle.net.ssl_server_dn_match=true
   javax.net.ssl.trustStore==${TNS_ADMIN}/truststore.jks
   javax.net.ssl.trustStorePassword=password
   javax.net.ssl.keyStore==${TNS_ADMIN}/keystore.jks
   javax.net.ssl.keyStorePassword=password

   Observação
   
   Comente a propriedade relacionada à wallet no arquivo ojdbc.properties. Por exemplo:

   
   # Property for using Oracle Wallets
   # oracle.net.wallet_location=(SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=${TNS_ADMIN})))

4. Compile e Execute: Para obter uma conexão bem-sucedida, compile e execute a amostra. Por exemplo:

   java –classpath ./lib/ojdbc8.jar:./lib/ucp.jar UCPSample

Se você não puder usar os drivers JDBC mais recentes, poderá estabelecer conexão com o Autonomous Database usando 12.2.0.2 ou outros drivers JDBC mais antigos. Os drivers JDBC 12.2 ou mais antigos não suportam o arquivo ojdbc.properties. Com versões mais antigas do driver JDBC, você precisa transmitir wallets ou propriedades relacionadas ao JKS como propriedades do sistema ou como propriedades de conexão para estabelecer uma conexão.

Usando Oracle Wallet

Para usar o Java e os Drivers JDBC 12.2 ou mais antigos para se conectar ao Autonomous Database com a Oracle Wallet, faça o seguinte:

1. Certifique-se de que os pré-requisitos sejam atendidos: Consulte Requisitos de Conexão do Driver JDBC Thin com Wallets (mTLS) para obter mais informações.

2. Verifique a conexão: Você pode usar um programa Java, um servlet ou IDEs para verificar a conexão com o banco de dados. Um teste simples é fazer download de DataSourceSample.java ou UCPSample.java usando amostras de código JDBC e atualizar o URL de conexão para ter o alias de TNS necessário. Além disso, atualize o código-fonte de amostra para usar o nome de usuário e a senha do banco de dados. Por exemplo:

   DB_URL="jdbc:oracle:thin:@dbname_high”

   Observação
   
   Se você estiver usando o Microsoft Active Directory com o Autonomous Database, atualize o código de origem de amostra para usar o nome de usuário do Active Directory e a senha de usuário do Active Directory. Consulte Usar o Microsoft Active Directory com o Autonomous Database para obter mais informações.

3. Defina o local da wallet: Adicione OraclePKIProvider ao final da lista de provedores no arquivo java.security (esse arquivo faz parte da instalação do JRE localizada em $JRE_HOME/jre/lib/security/java.security), que normalmente é semelhante a:

   security.provider.14=oracle.security.pki.OraclePKIProvider

4. Compile e Execute: Para obter uma conexão bem-sucedida, compile e execute a amostra. Certifique-se de ter oraclepki.jar , osdt_core.jar e osdt_cert.jar, em classpath. Além disso, você precisa especificar as propriedades de conexão. Atualize as propriedades com o local onde estão tnsnames.ora e os arquivos da wallet.

   java –classpath 
   ./lib/ojdbc8.jar:./lib/ucp.jar:./lib/oraclepki.jar:./lib/osdt_core.jar:./lib/osdt_cert.jar:.
   -Doracle.net.tns_admin=/users/test/wallet_dbname  
   -Doracle.net.ssl_server_dn_match=true  
   -Doracle.net.ssl_version=1.2  (Not required for 12.2)
   -Doracle.net.wallet_location= “(SOURCE=(METHOD=FILE)(METHOD_DATA=(DIRECTORY=/users/test/wallet_dbname)))” 
   UCPSample

Usando o Java KeyStore

Para usar o Java e os Drivers JDBC Thin 12.2 ou mais recentes para se conectar ao Autonomous Database com o Java KeyStore (JKS), faça o seguinte:

1. Certifique-se de que os pré-requisitos sejam atendidos: Consulte Requisitos de Conexão do Driver JDBC Thin com Wallets (mTLS) para obter mais informações.

2. Verifique a conexão: Você pode usar um programa Java, um servlet ou IDEs para verificar a conexão com o banco de dados. Um teste simples é fazer download de DataSourceSample.java ou UCPSample.java por meio de amostras de código JDBC e atualizar o URL de conexão para que tenha o alias de TNS necessário e informar TNS_ADMIN, fornecendo o caminho de tnsnames.ora e atualizar o URL de conexão para que tenha o alias de TNS necessário. Além disso, no código-fonte de amostra, atualize o nome de usuário e a senha do banco de dados. Por exemplo:

   DB_URL="jdbc:oracle:thin:@dbname_high”

   Observação
   
   Se você estiver usando o Microsoft Active Directory com o Autonomous Database, atualize o código de origem de amostra para usar o nome de usuário do Active Directory e a senha de usuário do Active Directory. Consulte Usar o Microsoft Active Directory com o Autonomous Database para obter mais informações.

3. Compile e Execute: Para obter uma conexão bem-sucedida, compile e execute a amostra. Informe as propriedades de conexão, conforme mostrado. Atualize as propriedades com o local onde estão os arquivos tnsnames.ora e JKS. Se você quiser especificar essas propriedades de conexão de forma programática, consulte DataSourceForJKS.java. Por exemplo:

   java 
   -Doracle.net.tns_admin=/users/test/wallet_dbname
   -Djavax.net.ssl.trustStore=truststore.jks
   -Djavax.net.ssl.trustStorePassword=**********
   -Djavax.net.ssl.keyStore=keystore.jks    
   -Djavax.net.ssl.keyStorePassword=************   
   -Doracle.net.ssl_server_dn_match=true    
   -Doracle.net.ssl_version=1.2 // Not required for 12.2