Cloudflare

En este documento, se describe cómo integrar Cloudflare en Google Security Operations.

Casos de uso de productos

Realiza el enriquecimiento de entidades

Configura la integración de Cloudflare en Google Security Operations

Si quieres obtener instrucciones detalladas para configurar una integración en Google SecOps, consulta Configura integraciones.

Parámetros de integración

Usa los siguientes parámetros para configurar la integración:

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Raíz de la API String https://api.cloudflare.com Sí Es la raíz de la API de la instancia de Cloudflare.
Token de API Contraseña N/A Sí Es el token de la API de la instancia de Cloudflare.
Nombre de la cuenta String N/A Sí Es el nombre de la cuenta que se debe usar en la integración.
Verificar SSL Casilla de verificación Marcado No Si se habilita, verifica que el certificado SSL para la conexión con el servidor de Cloudflare sea válido.

Cómo configurar el token

  1. Ve a Configuración del perfil y haz clic en Tokens de API.
  2. Navega a Crear token > Crear token personalizado y selecciona los siguientes permisos:
Cuenta WAF de la cuenta Leer
Cuenta Políticas de reglas Leer
Cuenta Listas de filtros de cuentas Editar
Cuenta Acceso al firewall de la cuenta Editar
Cuenta Firewall de DNS Leer
Cuenta Configuración de la cuenta Leer
Zona WAF de zona Editar
Zona Configuración de la zona Leer
Zona Zona Leer
Zona Registros Leer
Zona Servicios de firewall Editar
Zona Servicios de firewall Leer
Zona Analytics Leer

Lista de permisos obligatorios

Acciones

Agregar IP a la lista de reglas

Descripción

Agrega direcciones IP a la lista de reglas en Cloudflare. Entidades admitidas: dirección IP.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre de la regla String N/A Sí Especifica el nombre de la lista de reglas a la que deseas agregar elementos.
Descripción String N/A No Especifica una descripción para los elementos de la lista de reglas que se agregaron recientemente.

Fecha de ejecución

Esta acción se ejecuta en la entidad de dirección IP.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Resultado de JSON
{
    "result": {
        "operation_id": "f16b978552ca49f88b36fe628de31142"
    },
    "success": true,
    "errors": [],
    "messages": []
}
Muro de casos
Tipo de resultado Valor / Descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se informa el código de estado 200 para una entidad (is_success=true): "Se agregaron correctamente las siguientes entidades a la lista de reglas {name} en Cloudflare: {entity.identifier}."

Si no se ejecuta correctamente para una entidad (is_success=true): "La acción no pudo agregar las siguientes entidades a la lista de reglas {name} en Cloudflare: {entity.identifier}".

Si no se realiza correctamente para todas (is_success=false): "No se agregó ninguna de las entidades proporcionadas a la lista de reglas {name}".

La acción debería fallar y detener la ejecución de una guía:

Si se informa un error fatal, como credenciales incorrectas, falta de conexión al servidor, etcétera: "Error executing action "Add IP To Rule List". Reason: {0}''.format(error.Stacktrace)

Si no se encuentra la lista: "Error al ejecutar la acción "Agregar IP a la lista de reglas". Motivo: No se encontró la lista de reglas {name} en Cloudflare.''

Si la lista no es del tipo válido: "Error al ejecutar la acción "Agregar IP a la lista de reglas". Motivo: La lista de reglas {name} no es del tipo "IP"."

 General

Agregar URL a la lista de reglas

Descripción

Agrega URLs a la lista de reglas en Cloudflare. Entidades admitidas: URL.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre de la regla String N/A Sí Especifica el nombre de la lista de reglas a la que deseas agregar elementos.
URL de la fuente String N/A Sí Especifica la URL de origen del elemento de la lista de reglas.
Descripción String N/A No Especifica una descripción para los elementos de la lista de reglas que se agregaron recientemente.
Código de estado DDL

301

Valores posibles:

  • 301
  • 302
  • 307
  • 308
 No Especifica el estado del elemento de la lista de reglas.
Conservar la cadena de consulta Casilla de verificación Desmarcado No Si se habilita, el elemento de la lista de reglas conserva la cadena de consulta.
Incluir subdominios Casilla de verificación Desmarcado No Si está habilitado, el elemento de la lista de reglas incluye subdominios.
Coincidencia de subruta Casilla de verificación Desmarcado No Si se habilita, el elemento de la lista de reglas coincidirá con la ruta secundaria.
Conserva el sufijo de la ruta de acceso Casilla de verificación Desmarcado No Si está habilitado, el elemento de la lista de reglas conserva el sufijo de la ruta de acceso.

Fecha de ejecución

Esta acción se ejecuta en la entidad de dirección IP.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Resultado de JSON
{
    "result": {
        "operation_id": "f16b978552ca49f88b36fe628de31142"
    },
    "success": true,
    "errors": [],
    "messages": []
}
Muro de casos
Tipo de resultado Valor / Descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si el código de estado es 200 para una entidad (is_success=true): "Se agregaron correctamente las siguientes entidades a la lista de reglas {name} en Cloudflare: {entity.identifier}."

Si no se ejecuta correctamente para una entidad (is_success=true): "La acción no pudo agregar las siguientes entidades a la lista de reglas {name} en Cloudflare: {entity.identifier}".

Si no se realiza correctamente para todas las entidades (is_success=false): "No se agregó ninguna de las entidades proporcionadas a la lista de reglas {name}".

La acción debería fallar y detener la ejecución de una guía:

Si se informa un error fatal, como credenciales incorrectas, falta de conexión al servidor, etcétera: "Error executing action "Add URL To Rule List". Reason: {0}''.format(error.Stacktrace)

Si no se encuentra la lista: "Error executing action "Add URL To Rule List". Motivo: No se encontró la lista de reglas {name} en Cloudflare.''

Si la lista no es del tipo válido: "Error al ejecutar la acción "Agregar URL a la lista de reglas". Motivo: La lista de reglas {name} no es del tipo "Redireccionamiento".'

 General

Crear una regla de firewall

Descripción

Crea una regla de firewall en Cloudflare.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre de la zona String N/A Sí Especifica el nombre de la zona que contiene la regla de firewall.
Nombre String N/A No Especifica el nombre de la regla de firewall.
Acción DDL

Bloquear

Valores posibles:

  • Permitir
  • Bloquear
  • Omitir
  • Registro
  • CAPTCHA heredado
  • Desafío administrado
  • Desafío de JS
 No

Especifica la acción para la regla de firewall.

Si se selecciona "Bloquear", debes proporcionar valores en el parámetro "Productos".
Expresión String N/A Sí Especifica la expresión para la regla de firewall.
Productos CSV N/A No

Especifica una lista separada por comas de productos para la regla de firewall.

Nota: Este parámetro solo es obligatorio si se selecciona "Omitir" para el parámetro "Acción".

Valores posibles: zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit, waf
Prioridad Número entero N/A No Especifica la prioridad de la regla de firewall.
Etiqueta de referencia String N/A No

Especifica una etiqueta de referencia para la regla de firewall.

Nota: Solo puede tener hasta 50 caracteres.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Resultado de JSON
{
        {
            "id": "b520c154bdeb4fe2a1f647b2c6b35829",
            "paused": false,
            "description": "Blocks traffic identified during investigation for MIR-31",
            "action": "block",
            "priority": 50,
            "filter": {
                "id": "fc6dfad848c24a42ae5be0114db09fb9",
                "expression": "(ip.geoip.continent eq \"ASIA\")",
                "paused": false
            },
            "created_on": "2022-07-25T11:19:22Z",
            "modified_on": "2022-07-25T11:19:22Z",
            "index": 0
        }
}
Muro de casos
Tipo de resultado Valor / Descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se informa el código de estado 200 (is_success=true): "Se creó correctamente una nueva regla de firewall en la zona "{zone_name}" en Cloudflare".

La acción debería fallar y detener la ejecución de una guía:

Si se informa un error fatal, como credenciales incorrectas, falta de conexión al servidor, entre otros: "Error executing action "Create Firewall Rule". Reason: {0}''.format(error.Stacktrace)

Si la lista de errores no está vacía: "Error executing action "Create Firewall Rule". Motivo: {0}''.format(errors/message)

Si no se encuentra la zona: "Error executing action "Create Firewall Rule". Motivo: No se encontró la zona {zone_name} en Cloudflare.''

 General

Crea una lista de reglas

Descripción

Crea una lista de reglas en Cloudflare.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre String N/A Sí Especifica el nombre de la lista de reglas.
Tipo DDL

Dirección IP

Valores posibles:

  • Dirección IP
  • Redireccionamiento
 No Especifica el tipo de lista de reglas.
Descripción String N/A No Especifica la descripción de la lista de reglas.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Resultado de JSON
{
    "id": "d19589d629f140c0b961c467feadf99d",
    "name": "123",
    "kind": "ip",
    "num_items": 0,
"description": "description",
    "num_referencing_filters": 0,
    "created_on": "2022-07-25T12:13:46Z",
    "modified_on": "2022-07-25T12:13:46Z"
}
Muro de casos
Tipo de resultado Valor / Descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se informa el código de estado 200 (is_success = true): "Successfully create a rule list in Cloudflare."

La acción debería fallar y detener la ejecución de una guía:

Si se informa un error fatal, como credenciales incorrectas, falta de conexión al servidor, etcétera: "Error executing action "Create Rule List". Reason: {0}''.format(error.Stacktrace)

Si la lista de errores no está vacía: "Error executing action "Create Rule List". Motivo: {0}''.format(errors/message)

 General

Enumera las reglas de firewall

Descripción

Enumera las reglas de firewall disponibles en Cloudflare.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre de la zona String N/A Sí Especifica el nombre de la zona, que contendrá la regla de firewall.
Clave de filtro DDL

Selecciona una opción

Valores posibles:

  • Selecciona una opción
  • Nombre
  • ID
  • Acción
 No Especifica la clave que se debe usar para filtrar {item type}.
Lógica de filtrado DDL

Selecciona una opción

Valores posibles:

  • Seleccionar una opción
  • Igual
  • Contiene
 No

Especifica la lógica de filtro que se debe aplicar.

La lógica de filtrado se basa en el valor proporcionado en el parámetro "Clave de filtro".
Valor del filtro String N/A No

Especifica el valor que se debe usar en el filtro.

Si se selecciona "Igual", la acción intenta encontrar la coincidencia exacta entre los resultados.

Si se selecciona "Contiene", la acción intenta encontrar resultados que contengan esa subcadena.

Si no se proporciona nada en este parámetro, no se aplica el filtro.

La lógica de filtrado se basa en el valor proporcionado en el parámetro "Clave de filtro".
Cantidad máxima de registros para devolver Número entero 50 No

Especifica la cantidad de registros que se devolverán.

Si no se proporciona nada, la acción devuelve 50 registros.

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Resultado de JSON
{
    "id": "55ec8db30f9e4640b5d0d13cff6b5429",
    "paused": false,
    "description": "rulle2",
    "action": "allow",
    "filter": {
        "id": "2bb05df8c4f547bd9792d8dc38a86b81",
        "expression": "(ip.geoip.country eq \"BG\")",
        "paused": false
    },
    "created_on": "2022-07-05T13:53:39Z",
    "modified_on": "2022-07-05T13:53:39Z"
}
Muro de casos
Tipo de resultado Valor / Descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si hay datos disponibles (is_success=true): "Successfully found {item name} for the provided criteria in {product name}".

Si los datos no están disponibles (is_success=false): "No se encontraron {item name} para los criterios proporcionados en {product name}"

Si el parámetro "Filter Value" está vacío (is_success=true):

"No se aplicó el filtro porque el parámetro "Valor de filtro" tiene un valor vacío".

La acción debería fallar y detener la ejecución de una guía:

Si el parámetro "Filter Key" se establece en "Select One" y el parámetro "Filter Logic" se establece en "Equal" o "Contains":

"Error al ejecutar la acción "{action name}". Motivo: Debes seleccionar un campo del parámetro "Clave de filtro".

Si se proporciona un valor no válido para el parámetro "Cantidad máxima de registros que se mostrarán": "Error al ejecutar la acción "{action name}". Motivo: "Se proporcionó un valor no válido para "Cantidad máxima de registros que se mostrarán": . Se debe proporcionar un número positivo".

Si se informa un error fatal, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error al ejecutar la acción "{action name}". Reason: {0}''.format(error.Stacktrace)

 General
Tabla del muro de casos

Nombre de la tabla: {grupo de artículos} disponible

Columnas de la tabla: {fields}

 General

Ping

Descripción

Prueba la conectividad con Cloudflare con los parámetros proporcionados en la página de configuración de la integración en la página de Google SecOps Content Hub.

Parámetros

N/A

Fecha de ejecución

La acción no usa ninguna de las entidades de alcance de Google SecOps ni tiene parámetros de entrada obligatorios.

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Resultado de JSON
N/A
Muro de casos
Tipo de resultado Valor / Descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se realiza correctamente: "Successfully connected to the SpyCloud server with the provided connection parameters!"

La acción debería fallar y detener la ejecución de una guía:

Si no se realiza correctamente, aparecerá el mensaje "Failed to connect to the SpyCloud server! Error is {0}".format(exception.stacktrace)

Si no se encuentra la cuenta, aparecerá el mensaje "No se pudo establecer la conexión con el servidor de Cloudflare. Se proporcionó un nombre de cuenta no válido. Verifica la ortografía".

 General

Actualiza la regla de firewall

Descripción

Actualizar una regla de firewall en Cloudflare

Fecha de ejecución

Esta acción no se ejecuta en entidades.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre de la regla String N/A Sí Especifica el nombre de la regla que se debe actualizar.
Nombre de la zona String N/A Sí Especifica el nombre de la zona que contiene la regla de firewall.
Acción DDL

Bloquear

Valores posibles:

  • Permitir
  • Bloquear
  • Omitir
  • Registro
  • CAPTCHA heredado
  • Desafío administrado
  • Desafío de JS
 No

Especifica la acción para la regla de firewall.

Si se selecciona "Bloquear", debes proporcionar valores en el parámetro "Productos".
Expresión String N/A Sí Especifica la expresión para la regla de firewall.
Productos CSV N/A No

Especifica una lista separada por comas de productos para la regla de firewall.

Nota: Este parámetro solo es obligatorio si se selecciona "Omitir" para el parámetro "Acción".

Valores posibles: zoneLockdown, uaBlock, bic, hot, securityLevel, rateLimit, waf
Prioridad Número entero N/A No Especifica la prioridad de la regla de firewall.
Etiqueta de referencia String N/A No

Especifica una etiqueta de referencia para la regla de firewall.

Nota: Solo puede tener hasta 50 caracteres.

Fecha de ejecución

Resultados de la acción

Resultado de secuencia de comandos
Nombre del resultado de la secuencia de comandos Opciones de valor Ejemplo
is_success Verdadero o falso is_success:False
Resultado de JSON
{
        {
            "id": "b520c154bdeb4fe2a1f647b2c6b35829",
            "paused": false,
            "description": "Blocks traffic identified during investigation for MIR-31",
            "action": "block",
            "priority": 50,
            "filter": {
                "id": "fc6dfad848c24a42ae5be0114db09fb9",
                "expression": "(ip.geoip.continent eq \"ASIA\")",
                "paused": false
            },
            "created_on": "2022-07-25T11:19:22Z",
            "modified_on": "2022-07-25T11:19:22Z",
            "index": 0
        }
}
Muro de casos
Tipo de resultado Valor / Descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se informa el código de estado 200 (is_success=true): "Se actualizó correctamente una regla de firewall en la zona "{zone_name}" de Cloudflare".

La acción debería fallar y detener la ejecución de una guía:

Si se informa un error fatal, como credenciales incorrectas, falta de conexión al servidor, entre otros: "Error al ejecutar la acción "Actualizar regla de firewall". Reason: {0}''.format(error.Stacktrace)

Si la lista de errores no está vacía: "Error al ejecutar la acción "Actualizar regla de firewall". Motivo: {0}''.format(errors/message)

Si no se encuentra la zona: "Error al ejecutar la acción "Actualizar regla de firewall". Motivo: No se encontró la zona {zone_name} en Cloudflare.''

 General

¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.