Step 3: Configure app in Salesforce - Step 3: Configure app in Salesforce - Alfresco - Alfresco Content Connector for Salesforce - Alfresco/Alfresco-Content-Connector-for-Salesforce/2.2/Alfresco-Content-Connector-for-Salesforce/Alfresco-Content-Connector-for-Salesforce/Install-Salesforce-Connector/Install-Salesforce-Connector-Lightning-Experience/Step-3-Configure-app-in-Salesforce - 2.2

After you've installed the app, create a new connected app definition using the Salesforce Setup menu.

Make sure that you've downloaded the Alfresco Content Connector app, as described in Step 2: Install the app in Salesforce. In this task, you'll use the Setup menu in Salesforce to customize the install. You need administrator rights to make these changes.

1. In your Salesforce account, find Setup. This is accessible by clicking the gear icon, , from the top-right toolbar on the Salesforce page.

   See Explore the Salesforce Setup Menu for more guidance on where to find this.

   Search for Apps in the Quick Find search bar, and click App Manager to see your installed apps.

2. Click New Connected App to create a new connected app.

   

   This new app extends the standard connector to work for your organization. Use the following settings:

   1. Connected App Name: Name your app something memorable and unique; for example, Alfresco On-Premise

   2. API Name: Choose a meaningful name. This is the name used by the API and managed packages. The name must be less than or equal to 40 characters.

      Note

      A suggested name is Alfresco_for_Salesforce. You'll need to remember the API Name when you configure the Alfresco Setup tab.

      Note

      If this is not set up correctly, you'll see an error message. See Troubleshooting for guidance.

   3. Contact Email: Enter an administrator email address.

   4. Check Enable OAuth Settings.
   5. Callback URL: this field is not used, but does need to be completed. You can set this to https://www.alfresco.com/dummy_callback.

   6. In Selected OAuth Scopes add the following scopes:

      • Full access (full)
      • Perform requests on your behalf at any time (refresh_token, offline_access)

   7. Check Force.com Canvas.

   8. In Canvas App URL, enter a secure (https) URL that points to the Alfresco Share environment, that you have configured with the Alfresco Content Connector. You also need a suffix of share/page/sfdc/canvas/signedrequest. For example:

      https://localhost:8443/share/page/sfdc/canvas/signedrequest
      

   9. Access Method: Select Signed Request (POST)

   10. Add these Locations:

       • Chatter Tab
       • Layouts and Mobile Cards
       • Lightning Component
       • Visualforce Page

       These are locations in Salesforce where the canvas app can be displayed.

   11. In Lifecycle Class, look up the options and select AlfrescoCanvasLifeCycleHandler.

   12. Click Save to save your settings.

   Next, you’ll need to manage the connected app that you've just created.

3. For the new connected app, click Manage to set permissions and accessibility.

4. In the OAuth policies section, enter these values:

   1. Permitted Users: Select Admin approved users are pre-authorized. Click OK to accept the Salesforce message.
   2. IP Relaxation: Select Enforce IP restrictions.
   3. Refresh Token Policy: Select the Refresh token is valid until revoked radio button.
   4. Save your settings.

5. In the Manage Profiles section, click Manage Profiles, check the required profiles, and Save your settings.

   For example, select System Administrator and Standard User. We'll now find the consumer secret ready to paste into Alfresco.