S3 Bucket Setup

How to connect to a S3 bucket

This document outlines how to connect to and use an Audience S3 bucket for RZR. It covers three options:

1. Cyberduck

2. AWS Command Line Interface (CLI)

3. Python script

---

Option 1: Using Cyberduck

To connect to a S3 bucket from Windows PC / Mac we use a client called Cyberduck.

To download this program you need to access the following link: cyberduck.io

After downloading the Cyberduck client, run the program (as an Administrator in Windows).

The installation process is very simple:

• When prompted with the Cyberduck Welcome screen, press the Install button and the program will be installed automatically.

• After the installation is done, run the program.

In the bottom left corner of the program you will find the “+” button to create a new bookmark

Click on the “+” button to show the new Bookmark dialog box

In the first field the Amazon S3 (Amazon Simple Storage Service) protocol must be selected. After that the following fields MUST be completed:

• Nickname: give a name for the connection (for example, RZR)

• Server: must be set to s3.amazonaws.com

• Port: must be set to 443

• Access Key ID: your Access Key ID for the desired bucket must be entered (to be provided)

• Path: must be set to the folder name provided to you

• Secret Access Key: To be shared

Close the bookmark dialog box, and double click on the newly created bookmark to establish the connection.

---

Option 2: Using AWS CLI (Command Line Interface)

To connect to S3 bucket using AWS Command Line Interface or CLI, please follow the instructions as listed by Amazon AWS CLI

Once installed, open a shell and configure a profile for RZR

• aws configure --profile aarki_s3

Add the access keys in the prompt

• AWS Access Key ID: Your Access Key ID for the desired bucket (to be provided)

• AWS Secret Access Key: (To be shared)

• Default region name [None]: us-east-1

• Default output format [None]:

Now copy the file using the following commands:

• aws s3 cp FILE_PATH_ON_COMPUTER s3://S3_PATH --profile aarki_s3

where

• FILE_PATH_ON_COMPUTER: The file you want to copy to S3 bucket

• S3_PATH: The name of bucket provided to you by RZR

---

Option 3: Using a script

If you prefer to use a script to upload files to the S3 bucket, you can use the following code example that you can save as upload_s3.py.

import argparse
import boto3
from botocore.exceptions import NoCredentialsError, PartialCredentialsError
import os

def upload_to_s3(local_file, bucket_name, s3_file, aws_access_key_id,
aws_secret_access_key, region_name='us-east-1'):
        # Create an S3 client with hardcoded credentials
        s3 = boto3.client('s3',
                        aws_access_key_id=aws_access_key_id,
                        aws_secret_access_key=aws_secret_access_key,
                        region_name=region_name)
        try:
                        s3.upload_file(local_file, bucket_name, s3_file)
                        print(f"Upload Successful: {local_file} to s3://{bucket_name}/{s3_file}")
        except FileNotFoundError:
                        print(f"The file {local_file} was not found")
        except NoCredentialsError:
                        print("Credentials not available")
        except PartialCredentialsError:
                        print("Incomplete credentials")
        except Exception as e:
                        print(f"An error occurred: {e}")

if __name__ == "__main__":
                AWS_ACCESS_KEY_ID = 'REPLACE_THIS_WITH_AWS_ACCESS_KEY_ID'
                AWS_SECRET_ACCESS_KEY = 'REPLACE_THIS_WITH_AWS_SECRET_ACCESS_KEY'
                AWS_REGION = 'us-east-1'

       parser = argparse.ArgumentParser(description="Upload a file to an S3 bucket")
       parser.add_argument('--local_file', required=True, help="Path to the local file")
       parser.add_argument('--bucket_name', required=True, help="Name of the S3 bucket")
       parser.add_argument('--s3_file', required=True, help="S3 object key (path in the bucket)")
       parser.add_argument('--aws_access_key_id', default=AWS_ACCESS_KEY_ID, help="AWS Access Key ID")
       parser.add_argument('--aws_secret_access_key', default=AWS_SECRET_ACCESS_KEY, help="AWS Secret Access Key")
       parser.add_argument('--region_name', default=AWS_REGION, help="AWS region name (default: us-east-1)")
       
       args = parser.parse_args()
       
       upload_to_s3(args.local_file, args.bucket_name, args.s3_file, args.aws_access_key_id, args.aws_secret_access_key, args.region_name)

In the above example, replace the highlighted red text as follows

• REPLACE_THIS_WITH_AWS_ACCESS_KEY_ID: Your Access Key ID for the desired bucket (to be provided)

• REPLACE_THIS_WITH_AWS_SECRET_ACCESS_KEY: (To be shared)

To run the script, use the following command from a shell

python3 upload_s3.py --bucket_name BUCKET_NAME --s3_file FILE_NAME_TO_UPLOAD --local_file FILE_NAME_TO_UPLOAD

where

• upload_s3.py: The name of the script

• BUCKET_NAME: The folder name provided to you

• FILE_NAME_TO_UPLOAD: The name of the file to upload

---

This guide covers everything you need to upload audiences to RZR via S3 Bucket — including connection options, required credentials, and step-by-step instructions for Cyberduck, AWS CLI, and Python.

If you need help with setup, reach out to your RZR Account Manager or Account Coordinator for assistance.