Integra AlgoSec en Google SecOps
En este documento, se explica cómo integrar AlgoSec en Google Security Operations.
Casos de uso
La integración de AlgoSec usa las capacidades de Google SecOps para admitir los siguientes casos de uso:
Contención de amenazas automatizada: Bloquea las direcciones IP maliciosas en los firewalls administrados enviando solicitudes de cambio de tráfico de descarte automatizadas durante las investigaciones de seguridad.
Autorización de tráfico controlado: Permite el tráfico empresarial legítimo a las direcciones IP de destino verificadas creando reglas de permiso estandarizadas en AlgoSec FireFlow.
Detección y administración de plantillas: Recupera las plantillas de solicitud de cambio de FireFlow disponibles para alinear las acciones de respuesta automatizadas con las políticas de administración de cambios de la organización.
Seguimiento asíncrono del ciclo de vida de los cambios: Supervisa las solicitudes de cambio de tráfico enviadas hasta que alcancen los estados operativos de destino, como resuelto o implementado.
Antes de comenzar
Antes de configurar la integración de AlgoSec en Google SecOps, verifica que tu entorno cumpla con los siguientes requisitos:
Conectividad de red: Asegúrate de que Google SecOps (o un agente remoto implementado para entornos locales) pueda comunicarse con tu servidor de AlgoSec a través de HTTPS en el puerto TCP
443.Plantillas de FireFlow: Habilita al menos una plantilla de solicitud de cambio de tráfico (como
Standard) en AlgoSec FireFlow antes de ejecutar acciones que envíen solicitudes de cambio.Permisos de usuario con privilegios mínimos: Configura una cuenta de servicio dedicada de AlgoSec FireFlow con los permisos mínimos necesarios para las acciones que se usan en tus guías, como se detalla en la siguiente tabla:
| Acción | Permisos obligatorios de AlgoSec FireFlow |
|---|---|
Allow IP |
Autenticarte con FireFlow, crear solicitudes de cambio de tráfico para las reglas de permiso y leer los detalles de las solicitudes de cambio de tráfico |
Block IP |
Autenticar con FireFlow, crear solicitudes de cambio de tráfico para las reglas de descarte y leer los detalles de las solicitudes de cambio de tráfico |
List Templates |
Autentícate con FireFlow y consulta las plantillas de solicitud de cambio disponibles. |
Ping |
Autentícate con FireFlow y consulta las plantillas de solicitud de cambio disponibles para validar la conectividad. |
Wait for Change Request Status Update |
Autentícate con FireFlow y lee los detalles de la solicitud de cambio de tráfico y los estados del ciclo de vida. |
Para obtener más información sobre cómo configurar los roles, las cuentas de usuario y las plantillas de solicitud de cambio de FireFlow, consulta la documentación oficial de AlgoSec FireFlow.
Parámetros de integración
La integración de AlgoSec requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
API Root |
Obligatorio. Es la URL base del servidor de AlgoSec, con el formato
|
Username |
Obligatorio. Es el nombre de usuario de la cuenta de AlgoSec FireFlow que se usa para la autenticación. |
Password |
Obligatorio. Es la contraseña de la cuenta de AlgoSec FireFlow que se usa para la autenticación. |
Verify SSL |
Obligatorio. Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de AlgoSec. Habilitada de forma predeterminada. |
Para obtener instrucciones sobre cómo configurar una integración en Google SecOps, consulta Configura integraciones.
Si es necesario, puedes realizar cambios más adelante. Después de configurar una instancia de integración, puedes usarla en las guías. Para obtener más información sobre cómo configurar y admitir varias instancias, consulta Cómo admitir varias instancias.
Acciones
Para obtener más información sobre las acciones, consulta Responde a las acciones pendientes desde tu escritorio y Ejecuta una acción manual en tu caso.
Permitir IP
Usa la acción Permitir IP para enviar una solicitud de cambio de tráfico en AlgoSec
FireFlow que permita el tráfico a las entidades IP Address del caso (usadas como
direcciones de destino).
Esta acción se ejecuta en la entidad IP Address de Google SecOps.
Entradas de acción
La acción Permitir IP requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Template |
Obligatorio. Es el nombre de la plantilla de AlgoSec FireFlow que se usará para la solicitud de cambio de tráfico. El valor predeterminado es |
Source |
Obligatorio. Es una lista separada por comas de direcciones IP de origen o de objetos de red para
la regla de permiso, o la palabra clave El valor predeterminado es |
Service |
Obligatorio. Es una lista separada por comas de los servicios de red que se permitirán, con el formato de
pares de protocolo y puerto, como El valor predeterminado es |
Subject |
Es opcional. Es una línea de asunto para la solicitud de cambio de tráfico en AlgoSec FireFlow. El valor predeterminado es |
Owner |
Es opcional. Es un nombre de usuario o identificador del usuario que posee la solicitud de cambio. Si no proporcionas un valor, AlgoSec asigna como propietario al usuario autenticado que creó el ticket. |
Due Date |
Es opcional. Es una fecha y hora de finalización objetivo para la solicitud de cambio en
formato ISO 8601, como |
Expiration Date |
Es opcional. Es la fecha y hora de vencimiento de la regla de tráfico permitido en
formato ISO 8601, como |
Custom Fields |
Es opcional. Son campos adicionales de solicitud de cambio de FireFlow que se proporcionan como pares clave-valor, como
Si se proporciona, este parámetro anula los parámetros |
Resultados de la acción
La acción Permitir IP proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | Disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento de entidades | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de la secuencia de comandos | Disponible |
Vínculo al muro de casos
La acción Permitir IP proporciona el siguiente vínculo en el muro de casos:
Título del vínculo:
Change Request LinkDestino del vínculo: Abre la solicitud de cambio de tráfico creada en la interfaz web de AlgoSec FireFlow.
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción 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"
}
]
}
}
Mensajes de salida
La acción Permitir IP proporciona los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
Successfully created a traffic change request to allow traffic
to the provided entities in AlgoSec |
La acción se realizó correctamente. |
Error executing action AlgoSec - Allow IP. Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica que la URL y las credenciales del servidor de AlgoSec sean válidas, confirma que el nombre de la plantilla especificada exista en FireFlow, asigna el formato ISO 8601 a los parámetros de fecha y asigna el formato de pares clave-valor válidos a los campos personalizados. |
Resultado de la secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Permitir IP:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
true o false |
Bloquea la IP
Usa la acción Bloquear IP para enviar una solicitud de cambio de tráfico en AlgoSec
FireFlow que bloquee el tráfico a las entidades IP Address del caso (usadas como
direcciones de destino).
Esta acción se ejecuta en la entidad IP Address de Google SecOps.
Entradas de acción
La acción Bloquear IP requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Template |
Obligatorio. Es el nombre de la plantilla de AlgoSec FireFlow que se usará para la solicitud de cambio de tráfico. El valor predeterminado es |
Source |
Obligatorio. Es una lista separada por comas de direcciones IP de origen o de objetos de red para
la regla de bloqueo, o la palabra clave El valor predeterminado es |
Service |
Obligatorio. Es una lista separada por comas de los servicios de red que se bloquearán, con formato de
pares de protocolo y puerto, como El valor predeterminado es |
Subject |
Es opcional. Es una línea de asunto para la solicitud de cambio de tráfico en AlgoSec FireFlow. El valor predeterminado es |
Owner |
Es opcional. Es un nombre de usuario o identificador del usuario que posee la solicitud de cambio. Si omites este parámetro, AlgoSec asigna como propietario al usuario autenticado que creó el ticket. |
Due Date |
Es opcional. Es una fecha y hora de finalización objetivo para la solicitud de cambio en
formato ISO 8601, como |
Expiration Date |
Es opcional. Es la fecha y hora de vencimiento de la regla de tráfico bloqueado en
formato ISO 8601, como |
Custom Fields |
Es opcional. Son campos adicionales de solicitud de cambio de FireFlow que se proporcionan como pares clave-valor, como
Si se proporciona, este parámetro anula los parámetros |
Resultados de la acción
La acción Bloquear IP proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | Disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento de entidades | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de la secuencia de comandos | Disponible |
Vínculo al muro de casos
La acción Bloquear IP proporciona el siguiente vínculo en el muro del caso:
Título del vínculo:
Change Request LinkDestino del vínculo: Abre la solicitud de cambio de tráfico creada en la interfaz web de AlgoSec FireFlow.
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción 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"
}
]
}
}
Mensajes de salida
La acción Bloquear IP proporciona los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
Successfully created a traffic change request to block traffic
to the provided entities in AlgoSec |
La acción se realizó correctamente. |
Error executing action AlgoSec - Block IP. Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica que la URL y las credenciales del servidor de AlgoSec sean válidas, confirma que el nombre de la plantilla especificada exista en FireFlow, asigna el formato ISO 8601 a los parámetros de fecha y asigna el formato de pares clave-valor válidos a los campos personalizados. |
Resultado de la secuencia de comandos
En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Bloquear IP:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
true o false |
Enumerar plantillas
Usa la acción List Templates para recuperar las plantillas de solicitud de cambio disponibles configuradas en AlgoSec FireFlow. Puedes filtrar las plantillas por nombre para identificar el nombre exacto de la plantilla que se requiere cuando se automatizan las solicitudes de cambio de tráfico.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción List Templates requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Filter Logic |
Es opcional. Es la lógica de coincidencia que se aplica cuando se filtran los nombres de las plantillas con el parámetro Los valores posibles son los siguientes:
El valor predeterminado es |
Filter Value |
Es opcional. Es el nombre de la plantilla o la subcadena que distingue mayúsculas de minúsculas y que se usa para filtrar
las plantillas disponibles según el Si no especificas un valor de filtro, la acción devuelve todas las plantillas hasta el límite configurado. |
Max Templates To Return |
Es opcional. Es la cantidad máxima de plantillas que se devolverán. El valor predeterminado es |
Resultados de la acción
La acción List Templates proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | Disponible |
| Tabla de enriquecimiento de entidades | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de la secuencia de comandos | Disponible |
Tabla del muro de casos
La acción List Templates proporciona la siguiente tabla en el muro del caso:
Nombre de la tabla:
Available TemplatesColumnas:
NameDescriptionType
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción List Templates:
[
{
"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
}
]
Mensajes de salida
La acción List Templates proporciona los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
Successfully found templates for the provided criteria in
AlgoSec. |
La acción se realizó correctamente. |
No templates were found for the provided criteria in
AlgoSec. |
No se pudo realizar la acción. Verifica que existan plantillas en AlgoSec FireFlow y comprueba la
ortografía y el uso de mayúsculas y minúsculas del parámetro |
Error executing action AlgoSec - List Templates. Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica que los parámetros de conexión del servidor de AlgoSec sean válidos y
que |
Resultado de la secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción List Templates:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
true o false |
Ping
Usa la acción Ping para probar la conectividad y la autenticación en el servidor de AlgoSec con los parámetros de integración configurados.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
Ninguno
Resultados de la acción
La acción Ping proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento de entidades | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | Disponible |
| Resultado de la secuencia de comandos | Disponible |
Mensajes de salida
La acción Ping proporciona los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
Successfully connected to the AlgoSec server with the provided
connection parameters! |
La acción se realizó correctamente. |
Failed to connect to the AlgoSec server! Error is
ERROR_REASON |
No se pudo realizar la acción. Verifica que se pueda acceder a la URL de |
Resultado de la secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Ping:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
true o false |
Espera a que se actualice el estado de la solicitud de cambio
Usa la acción Wait for Change Request Status Update para supervisar una solicitud de cambio de tráfico en AlgoSec FireFlow hasta que alcance un estado objetivo.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Espera la actualización del estado de la solicitud de cambio requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Request ID |
Obligatorio. Es el identificador numérico de la solicitud de cambio de tráfico de AlgoSec que se supervisará. |
Status |
Obligatorio. Es una lista separada por comas de los estados del ciclo de vida de destino que completan la acción cuando coinciden. La acción ignora los nombres de estado no válidos si proporcionas al menos un estado válido. Los valores posibles son los siguientes:
El valor predeterminado es |
Resultados de la acción
La acción Espera la actualización del estado de la solicitud de cambio proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento de entidades | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de la secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Espera la actualización del estado de la solicitud de cambio:
{
"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"
}
]
}
}
Mensajes de salida
La acción Espera la actualización del estado de la solicitud de cambio proporciona los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
Status of the change request with ID
REQUEST_ID was updated to status:
STATUS. |
La acción se realizó correctamente. |
Waiting for a change request to be updated... |
La acción sigue ejecutándose y sondeando AlgoSec FireFlow hasta que la solicitud de cambio alcance uno de los estados 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. |
No se pudo realizar la acción. Aumenta el tiempo de espera de ejecución de la acción en el IDE de Google SecOps o verifica que la solicitud de cambio avance por su flujo de trabajo de aprobación en AlgoSec FireFlow. |
Error executing action AlgoSec - Wait for Change Request Status
Update. Reason:
ERROR_REASON |
No se pudo realizar la acción. Verifica que el |
Resultado de la secuencia de comandos
En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Wait for Change Request Status Update:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
true o false |
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.