Analisador de acesso do IAM da AWS

Neste documento, descrevemos como integrar o AWS IAM Access Analyzer ao Google Security Operations.

Casos de uso

  1. Ingerir descobertas no Google Security Operations para investigação
  2. Ações ativas: atualizar insights, verificar recursos

Configurar a integração do AWS IAM Access Analyzer no Google SecOps

Para instruções detalhadas sobre como configurar uma integração no Google SecOps, consulte Configurar integrações.

Parâmetros de integração

Use os seguintes parâmetros para configurar a integração:

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID da chave de acesso da AWS String N/A Sim ID da chave de acesso da AWS a ser usado na integração.
Chave secreta da AWS Senha N/A Sim Chave secreta da AWS para usar na integração.
Região padrão da AWS String N/A Sim Região padrão da AWS a ser usada na integração, por exemplo, us-west-2.
Nome do analisador String N/A Sim Nome do analisador que deve ser usado na integração.

Ações

Ping

Descrição

Teste a conectividade com o AWS IAM Access Analyzer usando os parâmetros fornecidos na página de configuração de integração na página do Google SecOps Content Hub.

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:
Se for bem-sucedida:mostre "Conexão estabelecida com o servidor do AWS IAM Access Analyzer usando os parâmetros de conexão fornecidos!"

A ação deve falhar e interromper a execução de um playbook:
if not successful: print "Failed to connect to the AWS IAM Access Analyzer server! O erro é {0}".format(exception.stacktrace)

Geral

Verificar recursos

Descrição

Verificar recursos usando o AWS IAM Access Analyzer.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ARNs de recursos CSV N/A Sim Especifique uma lista separada por vírgulas de ARNs de recursos que precisam ser verificados.

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Resultado do JSON
{"ResponseMetadata": {"HTTPHeaders": {"connection": "keep-alive",
    "content-length": "178",
    "content-type": "application/json",
    "date": "Sun, 22 Nov 2020 09:22:03 GMT",
    "x-amz-apigw-id": "WZwVQFICIAMFjnQ=",
    "x-amzn-requestid": "c15d8ab2-afc7-4cb0-bea2-a47ebc649cb8",
    "x-amzn-trace-id": "Root=1-5fba2dbb-042d89bb2964e4f635bd7843"},
"HTTPStatusCode": 200,
"RequestId": "c15d8ab2-afc7-4cb0-bea2-a47ebc649cb8",
"RetryAttempts": 0},
"resource": {"analyzedAt": datetime.datetime(2020, 11, 22, 9, 21, 50, 919000, tzinfo=tzutc()),
"isPublic": False,
"resourceArn": "arn:aws:s3:::asddsa",
"resourceOwnerAccount": "582302349248",
"resourceType": "AWS::S3::Bucket"}}
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se as verificações retornarem com sucesso para pelo menos um (is_success = true): print"Successfully scanned the following resources using AWS IAM Access Analyzer: \n".format(Resource IDs)

Se houver falha em pelo menos um (is_success = true): print"Action wasn't able to scan the following resources using AWS IAM Access Analyzer: \n".format(Resource IDs)

Se falhar para todos (is_success = false): mostre"Nenhum recurso foi verificado".

Mensagem assíncrona:

"Aguardando a verificação dos seguintes recursos usando o AWS IAM Access Analyzer: {0}".format(unprocessed resources)

A ação deve falhar e interromper a execução de um playbook:

Se houver um erro fatal ou do SDK, como credenciais incorretas, falta de conexão com o servidor, entre outros:mostre "Erro ao executar a ação 'Verificar recursos'". Motivo: {0}''.format(error.Stacktrace)

Se o Analyzer não for encontrado:mostre "Erro ao executar a ação 'Verificar recursos'". Motivo: o analisador '{0}' não foi encontrado''.format(Analyzer Name).

Geral

Arquivar descoberta

Arquivar descoberta na Central de segurança do AWS.

Parâmetros

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
ID da descoberta String N/A Sim Especifique o ID da descoberta que você quer arquivar.

Corrida

Essa ação não é executada em entidades.

Resultados da ação

Resultado do script
Nome do resultado do script Opções de valor
is_success is_success=False
is_success is_success=True
Painel de casos
Tipo de resultado Valor / Descrição Tipo
Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se não houver erros gerados pelo SDK (is_success = true): print"Successfully archived finding with ID '{0}' in AWS IAM Access Analyzer".format(Finding ID)

A ação deve falhar e interromper a execução de um playbook:

se houver um erro fatal, um erro do SDK, como credenciais incorretas, falta de conexão com o servidor, entre outros: print "Erro ao executar a ação 'Arquivar descoberta'. Motivo: {0}''.format(error.Stacktrace)

Se o Analyzer não for encontrado:mostre "Erro ao executar a ação 'Arquivar descoberta'". Motivo: o analisador '{0}' não foi encontrado''.format(Analyzer Name).

Geral

Conector

AWS IAM Access Analyzer - Findings Connector

Descrição

Extraia descobertas do AWS IAM Access Analyzer.

Configurar o AWS IAM Access Analyzer - Conector de descobertas no Google SecOps

Para instruções detalhadas sobre como configurar um conector no Google SecOps, consulte Configurar o conector.

Parâmetros do conector

Use os seguintes parâmetros para configurar o conector:

Nome de exibição do parâmetro Tipo Valor padrão É obrigatório Descrição
Nome do campo do produto String Nome do produto Sim Insira o nome do campo de origem para recuperar o nome do campo do produto.
Nome do campo do evento String resourceType Sim Insira o nome do campo de origem para recuperar o nome do campo de evento.
Nome do campo do ambiente String "" Não

Descreve o nome do campo em que o nome do ambiente é armazenado.

Se o campo de ambiente não for encontrado, o ambiente será o padrão.

Padrão Regex do ambiente String .* Não

Um padrão de regex para ser executado no valor encontrado no campo "Nome do campo de ambiente".

O padrão é .* para capturar tudo e retornar o valor inalterado.

Usado para permitir que o usuário manipule o campo de ambiente usando a lógica de regex.

Se o padrão de regex for nulo ou vazio, ou se o valor do ambiente for nulo, o resultado final será o ambiente padrão.

Tempo limite de script (segundos) Inteiro 180 Sim Limite de tempo limite para o processo do Python que executa o script atual.
ID da chave de acesso da AWS String N/A Verdadeiro ID da chave de acesso da AWS a ser usado na integração.
Chave secreta da AWS Senha N/A Verdadeiro Chave secreta da AWS para usar na integração.
Região padrão da AWS String N/A Verdadeiro Região padrão da AWS a ser usada na integração, por exemplo, us-west-2.
Nome do analisador String N/A Verdadeiro Nome do analisador que deve ser usado na integração.
Gravidade do alerta String Média Falso

Gravidade dos alertas do Google SecOps criados com base nesse conector. Valores possíveis:

Crítica, alta, média,baixa,informativa

Máximo de descobertas a serem buscadas Inteiro 50 Não Quantas descobertas serão processadas por iteração do conector.
Máximo de horas para trás Inteiro 1 Não Quantas horas retroceder para buscar descobertas.
Usar a lista de permissões como uma lista de bloqueio Caixa de seleção Desmarcado Sim Se ativada, a lista de permissões será usada como uma lista de bloqueio.
Verificar SSL Caixa de seleção Desmarcado Sim Se ativado, verifique se o certificado SSL para a conexão com o servidor do AWS IAM Access Analyzer é válido.
Endereço do servidor proxy String N/A Não O endereço do servidor proxy a ser usado.
Nome de usuário do proxy String N/A Não O nome de usuário do proxy para autenticação.
Senha do proxy Senha N/A Não A senha do proxy para autenticação.

Regras do conector

Suporte a proxy

O conector é compatível com proxy.

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.