kv_set_property()

#include <kvstore.h>

kv_error_t 
kv_set_property(kv_properties_t* props,
                const char* prop_name,
                const char* prop_value)

Sets a Java property to the kv_properties_t structure. At present, only the Oracle NoSQL Database security properties can be set. The resulting properties structure is assigned to the store configuration structure using kv_config_set_security_properties().

Parameters

props

The props parameter references the properties structure on which you want to set the properties.
props_name

The props_name parameter must be a property name. Supported properties are defined in kvstore.h:
- KV_SEC_SECURITY_FILE_PROPERTY
  
  Identifies a security property configuration file to be read when a KVStoreConfig is created, as a set of overriding property definitions.
- KV_SEC_TRANSPORT_PROPERTY
  
  If set to ssl, enables the use of SSL/TLS communications.
- KV_SEC_SSL_CIPHER_SUITES_PROPERTY
  
  Controls what SSL/TLS cipher suites are acceptable for use. The property value is a comma-separated list of SSL/TLS cipher suite names. Refer to your Java documentation for the list of valid values.
- KV_SEC_SSL_PROTOCOLS_PROPERTY
  
  Controls what SSL/TLS protocols are acceptable for use. The property value is a comma-separated list of SSL/TLS protocol names. Refer to your Java documentation for the list of valid values.
- KV_SEC_SSL_HOSTNAME_VERIFIER_PROPERTY
  
  Specifies a verification step to be performed when connecting to a NoSQL DB server when using SSL/TLS. The only verification step currently supported is the dnmatch verifier.
  
  The dnmatch verifier must be specified in the form dnmatch(distinguished-name), where distinguished-name must be the NoSQL DB server certificate's distinguished name. For a typical secure deployment this should be dnmatch(CN=NoSQL).
- KV_SEC_SSL_TRUSTSTORE_FILE_PROPERTY
  
  Identifies the location of a Java truststore file used to validate the SSL/TLS certificates used by the Oracle NoSQL Database server. This property must be set to an absolute path for the file. If this property is not set, a system property setting of javax.net.ssl.trustStore is used.
- KV_SEC_SSL_TRUSTSTORE_TYPE_PROPERTY
  
  Identifies the type of Java truststore that is referenced by the KV_SEC_SSL_TRUSTSTORE_FILE_PROPERTY property. This is only needed if using a non-default truststore type. The specified type must be supported by your Java implementation.
- KV_SEC_SSL_AUTH_USERNAME_PROPERTY
  
  Specifies the username used for authentication.
- KV_SEC_SSL_AUTH_WALLET_PROPERTY
  
  Identifies an Oracle Wallet directory containing the password of the user to authenticate. This is only used in the Enterprise Edition of the product.
- KV_SEC_SSL_AUTH_PWDFILE_PROPERTY
  
  Identifies a password store file containing the password of the user to authenticate
prop_value

The prop_value parameter must be the property's value.