Skip to content

AWS SSM configuration

In some scenarios, you may need to interact with AWS resources through Systems Manager (SSM) to manage and automate operations. Team Edition offers a way to configure AWS SSM settings to facilitate this.

Before proceeding, ensure that you have the AWS CLI and Session Manager Plugin for the AWS CLI installed on your local machine.

Configuring AWS CLI and Session Manager Plugin paths

Before you can use AWS SSM with Team Edition, you need to specify the paths for the AWS CLI executable and the Session Manager Plugin. Follow these steps to configure the paths:

  1. Navigate to Window -> Preferences -> Connections -> AWS Configuration.

  2. You will see fields for the AWS CLI executable and the AWS SSM plugin path.

  3. Enter the appropriate paths based on your operating system.

    Path Windows MacOS/Unix
    AWS CLI executable C:\Program Files\Amazon\AWSCLI\bin\aws.exe /usr/local/bin/aws
    AWS SSM plugin path C:\Program Files\Amazon\SessionManagerPlugin\bin\session-manager-plugin.exe /usr/local/bin/sessionmanagerplugin/bin

  4. After entering the paths, click the Apply and Close to apply the changes.

Setting up AWS SSM

To configure AWS SSM, follow these steps:

  1. Start creating a new connection.

  2. Click on the plus () button and select AWS SSM.

  3. After selecting, an AWS SSM tab will appear in the menu at the top.

  4. In the AWS SSM tab, enter the necessary configuration details:

    Field Description
    Instance ID Enter the ID of the EC2 instance you want to connect to.
    Region Specify the AWS region where your EC2 instance is located.
    Credentials Select the type of credentials you want to use. You can choose from Default credentials, AWS profile, or Access/secret keys. Read more about AWS Credentials
    Role Name (Optional) Enter the name or ARN of the AWS IAM role if you want to assume a role for this connection.
    Enable SSO Check this box to enable Single Sign-On (SSO) authentication. Learn more about AWS SSO
    3rd party account Check this box if you are using a third-party AWS account for this connection.

  5. After configuring settings, click on Test configuration button to test whether all parameters are valid.

Tip

Use network profiles to save and reuse your settings across multiple connections.