Integrar o Akeyless ao Google SecOps

Este documento explica como integrar o Akeyless ao Google Security Operations.

Casos de uso

A integração do Akeyless usa os recursos do Google SecOps para oferecer suporte aos seguintes casos de uso:

  • Sincronizar credenciais de integração: atualize automaticamente as credenciais e os parâmetros sensíveis em instâncias, conectores e jobs de integração do Google SecOps usando segredos armazenados no Akeyless.

  • Recuperar secrets em playbooks: busque secrets estáticos ou versões de secrets específicas do Akeyless sob demanda durante a execução do playbook para autenticação com serviços externos.

  • Automatizar a rotação de credenciais: propague chaves de API, tokens e senhas rotacionados do Akeyless para integrações, conectores e jobs do Google SecOps mapeando parâmetros para a versão secreta latest, evitando interrupções causadas por credenciais expiradas.

  • Controlar as atualizações de credenciais com a fixação de versão: fixe os parâmetros de integração, conector ou job em uma versão de secret específica no Akeyless para validar as mudanças de credenciais ou reverter para uma versão anterior, quando necessário.

  • Elimine secrets codificados em fluxos de trabalho: centralizar credenciais sensíveis no Akeyless em vez de incorporá-las diretamente em entradas de playbook ou scripts personalizados, reduzindo a exposição de credenciais em fluxos de trabalho do SOC.

Antes de começar

Antes de configurar a integração na plataforma do Google SecOps, verifique se você tem o seguinte:

  • Credenciais de chave de API: um ID de acesso e uma chave de acesso do Akeyless para autenticação.

    Para mais informações, consulte Autenticação de chave de API do Akeyless.

  • Permissões de acesso: permissões de leitura concedidas ao método de autenticação para os secrets que o Google SecOps recupera.

    Para mais informações, consulte Controle de acesso baseado em papéis (RBAC) do Akeyless.

  • Conectividade de rede: acesso à rede da sua instância do Google SecOps ou do agente remoto ao URL do gateway de API do Akeyless.

Parâmetros de integração

A integração do Akeyless requer os seguintes parâmetros:

Parâmetro Descrição
API Gateway URL

Opcional.

O URL do gateway de API do Akeyless.

O valor padrão é https://api.akeyless.io.
Access ID

Obrigatório.

O ID de acesso do método de autenticação da chave de API do Akeyless.
Access Key

Obrigatório.

A chave de acesso associada ao ID de acesso do Akeyless.
Verify SSL

Obrigatório.

Se selecionada, a integração valida o certificado SSL ao se conectar ao servidor Akeyless.

Ativado por padrão.

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

Você pode fazer mudanças depois, se necessário. Depois de configurar uma instância de integração, é possível usá-la em playbooks. Para mais informações sobre como configurar e oferecer suporte a várias instâncias, consulte Como oferecer suporte a várias instâncias.

Ações

Para mais informações sobre ações, consulte Responder a ações pendentes na Sua Área de Trabalho e Realizar uma ação manual.

Receber valor do secret

Use a ação Get Secret Value para recuperar um valor de secret do Akeyless para uso em playbooks.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

A ação Get Secret Value requer os seguintes parâmetros:

Parâmetro Descrição
Secret Name

Obrigatório.

O nome ou caminho do secret a ser recuperado do Akeyless.

Para recuperar a versão mais recente, digite SECRET_NAME ou SECRET_NAME:latest.

Para recuperar uma versão específica, insira SECRET_NAME:VERSION_NUMBER, em que VERSION_NUMBER é um número inteiro positivo (por exemplo, /prod/api-key:2).

Saídas da ação

A ação Get Secret Value fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Get Secret Value:

{
  "secret_name": "/secops/integrations/example-api-key",
  "version": "latest",
  "secret_value": "EXAMPLE_SECRET_VALUE"
}
Mensagens de saída

No Case Wall, a ação Get Secret Value fornece as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem
Successfully retrieved secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. A ação foi concluída.
Failed to retrieve secret 'SECRET_NAME' (version: 'SECRET_VERSION') from Akeyless Security. Reason: ERROR_REASON

A ação falhou.

Verifique se o caminho e a versão do secret existem no Akeyless e se as credenciais de autenticação têm acesso de leitura ao secret.
Error executing action 'Get Secret Value'. Reason: Invalid credential mapping format for value 'SECRET_NAME'. Expected format: 'secret_name' or 'secret_name:version' (where version is a positive integer or 'latest').

A ação falhou.

Verifique o formato do parâmetro Secret Name.
Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Get Secret Value:

Nome do resultado do script Valor
is_success true ou false

Ping

Use a ação Ping para testar a conectividade com o servidor Akeyless.

Essa ação não é executada em entidades do Google SecOps.

Entradas da ação

Nenhuma.

Saídas da ação

A ação Ping fornece as seguintes saídas:

Tipo de saída da ação Disponibilidade
Anexo do Painel de Casos Indisponível
Link do Painel de Casos Indisponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento Indisponível
Resultado JSON Indisponível
Mensagens de saída Disponível
Resultado do script Disponível
Mensagens de saída

No Painel de casos, a ação Ping fornece as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem
Successfully connected to the Akeyless server with the provided connection parameters! A ação foi concluída.
Failed to connect to the Akeyless server! Reason: ERROR_REASON

A ação falhou.

Verifique as configurações de API Gateway URL, Access ID, Access Key e SSL.
Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Ping:

Nome do resultado do script Valor
is_success true ou false

Jobs

Para mais informações sobre jobs, consulte Configurar um novo job e Programação avançada.

Job de sincronização de credenciais de integração

Use o Job de sincronização de credenciais de integração para sincronizar automaticamente os segredos armazenados no Akeyless com as instâncias, os conectores e os jobs de integração do Google SecOps configurados.

Parâmetros do job

O job de sincronização de credenciais de integração requer os seguintes parâmetros:

Parâmetro Descrição
API Gateway URL

Opcional.

O URL do gateway de API do Akeyless.

O valor padrão é https://api.akeyless.io.
Access ID

Obrigatório.

O ID de acesso do método de autenticação da chave de API do Akeyless.
Access Key

Obrigatório.

A chave de acesso associada ao ID de acesso do Akeyless.
Verify SSL

Obrigatório.

Se selecionada, a integração valida o certificado SSL ao se conectar ao servidor Akeyless.

Ativado por padrão.
Environment Name

Obrigatório.

O ambiente do Google SecOps em que as instâncias de integração, os conectores e os jobs de destino são configurados.

O valor padrão é Default Environment.
Credential Mapping

Obrigatório.

Um dicionário JSON ou YAML que mapeia instâncias de integração de destino, conectores e jobs para os secrets do Akeyless que contêm os valores de parâmetro.

Inclua pelo menos um parâmetro mapeado nas chaves integration_instances, connectors ou jobs.

Para ver um exemplo, consulte Exemplo de Credential Mapping.

O valor padrão é {"integration_instances": {"Integration_Instance_Name": {"Parameter_Name": "Secret_Name"}}}.

Exemplo de Credential Mapping

O exemplo a seguir mostra como mapear parâmetros para instâncias de integração, conectores e jobs no parâmetro Credential Mapping:

{
  "integration_instances": {
    "VirusTotal_Prod": {
      "API Key": "/secops/prod/virustotal-api-key"
    },
    "Jira_Instance_1": {
      "API Token": "/secops/prod/jira-api-token:2"
    }
  },
  "connectors": {
    "CrowdStrike Falcon Alerts Connector": {
      "Client Secret": "/secops/prod/crowdstrike-client-secret:latest"
    }
  },
  "jobs": {
    "ServiceNow Sync Closed Cases": {
      "Password": "/secops/prod/servicenow-password:1"
    }
  }
}

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