leoc-22 / tf-module-iam-role

A Terraform module to create IAM roles.

Terraform Module: IAM Role

This is DAQ's Terraform Module for AWS IAM role management.

This repo provides a template for other Terraform repos to create IAM roles.

Install

• pre-commit
  • install pre-commit
  • run pre-commit install locally

Usage

This module creates an IAM Role and its policy document. You need to pass your custom policy document or a list of AWS pre-defined policies to the module.

Example

See examples.

Requirements

Name	Version
terraform	>= 0.13

Providers

Name	Version
aws	n/a

Modules

No modules.

Resources

Name	Type
aws_iam_policy.custom_policy	resource
aws_iam_policy_attachment.custom_policy_attachment	resource
aws_iam_role.custom_role	resource
aws_iam_role_policy_attachment.existing_policy_attachment	resource
aws_caller_identity.current	data source
aws_iam_policy_document.assume_role	data source

Inputs

Name	Description	Type	Default	Required
arns_assume_role	List of ARNs of IAM entities that can assume the role	list(string)	[]	no
existing_iam_policy_arns	List of ARNs of existing IAM policies	list(string)	[]	no
iam_policy_document	Custom IAM policy document	string	""	no
name_prefix	Name prefix for IAM role name	string	""	no
role_description	An optional IAM role description	string	""	no
role_path	An optional IAM role path	string	""	no
services_assume_role	List of services that can assume the role	list(string)	[]	no

Outputs

Name	Description
role_arn	IAM role ARN
role_name	IAM role name