Coletar registros do IAM da AWS

Versão do analisador: 1.0

Compatível com:

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

  1. Acesse Configurações > Gerenciamento de dados > Feeds. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Feeds.
  2. Clique em Adicionar novo feed.
  3. 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.

  1. Crie um usuário seguindo as instruções neste guia: Como criar um usuário do IAM.
  2. Selecione o Usuário criado.
  3. Selecione a guia Credenciais de segurança.
  4. Clique em Criar chave de acesso na seção Chaves de acesso.
  5. Selecione Serviço de terceiros como Caso de uso.
  6. Clique em Próxima.
    • Opcional: adicione uma tag de descrição.
  7. Clique em Criar chave de acesso.
  8. 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.
  9. Clique em Concluído.
  10. Selecione a guia Permissões.
  11. Clique em Adicionar permissões na seção Políticas de permissões.
  12. Selecione Adicionar permissões.
  13. Selecione Anexar políticas diretamente.
  14. Pesquise IAMReadOnlyAccess (política gerenciada da AWS).
  15. Selecione a política.
  16. Clique em Próxima.
  17. Clique em Adicionar permissões

Importante: a política IAMReadOnlyAccess inclui todas as permissões necessárias:

  • iam:GetUser
  • iam:ListUsers
  • iam:GetGroup
  • iam:ListGroups
  • iam:GetPolicy
  • iam:ListPolicies
  • iam:GetRole
  • iam:ListRoles
  • iam:ListAttachedUserPolicies
  • iam:ListAttachedGroupPolicies
  • iam:ListAttachedRolePolicies
  • iam: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:

  1. No console da AWS, acesse IAM > Políticas > Criar política > guia JSON.
  2. 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": "*"
        }
      ]
    }
    
  3. Clique em Próxima.

  4. Nomeie a política como chronicle-iam-api-read-policy.

  5. Clique em Criar política.

  6. Crie um usuário seguindo as instruções neste guia: Como criar um usuário do IAM.

  7. Selecione o Usuário criado.

  8. Selecione a guia Credenciais de segurança.

  9. Clique em Criar chave de acesso na seção Chaves de acesso.

  10. Selecione Serviço de terceiros como Caso de uso.

  11. Clique em Próxima.

    • Opcional: adicione uma tag de descrição.
  12. Clique em Criar chave de acesso.

  13. 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.

  14. Clique em Concluído.

  15. Selecione a guia Permissões.

  16. Clique em Adicionar permissões na seção Políticas de permissões.

  17. Selecione Adicionar permissões.

  18. Selecione Anexar políticas diretamente.

  19. Pesquise e selecione chronicle-iam-api-read-policy.

  20. Clique em Próxima.

  21. 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.

  1. Acesse Hub de conteúdo > Pacotes de conteúdo > Comece já.
  2. Clique no pacote Amazon Cloud Platform.
  3. Encontre o tipo de registro AWS IAM na lista.
  4. Selecione API de terceiros no menu suspenso Tipo de origem.
  5. 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.
  6. 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

  1. Acesse Configurações > Gerenciamento de dados > Feeds. Se você estiver em uma plataforma somente SIEM, acesse Configurações > Feeds.
  2. Clique em Adicionar novo feed.
  3. Na página seguinte, clique em Configurar um único feed.
  4. No campo Nome do feed, insira um nome para o feed (por exemplo, AWS IAM API Configuration).
  5. Selecione API de terceiros como o Tipo de origem.
  6. Selecione AWS IAM como o Tipo de registro.
  7. Clique em Próxima.
  8. 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.
  9. Clique em Próxima.
  10. 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.