Setting up the Amazon SDK for Java 2.x
This section provides information about how to set up your development environment and projects to use the Amazon SDK for Java 2.x.
Setup overview
To successfully develop applications that access Amazon Web Services services using the Amazon SDK for Java, the following conditions are required:
-
The Java SDK must have access to credentials to authenticate requests on your behalf.
-
The permissions of the IAM role configured for the SDK must allow access to the Amazon Web Services services that your application requires. The permissions associated with the PowerUserAccess Amazon managed policy are sufficient for most development needs.
-
A development environment with the following elements:
-
Shared configuration files
that are set up in at least one of the following ways: -
The
config
file contains IAM Identity Center single sign-on settings so that the SDK can get Amazon credentials. -
The
credentials
file contains temporary credentials.
-
-
An installation of Java 8 or later.
-
A build automation tool such as Maven
or Gradle . -
A text editor to work with code.
-
(Optional, but recommended) An IDE (integrated development environment) such as IntelliJ IDEA
, Eclipse , or NetBeans . If you use IntelliJ IDEA, you can also add the Amazon Toolkit for IntelliJ IDEA to integrate Amazon Web Services services directly into the IDE to help you streamline development.
-
-
An active Amazon access portal session when you are ready to run your application. You use the Amazon Command Line Interface to initiate the sign-in process to IAM Identity Center's Amazon access portal.
Important
The instructions in this setup section assume that you or organization uses IAM Identity Center. If
your organization uses an external identity provider that works independently of IAM Identity Center,
find out how you can get temporary credentials for the SDK for Java to use. Follow these instructions to add
temporary credentials to the ~/.aws/credentials
file.
If your identity provider adds temporary credentials automatically to the
~/.aws/credentials
file, make sure that the profile name is
[default]
so that you do not need to provide a profile name to the SDK
or Amazon CLI.