Connecting Cloud Storage:
Kolena connects with any S3-compatible system to load files (e.g. images, videos, documents) directly into your browser for visualization. Supported systems include:
In this tutorial, we'll learn how to establish an integration between Kolena and a storage system implementing an S3-compatible API.
To get started, ensure you have administrator access within Kolena. Navigate to the "Integrations" tab on the Organization Settings page and click "Add Integration", then "MinIO".
Steps performed outside of Kolena are shown for a subset of possible S3-compatible systems. You may need to consult documentation for your provider to perform equivalent steps.
Step 1: Create a Service User for Kolena#
Step 2: Create an Access Policy#
Create a policy to allow read access for a bucket or set of buckets.
Save the following JSON policy to a file called
s3://share-with-kolena with the appropriate bucket(s):
Note: Bucket names
Please note that bucket names must follow S3 naming rules
Next, create the policy and attach the policy to the service user created in step 1:
Step 3: Save Integration on Kolena#
Return to the Kolena platform Integrations tab.
By default, any locators beginning with
s3:// will be loaded using this integration.
Note: scoping integrations
Optionally, each integration can be scoped to a specific bucket such that
only locators of the pattern
s3://<specific-bucket>/* will be loaded using the integration.
This can be necessary if multiple integrations are required.
Unchecking "Apply to all buckets by default?" and specifying a bucket will enable this behavior.
Fill in the fields for the integration and then click "Save".
|Access Key Id
|The username (
<kolena_user>) of the user created in step 1
|Secret Access Key
|The secret key (
<secret_access_key>) of the user created in step 1
|The hostname or IP address of your S3-compatible service
|The optional port to access your S3-compatible service
|The region your buckets will be accessed from