AWS IAM

AWS Identity and Access Management (IAM) é um serviço web que ajuda você a controlar de forma segura o acesso a recursos da AWS. O IAM permite gerenciar permissões que controlam quais recursos da AWS usuários, groups e roles podem acessar.

Com o AWS IAM, você pode:

  • Gerenciar usuários: Criar e gerenciar usuários IAM, atribuir credenciais de segurança individuais e conceder permissões para acessar serviços e recursos da AWS
  • Criar roles: Definir roles IAM com permissões específicas que podem ser assumidas por usuários, serviços ou aplicações para acesso temporário
  • Anexar policies: Atribuir managed policies a usuários e roles para definir quais ações eles podem executar em quais recursos
  • Organizar com groups: Criar groups IAM para gerenciar permissões de coleções de usuários, simplificando a gestão de acesso em escala
  • Controlar access keys: Gerar e gerenciar pares de access keys programáticas para acesso via API e CLI aos serviços da AWS

No Zoen, a integração do AWS IAM permite que seus fluxos de trabalho automatizem tarefas de gestão de identidade, como provisionar novos usuários, atribuir roles e permissões, gerenciar memberships de groups e rotacionar access keys. Isso é particularmente útil para automação de onboarding, fluxos de conformidade de segurança, revisões de acesso e resposta a incidentes — permitindo que seus agentes gerenciem o controle de acesso da AWS de forma programática.

Usage Instructions

Integrate AWS Identity and Access Management into your workflow. Create and manage users, roles, policies, groups, and access keys.

Actions

iam_list_users

List IAM users in your AWS account

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
pathPrefixstringNoPath prefix to filter users (e.g., /division_abc/)
maxItemsnumberNoMaximum number of users to return (1-1000, default 100)
markerstringNoPagination marker from a previous request

Output

ParameterTypeDescription
usersjsonList of IAM users with userName, userId, arn, path, and dates
isTruncatedbooleanWhether there are more results available
markerstringPagination marker for the next page of results
countnumberNumber of users returned

iam_get_user

Get detailed information about an IAM user

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
userNamestringNoThe name of the IAM user to retrieve (defaults to the caller if omitted)

Output

ParameterTypeDescription
userNamestringThe name of the user
userIdstringThe unique ID of the user
arnstringThe ARN of the user
pathstringThe path to the user
createDatestringDate the user was created
passwordLastUsedstringDate the password was last used
permissionsBoundaryArnstringARN of the permissions boundary policy
tagsjsonTags attached to the user (key, value pairs)

iam_create_user

Create a new IAM user

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
userNamestringYesName for the new IAM user (1-64 characters)
pathstringNoPath for the user (e.g., /division_abc/), defaults to /

Output

ParameterTypeDescription
messagestringOperation status message
userNamestringThe name of the created user
userIdstringThe unique ID of the created user
arnstringThe ARN of the created user
pathstringThe path of the created user
createDatestringDate the user was created

iam_delete_user

Delete an IAM user

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
userNamestringYesThe name of the IAM user to delete

Output

ParameterTypeDescription
messagestringOperation status message

iam_list_roles

List IAM roles in your AWS account

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
pathPrefixstringNoPath prefix to filter roles (e.g., /application/)
maxItemsnumberNoMaximum number of roles to return (1-1000, default 100)
markerstringNoPagination marker from a previous request

Output

ParameterTypeDescription
rolesjsonList of IAM roles with roleName, roleId, arn, path, and dates
isTruncatedbooleanWhether there are more results available
markerstringPagination marker for the next page of results
countnumberNumber of roles returned

iam_get_role

Get detailed information about an IAM role

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
roleNamestringYesThe name of the IAM role to retrieve

Output

ParameterTypeDescription
roleNamestringThe name of the role
roleIdstringThe unique ID of the role
arnstringThe ARN of the role
pathstringThe path to the role
createDatestringDate the role was created
descriptionstringDescription of the role
maxSessionDurationnumberMaximum session duration in seconds
assumeRolePolicyDocumentstringThe trust policy document (JSON)
roleLastUsedDatestringDate the role was last used
roleLastUsedRegionstringAWS region where the role was last used

iam_create_role

Create a new IAM role with a trust policy

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
roleNamestringYesName for the new IAM role (1-64 characters)
assumeRolePolicyDocumentstringYesTrust policy JSON specifying who can assume this role
descriptionstringNoDescription of the role
pathstringNoPath for the role (e.g., /application/), defaults to /
maxSessionDurationnumberNoMaximum session duration in seconds (3600-43200, default 3600)

Output

ParameterTypeDescription
messagestringOperation status message
roleNamestringThe name of the created role
roleIdstringThe unique ID of the created role
arnstringThe ARN of the created role
pathstringThe path of the created role
createDatestringDate the role was created

iam_delete_role

Delete an IAM role

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
roleNamestringYesThe name of the IAM role to delete

Output

ParameterTypeDescription
messagestringOperation status message

iam_attach_user_policy

Attach a managed policy to an IAM user

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
userNamestringYesThe name of the IAM user
policyArnstringYesThe ARN of the managed policy to attach

Output

ParameterTypeDescription
messagestringOperation status message

iam_detach_user_policy

Remove a managed policy from an IAM user

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
userNamestringYesThe name of the IAM user
policyArnstringYesThe ARN of the managed policy to detach

Output

ParameterTypeDescription
messagestringOperation status message

iam_attach_role_policy

Attach a managed policy to an IAM role

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
roleNamestringYesThe name of the IAM role
policyArnstringYesThe ARN of the managed policy to attach

Output

ParameterTypeDescription
messagestringOperation status message

iam_detach_role_policy

Remove a managed policy from an IAM role

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
roleNamestringYesThe name of the IAM role
policyArnstringYesThe ARN of the managed policy to detach

Output

ParameterTypeDescription
messagestringOperation status message

iam_list_policies

List managed IAM policies

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
scopestringNoFilter by scope: All, AWS (AWS-managed), or Local (customer-managed)
onlyAttachedbooleanNoIf true, only return policies attached to an entity
pathPrefixstringNoPath prefix to filter policies
maxItemsnumberNoMaximum number of policies to return (1-1000, default 100)
markerstringNoPagination marker from a previous request

Output

ParameterTypeDescription
policiesjsonList of policies with policyName, arn, attachmentCount, and dates
isTruncatedbooleanWhether there are more results available
markerstringPagination marker for the next page of results
countnumberNumber of policies returned

iam_create_access_key

Create a new access key pair for an IAM user

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
userNamestringNoThe IAM user to create the key for (defaults to current user)

Output

ParameterTypeDescription
messagestringOperation status message
accessKeyIdstringThe new access key ID
secretAccessKeystringThe new secret access key (only shown once)
userNamestringThe user the key was created for
statusstringStatus of the access key (Active)
createDatestringDate the key was created

iam_delete_access_key

Delete an access key pair for an IAM user

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
accessKeyIdToDeletestringYesThe access key ID to delete
userNamestringNoThe IAM user whose key to delete (defaults to current user)

Output

ParameterTypeDescription
messagestringOperation status message

iam_list_groups

List IAM groups in your AWS account

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
pathPrefixstringNoPath prefix to filter groups
maxItemsnumberNoMaximum number of groups to return (1-1000, default 100)
markerstringNoPagination marker from a previous request

Output

ParameterTypeDescription
groupsjsonList of IAM groups with groupName, groupId, arn, and path
isTruncatedbooleanWhether there are more results available
markerstringPagination marker for the next page of results
countnumberNumber of groups returned

iam_add_user_to_group

Add an IAM user to a group

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
userNamestringYesThe name of the IAM user
groupNamestringYesThe name of the IAM group

Output

ParameterTypeDescription
messagestringOperation status message

iam_remove_user_from_group

Remove an IAM user from a group

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
userNamestringYesThe name of the IAM user
groupNamestringYesThe name of the IAM group

Output

ParameterTypeDescription
messagestringOperation status message

iam_list_attached_role_policies

List all managed policies attached to an IAM role

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
roleNamestringYesName of the IAM role
pathPrefixstringNoPath prefix to filter policies (e.g., /application/)
maxItemsnumberNoMaximum number of policies to return (1-1000)
markerstringNoPagination marker from a previous request

Output

ParameterTypeDescription
attachedPoliciesjsonList of attached policies with policyName and policyArn
isTruncatedbooleanWhether there are more results available
markerstringPagination marker for the next page of results
countnumberNumber of attached policies returned

iam_list_attached_user_policies

List all managed policies attached to an IAM user

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
userNamestringYesName of the IAM user
pathPrefixstringNoPath prefix to filter policies (e.g., /application/)
maxItemsnumberNoMaximum number of policies to return (1-1000)
markerstringNoPagination marker from a previous request

Output

ParameterTypeDescription
attachedPoliciesjsonList of attached policies with policyName and policyArn
isTruncatedbooleanWhether there are more results available
markerstringPagination marker for the next page of results
countnumberNumber of attached policies returned

iam_simulate_principal_policy

Simulate whether a user, role, or group is allowed to perform specific AWS actions — useful for pre-flight access checks

Input

ParameterTypeRequiredDescription
regionstringYesAWS region (e.g., us-east-1)
accessKeyIdstringYesAWS access key ID
secretAccessKeystringYesAWS secret access key
policySourceArnstringYesARN of the user, group, or role to simulate (e.g., arn:aws:iam::123456789012:user/alice)
actionNamesstringYesComma-separated list of AWS actions to simulate (e.g., s3:GetObject,ec2:DescribeInstances)
resourceArnsstringNoComma-separated list of resource ARNs to simulate against (defaults to * if not provided)
maxResultsnumberNoMaximum number of simulation results to return (1-1000)
markerstringNoPagination marker from a previous request

Output

ParameterTypeDescription
evaluationResultsjsonSimulation results per action: evalActionName, evalResourceName, evalDecision (allowed/explicitDeny/implicitDeny), matchedStatements (sourcePolicyId, sourcePolicyType), missingContextValues
isTruncatedbooleanWhether there are more results available
markerstringPagination marker for the next page of results
countnumberNumber of evaluation results returned

On this page