Blackfynn Discover allows users to get direct access to published data using their own Amazon Web Services (AWS) account. Amazon is one of the worlds largest cloud providers in the world. With an AWS account, you can get access to cloud-storage, compute, and many other cloud-based services. Having an AWS account is required in order to get access to data over 5GB from Blackfynn Discover.
A walkthrough of all steps, from setting up the AWS account to downloading a dataset from Blackfynn Discover can be found in the following YouTube video. This video follows the steps outline in this documentation.
This document describes the process of creating an account on AWS and configure the account to enable this functionality. For detailed information about AWS and AWS account management, please refer to the AWS Documentation.
Creating an AWS Account
First, click on the button below to open a webpage that guides you through the process of setting up an AWS account. This account is completely independent from Blackfynn and Blackfynn has no access to any of the information you will be entering.
After clicking on the
Create a Free Account button, AWS will guide you through the requirements to setup an account. During this process, you'll be asked to:
Choose either a company or personal account
Add payment information
Verify your identity
Select a support plan
Once you've completed the setup steps you'll receive an email to confirm your email and ensure your account is setup correctly. Once you receive your email, you can sign in to the AWS Console using your root user account.
IMPORTANT NOTE: Your AWS root user (which you just created) provides full access to all of your AWS services and should never be shared.
Creating an IAM User Role for Managing AWS Permissions
Using your root account, we will now create an IAM user inside your AWS account. Each AWS account can have many IAM users which are managed through the AWS Identity and Access Management (IAM) service. Going forward, you will use credentials associated with this IAM user to access AWS in a secure way.
From the AWS documentation: We strongly recommend that you do not use the root user for your everyday tasks, even the administrative ones. Instead, adhere to the best practice of using the root user only to create your first IAM user. Then securely lock away the root user credentials and use them to perform only a few account and service management tasks. To view the tasks that require you to sign in as the root user, see AWS Tasks That Require Root User.
You can access the IAM dashboard by typing
IAM in the
Find Services search box.
Create a new IAM user by selecting
Users in the left side-panel, and then clicking on
Add User . You will be guided through a number of screens to setup the IAM user.
Select a username
We recommend giving this user both Programmatic, and AWS Console access.
We recommend granting full AWS access to the IAM user by selecting the
Attach Existing Policies Directlytab and selecting
Administrator Access. Note that you can opt to restrict access of this user by selecting other policies. More advanced users can opt to allow only specific services to their IAM user.
Next, you can elect to add optional tags. Tags can include user information, such as an email address, or can be descriptive, such as a job title. You can use the tags to organize, track, or control access for this user. This is an optional step.
Finally, you will be asked to review your new user profile before officially creating it by clicking on the
Create User button.
IMPORTANT: Make sure you download, or take note of the user security credentials as noted in the final step of the process and the AWS Console login url that is created for your account.
Once you’ve created your IAM user, you can use this user instead of your root account user to access AWS services. Next, you can proceed to the last step of this configuration workflow to create a S3 bucket in case you want to copy public data to your personal AWS account.
(Optional) Creating an AWS S3 bucket
If you want to transfer datasets from Blackfynn Discover to your own AWS account, you can setup a S3-bucket that can be used as the target for the data transfer.
From the AWS Management Console, select type
S3 in the
Find Services search box and then click on
S3 to open the AWS S3 management console. Click on
Create Bucket to initiate the process of creating a new S3 Bucket.
After clicking Create Bucket, you'll be stepped through the process of creating a bucket. Keeping all settings to default will ensure a secure private bucket. During the final step, review and create the bucket.
IMPORTANT NOTE: All Blackfynn Discover objects are in the U.S. East (N. Virginia) region. Keeping your buckets in the same region will help reduce any AWS fees as there are no transfer costs within a AWS region!
We created an AWS Account
We created a IAM user with privileges in the AWS account because this is more secure than using the root user account
We created a S3 Bucket under the account which can be used for personal data storage in the cloud