Purpose

Specifies the name and location of the secure connect bundle that contains security certificates and credentials for your database. Provide a value for this property only if you are connecting to a database that uses a secure connect bundle.

Valid Values

bundle_path | UseConnInfo

where:

bundle_path
is the path and filename of the zip file containing your security . For example, C:\secure-connect-database_name.zip.

Behavior

If set to bundle_path, the driver uses the security certificates and credentials contained in the specified secure connect bundle .zip file to connect.

If set to UseConnInfo, the driver uses credential information stored in the connection string or data source, instead of a .zip file, to connect to databases that employ a secure connect bundle. The following properties are obtained from the connection string in lieu of the .zip file:
  • KeyStore
  • KeyStorePassword
  • KeySpaceName
  • PortNumber
  • ServerName
  • TrustStore
  • TrustStorePassword

Notes

  • Escapes are required when specifying a path for this property in a data source. For example, C:\\path\\secure-connect-database_name.zip.
  • When the value of SecureConnectBundle is set to UseConnInfo, the values for the host (ServerName) and port (PortNumber) in the string must be the same as those in the config.json of the .zip file.
  • With the exception of KeySpaceName, the values stored in the secure connect bundle override corresponding values for connection properties specified in the connection string or data source. The value for KeyspaceName in the connection string or data source always takes precedent.

Data Source Method

setSecureConnectBundle

Default

No default value

Data Type

String

See also