All pages
Powered by GitBook
1 of 21

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Loading...

Adding new storage

This article describes the process of setting up an S3-compatible bucket as storage in Xopero ONE.

1

Open the Storages section and click Add storage button.

2

The Add storage sidebar will appear— use it to enter the name of your new storage in the Add storage name field (step 1), then click the arrow next to the Storage type section (step 2) to expand the list of available storage types.

3

Scroll down the list and select the S3 storage option.

4

After selecting storage option, the system will display additional sections, including: Authentication data, Service URL, Bucket name, and Optional description.

5

Copy the access key ID and secret access key from your S3-compliant storage provider, paste the access key ID to the corresponding field, and click Select or add secret access key to open the Password Manager menu and add your copied secret key to your bucket.

6

In the Service URL field, enter the URL provided by your S3-compliant storage provider.

7

Enter the bucket name in the Bucket name field and proceed to the next step.

8

Ensure that the browsing machine—a device with an active license and the Xopero ONE agent installed—can access your S3 bucket. To use a different device, click Change next to the Browsing machine at the bottom.

9

Review your settings and click the Save button to add the storage to Xopero ONE. Refresh the page to see the newly added storage on your storages list.

S3 compliant

Overview and limitations
Xopero Cloud Storage
Adding new storage
Cover
Cover
Cover
Cover

To get the access key ID and secret access key, visit your S3-compatible platform and create a new access key.

Overview and limitations

Xopero ONE supports the majority of the most popular cloud service providers compatible with S3:


Sending backup tasks to S3 cloud storage has a limit (buffer). The default buffer value is 128 MB, which limits both the maximum data size and the minimum internet speed. If your network environment or S3 endpoint has no additional restrictions, the minimum required upload speed is ~0.64 Mbit/s.


Xopero ONE supports S3-type immutable storage as a backup location. This feature is available for some of cloud storages supported by Xopero ONE (AWS, Wasabi, Backblaze B2 and Google Cloud Storage). Datastores of this type allow you to freely save and read data, but modification and deletion are only possible after meeting the bucket’s retention policies.

Advantages:

Azure Blob Storage

Backblaze B2

Cloud storage

AWS S3

Azure storage configuration

This article explains how to configure a storage account and blob storage in Azure.

1

Navigate to the Create a resource section in the top-left corner of the Azure Portal.

2

In the search bar, type storage account and select Create from the results.

3

Adding new storage

This article explains how to set up an Azure Blob Storage container as storage in Xopero ONE.

1

Open the Storages section and click Add storage button.

2

The Add storage sidebar will appear— use it to enter the name of your new storage in the Add storage name field (step 1), then click the arrow next to the

Wasabi

Google Cloud Storage

Compliance with legal regulations – meets requirements for storing confidential data (e.g., payment or medical records).

Configuration and limitation

For cloud storage backup to S3-compliant systems, Xopero suggests a minimum upload speed of 2.5 Mbit/s.

Immutable storage

Cover
Permissions
Cover
Adding new storage
Cover
Permissions
Cover
Adding new storage
Azure storage configuration
Azure integration methods
Adding new storage
Cover
Cover
Cover
Permissions
Adding new storage
Cover
Cover
S3 compliant
AWS S3
Azure Blob Storage
Backblaze B2
Google Cloud Storage
Wasabi
Cover
Cover
Cover
Cover
Cover
Cover
Permissions
IAM rules
Adding new storage
Cover
Cover
Cover

On the configuration page, complete the required fields: choose your subscription, select or create a resource group, and enter a unique name for the storage account that meets the global uniqueness requirement.

4

Select the region for the storage account, choose the performance tier (Standard or Premium), and specify the redundancy option, such as Locally-redundant storage (LRS) or Geo-redundant storage (GRS), according to your data redundancy needs.

5

Next, configure the networking options— choose whether the storage account will be accessible via the public internet, a private virtual network, or both.

6

In the Advanced tab, configure additional options such as data access and encryption. If needed, add tags in the Tags tab to meet management requirements (if you have any).

7

After configuring all settings, review your selections and click Create to finalize the creation of your storage account.


1

After creating the storage account, create a blob storage container— navigate to the storage account and select Containers from the side menu.

2

Click + Container to add a new container, enter a name, and select the appropriate access level (Private, Blob, or Container).

3

Click Create to set up the container.

Creating a storage account

Xopero ONE supports only Block Blobs; the other two types—Page Blobs and Append Blobs—are not supported.

Creating a blob storage container

Xopero ONE supports only three Azure Blob Storage access tiers: hot, cool, and cold. The archive access tier is not supported. Learn more about access tiers for blob data in the .

Storage type
section (
step 2
) to expand the list of available storage types.
3

Scroll down the list and select the Azure Blob Storage option.

4

After selecting storage option, the system will display additional sections, including: Authentication data, Container name, and Optional description.

5

To select the password for your container, click the Select or add connection string button and choose an existing password from the Password Manager or create a new one.

6

Enter the container name and description (if needed).

7

Ensure that the browsing machine—a device with an active license and the Xopero ONE agent installed—can access your Azure Blob Storage container. To use a different device, click Change next to the Browsing machine at the bottom.

8

Review your settings and click the Save button to add the storage to Xopero ONE. Refresh the page to see the newly added storage on your storages list.

Xopero ONE supports only three Azure Blob Storage access tiers: hot, cool, and cold. The archive access tier is not supported. Learn more about access tiers for blob data in the official Microsoft documentation.

Permissions

This article outlines the minimum permissions needed to use an AWS S3 bucket as backup storage for Xopero ONE. The policies below enable you to integrate your AWS S3 storage with Xopero ONE.


AWS bucket policy

The bucket that will be used to store the data must have the following policy (JSON) assigned:

{
     "Version": "2012-10-17",
     "Statement": [
          {
               "Effect": "Allow",
               "Principal": {
                    "AWS": "arn:aws:iam::{account}:user/backup-user"
          },
               "Action": [
                    "s3:ListBucket",
                    "s3:GetObject",
                    "s3:PutObject",
                    "s3:DeleteObject"
                
               ],
               "Resource": [
                    "arn:aws:s3:::bucket-name",
                    "arn:aws:s3:::bucket-name/*"
               ]
          }
     ]
}

Support for immutable storage

Remember that immutable storage configuration is available only when creating a new bucket— there is no option to enable it for an existing bucket.

Enabling retention and/or versioning for the bucket may result in additional data being stored— it is recommended that the retention period in Xopero ONE be longer than the one set for the storage. Otherwise, this may lead to storage overload.

If you want to use immutable storage, the following permissions are required:

Required to read Object Lock configuration
s3:GetBucketObjectLockConfiguration
Required to read the versioning configuration
s3:GetBucketVersioning

It must be added to the Action section, and after the changes, the section should look as shown below:

"Action": [
                    "s3:ListBucket",
                    "s3:GetObject",
                    "s3:PutObject",
                    "s3:DeleteObject",
		    "s3:GetBucketVersioning",
	            "s3:GetBucketObjectLockConfiguration"
               ],

Useful links and items

Permissions

Application key restrictions

Only application keys manually created in the Backblaze web UI or via the Backblaze B2 native API can be used to authenticate with the Backblaze S3 compatible API.

Automatically created master application key is not supported in Backblaze S3 compatible API.

If an app key is restricted to a bucket, the listAllBucketNames permission is required for compatibility with SDKs and integrations. This permission can be enabled during creation in the web UI or via the b2_create_key API call.

As a rule, both writeFiles and deleteFiles permissions must be assigned to any key used for deleting files in the S3 compatible API.

Backblaze S3 compatible API does not support unauthenticated ListObject calls on public buckets.


Support for immutable storage

Remember that immutable storage configuration is available only when creating a new bucket— there is no option to enable it for an existing bucket.

Enabling retention and/or versioning for the bucket may result in additional data being stored. It is recommended that the retention period in Xopero ONE be longer than the one set for the storage. Otherwise, this may lead to storage overload.

If you want to use immutable storage, the following permissions are required:

Required to read Object Lock
s3:GetBucketObjectLockConfiguration
Required to read the versioning configuration
configuration.s3:GetBucketVersioning

It must be added to the Action section, and after the changes, the section should look as shown below:


Permissions

IAM roles and permission

To use Google Cloud Storage as backup storage in the Xopero ONE service, it is recommended to assign the Storage Admin IAM role (roles/storage.admin – full control of buckets and objects) to the GCS user, or create a service account with the minimal permission set:

  1. storage.objects.list

  2. storage.objects.get

  3. storage.objects.create

  4. storage.objects.delete


If you want to use immutable storage, the following permissions are required:

It must be added to the Action section, and after the changes, the section should look as shown below:


IAM rules

This article explains how to integrate a bucket using IAM rules instead of an access/secret key.

IAM policy configuration

To increase security and eliminate the use of tokens, you can disable access/secret keys for your AWS buckets and use integration via IAM rules. This approach, however, has specific requirements—integrating a bucket using IAM rules involves creating an IAM policy accessible to Amazon EC2 and designating an EC2 instance that can communicate directly with the bucket.

Since the Xopero machine template is not available in EC2, you must create an instance using a supported operating system and install the Xopero worker on it.

The cloud worker cannot communicate with the bucket via IAM rules by default.

Steps for an AWS administrator:

  1. Create an IAM role accessible to EC2.

  2. Add a policy to the created role.

  3. Assign the role to the selected EC2 instance.

  4. Install the backup worker on the EC2 instance.


In the Xopero ONE Management Service (XMS) admin panel, enable the Use Amazon IAM toggle and specify your EC2 worker in the Default worker section at the bottom.


Adding new storage

This article explains how to set up a Wasabi bucket as storage in Xopero ONE.

1

Open the Storages section and click Add storage button.

2

The Add storage sidebar will appear— use it to enter the name of your new storage in the Add storage name field (step 1), then click the arrow next to the Storage type section (step 2) to expand the list of available storage types.

3

Scroll down the list and select the Wasabi option.

4

Copy the access key ID and secret access key from Wasabi, paste the access key ID to the corresponding field, and click Select or add secret access key to open the Password Manager menu and add your copied secret key to your bucket.

5

Click the Add new button to add your Wasabi secret access key to Xopero ONE Password Manager. Enter a password name, then enter the secret access key in the New password and Confirm password fields. Click Save to finish.

6

Next, select the region where your bucket is created and enter the bucket name (the bucket name is the unique identifier of the container where your objects are stored) in the appropriate field.

7

Ensure that the browsing machine—a device with an active license and the Xopero ONE agent installed—can access your Wasabi bucket. To use a different device, click Change next to the Browsing machine at the bottom.

8

Review your settings and click the Save button to add the storage to Xopero ONE. Refresh the page to see the newly added storage on your storages list.

Adding new storage

This article explains how to set up an Backblaze B2 bucket as storage in Xopero ONE.

1

Open the Storages section and click Add storage button.

2

The Add storage sidebar will appear— use it to enter the name of your new storage in the Add storage name field (step 1), then click the arrow next to the

Adding new storage

This article explains how to set up a Google Cloud Storage bucket as storage in Xopero ONE.

1

Open the Storages section and click Add storage button.

2

The Add storage sidebar will appear— use it to enter the name of your new storage in the Add storage name field (step 1), then click the arrow next to the

Storage type
section (
step 2
) to expand the list of available storage types.
3

Scroll down the list and select the Backblaze B2 option.

4

After selecting storage option, the system will display additional sections, including: Authentication data, Region, Bucket name, and Optional description.

5

Copy the key ID and application key (secret access key) from Backblaze B2, paste the key ID to the Access key ID field, and click Select or add secret access key to open the Password Manager menu and add your copied secret key to your bucket.

To get the application key ID (key ID) and application key (secret access key) go to App Keys site on Backblaze platform and create new application key. Learn more about app keys in .

6

Click the Add new button to add your Backblaze B2 secret access key to Xopero ONE Password Manager. Enter a password name, then enter the application key in the New password and Confirm password fields. Click Save to finish.

7

Next, select the region where your bucket is created and enter the bucket name (the bucket name is the unique identifier of the container where your objects are stored) in the appropriate field.

You can verify your bucket region on the Backblaze platform.

8

Ensure that the browsing machine—a device with an active license and the Xopero ONE agent installed—can access your Backblaze bucket. To use a different device, click Change next to the Browsing machine at the bottom.

9

Review your settings and click the Save button to add the storage to Xopero ONE. Refresh the page to see the newly added storage on your storages list.

Storage type
section (
step 2
) to expand the list of available storage types.
3

Scroll down the list and select the Google Cloud Storage option.

4

After selecting storage option, the system will display additional sections, including: Authentication data, Service URL, Bucket name, and Optional description.

5

Copy the access key ID and secret access key from Google Cloud Storage, paste the access key ID to the corresponding field, and click Select or add secret access key to open the Password Manager menu and add your copied secret key to your bucket.

To get the access key ID and secret access key, go to the Access Keys tab on Google Cloud Storage web platform and create a new access key. Learn more about access keys in .

6

In the Service URL field, enter the URL address from the Request Endpoint in Interoperability Settings (e.g., https://storage.googleapis.com). Enter the bucket name in the Bucket name field and proceed to the next step.

7

Ensure that the browsing machine—a device with an active license and the Xopero ONE agent installed—can access your Google Cloud Storage bucket. To use a different device, click Change next to the Browsing machine at the bottom.

8

Review your settings and click the Save button to add the storage to Xopero ONE. Refresh the page to see the newly added storage on your storages list.

"Action": [
                    "s3:ListBucket",
                    "s3:GetObject",
                    "s3:PutObject",
                    "s3:DeleteObject",
		    "s3:GetBucketVersioning",
	            "s3:GetBucketObjectLockConfiguration"
               ],

Useful links and items

Required to read Object Lock
s3:GetBucketObjectLockConfiguration
Required to read the versioning configuration
configuration.s3:GetBucketVersioning
"Action": [
                    "s3:ListBucket",
                    "s3:GetObject",
                    "s3:PutObject",
                    "s3:DeleteObject",
		    "s3:GetBucketVersioning",
	            "s3:GetBucketObjectLockConfiguration"
               ],

Support for immutable storage

Remember that immutable storage configuration is available only when creating a new bucket— there is no option to enable it for an existing bucket.

Enabling retention and/or versioning for the bucket may result in additional data being stored. It is recommended that the retention period in Xopero ONE be longer than the one set for the storage. Otherwise, this may lead to storage overload.

Buckets with retention enabled cannot be used as storage for Xopero ONE.

Useful links and items

Policy
{
"Version": "2012-10-17",
"Statement": [
{
"Sid": "VisualEditor1",
"Effect": "Allow",
"Action": [
"s3:"
],
"Resource": [
"arn:aws:s3:::[bucket_name]",
"arn:aws:s3:::[bucket_name]/",
"arn:aws:s3:::[bucket_name]/"
]
}
]
}

Enabling IAM authentication

Useful links and items

To get the access key ID and secret access key, go to Access Keys tab in your Wasabi web panel and create new access key. Learn more about access keys in Wasabi official documentation.

You can verify your bucket region on the Wasabi platform through the Buckets tab.

official Microsoft documentation

Azure integration methods

Learn about Azure integration methods.

Integration methods

After creating the storage account and a blob container, you can integrate them using one of two methods— access keys or a shared access signature (SAS):

  1. Access keys provide full administrative access to your storage account, allowing any operation. They are suitable for scenarios requiring complete control but must be handled carefully due to their high level of access.

  2. A shared access signature (SAS) offers more granular control, allowing access to specific resources for a limited time with restricted permissions. This method is ideal for scenarios where you need to grant a temporary access to clients or applications without exposing primary keys, enhancing security and flexibility in managing storage resources.


Minimal required permissions to configure Azure Blob Storage for use with:

  1. Allowed services:

  1. Allowed resource types:

  1. Allowed permissions:

  1. Allowed permissions for replication:


  1. Login to the Azure portal as an administrator.

  2. Select the storage account and click Shared Access Signature in the Settings tab.

  3. Select the permissions described in the section of this article.

  1. For setting up the blob storage, you will need the connection string:

  1. Login to the Azure portal as an administrator.

  2. Select the storage account.

  3. Go to Access keys under the Security + networking menu section.

  1. For setting up the blob storage, you will need the connection string:


List
List
  • Click Generate SAS and connection string.

    SAS configuration

    To use replication tasks when granting permissions, these permissions must either be full or extended with Add and Create.

    Generating the connection string

    Generating the connection string with the specified permissions:

    Generating the connection string with the full permission:

    Useful links and items

    SAS configuration
    Example of correct permissions for Azure Blob Storage.
    Example of correct replication permissions for Azure Blob Storage.
    Backblaze official documentation
    Google Cloud Storage official documentation
    What is AWS Security Incident Response? - AWS Security Incident Response User GuideAWS Security Incident Response User Guide
    Logo
    b2_create_bucketwww.backblaze.com
    Adding a bucket policy by using the Amazon S3 console - Amazon Simple Storage ServiceAmazon Simple Storage Service
    Logo
    Set and manage IAM policies on buckets  |  Cloud Storage  |  Google Cloud DocumentationGoogle Cloud Documentation
    IAM roles for Cloud Storage  |  Google Cloud DocumentationGoogle Cloud Documentation
    Protecting Cloud Storage with WORM, key management and more updates | Google Cloud BlogGoogle Cloud Blog
    Logo
    Logo
    Logo
    Overview of immutable storage for blob data - Azure StorageMicrosoftLearn
    Logo
    Immutable Backups: Five Ways to Use Object Lock ImmutabilityBackblaze Blog | Cloud Storage & Cloud Backup
    Policies and permissions in AWS Identity and Access Management - AWS Identity and Access ManagementAWS Identity and Access Management
    Logo
    Logo
    Define a stored access policy - Azure StorageMicrosoftLearn
    Logo

    Permissions

    This article lists the minimal permissions required for a Wasabi bucket to be used as backup storage in Xopero ONE. The policies below allow you to add your Wasabi storage to the Xopero ONE platform, store backup data, and restore it when needed.


    Wasabi bucket policy

    Access keys are generated for each Wasabi user account. You can view the list of access keys by logging in to your Wasabi account and navigating to the Access Keys tab.

    To create a new user account or edit an existing one, go to the Users tab. In the Policies section, select WasabiReadOnlyAccess and WasabiWriteOnlyAccess, according to your needs.


    If you want to use immutable storage, the following permissions are required:

    It must be added to the Action section, and after the changes, the section should look as shown below:

    arn:aws:iam::100000176259:user/xone-storage - Wasabi user

    arn:aws:s3:::xopero-test - Wasabi bucket

    Required to read Object Lock
    s3:GetBucketObjectLockConfiguration
    Required to read the versioning configuration
    configuration.s3:GetBucketVersioning
    "Action": [
                        "s3:ListBucket",
                        "s3:GetObject",
                        "s3:PutObject",
                        "s3:DeleteObject",
    		    "s3:GetBucketVersioning",
    	            "s3:GetBucketObjectLockConfiguration"
                   ],
    Example policy configuration
    {
      "Version": "2012-10-17",
      "Statement": [
        {
          "Sid": "AllowPublicRead",
          "Effect": "Allow",
          "Principal": {
            "AWS": "arn:aws:iam::100000176259:user/xone-storage"
          },
          "Action": [
            "s3:ListBucket",
            "s3:GetObject",
            "s3:PutObject",
            "s3:DeleteObject",
            "s3:GetBucketVersioning",
            "s3:GetBucketObjectLockConfiguration"
          ],
          "Resource": [
            "arn:aws:s3:::xopero-test/*",
            "arn:aws:s3:::xopero-test"
          ]
        }
      ]
    }

    Support for immutable storage

    Remember that immutable storage configuration is available only when creating a new bucket— there is no option to enable it for an existing bucket.

    Enabling retention and/or versioning for the bucket may result in additional data being stored. It is recommended that the retention period in Xopero ONE be longer than the one set for the storage. Otherwise, this may lead to storage overload.

    Useful links and items

    Logo
    Immutable Storage with S3 Object Lockwasabi.com
    Logo
    Permissions: Defining a Policy and Enablingdocs.wasabi.com
    Logo

    Adding new storage

    This article explains how to add AWS S3 storage to Xopero ONE.

    1

    Open the Storages section and click Add storage button.

    2

    The Add storage sidebar will appear— use it to enter the name of your new storage in the Add storage name field (step 1), then click the arrow next to the Storage type section (step 2) to expand the list of available storage types.

    3

    Scroll down the list and select the AWS storage option.

    4

    Copy the access key ID and secret access key from AWS, paste the access key ID to the corresponding field, and click Select or add secret access key to open the Password Manager menu and add your copied secret key to your bucket.

    5

    Next, select the region where your bucket is created and enter the bucket name (the bucket name is the unique identifier of the container where your objects are stored) in the appropriate field.

    6

    Define Bucket name (the bucket name is the unique identifier of the container where your objects are stored) and, if needed, Optional description.

    7

    Ensure that the browsing machine—a device with an active license and the Xopero ONE agent installed—can access your AWS bucket. To use a different device, click Change next to the Browsing machine at the bottom.

    8

    Review your settings and click the Save button to add the storage to Xopero ONE. Refresh the page to see the newly added storage on your storages list.

    To get access keys for AWS storage, refer to section in AWS Documentation.

    Authenticating with AWS