Uploading Files
This article explains how to upload files in Backstage.
Cloud Storage Service
Backstage cloud storage is based on Google's Cloud Storage service. Files are stored in regions (the storage region can be selected from a dropdown).
Note
Our storage system for file uploads is based on Google's Cloud Storage service, which imposes a 5GB limitation on maximum file size per upload operation. Files larger than 5GB will need to be split and uploaded in single parts. We also clean up unused large files regularly.
When a file is uploaded, its metadata is stored in Backstage and the file is transferred directly to Google's Cloud Storage API.
All file transfers use SSL for encrypting the payload, and all files are also encrypted at rest with a random key.
Files can only be accessed with a signed URL (which is provided by Backstage). In order to get a signed URL for a file, the user must have an active session and permission to access the file. These permissions can be configured by the owner of the file (the admins of the subscription and the user who uploaded the file, as long as they are a member of the subscription).
Caution
ForgeRock has a global service, which means that these files may be accessed in any country where ForgeRock operates. By uploading a file to Backstage, you guarantee that the file does not contain any information that has any limitations as to where it can be accessed geographically.
Subscription Files
To access files shared with your subscription (either by your team members or ForgeRock support), go to Subscription Files:
Select your subscription from the list to see all files shared with that subscription:
Uploading Files in Cloud Storage
To upload a file for a subscription in Backstage Cloud Storage, scroll to the Upload section on the Subscription Files page and select a storage region (the choice of region is entirely up to you, but you may be required to upload files to a specific region depending on your organization's circumstances and local laws).
You can also set tags – these tags will be applied to all files you upload. You can edit the tags after uploading a file as well. Once you selected a region, you can drag and drop files to upload them or click the Select files button. Your upload will begin immediately.
Do not refresh the page until the file is fully uploaded.
File Metadata
File metadata (description, tags, permissions) can be edited after a file has been uploaded by any user with write permissions to the file. The file's content can be updated, that is, a new file can be uploaded in its place, and it can also be deleted.
When a file's content is updated, the old versions are kept. When a file is deleted, all versions of its content are removed from the storage service, but the file's metadata is kept (and becomes hidden by default).
Editing the File Metadata
Once a file is uploaded, you can edit its metadata in the details dialog box. If you have write access to a file, you can change the description, the tags and the permissions of the file.