Connecting Cloud Storage: Google Cloud Storage

Kolena connects with Google Cloud Storage to load files (e.g. images, videos, documents) directly into your browser for visualization. In this tutorial, we'll learn how to establish an integration between Kolena and Google Cloud Storage.

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 "Google Cloud Storage".

Step 1: Save Integration to Create a Service Account

From the Integrations tab, saving a Google Cloud Storage integration will create a service account. Upon creation, the integration's client_email will be used to provide Kolena permission to load data from your Google Cloud Storage buckets.

Step 2: Grant Service Account Read Access

Within your Google Cloud Platform console, navigate to the bucket that contains your images. Click on the permissions tab. Click the "Grant Access" button and grant the service account created in step 1 the Storage Object Viewer role. The Storage Object Viewer role offers the following permissions:

• Grants access to view objects and their metadata, excluding ACLs.
• Grants access to list the objects in a bucket.

Step 3: Provide CORS Access

Create a json file cors.json with the following content:

[
  {
    "origin": [
      "https://app.kolena.com",
      "https://app.kolena.io"
    ],
    "method": ["GET"],
    "responseHeader": ["Content-Type"],
    "maxAgeSeconds": 3600
  }
]

Ensure you have gsutil installed. Then provide CORS access to Kolena for your bucket by running the following command:

gsutil cors set example_cors_file.json gs://<my-bucket>