iboss

En este documento, se proporcionan instrucciones para integrar iboss en Google SecOps.

Casos de uso

  1. Realiza acciones de enriquecimiento: Obtén datos de iboss para enriquecer los datos en las alertas de Google Security Operations.
  2. Realizar acciones activas: bloquear una IP o URL en iboss desde Google SecOps

Permiso de producto

Para autenticarse, las acciones realizan dos solicitudes. La primera solicitud es para obtener un token y la segunda es para obtener un token de XSRF especial.

Configura la integración de iboss en Google SecOps

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
Nombre de la instancia String N/A No Es el nombre de la instancia para la que deseas configurar la integración.
Descripción String N/A No Es la descripción de la instancia.
Raíz de la API de Cloud String https://cloud.iboss.com/ Sí Especifica la raíz de la API de iboss Cloud.
Raíz de la API de la cuenta String https://accounts.iboss.com/ Sí Especifica la raíz de la API de la cuenta de iboss.
Nombre de usuario String N/A Sí Especifica el nombre de usuario de la cuenta de iboss.
Contraseña Contraseña N/A Sí Especifica la contraseña de la cuenta de iboss.
Verificar SSL Casilla de verificación Desmarcado No Si está habilitado, verifica que el certificado SSL para la conexión con el servidor de nube pública de iboss sea válido.
Ejecuta de forma remota Casilla de verificación Marcado No Marca el campo para ejecutar la integración configurada de forma remota. Una vez marcada, aparecerá la opción para seleccionar el usuario remoto (agente).

Acciones

Ping

Descripción

Prueba la conectividad con iboss 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.

Ejecutar en

Esta acción no se ejecuta en entidades 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
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 ejecuta correctamente:
print "Successfully connected to the iboss 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:

print "Failed to connect to the iboss server! Error is {0}".format(exception.stacktrace)

 General

Agrega la URL a la lista de bloqueo de políticas

Descripción

Agrega la URL a la lista de URLs bloqueadas de iboss.

Cómo encontrar el ID de categoría

  1. Navega a Seguridad web -> Capas de políticas.
  2. Abre la consola de las Herramientas para desarrolladores (Ctrl + Mayúsculas + I en Google Chrome).
  3. Navega a la pestaña Red.
  4. Intenta editar la lista de bloqueo necesaria.

En la consola, verás las solicitudes que se están realizando. Busca entre esas solicitudes el parámetro customCategoryId=xxxx.

Parámetros
Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID de categoría Número entero 1001 Sí Especifica a qué categoría de política deseas agregar la URL.
Prioridad Número entero 50 Sí Especifica la prioridad de la URL que se debe bloquear.
Dirección DDL

Destino

Valores posibles:

Destino

Fuente

Destino y origen

 Sí Especifica la dirección de la URL.
Iniciar portabilidad Número entero N/A No Especifica el puerto de inicio relacionado con la URL que se debe bloquear. Nota: Si solo se especifica "Puerto de inicio" o "Puerto de finalización", el valor se agregará a ambos parámetros de acción.
Puerto final Número entero N/A No Especifica el puerto final relacionado con la URL que se debe bloquear. Nota: Si solo se especifica "Puerto de inicio" o "Puerto de finalización", el valor se agregará a ambos parámetros de acción.
Nota String N/A No Agrega una nota relacionada con la URL que se debe bloquear.
Es una expresión regular Casilla de verificación Desmarcado No Si se habilita, la URL se considerará como una expresión regular.
Esquema de bandas Casilla de verificación Desmarcado No Si habilitas esta opción, la acción quitará el esquema relacionado con la URL.

Ejecutar en

Esta acción se ejecuta en las siguientes entidades:

  • URL
  • Nombre de host

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
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:

if successful and at least one of the provided URLs were blocked(is_success = true):
print "Successfully blocked the following URLs in the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Si no se bloquean las URLs específicas(is_success = true):
print "Action was not able to block the following URLs in the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Si no se puede enriquecer para todas las entidades (is_success = false):

print: "No URLs were blocked in the iboss category with ID {0}.".format(category_id)

Si la política no es una lista de bloqueo (is_success = false):

print "Category with ID {category_id} is not associated with a Block list."

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

Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, etc.:

print "Error executing action "Add URL to Policy Block List". Reason: {0}''.format(error.Stacktrace)

 General

Agrega una IP a la lista de bloqueo de políticas

Descripción

Agrega la IP a la lista de bloqueo de iboss.

Cómo encontrar el ID de categoría

  1. Navega a Seguridad web -> Capas de políticas.
  2. Abre la consola de las Herramientas para desarrolladores (Ctrl + Mayúsculas + I en Google Chrome).
  3. Navega a la pestaña Red.
  4. Intenta editar la lista de bloqueo necesaria.

En la consola, verás las solicitudes que se están realizando. Busca entre esas solicitudes el parámetro customCategoryId=xxxx.

Parámetros
Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID de categoría Número entero 1001 Sí Especifica a qué categoría de política deseas agregar la URL.
Prioridad Número entero 50 Sí Especifica la prioridad de la URL que se debe bloquear.
Dirección DDL

Destino

Valores posibles:

Destino

Fuente

Destino y origen

 Sí Especifica la dirección de la URL.
Iniciar portabilidad Número entero N/A No Especifica el puerto de inicio relacionado con la URL que se debe bloquear. Nota: Si solo se especifica "Puerto de inicio" o "Puerto de finalización", el valor se agregará a ambos parámetros de acción.
Puerto final Número entero N/A No Especifica el puerto final relacionado con la URL que se debe bloquear. Nota: Si solo se especifica "Puerto de inicio" o "Puerto de finalización", el valor se agregará a ambos parámetros de acción.
Nota String N/A No Agrega una nota relacionada con la URL que se debe bloquear.
Es una expresión regular Casilla de verificación Falso No Si se habilita, la URL se considerará como una expresión regular.

Ejecutar en

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
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:

if successful and at least one of the provided URLs were blocked(is_success = true):
print "Successfully blocked the following URLs in the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Si no se bloquean las URLs específicas(is_success = true):
print "Action was not able to block the following URLs in the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Si no se puede enriquecer para todas las entidades (is_success = false):

print: "No URLs were blocked in the iboss category with ID {0}.".format(category_id)

Si la política no es una lista de bloqueo (is_success = false):

print "Category with ID {category_id} is not associated with a Block list."

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

Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, etc.:

print "Error executing action "Add URL to Policy Block List". Reason: {0}''.format(error.Stacktrace)

 General

Agrega una IP a la lista de bloqueo de políticas

Descripción

Agrega la IP a la lista de bloqueo de iboss.

Cómo encontrar el ID de categoría

  1. Navega a Seguridad web -> Capas de políticas.
  2. Abre la consola de las Herramientas para desarrolladores (Ctrl + Mayúsculas + I en Google Chrome).
  3. Navega a la pestaña Red.
  4. Intenta editar la lista de bloqueo necesaria.

En la consola, verás las solicitudes que se están realizando. Busca entre esas solicitudes el parámetro customCategoryId=xxxx.

Parámetros
Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID de categoría Número entero 1001 Sí Especifica a qué categoría de política deseas agregar la IP.
Prioridad Número entero 50 Sí Especifica la prioridad de la IP que se debe bloquear.
Dirección DDL

Destino

Valores posibles:

Destino

Fuente

Destino y origen

 Sí Especifica cuál es la dirección de la IP.
Iniciar portabilidad Número entero N/A No Especifica el puerto de inicio relacionado con la IP que se debe bloquear. Nota: Si solo se especifica "Puerto de inicio" o "Puerto de finalización", el valor se agregará a ambos parámetros de acción.
Puerto final Número entero N/A No Especifica el puerto final relacionado con la IP que se debe bloquear. Nota: Si solo se especifica "Puerto de inicio" o "Puerto de finalización", el valor se agregará a ambos parámetros de acción.
Nota String N/A No Agrega una nota relacionada con la IP que se debe bloquear.
Es una expresión regular Casilla de verificación Desmarcado No Si se habilita, la IP se considerará como una expresión regular.

Ejecutar en

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
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:

if successful and at least one of the provided IPs were blocked(is_success = true):
print "Successfully blocked the following IPs in the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

If fail to block specific IPs(is_success = true):
print "Action was not able to block the following IPs in the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Si no se puede enriquecer para todas las entidades (is_success = false):

print: "No IPs were blocked in the iboss category with ID {0}.".format(category_id)

Si la política no es una lista de bloqueo (is_success = false):

print "Category with ID {category_id} is not associated with a Block list."

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

Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, etc.:

print "Error executing action "Add IP to Policy Block List". Reason: {0}''.format(error.Stacktrace)

 General

Enumera las entradas de la lista de bloqueo de políticas

Descripción

Devuelve las entradas de la lista de bloqueo de iboss en un grupo específico.

Cómo encontrar el ID de categoría

  1. Navega a Seguridad web -> Capas de políticas.
  2. Abre la consola de las Herramientas para desarrolladores (Ctrl + Mayúsculas + I en Google Chrome).
  3. Navega a la pestaña Red.
  4. Intenta editar la lista de bloqueo necesaria.

En la consola, verás las solicitudes que se están realizando. Busca entre esas solicitudes el parámetro customCategoryId=xxxx.

Parámetros
Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID de categoría Número entero 1001 Sí Especifica en qué categoría de política deseas incluir las entradas de la lista de bloqueo.
Cantidad máxima de entradas que se devolverán Número entero 50 Sí Especifica cuántas entradas se deben mostrar.

Ejecutar en

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
{
    "entries": [
       {
          "direction": 0,
          "endPort": 0,
          "isRegex": 0,
          "note": "",
          "priority": 0,
          "startPort": 0,
          "type": 0,
          "url": "asaa.com",
          "weight": 501
       }
    ],
    "message": ""
}
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:

if successful returned and is available data(is_success = true):
print "Successfully listed entries from the iboss Block List in a category with ID '{0}'".format(category_id)

Si se devuelve y no hay datos (is_success = false):

print: "No Block List entries were found in the iboss category with ID {0}.".format(category_id)

Si la política no es una lista de bloqueo: (is_success = false)

Imprime "Category with ID {category_id} is not associated with a Block list."

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

Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, etc.:

print "Error executing action "List Policy Block List Entries". Reason: {0}''.format(error.Stacktrace)

 General
Muro de casos en CSV

Nombre: "Entradas de la lista de bloqueo". Categoría {0}".format(Category)

Columnas:

  • Nombre (asignado como URL)
  • Prioridad (asignada como prioridad)
  • Peso (asignado como peso)
  • Dirección (asignada como direction. Verifica el comportamiento de la acción)
  • Puerto de inicio (asignado como startPort)
  • Puerto final (asignado como endPort)
  • Nota (asignada como nota)
  • Regex (se asigna como isRegex. 1 = Verdadero, 0 = Falso)

Quita la URL de la lista de bloqueo de la política

Descripción

Quita la URL de la lista de URLs bloqueadas de iboss.

Cómo encontrar el ID de categoría

  1. Navega a Seguridad web -> Capas de políticas.
  2. Abre la consola de las Herramientas para desarrolladores (Ctrl + Mayúsculas + I en Google Chrome).
  3. Navega a la pestaña Red.
  4. Intenta editar la lista de bloqueo necesaria.

En la consola, verás las solicitudes que se están realizando. Busca entre esas solicitudes el parámetro customCategoryId=xxxx.

Parámetros
Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID de categoría Número entero 1001 Sí Especifica de qué categoría de política deseas quitar la URL.
Iniciar portabilidad Número entero N/A No Especifica el puerto de inicio relacionado con la URL que se debe borrar. Este parámetro es obligatorio si la URL deseada tiene un puerto de inicio definido. Esta es una limitación de iboss.
Puerto final Número entero N/A No Especifica el puerto final relacionado con la URL que se debe borrar. Este parámetro es obligatorio si la URL deseada tiene un puerto final definido. Esta es una limitación de iboss.
Esquema de bandas Casilla de verificación Desmarcado No Si habilitas esta opción, la acción quitará el esquema relacionado con la URL.

Ejecutar en

Esta acción se ejecuta en las siguientes entidades:

  • URL
  • Nombre de host

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
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 y se quita al menos una de las URLs proporcionadas (is_success = true):
print "Successfully removed the following URLs from the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Si no se quitan URLs específicas(is_success = true):

print "Action was not able to remove the following URLs from the category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Si no se puede enriquecer para todas las entidades (is_success = false):

Print: "No URLs were removed from the iboss category with ID {0}.".format(category_id)

Si la política no es una lista de bloqueo (is_success = false):

Imprime "Category with ID {category_id} is not associated with a Block list."

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

Si se produce un error grave, como credenciales incorrectas, falta de conexión al servidor, etc.:

print "Error executing action "Remove URL from Policy Block List". Reason: {0}''.format(error.Stacktrace)

 General

Quita la IP de la lista de bloqueo de políticas

Descripción

Quita la IP de la lista de bloqueo de iboss.

Cómo encontrar el ID de categoría

  1. Navega a Seguridad web -> Capas de políticas.
  2. Abre la consola de las Herramientas para desarrolladores (Ctrl + Mayúsculas + I en Google Chrome).
  3. Navega a la pestaña Red.
  4. Intenta editar la lista de bloqueo necesaria.

En la consola, verás las solicitudes que se están realizando. Busca entre esas solicitudes el parámetro customCategoryId=xxxx.

Parámetros
Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID de categoría Número entero 1001 Sí Especifica de qué categoría de política quieres quitar la IP.
Iniciar portabilidad Número entero N/A No Especifica el puerto de inicio relacionado con la IP que se debe borrar. Este parámetro es obligatorio si la URL deseada tiene un puerto de inicio definido. Esta es una limitación de iboss.
Puerto final Número entero N/A No Especifica el puerto final relacionado con la IP que se debe borrar. Este parámetro es obligatorio si la IP deseada tiene un puerto final definido. Esta es una limitación de iboss.

Ejecutar en

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
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 y se quita al menos una de las URLs proporcionadas (is_success = true):
print "Successfully removed the following IPs from the iboss category with ID {0}: \n {1}".format(category_id, entity.identifier list)

Si no se quitan URLs específicas(is_success = true):

print "Action was not able to remove the following IPs from the iboss category with ID {0}\n: {1}".format(category_id, [entity.identifier])

Si no se puede enriquecer para todas las entidades (is_success = false):

print: "No IPs were removed from the iboss category with ID {0}.".format(category_id)

Si la política no es una lista de bloqueo: (is_success = false)

Imprime "Category with ID {category_id} is not associated with a Block list."

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

Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, etc.:

print "Error executing action "Remove IP from Policy Block List". Reason: {0}''.format(error.Stacktrace)

 General

Búsqueda de URL

Descripción

Realiza una búsqueda de URL.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID del grupo Número entero N/A No Especifica para qué grupo se realizará la búsqueda de URL. Si no se especifica nada, se usará el grupo "Predeterminado".

Ejecutar en

Esta acción se ejecuta en las siguientes entidades:

  • URL
  • Nombre de host

Resultados de la acción

Enriquecimiento de entidades
Nombre del campo de enriquecimiento Fuente (clave JSON) Lógica: Cuándo aplicarlas
IBOSS_group_{group_id}_categories categories Cuando está disponible en JSON
IBOSS_group_{group_id}_action acción Cuando está disponible en JSON
IBOSS_group_{group_id}_message mensaje Cuando está disponible en JSON
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
{
    "action": "Not Blocked",
    "categories": "Pornography/Nudity",
    "message": "Url Known."
}
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 ejecuta correctamente y se buscó al menos una de las URLs proporcionadas (is_success = true):
print "Successfully retrieved information about the following URLs: \n {0}".format( entity.identifier list)

Si no se pueden buscar URLs específicas(is_success = true):

Imprime: "Action was not able to retrieve information about the following URLs\n: {0}".format([entity.identifier])

Si no se pueden buscar todas las entidades (is_success = false):

Imprime "No se recuperó información sobre las URLs".

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

Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, etc.:

print "Error executing action "URL Lookup". Reason: {0}''.format(error.Stacktrace)

 General

Recategorización de URLs

Descripción

Envía la URL para que se vuelva a categorizar.

Ejecutar en

Esta acción se ejecuta en la entidad de URL.

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
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:

if successful and at least one of the provided URLs was submitted(is_success = true):
print "Successfully submitted the following URLs for recategorization: \n {0}".format( entity.identifier list)

Si no se quitan URLs específicas(is_success = true):

print "Action was not able to submit the following URLs for recategorization\n: {0}".format([entity.identifier])

Si no se puede enriquecer para todas las entidades (is_success = false):

print: "No URLs were submitted for recategorization."

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

Si se produce un error grave, como credenciales incorrectas, falta de conexión con el servidor, etc.:

print "Error executing action "URL Recategorization". Reason: {0}''.format(error.Stacktrace)

 General

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