Configure an AWS Provider with a User Role

Configure your provider to add resources to your AWS account

Before your begin

IMPORTANT: We highly recommend using the Role-based method as this is more secure.

NOTE: The Role authentication method can only be used if your management cluster is running in AWS.

For more flexible credential configuration, we offer a role-based authentication method with an optional External ID for third party access.

Create role manually

The role should grant permissions to create the following resources in the AWS account:

  • EC2 Instances
  • VPC
  • Subnets
  • Elastic Load Balancer (ELB)
  • Internet Gateway
  • NAT Gateway
  • Elastic Block Storage (EBS) Volumes
  • Security Groups
  • Route Tables
  • IAM Roles

The user you delegate from your role must have a minimum set of permissions. Below is the minimal IAM policy required:

  "Version": "2012-10-17",
  "Statement": [
      "Sid": "Kommander",
      "Effect": "Allow",
      "Action": [
      "Resource": "*"

Make sure to also add a correct trust relationship to the created role. This example allows everyone within the same account to AssumeRole with the created role. YOURACCOUNTRESTRICTION must be replaced with the AWS Account ID you would like to AssumeRole from.

IMPORTANT: Never add a */ wildcard. This opens your account for the whole world.

  "Version": "2012-10-17",
  "Statement": [
      "Effect": "Allow",
      "Principal": {
        "Service": "",
        "AWS": "arn:aws:iam::YOURACCOUNTRESTRICTION:root"
      "Action": "sts:AssumeRole"

To use the role created, attach the following policy to the role which is already attached to your Kommander cluster. Replace YOURACCOUNTRESTRICTION with the AWS Account ID where the role you like to AssumeRole is saved. Also, replace THEROLEYOUCREATED with the AWS Role name.

  "Version": "2012-10-17",
  "Statement": [
      "Sid": "AssumeRoleKommander",
      "Effect": "Allow",
      "Action": "sts:AssumeRole",

Create role when creating the management cluster

Instead of creating the role manually, create the following file,, in the extras/provisioner/ directory, next to your cluster.yaml file. This creates the role when you create or update your cluster with konvoy up. Ensure you replace THEROLEYOUCREATED with the AWS Role name.

# Attaching sts:AssumeRole to the default node role from konvoy
resource "aws_iam_role_policy" "agent_policy_assumerole_kommander" {
  count = "${var.create_iam_instance_profile ? 1 : 0}"
  name  = "AssumeRoleKommander"
  role  = "${}"
  policy = <<EOF
    "Version": "2012-10-17",
    "Statement": [
            "Sid": "AssumeRoleKommander",
            "Effect": "Allow",
            "Action": "sts:AssumeRole",
            "Resource": "arn:aws:iam::YOURACCOUNTRESTRICTION:role/THEROLEYOUCREATED"

Create Infrastructure Provider

  1. In Kommander, select the Workspace associated with the credentials you are adding.

  2. Go to Administration > Infrastructure Providers and select the Add Infrastructure Provider button.

    Adding an Infrastructure Provider

    Add Infrastructure Provider Form

  3. Select the Amazon Web Services (AWS) option.

    AWS Role Infrastructure Provider Form

  4. Ensure Role is selected as the Authentication Method.

  5. Enter a name for your infrastructure provider. Select a name that matches the AWS user.

  6. Enter the Role ARN.

  7. You can add an External ID if you share the Role with a 3rd party. External IDs secure your environment from accidentally used roles. You can read more about External IDs in the AWS documentation.

  8. Select Verify and Save to verify the credentials are valid and to save your provider.

After the provider is created, the display name or role can be updated.