Salesforce Org

You must register the organization to use any Salesforce Org functionality inside ARM. When you register your Salesforce organization in ARM, ARM connects to your organization with the required permissions.

By default, ARM connects to orgs using the secure OAuth method (our recommended approach). You can also connect to orgs using username/password connections if you need to.

Adding a Salesforce Org connection via OAuth

1. Log in to your ARM account. 
2. Go to the Admin > SF Org Mgmt. page.
   
3. From the SF Org Mgmt. screen, click on the Add button.
   
4. Enter the Salesforce Org Name.
5. Select the Salesforce Org Type from the drop-down (Developer, Integration, QA, UAT, Production).
6. Select the Environment from the drop-down (Production or Development Edition, Sandbox, Pre-Release, Custom URL).
7. Salesforce Org URL is predefined based on the Environment selected.
8. Select Access type as OAuth as the authentication method.
9. Click Validate & Save to proceed through the OAuth flow and allow ARM to connect to your Salesforce Org.
   
10. Click Allow when prompted to grant ARM access to the Salesforce Org.
11. The org will now be added to your list of saved connections. It will appear in the list of available orgs via the dropdown for future comparisons and automation jobs.

Connecting to a Salesforce Org using username/password

1. Go to the Admin > SF Org Mgmt. page.
2. From the SF Org Mgmt. screen, click on the Add button.
   
3. Enter the Salesforce Org Name.
4. Select the Salesforce Org Type from the drop-down (Developer, Integration, QA, UAT, Production).
5. Select the Environment from the drop-down (Production or Development Edition, Sandbox, Pre-Release, Custom URL).
6. Select Access Type as Standard as the authentication method.
7. Enter the User Name and Password.
8. Enter the Security Token (For more information on Salesforce security tokens, click here).
9. Click Validate & Save to proceed through the OAuth flow and allow ARM to connect to your Salesforce Org.
   

What is Salesforce Security Token, and How Do I Find It?

Your Salesforce security token is a case-sensitive alphanumeric key used with a password to access Salesforce via API. The token aims to improve the security between Salesforce users and Salesforce.com in the case of a compromised account. It ensures, among other things, that if a user’s account credentials are compromised, a third party cannot access Salesforce.

Losing the security token

If you can’t remember your security token and have deleted the email containing the token, the only way to retrieve it is by resetting the token. Salesforce does not provide an option to view your token within the web application; the only option is resetting it.

Getting the Security Token for Your Salesforce Account

When you create a Salesforce account, Salesforce sends an email message from support@salesforce.com with the subject: salesforce.com security token confirmation to the email address associated with the account. This email message contains the Security Token for the account and is the only place where you can find the Security Token value. When you change the account password, the security token is regenerated (the previous one expires), and a similar email is sent.

To get the security token for your Salesforce account, In the mailbox for the email address associated with the Salesforce account, look for the latest email message received from support@salesforce.com with the subject: salesforce.com security token confirmation. 

If you cannot find the latest email with the security token, reset the security token: 

1. Log in to Salesforce using the Salesforce account.
2. In the User Menu, select Setup.
3. In the menu on the left, under Personal Setup, expand My Personal Information, then click Reset My Security Token. Follow the instructions on the screen.
4. A new email message will be sent.
5. Open the message and then copy the Security Token value.

Edit Salesforce Org details after registration

You can change the Environment type, the Access Type, or both.

1. From the screen, choose the desired environment and access types from the respective dropdown fields.
2. To edit the User Name, ensure that the Access type is set as Standard.
3. Click Save Details or Test Connection, and you will see one of the following confirmation messages:
   • If you change the Environment type:
     
   • If you change the Access Type:
     
   • If you change the Environment type and also the Access Type:
     
4. Click Yes to complete the request. Click No to close the confirmation message without changing the details.