Skip to content

evairmarinho/terraform-aws-iam-users-groups

Repository files navigation

Introduction

  • This Terraform Stack create IAM users and optionally IAM groups dynamically in AWS cloud.

Permissions

  • Crate a policy with content below and attach in EC2 IAM Role or IAM User. These permissions are required to works correctly!
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Sid": "",
            "Effect": "Allow",
            "Action": [
                "iam:CreateGroup",
                "iam:AddUserToGroup",
                "iam:RemoveUserFromGroup",
                "iam:DeleteGroup",
                "iam:ListGroupsForUser",
                "iam:UpdateGroup",
                "iam:DeleteUser",
                "iam:GetUser",
                "iam:CreateUser",
                "iam:GetGroup"
            ],
            "Resource": "*"
        }
    ]
}

Requirements

No requirements.

Providers

Name Version
aws n/a

Resources

Name Type
aws_iam_group.groups resource
aws_iam_user.users resource
aws_iam_user_group_membership.user_to_groups resource

Inputs

Name Description Type Default Required
access_key AWS Access Key string n/a yes
region Region where the resources will be created. string n/a yes
secret_key AWS Secret Access Key string n/a yes
create_groups Define if Terraform will create new_groups based on variable groups. bool true no
groups List of group names for Terraform create, case create_groups variable be true list(string) [] no
users Map for Terraform create users. map(any)
{
"user1": {
"groups": [
"ADM",
"developers"
],
"name": "test",
"path": "/"
}
}
no

This Terraform documentation was generated by terraform-docs.

Getting started

terraform init

terraform plan

terraform apply