Who can use this feature?
👤 Only Organizations Owners can access this feature.
🚩 Available on the Essential and Enterprise Plans.
Overview
ArborXR offers the ability for customers to connect their own cloud storage bucket to isolate their content (apps & files) from other content on the platform.
Click Settings in the navigation sidebar.
Select the Storage tab.
Click Configure Custom Storage Bucket.
In order to connect a Digital Ocean space, you will need the following information about your Digital Ocean space on hand:
Access key
Secret key
Space name
Region
Endpoint
This knowledge base articles details Digital Ocean space configuration requirements to enable the connection to ArborXR.
Set Up a Digital Ocean Space
Navigate to Digital Ocean, select Create from the top right, then select Spaces.
Select the datacenter region of your choice, set Allow file listing? to Restrict File Listing, enter a name for your space under Choose a unique name, then click Create a space.
Once the space is created, take a note of the space name, space endpoint, and region.
💡 In the below screenshot, these values are:
Space Name: arborxr-content-storage
Space Endpoint: https://arborxr-content-storage.nyc3.digitaloceanspaces.com
Space Region: nyc3
Create the Access & Secret Keys
Select API from the side navigation menu, scroll down to Spaces access keys, then click Generate a new key.
Enter the name of the key then select the blue check button.
Copy the Access Key and Secret Key and save it to a safe location.
Set Up CORS
To configure CORS for the space we will be using an external tool called s3cmd. s3cmd is a popular cross-platform command-line tool for managing S3 and S3-compatible object stores. Install the s3cmd tool from here.
Once the s3cmd tool is installed. Open a terminal window and configure s3cmd accordingly:
> s3cmd --configure
Access key and Secret key are your identifiers for Amazon S3. Leave them empty for using the env variables.
> Access Key: ENTER_YOUR_ACCESS_KEY
> Secret Key: ENTER_YOUR_SECRET_KEY
> Default Region [US]: nyc3
> S3 Endpoint [s3.amazonaws.com]: nyc3.digitaloceanspaces.com
> DNS-style bucket+hostname:port template for accessing a bucket [%(bucket)s.s3.amazonaws.com]: %(bucket)s.nyc3.digitaloceanspaces.com
OPTIONAL
> Encryption password: > Path to GPG program [/usr/bin/gpg]:
> Use HTTPS protocol [Yes]:
> HTTP Proxy server name:
> Test access with supplied credentials? [Y/n] Y Please wait, attempting to list all buckets... Success. Your access key and secret key worked fine :-)
> Save settings? [y/N] y
Configuration saved to '/home/arborxr/.s3cfg'📖 For more information visit https://docs.digitalocean.com/products/spaces/resources/s3cmd/.
Create a cors.xml file with the following content:
<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<CORSRule>
<AllowedOrigin>*</AllowedOrigin>
<AllowedMethod>GET</AllowedMethod>
<AllowedMethod>POST</AllowedMethod>
<AllowedMethod>PUT</AllowedMethod>
<MaxAgeSeconds>3000</MaxAgeSeconds>
<ExposeHeader>ETag</ExposeHeader>
<AllowedHeader>*</AllowedHeader>
</CORSRule>
</CORSConfiguration>Update the cors for the space:
> s3cmd setcors cors.xml s3://arborxr-content-storage
Identify the Endpoint
The endpoint format is https://SPACE_NAME.REGION.digitaloceanspaces.com.
Replace SPACE_NAME with the name of your space.
Replace REGION with the datacenter region you selected.
💡 From the screenshot above, the endpoint is https://arborxr-content-storage.nyc3.digitaloceanspaces.com.