Skip to content
Ionic Data Trust Services for AWS S3
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.

Setup Instructions for Developers

AWS Documentation:

Amazon Standard SDKs

  • If you don't already have an AWS Account, go to Sign In or Create an AWS Account. Select "Create an AWS Account" and follow the instructions to create and configure your AWS account.

Setup AWS Credentials

Create IAM User

The IAM user will be used to put and get objects from the AWS Bucket

  • Open the IAM console.
  • From the navigation menu, select your username and select My Security Credentials
  • Select the Access keys tab
  • Click the Create New Access Key button to generate Access key ID and Secret access key
  • Access key ID example: AKIAIOSFODNN7EXAMPLE
  • Secret access key example: wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY

Add AWS Credentials and Default Region to your machine

Either add your credentials and default region to your environment or set them in the .aws directory in your HOME.

Adding the keys and region to your .aws directory

Create .aws/ folder and credentials file if needed

  • ~/.aws/credentials on Linux, macOS, or Unix
  • C:\Users\USERNAME\.aws\credentials on Windows

In the credentials file, enter the following:

aws_access_key_id = your_access_key_id
aws_secret_access_key = your_secret_access_key

Create .aws/config and enter the following replacing your_default_region with the region you wish to use:


Adding the keys and region to your env

Replace your_access_key_id and your_secret_access_key with the keys created for the IAM user and your_default_region with the region you wish to use for IPCS S3.


  • export AWS_ACCESS_KEY_ID=your_access_key_id
  • export AWS_SECRET_ACCESS_KEY=your_secret_access_key
  • export AWS_REGION=your_default_region


  • set AWS_ACCESS_KEY_ID=your_access_key_id
  • set AWS_SECRET_ACCESS_KEY=your_secret_access_key
  • set AWS_REGION=your_default_region

Build the Project

To build and install the Ionic S3 sdk mvn install

To build the IonicS3SampleApp from ./examples mvn package


Sample App

After the build, a fat JAR of the sample app is produced at ./examples/target/IonicS3SampleApp.jar.

Ensure that your Ionic device credentials can be located at ${user.home}/.ionicsecurity/

The user can run the program from /awss3examples with either "put" or "get" commands with usage as follows:

  • ./ putString <bucketName> <objectKey> <objectContent> [<metadata>]
  • ./ putFile <bucketName> <objectKey> <filePath> [<metadata>]
  • ./ putMultipart <bucketName> <objectKey> <file> <partsize_mb> [<metadata>]
  • ./ getFile <bucketName> <objectKey> <destinationPath>
  • ./ getString <bucketName> <objectKey> Windows users should use ./run.bat instead

Note: S3SampleApp does not protect against invalid entry of AWS S3 bucket names or Object Keys Current Rules for naming S3 buckets can be found at: Current Rules for specifying Object Keys can be found at:

Using the Library

Developer documentation for this library can be found at The JAR for use here is produced in ./target/, such as ./target/ionic-for-aws-java-sdk-s3-1.0.0.jar. This JAR is thin, and needs the Ionic SDK and the AWS SDKs available during builds that use it.

You can’t perform that action at this time.