The driver supports OAuth 2.0, which is an open protocol for token-based authentication. OAuth 2.0 allows you to authenticate without specifying a user ID or password, eliminating the risk of exposing them to unauthorized access. It uses an access token, accompanied by the values discussed below, to authenticate to a Salesforce instance. Refer to the Salesforce documentation to know how to obtain an access token.
To configure the driver to use OAuth 2.0 authentication, set the following connection options:
Set the Authentication Method option to oauth2.0.
Set at least one of the following options:
Access Token: Set this to specify the access token you have obtained from Salesforce.
Refresh Token: Set this to specify the refresh token you have obtained from Salesforce.
If a value for the Access Token option is not specified, the driver uses the value of the Refresh Token option to make a connection. If both values are not specified, the driver cannot make a successful connection. If both are specified, the driver ignores the Access Token value and uses the Refresh Token value to generate a new Access Token value.
Set the Client ID option to specify the consumer key for your application.
Set the Schema Map option to specify either the name or the absolute path and name of the configuration file where the map of the Salesforce data model is written. Note that a value for the Schema Map option must be specified every time you authenticate to a Salesforce instance using OAuth 2.0.
Optionally, set the Client Secret option to specify the consumer secret for your application.
The following examples show how to connect to a Salesforce instance using OAuth2.0 authentication.
Set the Authentication Method option to oauth2.0.