Integrar o AlgoSec ao Google SecOps

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

Casos de uso

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

  • Contenção automatizada de ameaças: bloqueie endereços IP mal-intencionados em firewalls gerenciados enviando solicitações automatizadas de alteração de tráfego de descarte durante investigações de segurança.

  • Autorização de tráfego controlado: permita o tráfego comercial legítimo para endereços IP de destino verificados criando regras de permissão padronizadas no AlgoSec FireFlow.

  • Descoberta e governança de modelos: recupere os modelos de solicitação de mudança do FireFlow disponíveis para alinhar as ações de resposta automatizadas com as políticas de gerenciamento de mudanças organizacionais.

  • Rastreamento do ciclo de vida de mudanças assíncronas: monitorar as solicitações de mudança de tráfego enviadas até que elas atinjam os status de funcionamento de destino, como resolvidas ou implementadas.

Antes de começar

Antes de configurar a integração do AlgoSec no Google SecOps, verifique se o ambiente atende aos seguintes requisitos:

  • Conectividade de rede: verifique se o Google SecOps (ou um agente remoto implantado para ambientes locais) pode acessar o servidor do AlgoSec por HTTPS na porta TCP 443.

  • Modelos do FireFlow: ative pelo menos um modelo de solicitação de mudança de tráfego (como Standard) no AlgoSec FireFlow antes de executar ações que enviam solicitações de mudança.

  • Permissões de usuário com privilégio mínimo: configure uma conta de serviço dedicada do AlgoSec FireFlow com as permissões mínimas necessárias para as ações usadas nos playbooks, conforme detalhado na tabela a seguir:

Ação Permissões necessárias do AlgoSec FireFlow
Allow IP Autenticar com o FireFlow, criar solicitações de alteração de tráfego para regras de permissão e ler detalhes de solicitações de alteração de tráfego.
Block IP Autenticar com o FireFlow, criar solicitações de mudança de tráfego para regras de descarte e ler detalhes de solicitações de mudança de tráfego.
List Templates Autentique-se no FireFlow e confira os modelos de solicitação de mudança disponíveis.
Ping Autentique-se com o FireFlow e confira os modelos de solicitação de mudança disponíveis para validar a conectividade.
Wait for Change Request Status Update Autenticar com o FireFlow e ler os detalhes da solicitação de mudança de tráfego e os status do ciclo de vida.

Para mais informações sobre como configurar papéis, contas de usuário e modelos de solicitação de mudança do FireFlow, consulte a documentação oficial do AlgoSec FireFlow.

Parâmetros de integração

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

Parâmetro Descrição
API Root

Obrigatório.

O URL de base do servidor AlgoSec, formatado como https://SERVER_ADDRESS.

Username

Obrigatório.

O nome de usuário da conta do AlgoSec FireFlow usada para autenticação.

Password

Obrigatório.

A senha da conta do AlgoSec FireFlow usada para autenticação.

Verify SSL

Obrigatório.

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

Ativado por padrão.

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

Se necessário, você pode fazer mudanças depois. 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 mesa de trabalho e Executar uma ação manual no seu caso.

Permitir IP

Use a ação Permitir IP para enviar uma solicitação de mudança de tráfego no AlgoSec FireFlow que permita o tráfego para as entidades IP Address do caso (usadas como endereços de destino).

Essa ação é executada na entidade IP Address do Google SecOps.

Entradas da ação

A ação Permitir IP requer os seguintes parâmetros:

Parâmetro Descrição
Template

Obrigatório.

O nome do modelo do AlgoSec FireFlow a ser usado para a solicitação de alteração de tráfego.

O valor padrão é Standard.

Source

Obrigatório.

Uma lista separada por vírgulas de endereços IP de origem ou objetos de rede para a regra de permissão ou a palavra-chave all para incluir todas as origens. A ação converte todos os valores em minúsculas.

O valor padrão é all.

Service

Obrigatório.

Uma lista separada por vírgulas de serviços de rede a serem permitidos, formatada como pares de protocolo e porta, como tcp/80, ou a palavra-chave all para permitir todos os serviços.

O valor padrão é ALL.

Subject

Opcional.

Uma linha de assunto para a solicitação de mudança de tráfego no AlgoSec FireFlow.

O valor padrão é Siemplify Allow IP request.

Owner

Opcional.

Um nome de usuário ou identificador do usuário que é proprietário da solicitação de mudança.

Se você não fornecer um valor, o AlgoSec vai atribuir o usuário autenticado que criou o tíquete como proprietário.

Due Date

Opcional.

Uma data e hora de conclusão pretendida para a solicitação de mudança no formato ISO 8601, como 2021-08-13T08:16:10Z.

Expiration Date

Opcional.

Uma data e hora de validade para a regra de tráfego permitido no formato ISO 8601, como 2021-08-13T08:16:10Z.

Custom Fields

Opcional.

Campos adicionais de solicitação de mudança do FireFlow fornecidos como pares de chave-valor, como {"Owner": "admin@example.com", "Subject": "Allow IP request"}.

Se fornecido, esse parâmetro substitui os parâmetros Subject, Owner, Due Date e Expiration Date.

Saídas da ação

A ação Permitir IP 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 Disponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento de entidades Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível

A ação Permitir IP fornece o seguinte link no Painel de Casos:

  • Título do link: Change Request Link

  • Destino do link: abre a solicitação de mudança de tráfego criada na interface da Web do AlgoSec FireFlow.

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Permitir IP:

{
    "status": "Success",
    "messages": [],
    "data": {
        "id": 10,
        "fields": [
            {
                "name": "Owner",
                "values": [
                    "admin@example.com"
                ]
            },
            {
                "name": "Creator",
                "values": [
                    "admin@example.com"
                ]
            },
            {
                "name": "Due",
                "values": [
                    "2021-08-31 00:00:00"
                ]
            },
            {
                "name": "LastUpdated",
                "values": [
                    "2021-08-13 12:31:23"
                ]
            },
            {
                "name": "Requestor",
                "values": [
                    "admin@example.com"
                ]
            }
        ],
        "originalTraffic": [
            {
                "source": {
                    "items": [
                        {
                            "value": "all"
                        }
                    ]
                },
                "destination": {
                    "items": [
                        {
                            "value": "192.0.2.3"
                        }
                    ]
                },
                "service": {
                    "items": [
                        {
                            "value": "ALL"
                        }
                    ]
                },
                "application": {
                    "items": [
                        {
                            "value": "any"
                        }
                    ]
                },
                "user": {
                    "items": [
                        {
                            "value": "any"
                        }
                    ]
                },
                "action": "Allow"
            }
        ],
        "plannedTraffic": [
            {
                "source": {
                    "items": [
                        {
                            "value": "0.0.0.0-255.255.255.255"
                        }
                    ]
                },
                "destination": {
                    "items": [
                        {
                            "value": "192.0.2.3"
                        }
                    ]
                },
                "service": {
                    "items": [
                        {
                            "value": "tcp/*"
                        },
                        {
                            "value": "udp/*"
                        },
                        {
                            "value": "ospf"
                        },
                        {
                            "value": "icmp/*"
                        },
                        {
                            "value": "gre"
                        },
                        {
                            "value": "ipsec_50"
                        },
                        {
                            "value": "ipsec_51"
                        }
                    ]
                },
                "application": {
                    "items": [
                        {
                            "value": "any"
                        }
                    ]
                },
                "user": {
                    "items": [
                        {
                            "value": "any"
                        }
                    ]
                },
                "action": "Allow"
            }
        ]
    }
}
Mensagens de saída

A ação Permitir IP fornece as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem
Successfully created a traffic change request to allow traffic to the provided entities in AlgoSec A ação foi concluída.
Error executing action AlgoSec - Allow IP. Reason: ERROR_REASON

Falha na ação.

Verifique se o URL e as credenciais do servidor do AlgoSec são válidos, confirme se o nome do modelo especificado existe no FireFlow, formate os parâmetros de data no formato ISO 8601 e formate todos os campos personalizados como pares de chave-valor válidos.

Resultado do script

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

Nome do resultado do script Valor
is_success true ou false

Bloquear IP

Use a ação Bloquear IP para enviar uma solicitação de mudança de tráfego no AlgoSec FireFlow que bloqueia o tráfego para as entidades IP Address do caso (usadas como endereços de destino).

Essa ação é executada na entidade IP Address do Google SecOps.

Entradas da ação

A ação Bloquear IP requer os seguintes parâmetros:

Parâmetro Descrição
Template

Obrigatório.

O nome do modelo do AlgoSec FireFlow a ser usado para a solicitação de alteração de tráfego.

O valor padrão é Standard.

Source

Obrigatório.

Uma lista separada por vírgulas de endereços IP de origem ou objetos de rede para a regra de bloqueio ou a palavra-chave all para incluir todas as origens. A ação converte todos os valores em minúsculas.

O valor padrão é all.

Service

Obrigatório.

Uma lista separada por vírgulas de serviços de rede a serem bloqueados, formatada como pares de protocolo e porta, como tcp/80, ou a palavra-chave all para bloquear todos os serviços.

O valor padrão é ALL.

Subject

Opcional.

Uma linha de assunto para a solicitação de mudança de tráfego no AlgoSec FireFlow.

O valor padrão é Siemplify Block IP request.

Owner

Opcional.

Um nome de usuário ou identificador do usuário que é proprietário da solicitação de mudança. Se você omitir esse parâmetro, o AlgoSec vai atribuir o usuário autenticado que criou o tíquete como proprietário.

Due Date

Opcional.

Uma data e hora de conclusão pretendida para a solicitação de mudança no formato ISO 8601, como 2021-08-13T08:16:10Z.

Expiration Date

Opcional.

Uma data e hora de validade para a regra de tráfego bloqueado no formato ISO 8601, como 2021-08-13T08:16:10Z.

Custom Fields

Opcional.

Campos adicionais de solicitação de mudança do FireFlow fornecidos como pares de chave-valor, como {"Owner": "admin@example.com", "Subject": "Block IP request"}.

Se fornecido, esse parâmetro substitui os parâmetros Subject, Owner, Due Date e Expiration Date.

Saídas da ação

A ação Bloquear IP 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 Disponível
Tabela do painel de casos Indisponível
Tabela de enriquecimento de entidades Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível

A ação Bloquear IP fornece o seguinte link no Mural de Casos:

  • Título do link: Change Request Link

  • Destino do link: abre a solicitação de mudança de tráfego criada na interface da Web do AlgoSec FireFlow.

Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Bloquear IP:

{
    "status": "Success",
    "messages": [],
    "data": {
        "id": 11,
        "fields": [
            {
                "name": "Owner",
                "values": [
                    "admin@example.com"
                ]
            },
            {
                "name": "Creator",
                "values": [
                    "admin@example.com"
                ]
            },
            {
                "name": "Due",
                "values": [
                    "2021-08-31 00:00:00"
                ]
            },
            {
                "name": "LastUpdated",
                "values": [
                    "2021-08-13 12:35:10"
                ]
            },
            {
                "name": "Requestor",
                "values": [
                    "admin@example.com"
                ]
            }
        ],
        "originalTraffic": [
            {
                "source": {
                    "items": [
                        {
                            "value": "all"
                        }
                    ]
                },
                "destination": {
                    "items": [
                        {
                            "value": "192.0.2.3"
                        }
                    ]
                },
                "service": {
                    "items": [
                        {
                            "value": "ALL"
                        }
                    ]
                },
                "application": {
                    "items": [
                        {
                            "value": "any"
                        }
                    ]
                },
                "user": {
                    "items": [
                        {
                            "value": "any"
                        }
                    ]
                },
                "action": "Drop"
            }
        ],
        "plannedTraffic": [
            {
                "source": {
                    "items": [
                        {
                            "value": "0.0.0.0-255.255.255.255"
                        }
                    ]
                },
                "destination": {
                    "items": [
                        {
                            "value": "192.0.2.3"
                        }
                    ]
                },
                "service": {
                    "items": [
                        {
                            "value": "tcp/*"
                        },
                        {
                            "value": "udp/*"
                        },
                        {
                            "value": "ospf"
                        },
                        {
                            "value": "icmp/*"
                        },
                        {
                            "value": "gre"
                        },
                        {
                            "value": "ipsec_50"
                        },
                        {
                            "value": "ipsec_51"
                        }
                    ]
                },
                "application": {
                    "items": [
                        {
                            "value": "any"
                        }
                    ]
                },
                "user": {
                    "items": [
                        {
                            "value": "any"
                        }
                    ]
                },
                "action": "Drop"
            }
        ]
    }
}
Mensagens de saída

A ação Bloquear IP fornece as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem
Successfully created a traffic change request to block traffic to the provided entities in AlgoSec A ação foi concluída.
Error executing action AlgoSec - Block IP. Reason: ERROR_REASON

Falha na ação.

Verifique se o URL e as credenciais do servidor do AlgoSec são válidos, confirme se o nome do modelo especificado existe no FireFlow, formate os parâmetros de data no formato ISO 8601 e formate todos os campos personalizados como pares de chave-valor válidos.

Resultado do script

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

Nome do resultado do script Valor
is_success true ou false

Listar modelos

Use a ação Listar modelos para recuperar os modelos de solicitação de mudança disponíveis configurados no AlgoSec FireFlow. É possível filtrar modelos por nome para identificar o nome exato do modelo necessário ao automatizar solicitações de mudança de tráfego.

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

Entradas da ação

A ação Listar modelos requer os seguintes parâmetros:

Parâmetro Descrição
Filter Logic

Opcional.

A lógica de correspondência aplicada ao filtrar nomes de modelos usando o parâmetro Filter Value.

Os valores possíveis são os seguintes:

  • Equal
  • Contains

O valor padrão é Equal.

Filter Value

Opcional.

O nome do modelo que diferencia maiúsculas de minúsculas ou a substring usada para filtrar os modelos disponíveis com base no Filter Logic selecionado.

Se você não especificar um valor de filtro, a ação vai retornar todos os modelos até o limite configurado.

Max Templates To Return

Opcional.

O número máximo de modelos a serem retornados.

O valor padrão é 50.

Saídas da ação

A ação Listar modelos 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 Disponível
Tabela de enriquecimento de entidades Indisponível
Resultado JSON Disponível
Mensagens de saída Disponível
Resultado do script Disponível
Tabela do painel de casos

A ação Listar modelos fornece a seguinte tabela no Mural do caso:

  • Nome da tabela: Available Templates

  • Colunas:

    • Name
    • Description
    • Type
Resultado JSON

O exemplo a seguir mostra a saída do resultado JSON recebida ao usar a ação Listar modelos:

[
    {
        "id": 142,
        "name": "110: Multi-Approval Request",
        "description": "Create a traffic change request which requires multiple approvals",
        "type": "Traffic Change",
        "enabled": true
    },
    {
        "id": 597,
        "name": "190: Verbatim Rule Addition",
        "description": "Create a traffic change request for bulk rules addition as specified",
        "type": "Traffic Change",
        "enabled": true
    },
    {
        "id": 550,
        "name": "Basic Change Traffic Request",
        "description": "Create a basic change traffic request",
        "type": "Traffic Change",
        "enabled": true
    }
]
Mensagens de saída

A ação Listar modelos fornece as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem
Successfully found templates for the provided criteria in AlgoSec. A ação foi concluída.
No templates were found for the provided criteria in AlgoSec.

Falha na ação.

Verifique se os modelos existem no AlgoSec FireFlow e confira a ortografia e as letras maiúsculas e minúsculas do parâmetro Filter Value ou mude Filter Logic para Contains.

Error executing action AlgoSec - List Templates. Reason: ERROR_REASON

Falha na ação.

Verifique se os parâmetros de conexão do servidor AlgoSec são válidos e se Max Templates To Return está definido como um número maior que 0.

Resultado do script

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

Nome do resultado do script Valor
is_success true ou false

Ping

Use a ação Ping para testar a conectividade e a autenticação no servidor do AlgoSec usando os parâmetros de integração configurados.

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 de entidades Indisponível
Resultado JSON Indisponível
Mensagens de saída Disponível
Resultado do script Disponível
Mensagens de saída

A ação Ping fornece as seguintes mensagens de saída:

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

Falha na ação.

Verifique se o URL API Root pode ser acessado pelo Google SecOps, se as credenciais Username e Password são válidas e confirme as configurações do certificado 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

Aguardar a atualização do status do pedido de mudança

Use a ação Aguardar atualização do status da solicitação de mudança para monitorar uma solicitação de mudança de tráfego no AlgoSec FireFlow até que ela alcance um status de destino.

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

Entradas da ação

A ação Aguardar atualização do status da solicitação de mudança requer os seguintes parâmetros:

Parâmetro Descrição
Request ID

Obrigatório.

O identificador numérico da solicitação de mudança de tráfego do AlgoSec a ser monitorada.

Status

Obrigatório.

Uma lista separada por vírgulas de status de ciclo de vida de destino que concluem a ação quando correspondentes. A ação vai ignorar nomes de status inválidos se você fornecer pelo menos um status válido.

Os valores possíveis são os seguintes:

  • resolved
  • reconcile
  • open
  • check
  • implementation plan
  • implement
  • validate

O valor padrão é resolved.

Saídas da ação

A ação Aguardar atualização do status da solicitação de mudança 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 de entidades 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 Aguardar atualização do status da solicitação de mudança:

{
    "status": "Success",
    "messages": [],
    "data": {
        "id": 6,
        "subChangeRequests": [
            12
        ],
        "fields": [
            {
                "name": "Risk Level",
                "values": [
                    "No Risk"
                ]
            },
            {
                "name": "Owner",
                "values": [
                    "admin@example.com"
                ]
            },
            {
                "name": "Creator",
                "values": [
                    "admin@example.com"
                ]
            },
            {
                "name": "LastUpdated",
                "values": [
                    "2021-08-13 13:50:58"
                ]
            },
            {
                "name": "Requestor",
                "values": [
                    "admin@example.com"
                ]
            },
            {
                "name": "Form Type",
                "values": [
                    "Traffic Change"
                ]
            },
            {
                "name": "Risks Number",
                "values": [
                    "0"
                ]
            },
            {
                "name": "Initial Plan status",
                "values": [
                    "Result OK"
                ]
            },
            {
                "name": "Workflow",
                "values": [
                    "Basic"
                ]
            },
            {
                "name": "Subject",
                "values": [
                    "1"
                ]
            },
            {
                "name": "status",
                "values": [
                    "resolved"
                ]
            }
        ],
        "originalTraffic": [
            {
                "source": {
                    "items": [
                        {
                            "value": "all"
                        }
                    ]
                },
                "destination": {
                    "items": [
                        {
                            "value": "192.0.2.2"
                        }
                    ]
                },
                "service": {
                    "items": [
                        {
                            "value": "tcp/80"
                        }
                    ]
                },
                "application": {
                    "items": [
                        {
                            "value": "any"
                        }
                    ]
                },
                "user": {
                    "items": [
                        {
                            "value": "any"
                        }
                    ]
                },
                "action": "Allow"
            }
        ],
        "plannedTraffic": [
            {
                "source": {
                    "items": [
                        {
                            "value": "0.0.0.0-255.255.255.255"
                        }
                    ]
                },
                "destination": {
                    "items": [
                        {
                            "value": "192.0.2.2"
                        }
                    ]
                },
                "service": {
                    "items": [
                        {
                            "value": "tcp/80"
                        }
                    ]
                },
                "application": {
                    "items": [
                        {
                            "value": "any"
                        }
                    ]
                },
                "user": {
                    "items": [
                        {
                            "value": "any"
                        }
                    ]
                },
                "action": "Allow"
            }
        ]
    }
}
Mensagens de saída

A ação Aguardar atualização do status da solicitação de mudança fornece as seguintes mensagens de saída:

Mensagem de resposta Descrição da mensagem
Status of the change request with ID REQUEST_ID was updated to status: STATUS. A ação foi concluída.
Waiting for a change request to be updated... A ação ainda está em execução e sondando o AlgoSec FireFlow até que a solicitação de alteração alcance um dos status de destino.
Error executing action AlgoSec - Wait for Change Request Status Update. Reason: action ran into a timeout during execution. Current status of the change request: STATUS. Please increase the timeout for the action in the IDE.

Falha na ação.

Aumente o tempo limite de execução da ação no ambiente de desenvolvimento integrado do Google SecOps ou verifique se a solicitação de mudança está avançando no fluxo de trabalho de aprovação no AlgoSec FireFlow.

Error executing action AlgoSec - Wait for Change Request Status Update. Reason: ERROR_REASON

Falha na ação.

Verifique se o Request ID corresponde a uma solicitação de alteração de tráfego existente, confirme se você forneceu pelo menos um valor válido no parâmetro Status e verifique se as credenciais do servidor AlgoSec são válidas.

Resultado do script

A tabela a seguir lista o valor da saída do resultado do script ao usar a ação Aguardar atualização do status da solicitação de mudança:

Nome do resultado do script Valor
is_success true ou false

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