Amazon S3 is a cloud storage service from Amazon Web Services. Companies can store data in S3 from multiple services. Onna connects directly with S3's API and is able to connect to a specific bucket to collect all files found as well as relevant metadata.

Onna's S3 integration is meant to work as a bridge to applications that Onna does not have a direct integration. Customers can setup indirect integration through an S3 bucket. 

Integration Features

Type of Account Needed
To create a bucket in Amazon S3 you must have access to the Amazon Management Console to create a bucket or access information regarding buckets already created. Instructions for creating a bucket can be found here (link will open documentation from Amazon). 

To create the integration in Onna, you will need:

  • Bucket name
  • Access Key ID 
  • Secret Access Key 
  • AWS region

For security purposes, we recommend working with your AWS admin and creating a role with access to specific buckets. For more information on how to do that, visit Amazon's IAM Role documentation. 

Files Collected

Onna's S3 integration can collect all objects from a specific bucket. You can use an existing bucket from within the organization's S3 or create a new one specifically for Onna. 

All files available through the S3 API and linked to the specific bucket are synced, including, but not limited to:

  • Files stored in the bucket from other sources 

Historical information and related metadata, including:

  • File Title
  • File creation 
  • File last modified
  • Extension
  • Size
  • MD5 hash
  • Creators
  • File URL in source
  • S3 Bucket name

Onna's sync modes

We currently support two syncing modes - one-time sync and auto-sync. 

  • One-time sync is a sync that collects files in a source during a certain time range or up until the date the source was added. 
  • Auto-sync means that Onna will perform a full sync first and will keep the data source and Onna in mirrored sync. Any deletions from the data source will be deleted in Onna, as well.

Data Exports

Yes, you can export data and metadata in eDiscovery ready format. Load files are available in a dat file, CSV, or custom text file.

How to Guide

Amazon S3 is available from our user dashboard. Click on 'Add source' and select Amazon S3


Next you'll see the information that you need to add in order to connect an S3 source.

  • Source name: This is the name of your choice that will be used in Onna. It can be changed at a later date. 
  • Access ID: This would be provided by the AWS admin for the specific role
  • Access secret: This would be provided by the AWS admin for the specific role
  • Bucket name: You can add multiple buckets. The names must match the ones found in S3 
  • Region: This region must match the region the S3 bucket is stored in
  • Synchronization mode: This will define how Onna interacts with the bucket. Choose either one-time sync or auto-sync

Once you've filled out this information the 'Sync' button will become available. Once you click 'Sync' Onna will begin to collect all of the files stored in the S3 buckets specified. 

You will see the Amazon S3 source listed in your sources.


When you click on the S3 source, you will start seeing results being populated.

From this screen, you are able to filter results by date range, categories, and/or extensions using the menu on the left.  

Accessing audit logs

Clicking on the information icon on the top right will take you to the source details where you can see how many files it has and it's size.


Click on Audit Logs to see logs from collection and processing

Ready to start collecting from Amazon S3? 

Did this answer your question?