What is required:

• Bucket name (example: ease-customer-ingestion)
• Bucket Address (example: ease-customer-ingestion.s3.amazonaws.com)
• Access Key ID
• Access Key Secret

Common Applications

S3 Browser

Note that this application is not compatible with AWS GovCloud.

1. Install S3 Browser with defaults
2. If the “Add New Account” window does not pop up when the application is first started, Click Accounts>Add New Account
3. Enter the following for the new account
   1. Display - Name you are giving this account
   2. Access Key - provided by Ease IT for authentication
   3. Secret Access Key - Provided by Ease IT for authentication
   4. Encypt Access Keys with a password - enter a password you will remember here so that your credentials in the app are encrypted. Your IT dept. likely wants this.
   5. Check the Use secure transfer (SSL/TLS
4. You will receive an error that you cannot list all buckets. This is normal. Click Yes to add an external bucket
5. Enter the bucket name provided by Ease IT support and clicn “Add External bucket”
6. Your bucket contents will appear in the right pane of the app while your local files will appear in the left side by default.

CyberDuck

1. Install CyberDuck with defaults
2. Click “Open Connection”
3. Select “Amazon S3” in the connection type selection
4. Enter the Bucket Address in the Server field
5. Enter Access Key ID and Secret Access Key provided by Ease
6. Click Connect (Make sure to consult your IT before setting it to save your password.)

WinSCP

1. Install WinSCP with defaults
2. Open WinSCP
3. In the Login pop-up, select “Amazon S3” from the File Protocol drop-down

4. Enter the Provided Access Key ID and Secret Access Key

   Note that when using GovCloud, you must update the Hostname from s3.amazonaws.com to s3.us-gov-west-1.amazonaws.com

5. Click Advanced…

6. Under the Environment>Directories section, enter the bucket name in the “Remote directory” field and click OK

   

7. Click Save and a dialog will come up. The Site name is how it will show in the Login list, so please name accordingly. And the ability to save password may not align with your corporate security policies, so please check with your IT.
8. Click OK to save and Click Login. If no password was saved, it will ask for the Secret Key. This will have you connected.
9. Before exiting the application, it is recommended to save your workspace.

AWS CLI 2

The AWS Command Line Interface (CLI) v2 is a cross-platform tool that enables you to interact with S3 buckets directly from your terminal or command prompt. You will need the credentials.

1. Install AWS CLI v2
   1. Windows:

      1. 1Download the MSI installer from:

         AWS CLI v2 for Windows

      2. Run the installer and follow the prompts.
   2. macOS:
      1. brew install awscli
   3. Linux

      1. url "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"

         unzip awscliv2.zip 

         sudo ./aws/install

2. Verify installation:
   1. aws --version
   2. This should return something like:
   3. aws-cli/2.x.x Python/3.x.x ...
3. Configure Credentials
   1. Run
      1. aws configure
   2. You will be prompted to enter:
      1. AWS Access Key ID
      2. AWS Secret Access Key
      3. Default region name (can be left blank if only using S3)
      4. Default output format (e.g., json)
   3. Example
      1. AWS Access Key ID [None]: AKIAXXXXXXXXXXXXX
         AWS Secret Access Key [None]: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
         Default region name [None]: 
         Default output format [None]: json
   4. This stores your credentials in:
      1. Windows: %USERPROFILE%\.aws\credentials
      2. macOS/Linux: ~/.aws/credentials

4. Common Commands

   Below are examples of listing, uploading, and downloading files to your S3 bucket.

   1. List Files

      1. To list all files in the bucket

         aws s3 ls s3://ease-customer-ingestion/

      2. To list files in a specific folder/prefix

         aws s3 ls s3://ease-customer-ingestion/my-folder/

   2. Upload a File

      1. Example to upload a single file

         aws s3 cp /path/to/local/file.txt s3://ease-customer-ingestion/

      2. If you want to upload a specific folder inside the bucket

         aws s3 cp /path/to/local/file.txt s3://ease-customer-ingestion/incoming/

      3. Upload an entire directory

         aws s3 cp /path/to/local/folder/ s3://ease-customer-ingestion/ --recursive

      4. Notes:

         1. Windows: Use backslashes (\) or quoted paths

            aws s3 cp "C:\Users\YourName\Documents\file.txt" s3://ease-customer-ingestion/

         2. macOS/Linux: Standard forward slashes (/).

            aws s3 cp s3://ease-customer-ingestion/file.txt /local/target/path/

   3. Download a file

      1. To download a single file

         aws s3 cp s3://ease-customer-ingestion/file.txt /local/target/path/

      2. Example for downloading to current directory

         aws s3 cp s3://ease-customer-ingestion/reports/report1.csv .

      3. Download an Entire Directory

         aws s3 cp s3://ease-customer-ingestion/data-exports/ /local/target/folder/ --recursive

5. Platform Notes
   1. Windows:
      1. Use double quotes for paths with spaces.
      2. You can run commands in Command Prompt, PowerShell, or Windows Terminal.
   2. macOS/Linux:
      1. Standard single or double quotes for paths.
      2. Be sure you have execute permissions (chmod +x) if you install manually.
6. Security Reminder
   1. Never share your Access Key ID or Secret Access Key publicly.
   2. If your organization has security policies about storing credentials, consult IT before using aws configure.