Coletar registros do IAM da AWS
Versão do analisador: 1.0
Neste documento, explicamos como ingerir dados de configuração do AWS Identity and Access Management (IAM) no Google Security Operations usando o feed da API de terceiros.
O analisador do IAM da AWS transforma os dados da entidade do IAM (usuários, grupos, papéis e políticas) no Modelo de Dados Unificado (UDM) estruturado, extraindo campos como detalhes do usuário, informações de papéis, permissões e carimbos de data/hora para uma análise de segurança consistente.
Antes de começar
Verifique se você tem os pré-requisitos a seguir:
- Uma instância do Google SecOps
- Acesso privilegiado ao console da AWS
- Permissões para criar usuários e políticas do IAM
Acessar intervalos de IP do Google SecOps
- Acesse Configurações > Gerenciamento de dados > Feeds. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Feeds.
- Clique em Adicionar novo feed.
- Anote os intervalos de IP mostrados na parte de cima da página.
- Como alternativa, recupere os intervalos de IP de forma programática usando a API Feed Management.
Criar um usuário do IAM com as permissões necessárias
CRÍTICO: para permitir que o Google SecOps recupere dados do IAM da AWS usando a API, crie um usuário do IAM com as permissões de leitura adequadas.
Opção A: usar uma política gerenciada da AWS (recomendado)
- Crie um usuário seguindo as instruções neste guia: Como criar um usuário do IAM.
- Selecione o Usuário criado.
- Selecione a guia Credenciais de segurança.
- Clique em Criar chave de acesso na seção Chaves de acesso.
- Selecione Serviço de terceiros como Caso de uso.
- Clique em Próxima.
- Opcional: adicione uma tag de descrição.
- Clique em Criar chave de acesso.
- Clique em Fazer o download do arquivo .csv para salvar o ID da chave de acesso e a chave de acesso secreta para referência futura.
- Clique em Concluído.
- Selecione a guia Permissões.
- Clique em Adicionar permissões na seção Políticas de permissões.
- Selecione Adicionar permissões.
- Selecione Anexar políticas diretamente.
- Pesquise IAMReadOnlyAccess (política gerenciada da AWS).
- Selecione a política.
- Clique em Próxima.
- Clique em Adicionar permissões
Importante: a política IAMReadOnlyAccess inclui todas as permissões necessárias:
iam:GetUseriam:ListUsersiam:GetGroupiam:ListGroupsiam:GetPolicyiam:ListPoliciesiam:GetRoleiam:ListRolesiam:ListAttachedUserPoliciesiam:ListAttachedGroupPoliciesiam:ListAttachedRolePoliciesiam:GetAccountSummary
Opção B: criar uma política personalizada (privilégio mínimo)
Se a política de segurança exigir permissões mínimas em vez da política gerenciada:
- No console da AWS, acesse IAM > Políticas > Criar política > guia JSON.
Cole a seguinte política:
{ "Version": "2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "iam:GetUser", "iam:ListUsers", "iam:GetGroup", "iam:ListGroups", "iam:GetPolicy", "iam:ListPolicies", "iam:GetRole", "iam:ListRoles", "iam:ListAttachedUserPolicies", "iam:ListAttachedGroupPolicies", "iam:ListAttachedRolePolicies", "iam:GetAccountSummary" ], "Resource": "*" } ] }Clique em Próxima.
Nomeie a política como
chronicle-iam-api-read-policy.Clique em Criar política.
Crie um usuário seguindo as instruções neste guia: Como criar um usuário do IAM.
Selecione o Usuário criado.
Selecione a guia Credenciais de segurança.
Clique em Criar chave de acesso na seção Chaves de acesso.
Selecione Serviço de terceiros como Caso de uso.
Clique em Próxima.
- Opcional: adicione uma tag de descrição.
Clique em Criar chave de acesso.
Clique em Fazer o download do arquivo .csv para salvar o ID da chave de acesso e a chave de acesso secreta para referência futura.
Clique em Concluído.
Selecione a guia Permissões.
Clique em Adicionar permissões na seção Políticas de permissões.
Selecione Adicionar permissões.
Selecione Anexar políticas diretamente.
Pesquise e selecione
chronicle-iam-api-read-policy.Clique em Próxima.
Clique em Adicionar permissões
Configurar um feed no Google SecOps para ingerir dados de configuração do IAM
O feed do IAM da AWS coleta uma lista de entidades do IAM por feed, selecionada pelo campo Tipo de API (Usuários, Papéis ou Grupos). Para coletar todas as entidades do IAM, crie um feed para cada tipo de API, todos usando o tipo de registro AWS IAM.
Usar o Content Hub (recomendado)
- Acesse Hub de conteúdo > Pacotes de conteúdo > Comece já.
- Clique no pacote Amazon Cloud Platform.
- Encontre o tipo de registro AWS IAM na lista.
- Selecione API de terceiros no menu suspenso Tipo de origem.
- Informe os seguintes detalhes de configuração:
- Nome de usuário: o ID da chave de acesso do usuário do IAM criado anteriormente.
- Secret: a chave de acesso do secret do usuário do IAM criado anteriormente.
- Tipo de API: selecione a lista de entidades do IAM que será coletada: Usuários, Papéis ou Grupos.
- Nome do feed: um valor preenchido automaticamente que identifica o feed (por exemplo,
AWS IAM Users). - Namespace do recurso: namespace associado ao feed.
- Rótulos de ingestão: rótulos aplicados a todos os eventos desse feed.
- Clique em Criar feed.
Para mais informações sobre como configurar vários feeds para diferentes tipos de registro nessa família de produtos, consulte Configurar feeds por produto.
Usar as configurações do SIEM
- Acesse Configurações > Gerenciamento de dados > Feeds. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Feeds.
- Clique em Adicionar novo feed.
- Na página seguinte, clique em Configurar um único feed.
- No campo Nome do feed, insira um nome para o feed (por exemplo,
AWS IAM API Configuration). - Selecione API de terceiros como o Tipo de origem.
- Selecione AWS IAM como o Tipo de registro.
- Clique em Próxima.
- Especifique valores para os seguintes parâmetros de entrada:
- Nome de usuário: o ID da chave de acesso do usuário do IAM criado anteriormente.
- Secret: a chave de acesso do secret do usuário do IAM criado anteriormente.
- Tipo de API: selecione a lista de entidades do IAM que será coletada: Usuários, Papéis ou Grupos.
- Namespace do recurso: o namespace do recurso.
- Rótulos de ingestão: o rótulo a ser aplicado aos eventos desse feed.
- Clique em Próxima.
- Revise a configuração do novo feed na tela Finalizar e clique em Enviar.
Tabela de mapeamento de UDM
| Campo de registro | Mapeamento de UDM | Lógica |
|---|---|---|
Group.CreateDate |
entity.group.attribute.creation_time |
Analisado como ISO8601 |
Group.Path |
entity.group.attribute.labels.value |
Mapeado diretamente |
IsTruncated |
entity.group.attribute.labels.value |
Mapeado diretamente |
Marker |
entity.group.attribute.labels.value |
Mapeado diretamente |
Group.GroupName |
entity.group.email_addresses |
Mesclado |
Group.GroupName |
entity.group.group_display_name |
Mapeado diretamente |
Group.GroupID |
entity.group.product_object_id |
Mapeado diretamente |
RoleLastUsed.Region |
entity.location.name |
Mapeado diretamente |
CreateDate |
entity.resource.attribute.creation_time |
Analisado como ISO8601 |
MaxSessionDuration |
entity.resource.attribute.labels.value |
Mapeado diretamente |
Path |
entity.resource.attribute.labels.value |
Mapeado diretamente |
RoleLastUsed.LastUsedDate |
entity.resource.attribute.labels.value |
Mapeado diretamente |
AssumeRolePolicyDocument |
entity.resource.attribute.permissions.name |
Mapeado diretamente |
Description |
entity.resource.attribute.roles.description |
Mapeado diretamente |
RoleName |
entity.resource.attribute.roles.name |
Mapeado diretamente |
Arn |
entity.resource.name |
Mapeado diretamente |
Group.Arn |
entity.resource.name |
Mapeado diretamente |
RoleID |
entity.resource.product_object_id |
Mapeado diretamente |
CreateDate |
entity.user.attribute.creation_time |
Analisado como ISO8601 |
PasswordLastUsed |
entity.user.last_login_time |
Analisado como ISO8601 |
UserID |
entity.user.product_object_id |
Mapeado diretamente |
UserName |
entity.user.userid |
Mapeado diretamente |
PermissionsBoundary.PermissionsBoundaryArn |
relations.entity.resource.attribute.labels.value |
Mapeado diretamente |
PermissionsBoundary.PermissionsBoundaryType |
relations.entity.resource.attribute.labels.value |
Mapeado diretamente |
user.PermissionsBoundary.PermissionsBoundaryArn |
relations.entity.resource.attribute.labels.value |
Mapeado diretamente |
user.PermissionsBoundary.PermissionsBoundaryType |
relations.entity.resource.attribute.labels.value |
Mapeado diretamente |
user.Arn |
relations.entity.resource.name |
Mapeado diretamente |
user.CreateDate |
relations.entity.user.attribute.creation_time |
Analisado como ISO8601 |
tag.Key |
relations.entity.user.attribute.labels.key |
Mapeado diretamente |
Path |
relations.entity.user.attribute.labels.value |
Mapeado diretamente |
tag.Value |
relations.entity.user.attribute.labels.value |
Mapeado diretamente |
user.Path |
relations.entity.user.attribute.labels.value |
Mapeado diretamente |
user.PasswordLastUsed |
relations.entity.user.last_login_time |
Analisado como ISO8601 |
user.UserID |
relations.entity.user.product_object_id |
Mapeado diretamente |
user.UserName |
relations.entity.user.userid |
Mapeado diretamente |
| N/A | entity.group.attribute.labels.key |
Constante: is_truncated |
| N/A | entity.resource.attribute.cloud.environment |
Constante: AMAZON_WEB_SERVICES |
| N/A | entity.resource.attribute.labels.key |
Constante: max_session_duration |
| N/A | entity.resource.resource_subtype |
Constante: User |
| N/A | entity.resource.resource_type |
Constante: ACCESS_POLICY |
| N/A | metadata.entity_type |
Constante: USER |
| N/A | metadata.product_name |
Constante: AWS IAM |
| N/A | metadata.vendor_name |
Constante: AWS |
| N/A | relations.direction |
Constante: UNIDIRECTIONAL |
| N/A | relations.entity.resource.attribute.labels.key |
Constante: permissions_boundary_arn |
| N/A | relations.entity.resource.resource_subtype |
Constante: User |
| N/A | relations.entity.user.attribute.labels.key |
Constante: path |
| N/A | relations.entity_type |
Constante: USER |
| N/A | relations.relationship |
Constante: MEMBER |
Registro de alterações
Confira o registro de alterações deste analisador
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.