Blitzz Help Center

Custom Storage Endpoints with AWS S3 Cloud Storage

This article provides instructions for configuring your own custom AWS storage endpoints. This will route media files (images and recordings) to the storage service and region of your choice, and will not be stored on Blitzz Servers.


STEPS


Step 1: Create an S3 Storage Service on AWS


This is where your images and recordings from Blitzz Sessions will be stored. Please select the region of your choice.


  1. Sign up and create an account on AWS Console if you don’t have one already.
  2. Navigate to S3 Services in AWS Portal (https://s3.console.aws.amazon.com/)
  3. Create a new bucket
  4. Enable Public access




Step 2: Configure CORS


Cross-origin resource sharing (CORS) defines a way for client web applications that are loaded in one domain to interact with resources in a different domain. Learn more.


Ensure you have Cross-Origin Resource Sharing (CORS) enabled in your storage account and allowed these URLs as the origin URL with GET, POST, PUT, OPTIONS methods.



To Set up CORS:


  1. Go to your Bucket > Permissions > CORS Configuration
  2. Copy and paste the code below (remember to change the <subdomain> with your own subdomain)


<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<CORSRule>
<AllowedOrigin>https://web.blitzz.co</AllowedOrigin>
<AllowedMethod>GET</AllowedMethod>
</CORSRule>
<CORSRule>
<AllowedOrigin>https://join.blitzz.co</AllowedOrigin>
<AllowedMethod>GET</AllowedMethod>
</CORSRule>
<CORSRule>
<AllowedOrigin>https://<subdomain>.blitzz.co</AllowedOrigin>
<AllowedMethod>GET</AllowedMethod>
</CORSRule>
</CORSConfiguration>




 


Only for Custom Host Mapping (Eg. https://example.company.com)


If you have set up custom host mapping for your account, it is very important you whitelist your own subdomain as well by including that block of code.


Example:


<?xml version="1.0" encoding="UTF-8"?>
<CORSConfiguration xmlns="http://s3.amazonaws.com/doc/2006-03-01/">
<CORSRule>
<AllowedOrigin>https://web.blitzz.co</AllowedOrigin>
<AllowedMethod>GET</AllowedMethod>
</CORSRule>
<CORSRule>
<AllowedOrigin>https://join.blitzz.co</AllowedOrigin>
<AllowedMethod>GET</AllowedMethod>
</CORSRule>
<CORSRule>
<AllowedOrigin>https://<subdomain>.blitzz.co</AllowedOrigin>
<AllowedMethod>GET</AllowedMethod>
</CORSRule>
<CORSRule>
<AllowedOrigin>https://example.company.com</AllowedOrigin>
<AllowedMethod>GET</AllowedMethod>
</CORSRule>

</CORSConfiguration>


Step 3: Create AWS Access Keys


  1. Navigate to My Security Credentials from the drop-down menu
  2. Under Access Keys, select "Create New Access Key"
  3. Copy your access key. We will need to paste them in your Blitzz Admin Console (see Step 5)




 



Step 4: Configure Blitzz Portal


  1. Login to your Blitzz Portal as an Admin
  2. Click on the Settings gear (top right) > Custom Storage. Select AWS Storage from the options.
  3. Enter your Access Key, Secret, Bucket Name, and the Region where your S3 Bucket is located.
  4. Click Next and Test your connection. This step will store a temporary file (temp.jpeg) in the miscellaneous folder of your AWS Bucket.





Step 5: Finally, test your new endpoints


  1. Navigate to Blitzz ShowMe, and Create a new session.
  2. Join the session and Capture images during the session. If Recording* is enabled for the call experience, the recorded file will also be stored in your new storage account.
  3. Navigate to your AWS bucket and locate the images (and recordings if enabled).


* Recordings and Processing time: If your Blitzz Subscription plan includes recording, you can configure your call experience to have the videos recorded. Please note that there may be a delay of about 20 minutes (depending on the length of your call) to process the recordings before you see them in your storage account.


Here is a quick cheat sheet to test everything works well:


Test NumberTest CaseTest Result
1Create and session with recording enabledPass / Fail
2Take imagePass / Fail
3Save Markup ImagePass / Fail
4Save OCR imagePass / Fail
5Download images from Azure PortalPass / Fail
6Download recording from Azure PortalPass / Fail
7Download images from Blitzz PortalPass / Fail
8Download recordings from the Blitzz portalPass / Fail


 



 

Related articles:


Did you find it helpful? Yes No

Send feedback
Sorry we couldn't be helpful. Help us improve this article with your feedback.