59899: Acronis Cyber Files Cloud: how to register storage

use Google Translate

Applies to: 

Last update: 18-11-2022

Scenario

You can use Acronis Cyber Files Cloud with Acronis Storage (S3-compatible). This is the recommended configuration.

Alternatively, you can register Microsoft Azure Storage, Amazon S3, or other S3-compatible storages.

Prerequisites

When registering storage, have this information on hand:

Acronis Storage (S3-compatible)

  • s3 access key id
  • s3 secret access key
  • storage address
  • bucket name
  • encryption type (aes128, aes 256) you want to use (optional)
    Note: This is the encryption that Files Cloud uses before sending data to а storage, and not the encryption of the storage itself. Enabling this option noticeably decreases the upload and download speed of Files Cloud service, due to the overhead that encryption causes.

Amazon S3

  • s3 access key id
  • s3 secret access key
  • bucket name
  • region (optional)
  • encryption type (aes128, aes 256) you want to use (optional)

    Note: This is the encryption that Files Cloud uses before sending data to а storage, and not the encryption of the storage itself. Enabling this option noticeably decreases the upload and download speed of Files Cloud service, due to the overhead that encryption causes.

S3-compatible storages

  • s3 access key id
  • s3 secret access key
  • storage address
  • bucket name
  • encryption type (aes128, aes 256) you want to use (optional)

    Note: This is the encryption that Files Cloud uses before sending data to а storage, and not the encryption of the storage itself. Enabling this option noticeably decreases the upload and download speed of Files Cloud service, due to the overhead that encryption causes.

Microsoft Azure

  • azure account name
  • azure access key
  • azure blob container name
  • encryption type (aes128, aes 256) you want to use (optional)

    Note: This is the encryption that Files Cloud uses before sending data to а storage, and not the encryption of the storage itself. Enabling this option noticeably decreases the upload and download speed of Files Cloud service, due to the overhead that encryption causes.

Registration

Using a special registration tool, register your storage:

1. Download and unpack the tool.

2. Run the tool, using this syntax (the command should be all lower-case):
infra-tool.py --action=register --host=<account server host URL> --login=<account login> --password=<account password> --infra-capability=files_cloud --infra-name=<name of storage to be registered> --infra-url=<url of the component to be registered>

where:
<account server host URL> is the host name of the account server in the data center where this account is registered, for example https://eu-cloud.acronis.com

<account login> is the Acronis Cyber Protect Cloud administrator account login and <account password> is the password for this account

<name of storage to be registered> is a human-readable name which will be used for this storage in the UI

<url of the component to be registered> is the URL of the storage.
Provide domain name in lower case. Access keys and secrets containing special characters should be individually URL encoded: "+" to "%2B", "/" to "%2F", "=" to "%3D", etc.

As the url of the component to be registered includes the "&" character, use quotation marks.

The URL can have one of these formats:

Acronis Storage (S3-compatible)
s3://<s3-access-key-id>:<s3-secret-access-key>@<storage-address>/<bucket-name>?encryption=<aes128|aes256>&use_ssl=<true|false>

Amazon S3

The Sync & Share service is currently only compatible with servers with Version 2 Signatures support: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
If the provided region is on that list with "Version 4 only", use the default endpoint address (s3.amazonaws.com).

amazon+s3://<s3-access-key-id>:<s3-secret-access-key>@s3-<region>.amazonaws.com/<bucket-name>?encryption=<aes128|aes256>&use_ssl=<true|false>
<region> is optional, for default region use s3.amazonaws.com address.

S3-compatible storages
s3://<s3-access-key-id>:<s3-secret-access-key>@<storage-address>/<bucket-name>?encryption=<aes128|aes256>&use_ssl=<true|false>

Microsoft Azure Storage
microsoft+azure://<azure-account-name>:<azure-access-key>@blob.core.windows.net/<azure-blob-container-name>?encryption=<aes128|aes256>

More information

If registration fails with the error "500 Internal Server Error", it means that the certificate chain is incorrect on the URL that you are trying to register. Fix the certificate chain and check the URL using SSL checker (https://www.ssllabs.com/ssltest/ ), then attempt to register the storage once again.

If you have not found your storage type or have encountered an issue during registration, please contact Acronis Support for further instructions. Acronis engineers help you with registration.