Open in new tab 

Overview

Amazon S3 is a simple storage service that allows place files for import to Zaius, and retrieve requested exports from Zaius. To use S3, you need the bucket (location) you wish to access and the access key/secret for authentication. 

Prepare your account for S3 access

To access S3, you'll need to generate credentials or retrieve existing credentials:

• In your Zaius account, click the Account Settings  icon in the main navigation bar.
• In the sidebar, select Integrations under the Data Management section.
• Locate and select the AWS card to reveal its details.
• If you do not have access to S3 yet, you will need to generate a key and secret. Click Generate Access Keys to create your key and secret:

You now have everything you need to access Amazon S3 via command line or a third-party application. Both of these approaches are outlined in more detail below. 

Connecting to S3

Using command line

Install the AWS CLI tools and us the S3 command line reference guide as needed. The most common interactions are detailed below.

Importing

Copy a local file to S3

aws s3 cp zaius_customers.csv s3://zaius-incoming/<your tracker ID>/ --sse

Copy a complete directory of files to S3

aws s3 sync /tmp/yourlocaldir/ s3://zaius-incoming-temp/<your tracker ID>/ --sse 

Once you place a file in your zaius-incoming bucket, it will automatically be imported. There are no additional steps required. If you regularly produce data for imports and can schedule that data to be added to your S3 bucket, you will be able to fully automate the import process.

Exporting

Retrieve an S3 file (retrieve all files under an export id)

aws s3 cp s3://zaius-outgoing/<your tracker ID>/data-exports/<id> . --recursive --sse 

The above command will output the contents of your requested id to your current directory. To specify a location, replace the "." with the directory path. For example, to output the directory to your desktop, specify /Users/<name>/Desktop (OSX) or C:\Users\<name>\Desktop (Windows). 

Of note, Zaius exports are a set of files in a directory folder identified by the export id provided. Be sure you transfer the entire directory, as above, to get the entirety of the export.

Using an application

Download and Setup

1. Download a free tool like Cyberduck.
2. Launch Cyberduck and create a New Bookmark (Bookmark > New Bookmark).
3. Select Amazon S3 from the services dropdown menu.
4. Give your connection a nickname (optional).
5. Enter the AWS Access Key ID that you received from Zaius.
6. Enter the AWS Secret Access Key that you received from Zaius.
7. Open More Options and enter the path seen on the AWS card in Integrations. Do not copy "S3://", but preface the directory with a single forward-slash. There is a separate directory for each of imports and exports.
8. Close the dialog to save as a new bookmark.

Additional information on using Cyberduck to import files can be found in their documentation.