All pages
Powered by GitBook
1 of 12

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Microsoft 365

Information about backup and recovery for Microsoft 365 tenants.

Cover
Integration

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

Cover
Backup

Learn how to back up your Microsoft 365 resources with GitProtect.

Cover
Recovery

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

Integration

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

Cover
Required permissions

Permissions required for integrating Microsoft 365 with GitProtect.

Cover
Adding Microsoft 365 tenant to GitProtect

How to integrate a Microsoft 365 organization with GitProtect.

Cover
Enabling SharePoint protection in GitProtect

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

Backup

Learn how to back up your Microsoft 365 resources with GitProtect.

Cover
Process overview

An overview of Microsoft 365 backup plans in GitProtect.

Cover
Protected resources

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

Cover
Creating a backup plan

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

Recovery

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

Cover
Restoring Microsoft Exchange and OneDrive data

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

Cover
Restoring SharePoint sites

Learn how to restore SharePoint sites from a backup.

Required permissions

Permissions required for integrating Microsoft 365 with GitProtect.

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


To integrate a Microsoft 365 organization with GitProtect, 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 GitProtect 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.


To add your Microsoft 365 organization to GitProtect, 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 GitProtect.

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

Microsoft Graph

Directory.AccessAsUser.All

Access directory as the signed-in user.

delegated

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

Microsoft Graph

Mail.ReadWrite

Read and write mail in all mailboxes.

application

Enabling SharePoint protection in GitProtect

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

Enabling SharePoint protection in GitProtect 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 GitProtect 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 GitProtect, see this article.


Adding new Microsoft 365 organization with SharePoint protection

The below steps demonstrate how to integrate a Microsoft 365 organization with GitProtect using GitProtect 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 GitProtect Management Service.

1

Select Microsoft 365 from the left pane.

2

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

3


Process overview

An overview of Microsoft 365 backup plans in GitProtect.

In GitProtect, 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 GitProtect 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, GitProtect 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

GitProtect 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.


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

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.


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

1

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

Adding Microsoft 365 tenant to GitProtect

How to integrate a Microsoft 365 organization with GitProtect.

Adding a Microsoft 365 tenant to GitProtect 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 GitProtect, allowing you to configure backup settings, manage protection policies, and perform recovery operations.


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

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


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

Microsoft 365 groups

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

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 GitProtect 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 GitProtect Management Service.

11

The Microsoft 365 organization has been successfully added to GitProtect. 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 GitProtect 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 GitProtect
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.

Restore to the original account

  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 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.

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.

Recovery process

1

Select Microsoft 365 from the left pane.

2

Click Connect under Microsoft 365.

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

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 GitProtect Management Service.

7

The Microsoft 365 organization has been successfully added to GitProtect. 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 GitProtect the required permissions.

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


Important notice

Integration process

Enabling SharePoint protection in GitProtect

Additional permissions for shared mailboxes

Useful links and items

Licensing overview
Required permissions
Enabling SharePoint protection in GitProtect

Creating a backup plan

Learn how to create a Microsoft 365 backup plan in GitProtect 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.


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

1

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

2

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

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.

GitProtect 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.

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.

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

7

Select one of the data stores assigned to your GitProtect 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. Microsoft 365 diagnostics: lets you enable pre-backup diagnostics, such as the mail message download test.

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

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

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

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

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 GitProtect 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 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 GitProtect 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.

Backup plan setup (Microsoft Exchange & OneDrive)

Backup plan setup (SharePoint)

Restoring SharePoint sites

Learn how to restore SharePoint sites from a backup.

GitProtect 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 GitProtect 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.

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.

  • 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.

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

  • In the Site permissions section, specify whether GitProtect 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 GitProtect 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 GitProtect 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

    API name
    Claim value
    Permission
    Type

    Office 365 Exchange Online

    full_access_as_app

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

    application

    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

    API name
    Claim value
    Permission
    Type

    Office 365 Exchange Online

    full_access_as_app

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

    application

    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


    General requirements

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

    Account permissions

    Learn more about Microsoft 365 administrator roles in the official Microsoft documentation.

    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

    LogoAbout administrator roles in the Microsoft 365 admin center - Microsoft 365 adminMicrosoftLearn

    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 GitProtect 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.