Skip to main content

Set Up Users and Install the App

Learning Objectives

After completing this unit, you’ll be able to:

  • Give Salesforce Backup users the permissions they need.
  • Install Salesforce Backup.
  • List best practices and key considerations for using the application.

Assign User Permissions

In this module, we assume you are an administrator with the proper permissions to set up Salesforce Backup. If you’re not an administrator, that’s OK. Read along to learn how your administrator would take the steps in a production org. Don't try to follow these steps in your Trailhead Playground. Salesforce Backup isn't available in the Trailhead Playground. 

Note

You need to purchase Salesforce Backup to be able to assign the Backup and Restore User Permission Set License and utilize the app.

The Salesforce Backup app is a managed package that you can install in your Salesforce org and set up in as little as 10 minutes! 

The first step is assigning the necessary licenses and permissions to the users who will manage the app. Each Salesforce Backup user needs:

  • The Backup and Restore User Permission Set License
  • The BackupRestore Permission Set
  • Object permissions

Step 1: Assign the Backup and Restore Permission Set License

The Backup and Restore Permission Set License gives users the permissions they need to use the Backup managed package.

  1. From Setup, in the Quick Find Box, enter Users, and then select Users. Select the user that you want to grant access to Salesforce Backup.
  2. From Permission Set License Assignments, click Edit Assignments, and select Backup and Restore User Permission Set License.
  3. Save your work.

Step 2: Assign Backup and Restore Permissions

Next, assign users permission to access the Salesforce Backup application.

  1. From Setup, in the Quick Find Box, enter Users, and then select Users. Select the users that you want to grant access to Salesforce Backup.
  2. From Permission Set Assignments, click Edit Assignments.
  3. Under Available Permission Sets, select BackupRestore Permission Set, click Add.
  4. Save your work.

Step 3: Assign Object Permissions to Users

Users who manage backup policy or initiate restore jobs also need object permissions to ensure that they have the correct access to data. (We dive deeper into how Backup respects object rules next.)   

  1. From Setup, in the Quick Find Box, enter Permission Sets, and then select Permission Sets.
  2. Click BackupRestore.
  3. Click Object Settings.
  4. Click an object name, and then click Edit.
  5. Under the Object Permissions section, enable the permissions the user requires to back up and restore object data (see the table below).
  6. Save your work.
  7. Repeat step 5 for all objects that the user manages in the Backup app.

Use this table as a reference when assigning object-level permissions and access. Assign these permissions before you create policies or assign backup and restore tasks to team members to ensure that they have proper access.

ACTION

OBJECT PERMISSION

Backup

Read

Restore

Read, create, and edit

Restore only existing records

Edit

Restore only deleted records

Create

Give Authorized Users Access to Objects

Calvin had to identify the objects he wanted to include in his backup policy, and then make sure that he had the necessary object permissions.  

The Salesforce Backup application respects object access rules and only acts on objects that you have access to. Without full object access, backups don’t complete or aren’t available for restoration later. Most backup and restore issues stem from incorrect object access settings.

For objects you wish to include in your backup policy: Make sure that you’ve enabled Oauth for the app to have access to them, and assign read access to all objects you plan to back up.

Also ensure that you meet all special access rules. For example, some objects are only available in specific products or when features within those products are enabled. Review the Special Access Rules section of the Object Reference documentation for the licenses, permissions, and preferences that each object requires. 

  • Custom objects, including custom objects in managed packages, must be available site-wide.
  • Users must have all levels of access before an object can be backed up. See the Special Access section on each object’s entry in the Object Reference guide.
  • To confirm and modify object access, use the Object Manager and Profile pages in Setup along with the User Licenses related list on the Company Information page.

Key Considerations 

Salesforce Backup Doesn’t Support Certain Objects

Here is a list of objects and items that are not currently supported by the Backup app:

  • Objects that aren’t supported by the Bulk API
  • Records stored in Big Objects
  • Standard objects that don’t contain the system fields CreatedDate, LastModifiedDate, and SystemModstamp, plus the LoginDate field
    • If you have all required permissions and access levels enabled for an object, but the object shows a warning icon in the Backup Policy page or the backup log status shows NOT_VISIBLE, the object is likely missing one or more of these required fields
  • History objects aren’t backed up because they can’t be restored.
    • History tables are read-only, so they can’t be updated by the restore job
  • Light Application objects
  • Feed objects

Other key considerations:

  • When a record is updated, the original record ID is maintained. Only the fields that were changed get restored.
  • When a record is deleted, a new record ID is created to restore that record.
  • If a custom object is part of a managed package that’s not site-wide, integration users must have a license for the object.
  • Adding all objects for an initial Day 0 backup will take longer than an incremental backup.

Install and Set Up the Salesforce Backup Managed Package

You've set up your users with everything they need to use Salesforce Backup. Your last step is installing the managed package.

  1. Find the order form that your organization received when you purchased Salesforce Backup. It contains the installation URL.
  2. Click the URL, and then download the Salesforce Backup managed package.
  3. From the Managed Package page, select Install for Admins Only.
  4. If you’re prompted to approve third-party access, select Yes, grant access to these third-party web sites, and then click Continue. Although dev2.sf.k8phoenix.com isn’t a third-party URL, Salesforce uses this domain to support the backup and restore process. You receive an email notification that the package is installed.
  5. In the Salesforce Backup app, click the Settings tab.
  6. In the Provision a Region section, from the dropdown menu, select the AWS region where you want to store your backups. When choosing a region, keep in mind any data residency requirements that apply to your organization.
  7. If you have no IP restrictions, click Start.
Note

If you do have IP restrictions, add the IP address for the Backup and Restore provisioning API (3.219.91.219) to the Login IP Ranges on your profile, and then click Start. When provisioning is finished, an IP Addresses section appears on the page. It lists IP addresses that are specific to the AWS region that you selected. Add the IP addresses in the IP Addresses section to the Login IP Ranges for your user profile.

8. In the Set Up Your Connection section, click Connect. This action creates a secure connection using OAuth 2.0 Web Server Flow between Salesforce and the data storage location in AWS.

9. Click Test Connection.

When the test is successful, you’re ready to create a backup policy.

This is the application's backup tab, which includes a list of available objects. 

pplication backup tab, which includes list of available objects

This is the application's setting tab, which includes settings relating to trusted IP addresses and connection status. 

Application setting tab, which includes settings relating to trusted IP address and connection status

Congratulations! You’ve successfully installed the app and your users are ready to start protecting the organization’s data with Salesforce Backup. 

Resources 

Share your Trailhead feedback over on Salesforce Help.

We'd love to hear about your experience with Trailhead - you can now access the new feedback form anytime from the Salesforce Help site.

Learn More Continue to Share Feedback