How to Install the Flosum Connected App for Salesforce

Install the Flosum Connected App to pervent OAuth Errors.

circle-check

Required User Credentials

Overview

Salesforce recently announcedarrow-up-right new security policy changes that affect Connected Apps. To stay compliant and ensure seamless integration, all current Flosum customers should install the Flosum Connected App in their Salesforce orgs.

This installation is quick and ensures you won’t be caught off guard by Salesforce’s security changes. By completing this step, you’ll keep your Flosum Cloud Apps integrations running smoothly and avoid unexpected errors when connecting orgs to Flosum.

circle-info

Why Do You Need to Install the Connected App?

Existing connections are unlikely to be affected immediately. However, any new connections, including those from new users, sandboxes, or Salesforce orgs, will require the Connected App to be installed.

Because the Connected App cannot be installed or deployed through the Metadata API, this process must be done manually. Skipping this step might lead to OAuth Errors like:

Connected app OAuth App blocked.

Installing Flosum Connected App

For any Salesforce org that you use with Flosum, a System Administrator must complete these steps:

1

Check If Flosum Apps Are Installed

  1. Log in to your Salesforce org.

  2. Go to Setup.

  3. In the Quick Find box, enter and then select Connected Apps OAuth Usage.

  4. Find the Flosum Connected Applications in the list:

    1. Flosum Backup Org Auth

    2. Flosum DevOps: Web App Production

  5. If the Uninstall button is in the Actions column, the app is already installed, and no action is needed.

  6. If the Install button is in the Actions column, the app hasn't been installed. You need to complete the rest of the steps in this article.

2

Install the App

  1. Click Install.

  2. Click Install.

3

Edit Connected App

  1. Once installed, edit the connected app’s settings.

  2. Set the Permitted Users policy to: “Admin approved users are pre-authorized.

  3. Click Save.

  4. Modify the Profile or Permission Set to grant access to those with the appropriate level.

4

Refresh Token

circle-info

For more detailed instructions on updating a token, see the following article.

  1. Log in to Flosum Global Settings.

  2. Click Organizations from the left sidebar menu.

  3. Click the Three Dot menu for the Salesforce organization you are installing the connected app.

  4. Click Update Token.

  5. Log in to Salesforce to complete the authentication.

5

Confirm App Installed

  1. After installing the app, confirm that it is listed in the following places in Salesforce:

    1. Manage Connected Apps

    2. Connected Apps OAuth Usage

circle-info

To re-authenticate, click Unblock, then update the org's token in Global Settings → Organizations. Note: Once unblocked, the connected app will no longer be visible in the managed connected apps list.


Troubleshooting

If you’re having issues logging into Flosum or connecting to an organization, double-check the policy settings:

  1. Go to Setup → Connected Apps OAuth Usage.

  2. Select Manage App Policies for the Flosum Connected App(s).

  3. Check which Permitted Users setting you are using:

    1. All users may self-authorize: Flosum works as before; any user can connect.

    2. Admin-approved users are pre-authorized: Only users explicitly granted access can connect.

If the Admin-approved users are pre-authorized option is chosen, you’ll need to explicitly grant users access. See the section below for instructions on how to do this.

How to Grant Access to Users

If a Connected App's Permitted Users option is set to Admin approved users are pre-authorized, users won’t automatically have access to the Connected App. To grant access, add the Profiles and Permission Sets that include the users who need access.

circle-info

Adding Profiles and Permission Sets to a Connected App provides access to all users associated with them. If you need more control over access, create a custom Permission Set for users who need access to the app.

1

Add Profiles

  1. Access the Connected App.

  2. Find the Profiles section.

  3. Click Manage Profiles.

  4. Check all the profiles to grant access to.

  5. Click Save.

  6. All added profiles will be listed.

2

Add Permission Sets

circle-info

Alternet Method

A Connected App can be assigned to a Permission Set when the Permission Set is created or edited.

  1. Access the Connected App.

  2. Find the Permission Sets section.

  3. Click Manage Permission Sets.

  4. Check all the permission sets to grant access to.

  5. Click Save.

  6. All added permission sets will be listed.

Last updated

Was this helpful?