Recopila registros de Avaya Aura
Versión del analizador: 3.0
En este documento, se explica cómo transferir registros de Avaya Aura a Google Security Operations con el agente de Bindplane.
Avaya Aura es una plataforma de comunicaciones unificadas que genera mensajes de syslog para eventos de acceso y salida de usuarios, cambios en la configuración del sistema y eventos de seguridad. El analizador extrae campos de los mensajes de syslog con patrones de grok y los asigna al modelo de datos unificado (UDM).
Antes de comenzar
Asegúrate de cumplir con los siguientes requisitos previos:
- Una instancia de Google SecOps
- Windows Server 2016 o posterior, o host de Linux con
systemd - Conectividad de red entre el agente de Bindplane y el sistema Avaya Aura
- Si se ejecuta detrás de un proxy, asegúrate de que los puertos del firewall estén abiertos según los requisitos del agente de Bindplane
- Acceso con privilegios a Avaya Aura
Obtén credenciales de Google SecOps para el agente de Bindplane
Para autenticar el agente de Bindplane en Google SecOps, elige uno de los siguientes métodos:
- Implementaciones nuevas: Usa la API de Chronicle (opción 1).
- Implementaciones heredadas: Sigue usando el archivo de autenticación de transferencia (opción 2) hasta que se descontinúe la API de Ingestion el 20 de julio de 2027.
Opción 1: Crea una cuenta de servicio para la API de Chronicle (recomendado)
- Accede a la consola deGoogle Cloud y selecciona el proyecto de Google Cloud que está vinculado a tu instancia de Google SecOps.
- Ve a IAM y administración > Cuentas de servicio.
- Haga clic en Crear cuenta de servicio.
- Proporciona los siguientes detalles de configuración:
- Nombre de la cuenta de servicio: Ingresa un nombre para la cuenta (por ejemplo,
bindplane-ingest). - Descripción de la cuenta de servicio: Ingresa una descripción (por ejemplo,
Bindplane agent log ingestion).
- Nombre de la cuenta de servicio: Ingresa un nombre para la cuenta (por ejemplo,
- Haz clic en Crear y continuar.
- En la sección Otorga a esta cuenta de servicio acceso al proyecto, haz clic en Seleccionar un rol y elige Editor de Chronicle.
- Haz clic en Continuar y, luego, en Listo.
- Haz clic en la cuenta de servicio que creaste y, luego, ve a la pestaña Claves.
- Haz clic en Agregar clave > Crear clave nueva.
- Selecciona JSON y haz clic en Crear. El archivo de claves se descargará en tu computadora.
- Guarda el archivo de claves como
ingestion-auth.jsonen el directorio del recopilador de Bindplane (/opt/observiq-otel-collector/ingestion-auth.jsonen Linux oC:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.jsonen Windows) o actualizacreds_file_pathenconfig.yamlpara que coincida con la ruta de acceso en la que lo guardas. - Ve a IAM y administración > Configuración y copia el Número de proyecto. Lo necesitarás para la configuración del exportador.
Opción 2: Descarga el archivo de autenticación de transferencia (heredado)
- Accede a la consola de Google SecOps.
- Ve a Configuración > Administración de datos > Agentes de recopilación. Si estás en una plataforma solo de SIEM, ve a Configuración > Agentes de recopilación.
- Descarga el archivo de autenticación de transferencia.
- Guarda el archivo de forma segura en el sistema en el que se instalará el agente de Bindplane.
Obtén el ID de cliente de Google SecOps
- Accede a la consola de Google SecOps.
- Ve a Configuración > Administración > Perfil. Si estás en una plataforma solo de SIEM, ve a Configuración > Perfil.
Copia y guarda el ID de cliente de la sección Detalles de la organización.
Instala el agente de Bindplane
Instala el agente de Bindplane en tu sistema operativo Windows o Linux según las siguientes instrucciones.
Instalación en Windows
- Abre el símbolo del sistema o PowerShell como administrador.
Ejecuta el comando siguiente:
msiexec /i "https://github.com/observIQ/bindplane-agent/releases/latest/download/observiq-otel-collector.msi" /quietEspera a que se complete la instalación.
Ejecuta el siguiente comando para verificar la instalación:
sc query observiq-otel-collectorEl servicio debería mostrarse como RUNNING.
Instalación en Linux
- Abre una terminal con privilegios de raíz o sudo.
Ejecuta el comando siguiente:
sudo sh -c "$(curl -fsSlL https://github.com/observiq/bindplane-agent/releases/latest/download/install_unix.sh)" install_unix.shEspera a que se complete la instalación.
Ejecuta el siguiente comando para verificar la instalación:
sudo systemctl status observiq-otel-collectorEl servicio debería mostrarse como active (running).
Recursos de instalación adicionales
Para obtener más opciones de instalación y solución de problemas, consulta la guía de instalación del agente de Bindplane.
Configura el agente de BindPlane para transferir syslog y enviarlo a Google SecOps
Ubica el archivo de configuración
Linux:
sudo nano /opt/observiq-otel-collector/config.yamlWindows:
notepad "C:\Program Files\observIQ OpenTelemetry Collector\config.yaml"
Edita el archivo de configuración
Reemplaza todo el contenido de
config.yamlpor la siguiente configuración:receivers: udplog: listen_address: "0.0.0.0:514" exporters: chronicle/avaya_aura: protocol: https # Region of your instance, for example us, europe, asia-southeast1 location: <LOCATION> # Project number of the Google Cloud project linked to the instance project: '<PROJECT_NUMBER>' compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: '<customer_id>' endpoint: chronicle.googleapis.com log_type: AVAYA_AURA raw_log_field: body service: pipelines: logs/avaya_aura_to_chronicle: receivers: - udplog exporters: - chronicle/avaya_aura
Parámetros de configuración
Reemplaza los marcadores de posición que se indican más abajo:
Configuración del receptor:
listen_address: Es la dirección IP y el puerto que se escucharán:0.0.0.0para escuchar en todas las interfaces (recomendado)- El puerto
514es el puerto estándar de syslog (requiere acceso raíz en Linux; usa1514para acceso no raíz)
Configuración del exportador:
creds_file_path: Ruta de acceso completa al archivo de claves JSON de la cuenta de servicio (opción 1):- Linux:
/opt/observiq-otel-collector/ingestion-auth.json - Windows:
C:\Program Files\observIQ OpenTelemetry Collector\ingestion-auth.json
- Linux:
customer_id: Es el ID de cliente copiado de la consola de Google SecOps.location: Reemplaza<LOCATION>por la región de tu instancia de Google SecOps (por ejemplo,us,europeoasia-southeast1). El exportador agrega el prefijochronicle.googleapis.comcon este valor. Consulta Extremos regionales para obtener la lista completa.project: Reemplaza<PROJECT_NUMBER>por el número de proyecto de IAM y administración > Configuración.endpoint: Mantén la configuración comochronicle.googleapis.com.
Exportador de la API de transferencia heredada
Si usas el archivo de autenticación de transferencia de la opción 2, reemplaza el bloque
exporterspor lo siguiente. Establececreds_file_pathen la ruta de acceso al archivo de autenticación de transferencia y, si tu instancia está fuera de EE.UU., reemplazamalachiteingestion-pa.googleapis.compor tu extremo regional (por ejemplo,europe-malachiteingestion-pa.googleapis.com).exporters: chronicle/avaya_aura: compression: gzip creds_file_path: '/opt/observiq-otel-collector/ingestion-auth.json' customer_id: '<customer_id>' endpoint: malachiteingestion-pa.googleapis.com log_type: AVAYA_AURA raw_log_field: body
Guarda el archivo de configuración
- Después de editarlo, guarda el archivo:
- Linux: Presiona
Ctrl+O, luegoEntery, por último,Ctrl+X - Windows: Haz clic en Archivo > Guardar.
- Linux: Presiona
Reinicia el agente de Bindplane para aplicar los cambios.
Para reiniciar el agente de Bindplane en Linux, ejecuta el siguiente comando:
sudo systemctl restart observiq-otel-collectorVerifica que el servicio esté en ejecución:
sudo systemctl status observiq-otel-collectorRevisa los registros en busca de errores:
sudo journalctl -u observiq-otel-collector -f
Para reiniciar el agente de Bindplane en Windows, elige una de las siguientes opciones:
Símbolo del sistema o PowerShell como administrador:
net stop observiq-otel-collector && net start observiq-otel-collectorConsola de servicios:
- Presiona
Win+R, escribeservices.mscy presiona Intro. - Busca observIQ OpenTelemetry Collector.
- Haz clic con el botón derecho y selecciona Reiniciar.
Verifica que el servicio esté en ejecución:
sc query observiq-otel-collectorRevisa los registros en busca de errores:
type "C:\Program Files\observIQ OpenTelemetry Collector\log\collector.log"
- Presiona
Configura syslog en Avaya Aura
- Accede a la consola de Avaya Aura.
- Ve a EM > System Configuration > Logging Settings > Syslog.
- Habilita SYSLOG Delivery of Logs.
- Haz clic en Agregar.
- Proporciona los siguientes detalles de configuración:
- Dirección del servidor: Ingresa la dirección IP del agente de Bindplane.
- Puerto: Ingresa el puerto de escucha del agente de Bindplane.
- Haz clic en Guardar.
- Haz clic en Confirmar.
- Reinicia Avaya Aura.
Tabla de asignación de UDM
| Campo de registro | Asignación de UDM | Lógica |
|---|---|---|
| data{}.@timestamp | metadata.event_timestamp | La marca de tiempo del evento se analiza desde el campo de datos con el patrón de grok y se asigna al campo event_timestamp en la sección de metadatos del UDM. |
| data{}.host | principal.hostname | El valor del host se extrae del campo de datos con el patrón de grok y se asigna al campo de nombre de host dentro de la sección principal de la UDM. |
| data{}.portal | security_result.about.resource.attribute.labels.value | El valor del portal se extrae del campo de datos con el patrón de grok y se asigna como el valor de la etiqueta Portal dentro de la sección about.resource.attribute.labels de security_result en el UDM. |
| data{}.prod_log_id | metadata.product_log_id | El valor prod_log_id se extrae del campo de datos con el patrón de grok y se asigna al campo product_log_id en la sección de metadatos del UDM. |
| data{}.sec_cat | security_result.category_details | El valor sec_cat se extrae del campo de datos con el patrón de grok y se asigna al campo category_details dentro de la sección security_result del UDM. |
| data{}.sec_desc | security_result.description | El valor sec_desc se extrae del campo de datos con el patrón de grok y se asigna al campo de descripción dentro de la sección security_result del UDM. |
| data{}.severity | security_result.severity | El valor de gravedad se extrae del campo de datos con el patrón de grok. Si la gravedad es warn, fatal o error (no distingue mayúsculas de minúsculas), se asigna a HIGH en el campo security_result.severity del UDM. De lo contrario, si la gravedad es info (no distingue mayúsculas de minúsculas), se asigna a LOW. |
| data{}.summary | security_result.summary | El valor de resumen se extrae del campo de datos con el patrón de grok y se asigna al campo de resumen dentro de la sección security_result del UDM. |
| data{}.user_id | target.user.userid | El valor user_id se extrae del campo de datos con el patrón de grok y se asigna al campo userid dentro de la sección target.user del UDM. |
| extensions.auth.type | El campo auth.type se establece en AUTHTYPE_UNSPECIFIED si el campo event_name contiene log(in|on) o logoff (no distingue mayúsculas de minúsculas), o si el campo de resumen contiene login o logoff (no distingue mayúsculas de minúsculas) y el campo user_id no está vacío. |
|
| metadata.description | El campo de descripción se completa con el valor del campo desc si no está vacío. | |
| metadata.event_type | El campo event_type se determina según la siguiente lógica: - Si el campo nombre del evento contiene log(in|on) o el campo summary contiene login (no distingue mayúsculas de minúsculas) y el campo ID de usuario no está vacío, el event_type se establece en USER_LOGIN. - Si el campo event_name contiene logoff o el campo summary contiene logoff (no distingue mayúsculas de minúsculas) y el campo user_id no está vacío, el event_type se establece en USER_LOGOUT. - Si el campo has_principal es true, el event_type se establece en STATUS_UPDATE. - De lo contrario, el event_type permanece como GENERIC_EVENT (valor predeterminado). |
|
| metadata.log_type | El log_type está codificado como AVAYA_AURA. |
|
| metadata.product_event_type | El campo product_event_type se propaga con el valor del campo event_name si no está vacío. | |
| metadata.product_name | El product_name está codificado como AVAYA AURA. |
|
| metadata.vendor_name | El vendor_name está codificado en AVAYA AURA. |
|
| security_result.action | El campo action dentro de la sección security_result se establece según la siguiente lógica: - Si el campo summary contiene fail o failed (no distingue mayúsculas de minúsculas), el campo action se establece en BLOCK. - Si el campo de resumen contiene success (no distingue mayúsculas de minúsculas), la acción se establece en ALLOW. |
|
| security_result.severity_details | El campo severity_details se propaga con el valor del campo severity_details si no está vacío. | |
| timestamp.nanos | metadata.event_timestamp.nanos | El valor de nanos del campo de marca de tiempo se asigna directamente al campo nanos dentro de la sección event_timestamp de los metadatos en el UDM. |
| timestamp.seconds | metadata.event_timestamp.seconds | El valor de segundos del campo de marca de tiempo se asigna directamente al campo de segundos dentro de la sección event_timestamp de los metadatos en el UDM. |
time |
event.idm.read_only_udm.metadata.event_timestamp |
Asignado desde el registro de cambios |
src_ip |
event.idm.read_only_udm.principal.ip y event.idm.read_only_udm.principal.asset.ip |
Asignado desde el registro de cambios |
src_port |
event.idm.read_only_udm.principal.port |
Asignado desde el registro de cambios |
dst_ip |
event.idm.read_only_udm.target.ip y event.idm.read_only_udm.target.asset.ip |
Asignado desde el registro de cambios |
dst_port |
event.idm.read_only_udm.target.port |
Asignado desde el registro de cambios |
process_pid |
event.idm.read_only_udm.principal.process.pid |
Asignado desde el registro de cambios |
principal_application |
event.idm.read_only_udm.principal.application |
Asignado desde el registro de cambios |
network_protocol |
event.idm.read_only_udm.network.ip_protocol |
Asignado desde el registro de cambios |
application_protocol_version |
event.idm.read_only_udm.network.application_protocol_version |
Asignado desde el registro de cambios |
community_id |
event.idm.read_only_udm.network.community_id |
Asignado desde el registro de cambios |
security_description |
event.idm.read_only_udm.security_result.description |
Asignado desde el registro de cambios |
device_uptime |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
cmg_trap_subsystem |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
cmg_trap_onboard |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
cmg_trap_location |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
syslog_priority |
event.idm.read_only_udm.additional.fields |
Asignado desde el registro de cambios |
Registro de cambios
Consulta el registro de cambios de este analizador
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.