Integra Axonius con Google SecOps
En este documento, se describe cómo integrar Axonius en Google Security Operations (Google SecOps).
Casos de uso
Realizar acciones de enriquecimiento
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://{root} | Sí | Raíz de la API de Axonius |
| Clave de API | String | N/A | Sí | Clave de API de Axonius |
| Secreto de API | Contraseña | N/A | Sí | Secreto de la API de Axonius |
| Verificar SSL | Casilla de verificación | Marcado | Sí | Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de Axonius. |
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.
Ping
Prueba la conectividad con Axonius.
Fecha de ejecución
La 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 |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Muro de casos
| Tipo de resultado | Valor/Descripción | Tipo |
|---|---|---|
| Mensaje de salida* | La acción no debería fallar ni detener la ejecución de una guía: Si se realiza correctamente: "Successfully connected to the Axonius 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 Axonius server! Error is {0}".format(exception.stacktrace) |
General |
Enriquece entidades
Enriquece las entidades con información de Axonius. Las entidades admitidas incluyen el nombre de host, la dirección IP, la dirección MAC, el usuario y las direcciones de correo electrónico (entidades de usuario que coinciden con la expresión regular de correo electrónico).
Parámetros
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| Crea una estadística de extremo | Casilla de verificación | Verdadero | No | Si se habilita, la acción creará una estadística con información sobre los extremos. |
| Crea una estadística de usuario | Casilla de verificación | Verdadero | No | Si se habilita, la acción creará una estadística que contendrá información sobre el usuario. |
| Cantidad máxima de notas que se devolverán | Número entero | 50 | No | Especifica cuántas notas se mostrarán en la tabla del muro de casos. |
Fecha de ejecución
Esta acción se ejecuta en las siguientes entidades:
- Nombre de host
- Dirección IP
- Dirección MAC
- Usuario
- Correo electrónico
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Resultado de JSON para el extremo:
{
"adapters": [
{
"accurate_for_datetime": "Sun, 21 Mar 2021 03:44:19 GMT",
"client_used": "DOMAIN\\axoniusSvc",
"raw": {
"ad_distinguished_name": "CN=DESKTOP-ID,OU=Computers,DC=demo,DC=local",
"ad_object_class": [
"top",
"person",
"organizationalperson",
"user",
"computer"
],
"ad_sAMAccountName": "",
"ad_site_location": "Richmond",
"ad_site_name": "",
"device_disabled": false,
"device_managed_by": "Example User",
"domain": "example.example",
"hostname": "HOSTNAME",
"id": "CN=ID,OU=Computers,DC=demo,DC=local",
"last_seen": "Tue, 16 Mar 2021 19:44:05 GMT",
"name": "NAME",
"network_interfaces": [
{
"ips": [
"IP"
],
"ips_raw": [
"IP_RAW"
],
"ips_v4": [
"IP_V4"
],
"ips_v4_raw": [
"IP_V4_RAW"
]
}
],
"os": {
"bitness": 64,
"distribution": "10",
"is_windows_server": false,
"os_str": "windows 10 pro 64-bit",
"type": "Windows",
"type_distribution": "Windows 10"
},
"part_of_domain": true
},
"plugin_name": "",
"plugin_type": "Adapter",
"plugin_unique_name": "",
"quick_id": "active_directory_adapter_0!CN=ID,OU=OU,DC=DOMAIN,DC=DOMAIN",
"type": "entitydata"
},
{
"accurate_for_datetime": "Sun, 21 Mar 2021 03:43:52 GMT",
"client_used": "https://DOMAIN",
"raw": {
"hostname": "HOSTNAME",
"id": "ID",
"last_seen": "Sun, 21 Mar 2021 01:50:28 GMT",
"name": "NAME",
"network_id": "NETWORK_ID",
"network_interfaces": [
{
"ips": [
"IP"
],
"ips_raw": [
"IP_RAW"
],
"ips_v4": [
"IP_V4"
],
"ips_v4_raw": [
"IP_V4_RAW"
],
"mac": "01:23:45:AB:CD:EF",
"manufacturer": "(Intel Corporate)"
}
]
},
"plugin_name": "Example",
"plugin_type": "Adapter",
"plugin_unique_name": "Example",
"quick_id": "ID",
"type": "entitydata"
}
],
"Notes": [],
"internal_axon_id": "",
"labels": []
}
Resultado en JSON para usuarios:
{
"adapters": [
{
"accurate_for_datetime": "Sun, 21 Mar 2021 03:45:01 GMT",
"client_used": "DOMAIN\\axoniusSvc",
"raw": {
"account_disabled": false,
"ad_display_name": "",
"ad_distinguished_name": "CN=example, DC=example",
"ad_sid": "S-1-5-21-70119-3234025",
"ad_uac_dont_expire_password": false,
"ad_uac_password_not_required": false,
"display_name": "",
"domain": "example.example",
"employee_id": "ID",
"first_name": "Example",
"id": "CN=example, DC=example",
"is_admin": false,
"is_local": false,
"is_locked": false,
"last_name": "Example",
"last_password_change": "Wed, 17 Mar 2021 09:12:11 GMT",
"last_seen": "Thu, 18 Mar 2021 09:25:08 GMT",
"mail": "email@example.com",
"password_never_expires": false,
"password_not_required": false,
"user_city": "Boston",
"user_telephone_number": "(800) 555-0175",
"username": "user@example.com"
},
"user_city": "Boston",
"user_telephone_number": "(800) 555-0175",
"username": "user@example.com",
"plugin_name": "active_directory_adapter",
"plugin_type": "Adapter",
"plugin_unique_name": "active_directory_adapter_0",
"quick_id": "active_directory_adapter_0!CN=example,DC=example",
"type": "entitydata"
}
],
"Notes": [],
"internal_axon_id": "",
"labels": []
}
Enriquecimiento de entidades para extremos:
| Nombre del campo de enriquecimiento | Lógica: Cuándo aplicarla |
|---|---|
| object_classes | Cuando está disponible en JSON |
| site_name | Cuando está disponible en JSON |
| device_disabled | Cuando está disponible en JSON |
| device_managed_by | Cuando está disponible en JSON |
| Nombre de host | Cuando está disponible en JSON |
| ad_distinguished_name | Cuando está disponible en JSON |
| asset_name | Cuando está disponible en JSON |
| ips | Cuando está disponible en JSON |
| os | Cuando está disponible en JSON |
| id | Cuando está disponible en JSON |
| vínculo | Cuando está disponible en JSON |
Enriquecimiento de entidades para usuarios:
| Nombre del campo de enriquecimiento | Lógica: Cuándo aplicarla |
|---|---|
| account_disabled | Cuando está disponible en JSON |
| ad_display_name | Cuando está disponible en JSON |
| ad_distinguished_name | Cuando está disponible en JSON |
| ad_sid | Cuando está disponible en JSON |
| employee_id | Cuando está disponible en JSON |
| is_admin | Cuando está disponible en JSON |
| is_local | Cuando está disponible en JSON |
| is_locked | Cuando está disponible en JSON |
| Cuando está disponible en JSON | |
| user_telephone_number | Cuando está disponible en JSON |
| id | Cuando está disponible en JSON |
| vínculo | Cuando está disponible en JSON |
Muro de casos
| Tipo de resultado | Valor/Descripción | Tipo (entidad/general) |
|---|---|---|
| Mensaje de salida* | La acción no debería fallar ni detener la ejecución de una guía: If enriched some(is_success = true): "Successfully enriched the following entities using Axonius:\n".format(entity.identifier) Si no se enriquecieron algunas (is_success = true): "Action wasn't able to enriche the following entities using Axonius:\n".format(entity.identifier) Si no se enriquecieron todas (is_success = false): "No entities were enriched". La acción debería fallar y detener la ejecución de una guía: Si se informa un error grave, como credenciales incorrectas, falta de conexión con el servidor, entre otros: "Error executing action "Enrich Entities". Reason: {0}''.format(error.Stacktrace) |
General |
| Tabla de la entidad | Entidad | |
Tabla del muro de casos (si los atributos, los datos o la lista de datos tienen valores) |
Nombre: {entity.identifier}: Notas Columna:
|
General |
Agregar nota
Agrega una nota a las entidades en Axonius. Las entidades admitidas incluyen el nombre de host, la dirección IP, la dirección MAC, el usuario y las direcciones de correo electrónico (entidades de usuario que coinciden con la expresión regular de correo electrónico).
Parámetros
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| Nota | String | N/A | Sí | Especifica qué nota se debe agregar. |
Fecha de ejecución
Esta acción se ejecuta en las siguientes entidades:
- Nombre de host
- Dirección IP
- Dirección MAC
- Usuario
- Dirección de correo electrónico
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Resultado de JSON
{
"data": {
"attributes": {
"accurate_for_datetime": "2021-03-21T15:55:10.876568+00:00",
"note": "example",
"user_id": "",
"user_name": "internal/apiNAME",
"uuid": ""
},
"type": "notes_details_schema"
}
}
Muro de casos
| Tipo de resultado | Valor/Descripción | Tipo (entidad/general) |
|---|---|---|
| Mensaje de salida* | La acción no debería fallar ni detener la ejecución de una guía: Si se agregó correctamente al menos una nota(is_success = true): "Successfully added note to the following entities in Axonius: {0}".format(entities) Si se produce un error en al menos una entidad(is_success = true): "Action wasn't able to add a note to the following entities in Axonius: {0}".format(entities) Si falla para todas (is_success = false): "No se agregó la nota a las entidades proporcionadas". La acción debería fallar y detener la ejecución de una guía: Si se produce un error fatal, como credenciales incorrectas, falta de conexión con el servidor, etcétera: "Error al ejecutar la acción 'Agregar nota'. Reason: {0}''.format(error.Stacktrace) |
General |
Agregar etiquetas
Agrega etiquetas a las entidades en Axonius. Entidades admitidas: nombre de host, IP, dirección MAC, usuario, direcciones de correo electrónico (entidades de usuario que coinciden con la regex de correo electrónico).
Parámetros
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| Etiquetas | CSV | Sí | Especifica una lista separada por comas de las etiquetas que se deben agregar a las entidades. |
Fecha de ejecución
Esta acción se ejecuta en las siguientes entidades:
- Nombre de host
- Dirección IP
- Dirección MAC
- Usuario
- Dirección de correo electrónico
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Muro de casos
| Tipo de resultado | Valor/Descripción | Tipo (entidad/general) |
|---|---|---|
| Mensaje de salida* | La acción no debería fallar ni detener la ejecución de una guía: Si se agregaron correctamente las etiquetas a al menos una entidad(is_success = true): "Successfully added tags to the following entities in Axonius: {0}".format(entities) Si se produce un error en al menos una entidad(is_success = true): "Action wasn't able to add tags to the following entities in Axonius: {0}".format(entities) Si falla para todas (is_success = false): "No se agregaron etiquetas a las entidades proporcionadas". 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 "Add Tags". Reason: {0}''.format(error.Stacktrace) |
General |
Quitar etiquetas
Quita etiquetas de las entidades en Axonius. Entidades admitidas: nombre de host, IP, dirección MAC, usuario y direcciones de correo electrónico (entidades de usuario que coinciden con la regex de correo electrónico).
Parámetros
| Nombre visible del parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| Etiquetas | CSV | Sí | Especifica una lista separada por comas de las etiquetas que se deben quitar de las entidades. |
Fecha de ejecución
Esta acción se ejecuta en las siguientes entidades:
- Nombre de host
- Dirección IP
- Dirección MAC
- Usuario
- Dirección de correo electrónico
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor |
|---|---|
| is_success | is_success=False |
| is_success | is_success=True |
Muro de casos
| Tipo de resultado | Valor/Descripción | Tipo (entidad/general) |
|---|---|---|
| Mensaje de salida* | La acción no debería fallar ni detener la ejecución de una guía: Si se quita correctamente al menos una etiqueta(is_success = true): "Successfully removed tags from the following entities in Axonius: {0}".format(entities) if at least fail for one(is_success = true): "Action wasn't able to remove tags from the following entities in Axonius: {0}".format(entities) Si se produce un error en todos los casos (is_success = false): "No se quitaron las etiquetas de las entidades proporcionadas". 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 con el servidor, etc.: "Error al ejecutar la acción 'Quitar etiquetas'. Reason: {0}''.format(error.Stacktrace) |
General |
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.