Connecting the AWS Toolkit for JetBrains to your AWS account
Most Amazon Web Services (AWS) and resources are managed through an AWS account. An AWS account isn't required to use the AWS Toolkit for JetBrains, however Toolkit functions are limited without a connection.
If you've previously set up an AWS account and authentication through another AWS service (such as the AWS Command Line Interface), then the AWS Toolkit for JetBrains automatically detects your credentials and guides you through the connection process.
Prerequisites
If you're new to AWS or haven't created an account, then there are 3 main steps to connect the AWS Toolkit for JetBrains with your AWS account:
Signing up for an AWS account: You can sign up for an AWS account from the AWS sign up
portal. For detailed information on setting up a new AWS account, see the Overview topic in the AWS Setup User Guide. Setting up authentication: There are 3 primary methods to authenticate with your AWS account from the AWS Toolkit for JetBrains. To learn more about each of these methods, see the Authentication and access topic in this User Guide.
Connecting with your AWS account from the AWS Toolkit for JetBrains: After you've created an AWS account and set up authentication, you can connect the AWS Toolkit for JetBrains with your AWS account by completing the Connecting to AWS from the AWS Toolkit for JetBrains procedure, located in the following section.
Opening the Sign In panel
If this is your first time using the AWS Toolkit for JetBrains, the AWS Toolkit Sign In panel automatically opens in JetBrains.
To access the AWS Sign In panel at anytime, complete the following procedure.
From the Toolkit, open AWS Connection Settings by choosing the ellipses icon in the connection panel.
From AWS Connection Settings, choose Setup Authentication... to open the AWS Toolkit Sign In pane.
From the AWS Toolkit Sign In panel, select your authentication method and follow the on-screen prompts.
The following is an image of the AWS Toolkit Sign In panel.
![AWS Toolkit sign-in panel with options for Workforce single sign-on or IAM Credential local key storage.](/images/toolkit-for-jetbrains/latest/userguide/images/awssigninpane2024.png)
Connecting to AWS from the AWS Toolkit for JetBrains
The following sections describe how to authenticate and connect the AWS Toolkit for JetBrains with AWS to access the AWS Explorer and Amazon CodeCatalyst.
Note
Authentication with AWS Builder ID or IAM Identity Center launches the AWS authorization portal in your default web browser. Each time your credentials expire this process must be repeated to renew the connection between your AWS account and the AWS Toolkit for JetBrains.
Authentication for the AWS Explorer
To get started working with the AWS Explorer in the Toolkit, authenticate and connect with either your IAM credentials or IAM Identity Center credentials.
The following procedures describe how to authenticate and connect the Toolkit with your AWS account.
Authenticate and connect with IAM Identity Center
From the AWS Toolkit Sign In panel, select the Workforce button, then choose the Continue button to advance to the Sign in with SSO screen.
From the IAM Identity Center screen, enter your
Profile Name
,Start URL
, and select your Region in the drop down, then choose the Continue button to open the AWS SSO Login Required dialog.Note
Choose the Region that matches the region associated with your IAM Identity Center credentials.
From the AWS SSO Login Required dialog, choose the Proceed To Browser button to open the AWS Authorization request website in your default web browser.
Follow the prompts in your default web browser, you're notified when the authorization process is complete, it is safe to return to close your browser, and return to JetBrains.
Authenticate and connect with IAM Credentials
From the AWS Toolkit Sign In panel, select the IAM Credentials button, then choose the Continue button to advance to the IAM Credentials screen.
From the IAM Credentials screen, enter your
Profile Name
,Access Key
, andSecret Key
, then choose the Continue button to add the profile to your config file and connect the Toolkit with your AWS account.The AWS Explorer updates to display your AWS services and resources when authentication is complete.
Authentication for Amazon CodeCatalyst
To get started working with CodeCatalyst from the Toolkit, authenticate and connect with your AWS Builder ID.
Complete the following steps to authenticate with your AWS account from the Toolkit, with your existing AWS Builder ID credentials.
Authenticate and connect with an AWS Builder ID
From the AWS Toolkit Sign In panel, select the Workforce button, then choose the Continue button to advance to the Sign in with SSO screen.
From the Sign in with SSO screen, choose the Skip to sign-in link to open the AWS Authorization request website in your default web browser.
Follow the prompts in your default web browser, you're notified when the authorization process is complete, it is safe to return to close your browser, and return to JetBrains.
Authenticate and connect with IAM Identity Center
From the AWS Toolkit Sign In panel, select the Workforce button, then choose the Continue button to advance to the Sign in with SSO screen.
From the IAM Identity Center screen, enter your
Profile Name
,Start URL
, and select your Region in the drop down, then choose the Continue button to open the AWS SSO Login Required dialog.Note
Choose the Region that matches the region associated with your IAM Identity Center credentials.
From the AWS SSO Login Required dialog, choose the Proceed To Browser button to open the AWS Authorization request website in your default web browser.
Follow the prompts in your default web browser, you're notified when the authorization process is complete, it is safe to return to close your browser, and return to JetBrains.