Adapter for Salesforce 8.2 | webMethods Adapter for Salesforce Documentation | webMethods Adapter for Salesforce Installation and User’s Documentation | Overview of webMethods Adapter for Salesforce | Adapter Connections | Types of Adapter for Salesforce Connections
 
Types of Adapter for Salesforce Connections
The adapter supports two types of connections:
*Salesforce.com connection, which connects in a standard way to Saleforce.com or Database.com.
*Salesforce.com OAuth connection, which uses the OAuth 2.0 authorization framework to connect to Salesforce.com or Database.com.
The OAuth framework allows secure authentication for accessing a user’s data, without handing out the user’s credentials (username and password).
When the adapter makes a login request, Salesforce.com sends two parameters as a response for making all subsequent calls. The parameters depend on the type of adapter connection that you use.
The following table shows the parameters that Salesforce.com sends for each connection type and how the adapter connection interacts with the backend.
Type of connection
Parameters that Salesforce.com sends at a login request from adapter
Adapter connection interaction with Salesforce.com
Salesforce.com
*sessionId
*serverURL
The adapter connection maintains the sessionId and serverURL, which are required for making any other Web service calls to Salesforce.com. The sessionId is essential for Salesforce.com to ensure that the call is from an authenticated user.
Salesforce.com enforces a session timeout limit that invalidates the sessionId when a configured limit is reached. In order to keep the Salesforce.com connection valid, the adapter monitors the value of the Session Timeout parameter and logs in again before the session times out. Maintaining the adapter connection ensures that the adapter service does not fail because of an INVALID_SESSION_ID error.
Salesforce.com OAuth
*Id
*accessToken
The accessToken is used for making all subsequent calls. The adapter connection maintains the accessToken, which is required for making any other Web service calls to Salesforce.com. The accessToken is essential for Salesforce.com to ensure that the call is from an authenticated user.
Salesforce.com enforces a session timeout limit that invalidates the accessToken when a configured limit is reached. In order to keep the Salesforce.com OAuth connection valid, the adapter monitors the value of the Session Timeout parameter and logs in again before the session times out. Maintaining the adapter connection ensures that the adapter service does not fail because of an INVALID_ACCESS_TOKEN error.
For instructions on configuring, viewing, editing, enabling, and disabling Adapter for Salesforce connections, see Adapter Connections. For information about setting user privileges, see the webMethods Integration Server Administrator’s Guide for your release. For a list of tasks that you must do before you can create your connections, see Before Configuring or Managing Adapter Connections.