All pages
Powered by GitBook
1 of 12

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Required permissions

Permissions required for integrating Microsoft 365 with Xopero ONE.

The required Microsoft 365 permissions define the access levels Xopero ONE needs to securely back up and restore your data.


General requirements

To integrate a Microsoft 365 organization with Xopero ONE, ensure it uses a Microsoft 365 business license.

To back up a single Microsoft 365 account, the account must have a Microsoft 365 license assigned. This also applies to shared mailboxes. License assignments can be managed in the Microsoft 365 admin center.

Each Microsoft 365 account and shared mailbox requires one Xopero ONE license to back up its data.

The backup process requires a backup agent (worker), which communicates with the Microsoft 365 API, downloads the requested data, and performs the backup. You can use either a cloud or local worker. Any device with the Xopero ONE Backup&Recovery Agent installed can act as a worker.

You do not need to assign any licenses to cloud workers — the appropriate license is assigned automatically by the Xopero ONE system.


To add your Microsoft 365 organization to Xopero ONE, you must use a global administrator account. Only a global administrator has the necessary permissions to back up data from all user accounts in the organization.


The following tables list Xopero apps and their permissions, which are automatically installed in the end user's Entra ID when integrating Microsoft 365 with Xopero ONE.

This application is used at the beginning of the integration to install and grant the necessary permissions for the Xopero ONE MS365 PRO app.

API name
Claim value
Permission
Type

This application is required to back up and recover data from Microsoft 365 tenants and is installed automatically in Entra ID by Xopero ONE Registrator.

API name
Claim value
Permission
Type
API name
Claim value
Permission
Type
API name
Claim value
Permission
Type

Microsoft Graph

Directory.AccessAsUser.All

Access directory as the signed-in user.

delegated

Microsoft Graph

Mail.ReadWrite

Read and write mail in all mailboxes.

application

Office 365 Exchange Online

full_access_as_app

Use Exchange Web Services (EWS) with full access to all mailboxes.

application

Office 365 Exchange Online

full_access_as_app

Use Exchange Web Services (EWS) with full access to all mailboxes.

application

Account permissions

Learn more about Microsoft 365 administrator roles in .

Application permissions

Xopero ONE Registrator

Microsoft Graph

Xopero ONE MS365 PRO

Microsoft Graph

Exchange Online

Office 365 SharePoint Online

Useful links and items

Microsoft Graph

offline_access

Maintain access to data you have granted access to.

delegated

Microsoft Graph

profile

View user's basic profile.

delegated

Microsoft Graph

openid

Sign users in.

delegated

Microsoft Graph

User.ReadWrite.All

Read and write all users' full profile information.

application

Microsoft Graph

Application.ReadWrite.All

Read and write all applications.

application

Microsoft Graph

Group.Read.All

Read all groups.

application

Microsoft Graph

Contacts.ReadWrite

Read and write contacts in all mailboxes.

application

Microsoft Graph

Group.Create

Create groups.

application

Microsoft Graph

Files.ReadWrite.All

Read and write files in all site collections.

application

Microsoft Graph

Calendars.ReadWrite

Read and write calendars in all mailboxes.

application

Microsoft Graph

Tasks.ReadWrite

Create, read, update, and delete user's tasks and task lists.

delegated

Microsoft Graph

Directory.ReadWrite.All

Read and write directory data.

delegated

Microsoft Graph

Group.ReadWrite.All

Read and write all groups.

delegated

Microsoft Graph

offline_access

Maintain access to data you have granted access to.

delegated

Office 365 Exchange Online

Mail.ReadWrite

Read and write mail in all mailboxes.

application

Office 365 Exchange Online

Calendars.ReadWrite.All

Read and write calendars in all mailboxes.

application

Office 365 Exchange Online

delegated

Office 365 Exchange Online

Mail.ReadWrite

Read and write mail in all mailboxes.

application

Office 365 Exchange Online

Calendars.ReadWrite.All

Read and write calendars in all mailboxes.

application

Office 365 Exchange Online

delegated

the official Microsoft documentation

Creating a backup plan

Learn how to create a Microsoft 365 backup plan in Xopero ONE to configure protection for Microsoft Exchange, OneDrive, and SharePoint.

A reliable backup plan is essential for protecting your Microsoft 365 organization's resources and ensuring business continuity when unexpected events occur.


Backup plan setup (Microsoft Exchange & OneDrive)

The following steps demonstrate how to create a Microsoft Exchange and OneDrive backup plan using Xopero ONE Management Service.

1

Open the Backup tab (Plans > Backup) and click the + Add plan button in the top bar.

2

Select Microsoft 365 from the list.

3

Select the Microsoft 365 Exchange option.

4

Click Select, then specify whether you want to protect the entire organization or only specific user accounts or shared mailboxes.

5

Set up a name for your backup plan.

6

In Data to protect section, select the resources that you want to back up. You can also change the default backup agent (worker), which is directly responsible for backing up your Microsoft 365 data.

7

Select one of the data stores assigned to your Xopero ONE instance to use as the backup storage.

8

Customize the scheduler and specify the retention period for your data.

9

Adjust the advanced settings, such as encryption, error handling, or bandwidth limit, to meet your organization's requirements.

  1. Encryption: lets you secure your backup copy with encryption.

  2. Compression: lets you compress and reduce copy size.

10

Review your configuration and click Save to create the backup plan, or Save&Run to start the first backup run immediately.


The following steps demonstrate how to create a SharePoint backup plan using Xopero ONE Management Service.

1

Open the Backup tab (Plans > Backup) and click the + Add plan button in the top bar.

2

Select Microsoft 365 from the list.

3

Deduplication: allows you to reduce the backup size.
  • Error handling: allows you to specify how to handle potential backup operation errors.

  • Bandwidth limit: allows you to reduce network usage and limit network speed during backup.

  • Backup scripts: enables configuring pre/post scripts executed during backup.

  • Microsoft 365 diagnostics: lets you enable pre-backup diagnostics, such as the mail message download test.

  • Task balancing: balances backup speed and CPU load.

  • Prevent system sleep: prevents your system from suspending while a backup is in progress.

  • Email notifications: lets you set up email notifications and its recipients.

  • S3 Buffer Settings: allows you to specify the buffer size allocated for large resources.

  • Select the SharePoint sites option.
    4

    Click Select, then specify whether you want to protect the entire environment or only specific SharePoint sites.

    5

    Set up a name for your backup plan.

    6

    In Data to protect section, you can change the default backup agent (worker), which is directly responsible for backing up your SharePoint data.

    7

    Select one of the data stores assigned to your Xopero ONE instance to use as the backup storage.

    8

    Customize the scheduler and specify the retention period for your data.

    9

    Adjust the advanced settings, such as encryption, error handling, or bandwidth limit, to meet your organization's requirements.

    1. Encryption: lets you secure your backup copy with encryption.

    2. Compression: lets you compress and reduce copy size.

    3. Deduplication: allows you to reduce the backup size.

    4. Error handling: allows you to specify how to handle potential backup operation errors.

    5. Bandwidth limit: allows you to reduce network usage and limit network speed during backup.

    6. Backup scripts: enables configuring pre/post scripts executed during backup.

    7. Task balancing: balances backup speed and CPU load.

    8. Prevent system sleep: prevents your system from suspending while a backup is in progress.

    9. Email notifications: lets you set up email notifications and its recipients.

    10

    Review your configuration and click Save to create the backup plan, or Save&Run to start the first backup run immediately.

    Xopero ONE supports Microsoft 365 groups — they appear in the users list and can be used to filter it. If the Search by group option is unavailable, re-register your Microsoft 365 organization to enable it.

    You can deploy multiple agents and assign different agents to each backup plan.

    Backup plan setup (SharePoint)

    Integration

    Learn about integrating a Microsoft 365 tenant with Xopero ONE to protect its resources.

    Permissions required for integrating Microsoft 365 with Xopero ONE.

    How to integrate a Microsoft 365 organization with Xopero ONE.

    How to integrate a Microsoft 365 organization with Xopero ONE and include SharePoint protection.

    Required permissions
    Adding Microsoft 365 tenant to Xopero ONE
    Enabling SharePoint protection in Xopero ONE
    Cover
    Cover
    Cover

    Adding Microsoft 365 tenant to Xopero ONE

    How to integrate a Microsoft 365 organization with Xopero ONE.

    Adding a Microsoft 365 tenant to Xopero ONE connects your organization's environment and enables data protection for supported services. The integration requires proper authorization and tenant-level permissions to establish a secure connection between Microsoft 365 and Xopero ONE, allowing you to configure backup settings, manage protection policies, and perform recovery operations.


    Important notice

    The following documentation applies only to Microsoft 365 organizations with Xopero ONE licenses that include backup for Microsoft Exchange data (including individual mailboxes, shared mailboxes, calendars, and contacts) and OneDrive.

    For instructions on enabling protection for SharePoint sites in new and existing Microsoft 365 organizations, refer to the Enabling SharePoint protection in Xopero ONE article.


    Integration process

    The below steps demonstrate how to integrate a Microsoft 365 organization with Xopero ONE using Xopero ONE Management Service.

    1

    Select Microsoft 365 from the left pane.

    2

    Click Connect under Microsoft 365.

    3

    Copy the authentication code, then click Log in to Microsoft 365.

    4

    In the Microsoft authentication tab, paste the copied code and click Next.

    5

    Select your account and sign in if prompted. Next, click Continue to confirm your sign-in to Xopero Registrator.

    6

    If the registration is completed successfully, the following message will appear. Close the tab and return to Xopero ONE Management Service.

    7

    The Microsoft 365 organization has been successfully added to Xopero ONE. Click Custom policy to modify your backup policy settings, or click Run backup to start a backup using the current policy configuration.


    After adding the organization, you may see the following message. Click Repair to configure permissions for shared mailbox protection.

    To start the permission update process, click Continue at the bottom of the configuration pane. If prompted, sign in to your Microsoft 365 account and grant Xopero ONE the required permissions.

    After the required permissions have been granted, you can configure a Microsoft 365 backup plan and start protecting your resources.


    If you already have a Microsoft 365 organization added, click the + Add new button in the top-left corner first.

    Additional permissions for shared mailboxes protection

    Useful links and items

    Licensing overview
    Required permissions
    Enabling SharePoint protection in Xopero ONE

    Restoring Microsoft Exchange and OneDrive data

    Restore emails, calendars, contacts, and selected OneDrive folders and files from a backup.

    Microsoft Exchange and OneDrive data can be restored with granular control over the recovery scope and destination. Emails, calendars, contacts, files, and folders can be restored directly to a Microsoft 365 user account or locally to a device, supporting recovery after accidental deletion, migration, and other data-loss scenarios.


    Recovery process

    The below steps demonstrate how to restore Microsoft Exchange data and OneDrive folders and files using Xopero ONE Management Service.

    1

    Open the Microsoft 365 tab, then click the Explore button next to the organization whose backup you want to restore.

    2

    In the Microsoft 365 Users tab, search for the user whose data you want to restore, and then click the restore button in the action menu for that user.

    3

    Next, select the backup plan from which you want to restore data. Click View available plans, and then select a plan from the list.

    4

    Choose the backup version from all the backups that have already been performed — select the desired date and click the Restore button.

    5

    Select the restore destination and click Next.

    6

    In the next pane, browse the tabs, select the data you want to restore, and click Restore selected. Alternatively, click Restore all to restore all available data.

    7

    Next, depending on the selected restore destination, configure the Restore to and Restore directory settings.

    1. In the Restore directory section, choose one of the following options:

      1. New directory — creates a new directory to restore the data to.

    8

    In Restore settings, you can limit bandwidth usage and select the default backup agent (worker) that will be used to restore the data (where applicable).

    9

    After defining all parameters, click the Restore button to start the recovery process. You can monitor the process in the Tasks tab.

    Original directory — restores the data to its original location. You can also choose to overwrite existing OneDrive files and email messages.

    1. In the Restore to pane, select the user to whom you want to restore the data, and click Save.

    1. In the Restore directory section, choose one of the following options:

      1. New directory — creates a new directory to restore the data to.

      2. Original directory — restores the data to its original location. You can also choose to overwrite existing OneDrive files and email messages.

    1. In the Restore to pane, select the device to use as the restore destination, and click Save.

    2. In the Restore directory section, select the directory where the data will be restored, and then click Apply.

    Restore to the original account

    The option to create a copy of overwritten OneDrive files is currently unavailable.

    Restore to a new account

    The option to create a copy of overwritten OneDrive files is currently unavailable.

    Restore to a device

    Backup

    Learn how to back up your Microsoft 365 resources with Xopero ONE.

    An overview of Microsoft 365 backup plans in Xopero ONE.

    Overview of Microsoft 365 resources protected by backup, including applications such as Microsoft Exchange, OneDrive, and SharePoint.

    Learn how to create a Microsoft 365 backup plan in Xopero ONE to configure protection for Microsoft Exchange, OneDrive, and SharePoint.

    Process overview
    Protected resources
    Creating a backup plan
    Cover
    Cover
    Cover
    About administrator roles in the Microsoft 365 admin center - Microsoft 365 adminMicrosoftLearn
    Logo

    Recovery

    How to restore Microsoft Exchange, OneDrive, and SharePoint data from backup.

    Restore Microsoft Exchange mailboxes, calendars, contacts, and selected OneDrive folders and files from a backup.

    Learn how to restore SharePoint sites from a backup.

    Restoring Microsoft Exchange and OneDrive data
    Restoring SharePoint sites
    Cover
    Cover

    Process overview

    An overview of Microsoft 365 backup plans in Xopero ONE.

    In Xopero ONE, creating a backup plan allows you to define what data should be protected, where backups are stored, and how often they are performed.


    General information

    A Microsoft 365 backup plan in Xopero ONE defines which data is protected, how frequently backups are performed, and how long recovery points are retained. A dedicated Microsoft 365 backup plan enables protection of mailboxes, OneDrive resources, and SharePoint sites while applying automated schedules and granular retention policies that align with organizational data protection and compliance requirements.

    To optimize backup tasks, Xopero ONE Management Service provides several advanced features that enable flexible configuration based on specific infrastructure requirements. When creating a backup plan, you can customize settings such as backup windows, task balancing, storage locations, bandwidth limits, and more.


    Selective backup configuration

    Xopero ONE provides granular control over Microsoft 365 backups. Instead of backing up an entire environment, you can selectively target specific data types—such as messages, calendars, or contacts—to optimize storage capacity and focus exclusively on critical assets.


    Xopero ONE supports Microsoft 365 groups — they appear in the users list (for example, when creating a backup plan) and can be used to filter it.

    Microsoft 365 groups

    If you cannot see the Groups field and the Search by group option is unavailable in Xopero ONE Management Service, re-register your Microsoft 365 organization to enable these options.

    Enabling SharePoint protection in Xopero ONE

    How to integrate a Microsoft 365 organization with Xopero ONE and include SharePoint protection.

    Enabling SharePoint protection in Xopero ONE allows SharePoint sites to be included in the Microsoft 365 backup scope. The setup follows the same tenant-based flow used for other Microsoft 365 resources and requires that the necessary prerequisites and permissions are in place before backup configuration is started.


    Important notice

    The following documentation applies only to Microsoft 365 organizations with Xopero ONE licenses (Microsoft 365 PRO) that include backup for Microsoft Exchange data (including individual mailboxes, shared mailboxes, calendars, and contacts), SharePoint, and OneDrive.

    For instructions on adding Microsoft 365 tenants with only Microsoft Exchange and OneDrive protection to Xopero ONE, see this article.


    Adding new Microsoft 365 organization with SharePoint protection

    The below steps demonstrate how to integrate a Microsoft 365 organization with Xopero ONE using Xopero ONE Management Service.

    1

    Select Microsoft 365 from the left pane.

    2

    Click Connect under Microsoft 365 Pro.

    3


    The following steps demonstrate how to enable SharePoint protection for existing Microsoft 365 organizations using Xopero ONE Management Service.

    1

    Select Microsoft 365 from the left pane.

    2

    Click Edit in the lower-left corner of the organization tile.

    3


    In the Add new organization pane, click Advanced configuration at the bottom of the pane.
    4

    In Advanced configuration, enable the Enable SharePoint protection switch, and specify whether Xopero ONE should automatically assign licenses to users.

    5

    Next, click the Add new or select certificate from (…) tile. In the Add certificate pane, select the certificate option that aligns with your deployment model: automatically generate a certificate, upload a custom certificate, or select an existing certificate from the list. Once done, click Save.

    6

    Set the synchronization interval (if needed), review your settings, and click Save to proceed.

    7

    Back in the Add new organization pane, copy the authentication code, and then click Log in to Microsoft 365.

    8

    In the Microsoft authentication tab, paste the copied code and click Next.

    9

    Select your account and sign in if prompted. Next, click Continue to confirm your sign-in to Xopero Registrator.

    10

    If the registration is completed successfully, the following message will appear. Close the tab and return to Xopero ONE Management Service.

    11

    The Microsoft 365 organization has been successfully added to Xopero ONE. Click Custom policy to modify your backup policy settings, or click Run backup to start a backup using the current policy configuration.

    In
    Settings
    section, turn on the
    Enable SharePoint protection
    switch, and then click the
    Add new or select certificate from (…)
    tile.
    4

    In the Add certificate pane, select the certificate option that aligns with your deployment model: automatically generate a certificate, upload a custom certificate, or select an existing certificate from the list. Once done, click Save.

    5

    The system will automatically prompt you to create or run a default backup plan. You can skip this step and configure the SharePoint backup plan later.

    6

    Back in the Microsoft 365 organization dashboard, click Repair to configure permissions for SharePoint protection.

    7

    To start the permission update process, click Continue at the bottom of the Edit organization pane. If prompted, sign in to your Microsoft 365 account and grant Xopero ONE the required permissions.

    8

    After the required permissions have been granted, you can configure a SharePoint backup plan and start protecting your resources.

    If you already have a Microsoft 365 organization added, click the + Add new button in the top-left corner first.

    Enabling SharePoint protection for existing organizations

    To enable SharePoint protection for an existing Microsoft 365 organization, you must have the Microsoft 365 PRO license.

    Useful links and items

    Licensing overview
    Required permissions
    Adding Microsoft 365 tenant to Xopero ONE

    Restoring SharePoint sites

    Learn how to restore SharePoint sites from a backup.

    Xopero ONE allows you to recover SharePoint data from available backup points and restore it to the original location or another selected destination. The recovery process helps restore entire sites after accidental deletion, unwanted changes, or other data-loss scenarios while preserving their structure, documents, lists, and associated data.


    Recovery process

    The below steps demonstrate how to restore SharePoint sites and their metadata using Xopero ONE Management Service.

    1

    Open the Microsoft 365 tab, then click the Explore button next to the organization whose backup you want to restore.

    2

    In the SharePoint Sites tab, search for the site whose data you want to restore, and then click the restore button in the action menu for that site.

    3

    Next, select the backup plan from which you want to restore data. Click View available plans, and then select a plan from the list.

    4

    Choose the backup version from all the backups that have already been performed — select the desired date and click the Restore button.

    5

    Select the restore destination and click Next.

    6

    In the next pane, select the data you want to restore, and then click Restore selected. Alternatively, click Restore all to restore all available data.

    7

    Next, depending on the selected restore destination, configure the Restore to and Restore directory settings.

    1. In the Overwrite data section, choose one of the following options:

      1. Don't overwrite site and its data.

    8

    In Restore settings, you can limit bandwidth usage and select the default backup agent (worker) that will be used to restore the data (where applicable).

    9

    After defining all parameters, click the Restore button to start the recovery process. You can monitor the process in the Tasks tab.

    Overwrite only if existing resources are older than restored.
  • Always overwrite.

  • In the Site permissions section, specify whether Xopero ONE should restore site permissions along with other site data.

    1. In the Restore to pane, select the site where you want to restore the data, and click Save.

    1. In the Overwrite data section, choose one of the following options:

      1. Don't overwrite site and its data.

      2. Overwrite only if existing resources are older than restored.

      3. Always overwrite.

    2. In the Site permissions section, specify whether Xopero ONE should restore site permissions along with other site data.

    1. In the Restore to pane, select the Microsoft 365 organization where you want to restore the data, and click Save.

    1. Next, enter a custom name for the new site.

    1. In the Site permissions section, specify whether Xopero ONE should restore site permissions along with other site data.

    1. In the Restore to pane, select the device to use as the restore destination, and click Save.

    2. In the Restore directory section, select the directory where the data will be restored, and then click Apply.

    Restore to the original site

    Restore to an existing site

    Restore to a new site

    If the site URL is already in use, SharePoint will modify the new URL by adding a few characters to make it unique (typically, a number at the end).

    Restore to a device

    Protected resources

    Overview of Microsoft 365 resources protected by backup, including applications such as Microsoft Exchange, OneDrive, and SharePoint.

    Microsoft 365 protected resources define which parts of the environment Xopero ONE can access, backup, and restore.


    The following list includes all Microsoft 365 resources covered by backup.

    Backup coverage

    The list is presented in alphabetical order.

    Microsoft Exchange

    *Protection includes both individual and shared mailboxes. Shared mailboxes require the same licensing as individual user mailboxes, with each shared mailbox requiring one Microsoft user license.

    OneDrive

    *Includes information about permission settings.

    SharePoint

    *These elements can be backed up, but they cannot be fully restored to their original state.

    **The size limit for restored files is 2 MB.

    Microsoft 365

    Information about backup and recovery for Microsoft 365 tenants.

    Learn about integrating a Microsoft 365 tenant with Xopero ONE to protect its resources.

    Learn how to back up your Microsoft 365 resources with Xopero ONE.

    How to restore Microsoft Exchange, OneDrive, and SharePoint data from backup.

    Integration
    Backup
    Recovery
    Cover
    Cover
    Cover