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
|
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 é |
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 O valor padrão é |
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 O valor padrão é |
Subject |
Opcional. Uma linha de assunto para a solicitação de mudança de tráfego no AlgoSec FireFlow. O valor padrão é |
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 |
Expiration Date |
Opcional. Uma data e hora de validade para a regra de tráfego permitido no
formato ISO 8601, como |
Custom Fields |
Opcional. Campos adicionais de solicitação de mudança do FireFlow fornecidos como pares de chave-valor, como Se fornecido, esse parâmetro substitui os parâmetros
|
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 |
Link do Painel de Casos
A ação Permitir IP fornece o seguinte link no Painel de Casos:
Título do link:
Change Request LinkDestino 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 é |
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 O valor padrão é |
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 O valor padrão é |
Subject |
Opcional. Uma linha de assunto para a solicitação de mudança de tráfego no AlgoSec FireFlow. O valor padrão é |
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 |
Expiration Date |
Opcional. Uma data e hora de validade para a regra de tráfego bloqueado no
formato ISO 8601, como |
Custom Fields |
Opcional. Campos adicionais de solicitação de mudança do FireFlow fornecidos como pares de chave-valor, como Se fornecido, esse parâmetro substitui os parâmetros
|
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 |
Link do Painel de Casos
A ação Bloquear IP fornece o seguinte link no Mural de Casos:
Título do link:
Change Request LinkDestino 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 Os valores possíveis são os seguintes:
O valor padrão é |
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 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 é |
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 TemplatesColunas:
NameDescriptionType
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 |
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 |
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 |
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:
O valor padrão é |
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 |
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.