Zscaler
En este documento, se proporcionan instrucciones para integrar Zscaler con Google SecOps.
Casos de uso
La integración de Zscaler usa las capacidades de Google SecOps para admitir los siguientes casos de uso:
Administrar el filtrado de URLs: Actualiza automáticamente las categorías de URLs y las reglas de filtrado para bloquear los dominios maliciosos identificados durante las investigaciones.
Automatiza la administración del ciclo de vida de los usuarios: Administra de forma dinámica el acceso de los usuarios y las membresías de grupos en Zscaler según los niveles de riesgo de seguridad.
Enriquece las alertas de red: Recupera información detallada sobre los usuarios, los departamentos y las ubicaciones asociados con el tráfico bloqueado.
Sincroniza las políticas de seguridad: Implementa cambios de seguridad de forma instantánea en tu entorno de Zscaler para responder a las amenazas activas.
Antes de comenzar
Antes de configurar la integración en Google SecOps, verifica que tu entorno de Zscaler cumpla con los siguientes requisitos:
Método de autenticación: Determina si tu organización usa OAuth 2.0 o la autenticación basada en credenciales heredada. La integración usa estas credenciales para establecer una sesión y recuperar un token temporal para las solicitudes a la API:
OAuth 2.0 (recomendado): Este método usa el servicio ZSLogin para la administración centralizada de identidades. Debes registrar un cliente de OAuth 2.0 en tu proveedor de identidad y agregar el servidor de autorización al portal de administración de ZIA. Para obtener más detalles, consulta Protege las APIs de ZIA con OAuth 2.0.
Credencial heredada: Este método usa una clave de API y credenciales de administrador de ZIA. Para obtener más información, consulta Administra la clave de API de Cloud Service.
Permisos de la cuenta: Asegúrate de que la cuenta de cliente o administrador tenga asignados los roles correctos:
OAuth 2.0: Requiere un rol de API. Para obtener más detalles, consulta Agrega roles de API.
Credencial heredada: Requiere un rol de administrador con permisos de acceso a la API habilitados. Para obtener más información, consulta Agrega roles de administrador.
Acceso a la red: Asegúrate de que la configuración de red permita conexiones HTTPS salientes desde tu entorno de Google SecOps a los endpoints de API de Zscaler, por ejemplo,
zsapi.{your_cloud_name}.
Parámetros de integración
La integración de Zscaler requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Api Root |
Obligatorio. Es la URL base de la instancia de Zscaler, por ejemplo,
|
Login ID |
Es opcional. Es el nombre de usuario o la dirección de correo electrónico asociados con la cuenta de administrador de Zscaler que se usa para la autenticación. Este parámetro es obligatorio para la autenticación heredada. Si se proporcionan credenciales heredadas y de OAuth 2.0, estas últimas tienen prioridad. |
Api Key |
Es opcional. Es la clave de API única que se genera en el portal de Zscaler para autorizar las solicitudes a la API. Este parámetro es obligatorio para la autenticación heredada. Si se proporcionan credenciales heredadas y de OAuth 2.0, estas últimas tienen prioridad. |
Password |
Es opcional. Es la contraseña asociada con la cuenta de administrador de Zscaler que se usa para la autenticación. Este parámetro es obligatorio para la autenticación heredada. Si se proporcionan credenciales heredadas y de OAuth 2.0, estas últimas tienen prioridad. |
Verify SSL |
Es opcional. Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de Zscaler. Habilitada de forma predeterminada. |
Client ID |
Es opcional. Es el identificador único del cliente de OAuth 2.0 que se usa para la autenticación con el servicio de ZSLogin. Este parámetro es obligatorio para la configuración de OAuth 2.0 y tiene prioridad sobre la autenticación heredada. |
Client Secret |
Es opcional. Es la clave secreta asociada con el ID de cliente que se usa para autenticar el cliente de OAuth 2.0. Este parámetro es obligatorio para la configuración de OAuth 2.0 y tiene prioridad sobre la autenticación heredada. |
Login API Root |
Es opcional. Es la URL base del servicio de ZSLogin que se usa para la administración centralizada de identidades y accesos. Este parámetro es obligatorio para la configuración de OAuth 2.0 y tiene prioridad sobre la autenticación heredada. El valor predeterminado es |
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.
Agregar a la lista negra
Agrega una URL, un dominio o una IP a la lista de entidades bloqueadas.
Entradas de acción
Esta acción requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
IOCs |
Es opcional. Es una lista separada por comas de IOC (direcciones IP, URLs o dominios) para agregar a
la lista de entidades bloqueadas, por ejemplo, |
Fecha de ejecución
Esta acción se ejecuta en las siguientes entidades:
- URL
- Nombre de host
- Dirección IP
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
Enriquecimiento de entidades
N/A
Estadísticas
N/A
Agregar a la lista de entidades permitidas
Agrega una URL, un dominio o una IP a la lista de entidades permitidas.
Entradas de acción
Esta acción requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
IOCs |
Es opcional. Es una lista separada por comas de IOC (direcciones IP, URLs o dominios) para agregar a
la lista de entidades permitidas, por ejemplo, |
Fecha de ejecución
Esta acción se ejecuta en las siguientes entidades:
- URL
- Nombre de host
- Dominio
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
Enriquecimiento de entidades
N/A
Estadísticas
N/A
Obtener lista de bloqueo
Obtiene una lista de URLs incluidas en la lista de bloqueo.
Parámetros
N/A
Fecha de ejecución
Esta acción se ejecuta en todas las entidades.
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
Enriquecimiento de entidades
N/A
Estadísticas
N/A
Obtener informe de zona de pruebas
Obtén un informe completo de un hash MD5 de un archivo que analizó la zona de pruebas.
Parámetros
N/A
Fecha de ejecución
Esta acción se ejecuta en la entidad Filehash.
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
[
{
"EntityResult":
{
"Full Details":
{
"SystemSummary": [
{
"SignatureSources": [
"",
"76CD0000 page execute and read and write",
"76DD0000 page execute and read and write"
],
"Risk": "LOW",
"Signature": "Allocates memory within range which is reserved for system DLLs"
},{
"SignatureSources": [
"",
"wow64.pdb source: loaddll32.exe",
"wow64.pdbH source: loaddll32.exe",
"wow64cpu.pdb source: loaddll32.exe",
"wow64win.pdb source: loaddll32.exe",
"wow64win.pdbH source: loaddll32.exe"
],
"Risk": "LOW",
"Signature": "Binary contains paths to debug symbols"
},{
"SignatureSources": [
"",
"clean0.winDLL@1/1@0/0"
],
"Risk": "LOW",
"Signature": "Classification label"
}, {
"SignatureSources":[
"",
"More than 502 > 100 exports found"
],
"Risk": "LOW",
"Signature": "PE file exports many functions"
}, {
"SignatureSources": [
"",
"Virtual size of .text is bigger than: 0x100000"
],
"Risk": "LOW",
"Signature": "PE file has a big code size"
},{
"SignatureSources": [
"",
"Raw size of .text is bigger than: 0x100000 < 0x176000"
],
"Risk": "LOW",
"Signature": "PE file has a big raw section"
}, {
"SignatureSources": [
"",
"Image base 0x704c0000 > 0x60000000"
],
"Risk": "LOW",
"Signature": "PE file has a high image base. often used for DLLs"
}, {
"SignatureSources": [
"",
"Section: .text IMAGE_SCN_ALIGN_MASK, IMAGE_SCN_ALIGN_256BYTES, IMAGE_SCN_ALIGN_16BYTES, IMAGE_SCN_ALIGN_64BYTES, IMAGE_SCN_ALIGN_1BYTES, IMAGE_SCN_MEM_EXECUTE, IMAGE_SCN_CNT_INITIALIZED_DATA, IMAGE_SCN_ALIGN_2048BYTES, IMAGE_SCN_ALIGN_1024BYTES, IMAGE_SCN"
],
"Risk": "LOW",
"Signature": "PE file has an executable .text section and no other executable section"
}, {
"SignatureSources": [
"", "HKEY_USERS\\\\Software\\\\Policies\\\\Microsoft\\\\Windows\\\\Safer\\\\CodeIdentifiers"
],
"Risk": "LOW",
"Signature": "Reads software policies"
},{
"SignatureSources": [
"",
"File size 1710606 > 1048576"
],
"Risk": "LOW",
"Signature": "Submission file is bigger than most known malware samples"
},{
"SignatureSources": [
"",
"no activity detected"
],
"Risk": "MODERATE",
"Signature": "Program does not show much activity"
}
],
"Summary":
{
"Status": "COMPLETED",
"Category": "EXECS",
"FileType": "DLL",
"Duration": 499618,
"StartTime": 1553130306
},
"Classification":
{
"Category": "BENIGN",
"Type": "BENIGN",
"Score": 0,
"DetectedMalware": ""
},
"Persistence":[
{
"SignatureSources": [
"",
"section name: /4"
],
"Risk": "LOW",
"Signature": "PE file contains sections with non-standard names"
}
],
"FileProperties":
{
"SHA1": "b0aa7eecfa6c0066504bf79efe1bc057ac61e9b8",
"FileSize": 1710606,
"RootCA": "",
"Issuer": "",
"FileType": "DLL",
"Sha256": "a39180232ae6a689650f5df566bb4e81b94d9d19a53363ce17d7a12fd21f78cf",
"DigitalCerificate": "",
"SSDeep": "24576:3LnYQhDtnNgQe42lcCZNj4I/MmaOdb+Y+mmY5Gc3nGkh2sQginrgGGQCTQIMGNdd:zYQlEpIE/p3nFhckZF7oU",
"MD5": "1803c2c0f0ec61c98b3630d7e4b1cd5d"
}
}
},
"Entity": "1803C2C0F0EC61C98B3630D7E4B1CD5D"
}
]
Enriquecimiento de entidades
| Nombre del campo de enriquecimiento | Lógica: Cuándo aplicarla |
|---|---|
| Todos los detalles | Se devuelve si existe en el resultado JSON |
Estadísticas
N/A
Obtén categorías de URL
Obtiene información sobre todas las categorías de URLs.
Parámetros
N/A
Fecha de ejecución
Esta acción se ejecuta en todas las entidades.
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
[
{
"description": "OTHER_ADULT_MATERIAL_DESC",
"val": 1,
"dbCategorizedUrls": [],
"editable": true,
"urls": [],
"customCategory": false,
"id": "OTHER_ADULT_MATERIAL"
}, {
"description": "ADULT_THEMES_DESC",
"val": 2,
"dbCategorizedUrls": [],
"editable": true,
"urls": [],
"customCategory": false,
"id": "ADULT_THEMES"
}
]
Enriquecimiento de entidades
N/A
Estadísticas
N/A
Obtener lista de entidades permitidas
Obtiene una lista de URLs incluidas en la lista de entidades permitidas.
Parámetros
N/A
Fecha de ejecución
Esta acción se ejecuta en todas las entidades.
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
Enriquecimiento de entidades
N/A
Estadísticas
N/A
Busca una entidad
Busca la categorización de una URL, un dominio o una IP.
Parámetros
N/A
Fecha de ejecución
Esta acción se ejecuta en las siguientes entidades:
- URL
- Nombre de host
- Dominio
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
[
{
"EntityResult": {
"url": "markossolomon.com/f1q7qx.php",
"urlClassificationsWithSecurityAlert": ["MALWARE_SITE"],
"urlClassifications": []
},
"Entity": "HTTP://MARKOSSOLOMON.COM/F1Q7QX.PHP"
}
]
Enriquecimiento de entidades
| Nombre del campo de enriquecimiento | Lógica: Cuándo aplicarlas |
|---|---|
| url | Devuelve si existe en el resultado JSON |
| urlClassificationsWithSecurityAlert | Se devuelve si existe en el resultado JSON |
| urlClassifications | Se devuelve si existe en el resultado JSON |
Estadísticas
N/A
Ping
Verifica la conectividad.
Parámetros
N/A
Fecha de ejecución
Esta acción se ejecuta en todas las entidades.
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
Enriquecimiento de entidades
N/A
Estadísticas
N/A
Quitar de la lista de bloqueo
Quita una URL, un dominio o una IP de la lista de entidades bloqueadas.
Entradas de acción
Esta acción requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
IOCs |
Es opcional. Es una lista separada por comas de IOC (direcciones IP, URLs o dominios) que se quitarán
de la lista de entidades bloqueadas, por ejemplo, |
Fecha de ejecución
Esta acción se ejecuta en las siguientes entidades:
- URL
- Nombre de host
- Dirección IP
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
Enriquecimiento de entidades
N/A
Estadísticas
N/A
Quitar de la lista de entidades permitidas
Quita una URL, un dominio o una IP de la lista de entidades permitidas.
Entradas de acción
Esta acción requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
IOCs |
Es opcional. Es una lista separada por comas de IOC (direcciones IP, URLs o dominios) que se quitarán
de la lista de entidades permitidas, por ejemplo, |
Fecha de ejecución
Esta acción se ejecuta en las siguientes entidades:
- URL
- Nombre de host
- Dirección IP
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
Enriquecimiento de entidades
N/A
Estadísticas
N/A
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.