Access your security information through your Salesforce.com
account, and then use this information to configure a security identity
by using the mqsisetdbparms command
in IBM® Integration Bus.
Before you begin
Decide which credentials IBM Integration Bus will
use when accessing Salesforce.com.
About this task
Follow these steps to create a Salesforce Connected App for
use with IBM Integration Bus, and to create
a secure connection between the systems:
Procedure
Follow these steps to create a Connected App:
- Log on to Salesforce.com using your chosen credentials
and navigate to the Apps page.
- Create a new Connected App for use with IBM Integration Bus, and set the following properties:
- Set the Connected App
Name property to IBM
Integration Bus
- Set the API Name to IBM_Integration_Bus
- Specify your chosen contact email address.
- Select the Enable OAuth
Setting check box.
- Set the Callback URL to
any valid secure URL (this URL will not be used by your IBM Integration Bus Connected App).
- Set the Selected OAuth
scopes to Access and
manage your data (api).
- Click Save.
- Click Manage and ensure that the
OAuth policy Permitted Users is set to All
users may self-authorize. If this option is not selected,
connections might fail even if the correct credentials are supplied.
Follow these steps to access the required security information
from your Salesforce system:
- Make a note of your Consumer Key and your Consumer Secret,
which you will need later when you configure security for the connection.
The Consumer Key and Consumer secret are generated by Salesforce
when you create a Connected App.
- Obtain the security token for the chosen Salesforce credentials.
You can get this from the email that was sent to the email address
associated with the credentials when the security token was last reset.
Alternatively, you can reset it now by following these steps:
- From the Setup page, click your name and then click
the My Settings menu option.
- Click Reset My Security Token.
A message is displayed, informing you that the existing
security token will be invalidated.
- Click the Reset Security Token button
to confirm that you want to continue.
The new security
token is sent to your email address.
Follow these steps to configure a secure connection between IBM Integration Bus and your Salesforce system:
- Use the mqsisetdbparms command
to configure a security identity for the connection, by setting the
following parameters:
- -n salesforce::securityIdentity
- The name of the security identity that is used to authenticate
a connection to a Salesforce system, where securityIdentity is
the value of the Security Identity property
in the SalesforceRequest node.
- -u UserId
- The Salesforce user ID
- -p Password
- The password for accessing the Salesforce system, suffixed with
the security token that was sent to you by Salesforce when you reset
your security token (in Step 4)
- -c ClientIdentity
- The name of the consumer key of your Connected App.
- -s ClientSecret
- The consumer secret of your Connected App.
For example:
mqsisetdbparms IBNODE -n salesforce::sf1 -u myUserID -p myPassword -c myClientIdentity -s myClientSecret
For
more information, see mqsisetdbparms command. For information
about the security credentials that have been set on the integration
node, see mqsireportdbparms command.
- In your message flow, specify sf1 as the value in the Security identity property in the SalesforceRequest node.
This security identity will be used when you connect to your
Salesforce system from IBM Integration Bus.