Google Cloud Storage
Upload files and images directly into your own GCS buckets.
Last updated
Was this helpful?
Upload files and images directly into your own GCS buckets.
Last updated
Was this helpful?
When collecting binary data from your flows, such as images or documents from , , or questions, we upload them directly into your infrastructure from the responder's browser.
The answer associated with the question will contain the Object URL of the uploaded asset, such as https://storage.cloud.google.com/{{YOUR_BUCKET_NAME}}/{{FILENAME}}/
This way, you retain control over your responder's data: the GCS bucket can only provide write access to Formsort, so the data uploaded can be secure.
A common pattern is to use Google Cloud Storage as a staging ground for binary files:
A file is uploaded by Formsort into a bucket.
emit events.
The file is copied / processed / served elsewhere in your infrastructure.
If you don't have an GCS bucket already, or wish to create a new one, set one up in the , taking note of the bucket name of the bucket.
Within your bucket, click Permissions and then Grant access and provide the Storage Object Creator role to the google-cloud-storage@formsort-studio.iam.gserviceaccount.com user. This will allow us to upload, but not read data into this bucket.
Because Formsort will be uploading content directly from the browser and not via Formsort servers, you need to allow Cross Origin Resource Sharing (CORS) for this bucket. Please follow the instructions below
Login with 'gcloud init' command
Upload the CORS configuration with gsutil cors set cors.json gs://{ YOUR_BUCKET_NAME }
You can confirm your CORS settings with gsutil cors get gs://{ YOUR_BUCKET_NAME }
Back in Formsort, in the integrations editor, under Google Cloud Storage, click Add new credential...
Provide your bucket name, and a description of the bucket and click Save bucket info.
At this point, you can return back to the flow you are working on, and add file, image upload, and signature questions, and the files will be placed within your bucket directly from your responders' browsers.
At the level of the flow's integration, a base path can be specified. This adds an additional prefix that is used to create Object URLs for all uploaded assets. One helpful trick is to create a base path like /prod for the production environment, to distinguish from assets uploaded to other environments.
At the level of a particular question, additional filename patterns can be specified:
In the above configuration, uploaded assets would be located at URLs such ashttps://storage.cloud.google.com/fils-test-bucket/file-ae87adcd-e3d3-4578-a9d5-3fa1e7052d1c-fixed.jpg, and is what would be provided in the answers stored in the flow itself.
If your bucket is publicly available, then the URL that is in the answers can be used by anyone to access the uploaded file.
Generally, the process for generating signed URLs looks like:
Create a service account with the Storage Object Viewer role
Download a keyfile for that service account
For testing locally, you can use the gsutil command. The following generates a URL that's usable for one day after it's created.
First, install the Google Cloud SDK CLI:
Create cors.json file with the following example config. You can be more strict about the domain if you want, for example restricting it to *.formsort.app or the you have configured for use with Formsort.
If your bucket or the containing folder are not publicly available, but you wish to give web users access to the file, you will need to create a . Formsort cannot create the signed URL, since it is only given the Storage Object Creator role, and doesn't have the ability to read files.
Use the to generate a signed URL for the storage.google.com URL
