Guidelines for configuring S3-compatible storage
This guide provides instructions on how to configure your own S3-compatible storage, such as Wasabi, Backblaze B2, or MinIO, for use as a custom video storage in Wialon.
For a successful connection, your external storage must have correct settings and permissions:
- The storage container (bucket) must be private, with all public access disabled.
- The system must connect using a generated access key and secret key.
- The keys must have permissions to perform read, write, delete, and list operations on files.
- The storage service must support the ability to generate temporary, secure links (pre-signed URLs) for accessing files.
Detailed instructions on how to comply with these requirements are provided below.
Step 1: Creating a private bucket
Using the web interface or command-line tool (CLI) of your storage provider, create a new bucket with the following settings:
-
Bucket name: Choose a unique name (for example,
your-company-video-storage). -
Region: Select the appropriate region for your data, if required by your provider.
-
Public access: Ensure that all public access settings are disabled. The bucket and its contents must remain private and accessible only via the key pair.
-
Data protection (recommended): If your provider offers features like versioning or object lock, consider enabling them to protect your files from accidental deletion.
Step 2: Configuring access permissions
The access key and secret key you use for the integration must have an attached policy that grants the following permissions on the bucket you created:
| Permission | Description |
|---|---|
GetObject |
Allows reading/downloading files |
PutObject |
Allows writing/uploading files |
DeleteObject |
Allows deleting files |
ListBucket |
Allows listing the contents of the bucket |
The system also requires the ability to generate temporary signed links (presigned URLs) for secure file access.
Depending on your provider, these permissions may be configured using identity and access management (IAM) policies, access control lists (ACLs), or similar security settings. Consult the documentation of your storage provider for specific instructions.
Next steps
After completing these steps, your S3-compatible storage will be configured correctly. You should now have all the necessary information to proceed:
- Storage URL (endpoint)
- Bucket name
- Access key
- Region (if applicable)
- Secret key
Use these details to set up the custom video storage in Wialon.