You are here:
Fix Missing FLS Permissions for Backup
Ensure your Salesforce Backup service can access all necessary data by fixing missing field-level security (FLS) permissions. Identify inaccessible data for your backup service's authenticated user and then update the user's permission set with the missing field permissions.
Admins can use the permissions report to update the authenticated user's permission set with missing field permissions using Lightning Platform IDE or similar tools. By downloading the Salesforce-compatible Package, you can easily update a permission set for the authenticated user. Follow the steps below on how to deploy the Package as a permission set in Workbench to correct permission exceptions. Workbench is free to use, but is not an official Salesforce product.
Security assignments, permission sets, and profile management are the sole responsibility of the admin user.
-
View the permission report in the application to see the field list and download the data
as a Salesforce-compatible package.
If the package download has failed, click on Analyze Permissions. This will run a Permission Report job. Once the job is complete, try to download the package again.
- The downloaded package may include fields that are marked as excluded. You can remove these fields from the package by opening the package and removing them manually from the permission set file.
- Read and Write permission will be assigned to all fields (for Backup and Restore).
-
Optional. Edit the Default Permission Sets when merging to an existing permission set is
not required. If you want to continue with the default permissions, continue to Step 4.
We use IntegrationUserMissingFields as the default name for the permission set. If you prefer a different name for the permission set, follow the instructions below.
- Download the SFDC Compatible Package from the permission report for the affected backup.
- Use a text editor to open the package.xml file within the downloads package.
- Replace the name: IntegrationUserMissingFields with the name you prefer for the permission set.
- In the permissionsets folder, rename the file IntegrationUserMissingFields.permissionset to the name that you prefer.
- Open the .permissionset file and replace the name IntegrationUserMissingFields with the permission set name that you prefer, within the 2 tags <label> ... </label>.
-
Optional. Edit the Default Permission Sets when merging to an existing permission set is
required. If you want to continue with the default permissions, continue to Step 4.
- Complete Step 2.
- Select the Metadata backup for the specific service you wish to update.
- Access the most recent backup, then download the XML for permission sets by selecting the highlighted number next to permission sets.
- Open the downloaded zip file, and navigate to the permission sets folder.
- Open the .permissionset with the name you set in Step 2.
- Copy all <fieldPermissions> … </fieldPermissions> tags.
- Paste it to the .permissionset file from Step 2 at the end of the file, before <hasActivationRequired>false</hasActivationRequired><label>IntegrationUserMissingFields</label>
- Compress the updated package.
-
Deploy with WorkBench.
- Login to your target organization.
- Click Migration Menu.
- Select Deploy.
-
Choose the package zip file and select the following options:
- Allow Missing Files
- Single Package
-
Click Next and then Deploy.
- When deploying to production, Rollback On Error must be selected. And the test level should be Run Specified test.
- In order for the permission set to deploy to production, a test class that will run successfully must be used.
- Further reading about adding a test class in Salesforce, see here.
- The test class specified to run when deploying to production must run successfully. It is advised to select a class with a small size and to avoid test classes from managed packages.
A success message will appear under the 'Results' when the package has been successfully deployed. -
Assign the Permission Set to the Authenticated User. In Salesforce, assign the permission
set to the authenticated user.
- Log in to Salesforce.
- Select Setup > Permission Set.
- Click the permission IntegrationUserMissingFields, then click Manage Assignments.
- Add the authenticated user to this permission set.
- After assigning the permission, validate the permissions worked by re-running the analyze permission job via Backup Services → Options → Analyze Profile Permissions.

