Integra Jira con Google SecOps
En este documento, se explica cómo integrar Jira con Google Security Operations.
Casos de uso
La integración de Jira usa las capacidades de Google SecOps para admitir los siguientes casos de uso:
Generación automática de tickets: Crea automáticamente problemas de Jira a partir de alertas de Google SecOps con el conector de Jira para optimizar la transferencia entre los equipos de seguridad y de TI.
Sincronización bidireccional: Mantén la coherencia entre las plataformas sincronizando automáticamente los comentarios y los cambios de estado entre los tickets de Jira y los casos de Google SecOps con trabajos de sincronización dedicados.
Enriquecimiento de incidentes: Adjunta evidencia, registros y capturas de pantalla directamente a los problemas de Jira con la acción Subir archivo adjunto para proporcionar un contexto completo a los encargados de la solución.
Administración dinámica de tareas: Actualiza, asigna o vincula problemas de Jira relacionados directamente desde la guía de Google SecOps para automatizar los procedimientos operativos estándar (SOP).
Antes de comenzar
Antes de configurar la integración de Jira en la plataforma de Google SecOps, verifica que tengas lo siguiente:
Compatibilidad de productos: Acceso a una instancia de Jira Cloud o a un entorno de Jira Data Center (local).
Método de autenticación: Elige un método de autenticación.
- Autenticación básica (Jira Cloud): Requiere un nombre de usuario (correo electrónico) y un token de API de Atlassian.
- Autenticación de la cuenta de servicio (Jira Cloud): Requiere un token de cuenta de servicio y tu ID de Cloud.
- Autenticación estándar (Jira Data Center): Requiere un nombre de usuario y una contraseña válidos.
URL raíz de la API: El formato de la raíz de la API depende de tu método de autenticación.
- Estándar/Básico: Es la URL base de tu instancia de Jira (por ejemplo,
https://yourdomain.atlassian.net). - Cuenta de servicio: Es la URL del proxy de la API de Atlassian, que debe incluir tu
ID de Cloud (por ejemplo,
https://api.atlassian.com/ex/jira/{cloud_id}).
- Estándar/Básico: Es la URL base de tu instancia de Jira (por ejemplo,
Configura la autenticación para Jira Cloud
Para conectarte a Jira Cloud con un token de API, sigue las instrucciones de la documentación de Atlassian para generar un token.
Configura la autenticación para las cuentas de servicio
Para usar la autenticación basada en tokens (token del portador) en Jira Cloud, sigue estos pasos:
Consulta Información sobre las cuentas de servicio para obtener más detalles sobre cómo crear una cuenta de servicio con la consola de Atlassian Admin.
Para recuperar tu ID de Cloud, navega a:
https://<your_tenant>.atlassian.net/_edge/tenant_info(donde<your_tenant>es el nombre de tu instancia específica de Atlassian).Cuando configures la integración, deja el campo Nombre de usuario en blanco para activar la autenticación con token del portador.
Parámetros de integración
La integración de Jira requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Api Root |
Obligatorio. La URL base de la instancia de Jira. |
Username |
Es opcional. Es el nombre de usuario (correo electrónico) que se usa para conectarse a Jira. El requisito de este parámetro depende del método de autenticación elegido:
Para obtener más información sobre los métodos de autenticación, consulta Antes de comenzar. |
Api Token |
Obligatorio. Es la credencial de autenticación que se usa para conectarse a Jira. Este campo acepta tokens de API, tokens de cuenta de servicio o contraseñas estándar (para el centro de datos). |
Verify SSL |
Es opcional. Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de Jira. |
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 comentario
Usa la acción Agregar comentario para redactar y agregar un comentario a un problema de Jira existente.
Esta es una forma eficaz de documentar los hallazgos, proporcionar actualizaciones y colaborar con los miembros del equipo directamente desde Google SecOps.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Agregar comentario requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Issue Key |
Obligatorio. Es el identificador único del problema de Jira (por ejemplo,
|
Comment |
Obligatorio. Es el texto que se agregará al problema de Jira. |
Resultados de la acción
La acción Agregar comentario proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Agregar comentario:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
comment_id |
Es el ID único del comentario recién creado en Jira. |
Asignar problema
Usa la acción Asignar problema para asignar un problema de Jira a un usuario específico.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Asignar problema requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Issue Key |
Obligatorio. Es el identificador único del problema de Jira (por ejemplo,
|
Assignee |
Obligatorio. Es el nombre o la dirección de correo electrónico del usuario al que se le asignará el problema. |
Jira Username |
Es opcional. Es el nombre de usuario de Jira de la persona que inicia la acción de asignación. |
Resultados de la acción
La acción Asignar problema proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Asignar problema:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
success |
true o false |
Crea un problema de alerta
Usa la acción Crear un problema de alerta para crear un ticket nuevo en Jira para una alerta específica.
Esta acción se usa principalmente en las guías para derivar incidentes de seguridad a los equipos de TI o ingeniería para que realicen más investigaciones o correcciones.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Crear problema de alerta requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Project Key |
Obligatorio. Es la clave abreviada única del proyecto de Jira en el que se crea el problema
(como |
Summary |
Obligatorio. Un título o resumen breve del problema. |
Issue Type |
Obligatorio. Es el nombre del tipo de problema (como |
Resultados de la acción
La acción Create Alert Issue proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando la acción crea un problema de forma correcta:
{
"summary": "Sample issue",
"description": "Create Enrich entities action using Insights API (IOC search). Write connector for alerts.",
"project": {
"key": "PR",
"name": "Project 1",
"projectTypeKey": "software"
},
"issuetype": {
"name": "Task",
"subtask": false
},
"status": {
"name": "DONE",
"statusCategory": {
"name": "Done",
"key": "done"
}
},
"priority": {
"name": "Medium",
"id": "3"
},
"creator": {
"displayName": "user1",
"emailAddress": "john_doe@example.com"
},
"assignee": {
"displayName": "user2",
"emailAddress": "john_doe@example.com"
},
"created": "2018-06-19T15:23:13.701+0300",
"updated": "2018-09-18T10:02:06.347+0300"
}
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Crear un problema de alerta:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
issue_key |
Es la clave abreviada única del problema de Jira recién creado (por ejemplo,
SEC-456). |
Crear problema
Usa la acción Create Issue para crear un ticket nuevo en un proyecto de Jira.
Esta acción proporciona opciones de personalización extensas, incluida la capacidad de especificar componentes, etiquetas y campos personalizados con JSON, lo que la hace adecuada para flujos de trabajo complejos de creación de tickets.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Crear problema requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Project Key |
Obligatorio. Es la clave abreviada única del proyecto de Jira en el que se crea el problema
(como |
Summary |
Obligatorio. Un título o resumen breve del problema. |
Description |
Es opcional. Una descripción detallada del problema |
Issue Type |
Obligatorio. Es el nombre del tipo de problema (como |
Jira Username |
Es opcional. Es el nombre de usuario de Jira de la persona que inicia la acción. |
Assignee |
Es opcional. Es el identificador del usuario al que se le asignó el problema. |
Components |
Es opcional. Es una lista separada por comas de los componentes de Jira que se asociarán con el problema. |
Labels |
Es opcional. Es una lista de etiquetas separadas por comas que se agregarán al problema. |
Custom Fields |
Es opcional. Es un objeto JSON que contiene campos y valores adicionales que se establecerán durante
la creación (por ejemplo, Los valores proporcionados en este parámetro tienen prioridad y reemplazan otras asignaciones de campos si se produce un conflicto. |
Resultados de la acción
La acción Crear problema proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Crear problema:
{
"summary": "Sample issue",
"description": "Create Enrich entities action using Insights API (IOC search). Write connector for alerts. In a couple of days we will have access to an instance.",
"project": {
"key": "PR",
"name": "Project 1",
"projectTypeKey": "software"
},
"issuetype": {
"name": "Task",
"description": "A task that needs to be done.",
"subtask": false
},
"status": {
"name": "DONE",
"statusCategory": {
"name": "Done",
"key": "done",
"colorName": "green"
}
},
"priority": {
"name": "Medium",
"id": "3"
},
"resolution": {
"name": "Done",
"description": "Work has been completed on this issue."
},
"creator": {
"displayName": "user1",
"emailAddress": "john_doe@example.com",
"active": true,
"timeZone": "Asia/Jerusalem"
},
"assignee": {
"displayName": "user2",
"emailAddress": "john_doe@example.com",
"active": true
},
"reporter": {
"displayName": "user1",
"emailAddress": "john_doe@example.com"
},
"labels": [
"Label1"
],
"attachment": [
{
"id": "1001",
"filename": "file.rar",
"mimeType": "binary/octet-stream",
"size": 15420,
"created": "2018-06-19T15:23:07.369+0300"
}
],
"created": "2018-06-19T15:23:13.701+0300",
"updated": "2018-09-18T10:02:06.347+0300",
"resolutiondate": "2018-09-18T10:02:06.340+0300",
"watches": {
"watchCount": 1,
"isWatching": false
}
}
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Crear problema:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
issue_key |
Es la clave abreviada única del problema de Jira recién creado (por ejemplo,
SEC-789). |
Borrar problema
Usa la acción Borrar problema para quitar un problema de Jira de forma permanente.
Esta acción se suele usar para limpiar tickets duplicados o quitar datos de prueba generados durante el desarrollo de la guía.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Borrar problema requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Issue Key |
Obligatorio. Es la clave abreviada única del problema de Jira que se borrará (por ejemplo,
|
Resultados de la acción
La acción Borrar problema proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de secuencia de comandos
En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Borrar problema:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
success |
true o false |
Descarga archivos adjuntos
Usa la acción Descargar archivos adjuntos para recuperar todos los archivos adjuntos a un
ticket de Jira específico. Si un archivo adjunto es un archivo .eml, la acción también descarga los archivos que contiene ese correo electrónico.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Descargar archivos adjuntos requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Issue Key |
Obligatorio. Es la clave abreviada única del problema de Jira (por ejemplo,
|
Download Path |
Es opcional. Es la ruta de acceso local o interna a la carpeta en la que la acción guarda los archivos adjuntos descargados. El formato requerido depende del tipo de implementación:
|
Download Attachments to the Case Wall |
Es opcional. Si se selecciona, la acción descarga los archivos adjuntos del problema de Jira directamente en el muro de casos actual de Google SecOps. Existe una limitación de tamaño para los archivos adjuntos que se agregan al muro de casos. Es posible que no se puedan subir los archivos grandes. Está inhabilitado de forma predeterminada. |
Resultados de la acción
La acción Descargar archivos adjuntos proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | Disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Descargar archivos adjuntos:
[
{
"download_path": "downloads/Security_Evidence.eml",
"attachment_details": {
"id": "10007",
"filename": "Security_Evidence.eml",
"author": {
"displayName": "Security Analyst",
"emailAddress": "analyst@example.com",
"active": true,
"timeZone": "Asia/Calcutta"
},
"created": "2024-05-25T20:27:09.066+0530",
"size": 12049140,
"mimeType": "message/rfc822"
}
},
{
"download_path": "downloads/Logs_Attachment.txt",
"attachment_details": {
"id": "10005",
"filename": "Logs_Attachment.txt",
"author": {
"displayName": "System Admin",
"emailAddress": "admin@example.com",
"active": true,
"timeZone": "Asia/Calcutta"
},
"created": "2024-05-16T11:48:24.141+0530",
"size": 43,
"mimeType": "text/plain"
}
}
]
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Descargar archivos adjuntos:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
true o false |
Obtener problemas
Usa la acción Obtener problemas para recuperar los detalles completos de uno o más problemas de Jira.
Esta acción es útil para enriquecer los casos de Google SecOps con metadatos de tickets actuales (como el estado, el destinatario y la prioridad).
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Obtener problemas requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Issue Keys |
Obligatorio. Es una lista separada por comas de las claves de problemas de Jira que se recuperarán (por ejemplo,
|
Resultados de la acción
La acción Get Issues proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción Obtener problemas:
{
"issues_details_list": [
{
"key": "TES-65",
"summary": "New summary",
"description": "Detailed description of the security incident.",
"project": {
"key": "TES",
"name": "test-project1",
"projectTypeKey": "software"
},
"issuetype": {
"name": "Bogue",
"subtask": false
},
"status": {
"name": "Fini",
"statusCategory": {
"name": "Terminé",
"key": "done"
}
},
"priority": {
"name": "Medium",
"id": "3"
},
"assignee": {
"displayName": "Vasil Daskalov",
"emailAddress": "vasil.daskalov@siemplify.co"
},
"creator": {
"displayName": "admin@siemplifylab.local",
"emailAddress": "admin@siemplifylab.local"
},
"created": "2021-08-31T12:15:22.089+0000",
"updated": "2021-11-11T13:16:50.552+0000",
"resolution": {
"name": "Terminé",
"description": "Ce ticket a été traité."
},
"labels": [],
"components": []
}
]
}
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Obtener problemas:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
issues_details_list |
Es una lista que contiene los metadatos completos de los problemas de Jira solicitados. |
Problemas con los vínculos
Usa la acción Vincular problemas para establecer una relación entre varios problemas de Jira.
Esta acción se usa principalmente en las guías para conectar incidentes de seguridad relacionados o para hacer un seguimiento de las dependencias entre los tickets de investigación.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción Link Issues requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Inward Issue ID |
Obligatorio. Es una lista separada por comas de los IDs de problemas entrantes. Por ejemplo, si |
Outward Issue IDs |
Obligatorio. Es la clave abreviada de la incidencia de Jira saliente. Por ejemplo, si |
Relation Type |
Obligatorio. Es el tipo de vínculo que se creará entre los problemas. Para encontrar una lista de los tipos de relaciones disponibles, ejecuta la acción List Relation Types. El valor predeterminado es |
Resultados de la acción
La acción Vincular problemas proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Mensajes de salida
La acción Vincular problemas puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
La acción no pudo encontrar los siguientes problemas de destino en Jira: ISSUE_IDS. |
La acción se realizó correctamente |
Error executing action "Link Issues".
Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción Vincular problemas:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
success |
true o false |
Enumera los problemas
Usa la acción List Issues para buscar y recuperar una lista de claves de problemas de Jira en función de criterios de filtrado específicos.
Esta acción es útil para identificar tickets existentes que coincidan con el contexto de una alerta, lo que evita duplicaciones o permite realizar actualizaciones en forma masiva dentro de una guía.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción List Issues proporciona los siguientes parámetros de filtrado opcionales. Si no se proporcionan parámetros, la acción devuelve todos los problemas a los que puede acceder el usuario de la integración.
| Parámetro | Descripción |
|---|---|
Project Names |
Es opcional. Es una lista separada por comas de los nombres de los proyectos en los que se buscará. |
Summary |
Es opcional. Si se proporciona, la acción filtra los problemas por el resumen o el título específicos. |
Description |
Es opcional. Si se proporciona, la acción filtra los problemas por el texto que contiene la descripción. |
Issue Types |
Es opcional. Es una lista separada por comas de tipos de problemas (por ejemplo,
El valor predeterminado es |
Priorities |
Es opcional. Es una lista separada por comas de los niveles de prioridad por los que se debe filtrar (por ejemplo,
|
Created From |
Es opcional. Si se proporciona, la acción filtra los problemas creados en esta fecha o después de ella
(en el formato |
Updated From |
Es opcional. Si se proporciona, la acción filtra los problemas actualizados en esta fecha o después de ella
(en el formato |
Assignees |
Es opcional. Es una lista separada por comas de los identificadores de los destinatarios por los que se filtrará. |
Reporter |
Es opcional. Es una lista separada por comas de identificadores de denunciantes por los que se filtrará. |
Statuses |
Es opcional. Es una lista separada por comas de los estados de los problemas por los que se debe filtrar (por ejemplo,
|
Created Before |
Es opcional. Es la fecha de creación más reciente por la que se filtrará. Formato: |
Custom JQL |
Es opcional. Consulta de JQL personalizada. Si se proporciona, se ignorarán todos los demás filtros. |
Resultados de la acción
La acción List Issues proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción List Issues:
[
"PR-123",
"PR-124",
"SEC-789"
]
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción List Issues:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
issues |
Es una lista que contiene las claves abreviadas únicas de los problemas de Jira encontrados. |
Enumera los tipos de relaciones
Usa la acción List Relation Types para recuperar una lista de todos los tipos de relaciones de vínculos disponibles configurados en tu instancia de Jira.
Esta acción es útil para validar los valores de entrada válidos para la acción Vincular problemas.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
La acción List Relation Types requiere los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
Filter Key |
Es opcional. Es el campo que se usa para filtrar los tipos de relación. Si la Lógica de filtro se establece en Los valores posibles son los siguientes:
El valor predeterminado es |
Filter Logic |
Es opcional. Es el operador lógico que se aplica al filtro. Los valores posibles son los siguientes:
El valor predeterminado es |
Filter Value |
Es opcional. Es el valor de cadena específico que se usa para filtrar según los valores de Si no se proporciona ningún valor, no se aplicará el filtro, incluso si se seleccionan una clave y una lógica. |
Max Records To Return |
Es opcional. Es la cantidad máxima de registros que se devolverán en los resultados. El valor predeterminado es |
Resultados de la acción
La acción List Relation Types proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | Disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | Disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Tabla del muro de casos
La acción List Relation Types proporciona la siguiente tabla:
Nombre de la tabla: Available Relation
Columnas de la tabla:
- Nombre
- Hacia adentro
- Hacia afuera
Resultado de JSON
En el siguiente ejemplo, se muestra el resultado JSON que se recibe cuando se usa la acción List Relation Types:
[{
"id": "10000",
"name": "Blocks",
"inward": "is blocked by",
"outward": "blocks"
}]
Mensajes de salida
La acción List Relation Types puede devolver los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "List Relation types".
Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Resultado de secuencia de comandos
En la siguiente tabla, se muestra el valor del resultado de la secuencia de comandos cuando se usa la acción List Relation Types:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
is_success |
true o false |
Ping
Usa la acción Ping para probar la conectividad con Jira.
Esta acción no se ejecuta en las entidades de Google SecOps.
Entradas de acción
Ninguno
Resultados de la acción
La acción Ping proporciona los siguientes resultados:
| Tipo de resultado de la acción | Disponibilidad |
|---|---|
| Archivo adjunto del muro de casos | No disponible |
| Vínculo al muro de casos | No disponible |
| Tabla del muro de casos | No disponible |
| Tabla de enriquecimiento | No disponible |
| Resultado de JSON | No disponible |
| Mensajes de salida | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de secuencia de comandos
En la siguiente tabla, se indica el valor del resultado de la secuencia de comandos cuando se usa la acción Ping:
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
success |
true o false |
Actualiza un problema
Descripción
Actualizar un problema Para la nueva API de Jira, la acción intenta encontrar una coincidencia para el destinatario para asignar un problema según el correo electrónico del usuario y, luego, lo intenta con el campo displayName.
Parámetros
| Parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| Clave del problema | String | N/A | Sí | Es la clave del problema que se actualizará. |
| Estado | String | N/A | No | Especifica el nombre de la transición pertinente para cambiar el estado de este problema al nuevo estado deseado. |
| Resumen | String | N/A | No | Es el nuevo resumen del problema. |
| Descripción | String | N/A | No | La nueva descripción del problema. |
| Tipo de problema | String | N/A | No | Es el nuevo tipo de problema. |
| Destinatario | String | N/A | No | Es el nuevo destinatario del problema. |
| Nombre de usuario de Jira | String | N/A | No | Es el nombre de usuario de Jira de quien inició la acción. |
| Componentes | String | N/A | No | Es el campo de componentes del problema. Este parámetro acepta varios valores como una cadena separada por comas. |
| Campos personalizados | JSON | N/A | No | Especifica un objeto JSON que contenga todos los campos y valores que se usan durante la creación de problemas. Nota: Este parámetro tiene prioridad, y todos los campos se reemplazan por el valor que se proporciona para este parámetro. Ejemplo: {"field":"value"} |
| Etiquetas | String | N/A | No | Es el campo de componentes del problema. Este parámetro acepta varios valores como una cadena separada por comas. |
Fecha de ejecución
Esta acción se ejecuta en todas las entidades.
Resultados de la acción
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Opciones de valor | Ejemplo |
|---|---|---|
| Listo | Verdadero o falso | Success:False |
Resultado de JSON
{
"comment":
{
"total": 0,
"startAt": 0,
"comments": [],
"maxResults": 0
},
"creator":
{
"displayName": "user1",
"name": "user1",
"self": "",
"avatarUrls":
{
"24x24": "",
"16x16": "",
"48x48": "",
"32x32": ""
},
"emailAddress": "john_doe@example.com",
"key": "user1user",
"active": true,
"timeZone": "Asia/Jerusalem",
"accountId": "0"
},
"aggregatetimeestimate": null,
"labels": ["Label1"],
"aggregatetimespent": null,
"watches":
{
"self": "",
"watchCount": 1,
"isWatching": false
},
"assignee":
{
"displayName": "user2",
"name": "user2",
"self": "",
"avatarUrls":
{
"24x24": "",
"16x16": "",
"48x48": "",
"32x32": ""
},
"emailAddress": "john_doe@example.com",
"key": "user2",
"active": true,
"timeZone": "Asia/Jerusalem",
"accountId": ""
},
"lastViewed": "2019-01-22T10:14:02.910+0200",
"issuelinks": [],
"Worklog":
{
"worklogs": [],
"total": 0,
"startAt": 0,
"maxResults": 20
},
"aggregateprogress":
{
"progress": 0,
"total": 0
},
"Priority":
{
"iconUrl": "",
"self": "",
"name": "Medium",
"id": "3"
},
"votes":
{
"hasVoted": false,
"self": "",
"votes": 0
},
"workratio": -1,
"fixVersions": [],
"environment": null,
"timespent": null,
"attachment":
[{
"mimeType": "binary/octet-stream",
"created": "2018-06-19T15:23:07.369+0300",
"self": "",
"author":
{
"displayName": "user1",
"name": "user1",
"self": "",
"avatarUrls":
{
"24x24": "",
"16x16": "",
"48x48": "",
"32x32": ""
},
"emailAddress": "john_doe@example.com",
"key": "user1",
"active": true,
"timeZone": "Asia/Jerusalem",
"accountId": "0"
},
"filename": "file.rar",
"content": "",
"id": "0",
"size": 0
}],
"progress":
{
"progress": 0,
"total": 0
},
"duedate": null,
"status":
{
"statusCategory":
{
"name": "Done",
"self": "",
"id": 3,
"key": "done",
"colorName": "green"
},
"description": "",
"self": "",
"iconUrl": "",
"id": "0",
"name": "DONE"
},
"updated": "2018-09-18T10:02:06.347+0300",
"subtasks": [],
"description": "Create Enrich entities action using Insights API (IOC search)\\n\\nWrite connector for laerts\\n\\nIn a couple of days we will have access to an instance",
"reporter":
{
"displayName": "user1",
"name": "user1",
"self": "",
"avatarUrls":
{
"24x24": "",
"16x16": "",
"48x48": "",
"32x32": ""
},
"emailAddress": "john_doe@example.com",
"key": "user1",
"active": true,
"timeZone": "Asia/Jerusalem",
"accountId": "0"
},
"timeoriginalestimate": null,
"aggregatetimeoriginalestimate": null,
"created": "2018-06-19T15:23:13.701+0300",
"versions": [],
"resolutiondate": "2018-09-18T10:02:06.340+0300",
"summary": "Sample issue",
"project":
{
"name": "Project 1",
"self": "",
"projectTypeKey": "software",
"avatarUrls":
{
"24x24": "",
"16x16": "",
"48x48": "",
"32x32": ""
},
"key": "PR",
"id": "0"
},
"timetracking": {},
"components": [],
"issuetype":
{
"name": "Task",
"self": "",
"iconUrl": "",
"subtask": false,
"avatarId": 10318,
"id": "10002",
"description": "A task that needs to be done."
},
"security": null,
"resolution":
{
"id": "10000",
"self": "",
"description": "Work has been completed on this issue.",
"name": "Done"
},
"timeestimate": null
}
Subir archivo adjunto
Descripción
Agrega un archivo adjunto a un error.
Parámetros
| Parámetro | Tipo | Valor predeterminado | Es obligatorio | Descripción |
|---|---|---|---|---|
| Clave del problema | String | N/A | Sí | Rutas de acceso a los archivos. |
| Rutas de acceso de los archivos | String | N/A | Sí | Son las rutas de acceso absolutas de los archivos que se subirán, separadas por comas. El formato requerido depende del tipo de implementación:
|
Fecha de ejecución
Esta acción se ejecuta en todas las 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
N/A
Buscar usuarios
Buscar usuarios en Jira
Entidades
Esta acción no se ejecuta en entidades.
Entradas de acción
Para configurar la acción, usa los siguientes parámetros:
| Parámetros | |
|---|---|
User Email Addresses |
Optional
Es la lista separada por comas de las direcciones de correo electrónico de las que se devolverán los usuarios. |
User Names |
Optional
Es la lista separada por comas de los nombres de usuario para los que se deben devolver los usuarios. |
Project |
Optional
Es el nombre del proyecto en el que se buscarán las direcciones de correo electrónico. Si se proporciona, solo se devuelve |
Resultados de la acción
| Tipo de resultado de la acción | |
|---|---|
| Archivo adjunto del muro de casos | N/A |
| Vínculo al muro de casos | N/A |
| Tabla del muro de casos | N/A |
| Tabla de enriquecimiento | N/A |
| Resultado de JSON | Disponible |
| Resultado de secuencia de comandos | Disponible |
Resultado de secuencia de comandos
| Nombre del resultado de la secuencia de comandos | Valor |
|---|---|
| is_success | Verdadero o falso |
Resultado de JSON
[
{
"Entity": "example",
"EntityResult": {
"_resource": "user?accountId={0}",
"_options": {
"server": "https://siemplify.atlassian.net",
"auth_url": "/rest/auth/1/session",
"context_path": "/",
"rest_path": "api",
"rest_api_version": "2",
"agile_rest_path": "agile",
"agile_rest_api_version": "1.0",
"verify": false,
"resilient": true,
"async": false,
"async_workers": 5,
"client_cert": null,
"check_update": false,
"delay_reload": 0,
"headers": {
"Cache-Control": "no-cache",
"Content-Type": "application/json",
"X-Atlassian-Token": "no-check"
}
},
"_session": "<jira.resilientsession.ResilientSession object>",
"_base_url": "{server}/rest/{rest_path}/{rest_api_version}/{path}",
"raw": {
"self": "https://siemplify.atlassian.net/rest/api/2/user?accountId=example-account-id",
"accountId": "example-account-id",
"accountType": "atlassian",
"emailAddress": "example.user",
"avatarUrls": {
"48x48": "https://example.com"
},
"displayName": "Example",
"active": true,
"timeZone": "UTC",
"locale": "en_US"
},
"self": "https://siemplify.atlassian.net/rest/api/2/user?accountId=example-account-id",
"accountId": "example-account-id",
"accountType": "atlassian",
"emailAddress": "example.user",
"avatarUrls": "<jira.resources.PropertyHolder object>",
"displayName": "Example",
"active": true,
"timeZone": "UTC",
"locale": "en_US"
}
}
]
Muro de casos
La acción proporciona los siguientes mensajes de salida:
| Mensaje de salida | Descripción del mensaje |
|---|---|
|
La acción se realizó correctamente. |
Error executing action "Search Users".
Reason: ERROR_REASON |
No se pudo realizar la acción. Verifica la conexión con el servidor, los parámetros de entrada o las credenciales. |
Configuración de asignación de motivos de cierre
El parámetro Closed Reason Mapping requiere una estructura JSON. Puedes asignar
valores estáticos o pasar nombres de campos dinámicos de Jira (por ejemplo, resolution,
customfield_10010). Si un motivo dinámico extraído no es válido o falta, el
trabajo usa automáticamente la asignación Fallback especificada.
Ejemplo de configuración de JSON:
{
"Done": {
"reason": "Maintenance",
"root_cause": "Other"
},
"Fallback": {
"reason": "Maintenance",
"root_cause": "Other"
}
}
Conectores
Conector de Jira
Descripción
Recuperar problemas de Jira a Google SecOps
Configura el conector de Jira en Google SecOps
Para obtener instrucciones detalladas sobre cómo configurar un conector en Google SecOps, consulta Configura el conector.
Parámetros del conector
Usa los siguientes parámetros para configurar el conector:
| Parámetro | Descripción |
|---|---|
DeviceProductField |
Obligatorio. Es el nombre del campo que se usa para determinar el producto del dispositivo. El valor predeterminado es |
EventClassId |
Es opcional. Es el nombre del campo que se usa para determinar el nombre del evento (subtipo). El valor predeterminado es |
PythonProcessTimeout |
Obligatorio. Es el límite de tiempo de espera (en segundos) para el proceso de Python que ejecuta la secuencia de comandos actual. El valor predeterminado es |
API Root |
Obligatorio. La raíz de la API de la instancia de Jira. El valor predeterminado es |
Username |
Es opcional. Es el nombre de usuario (correo electrónico) que se usa para conectarse a Jira. El requisito de este parámetro depende del método de autenticación elegido:
Para obtener más información sobre los métodos de autenticación, consulta Antes de comenzar. |
API Token |
Obligatorio. Es la credencial de autenticación que se usa para conectarse a Jira. |
Days Backwards |
Es opcional. Es la cantidad máxima de días anteriores de los que se extraerán las alertas. El valor predeterminado es |
Max Tickets Per Cycle |
Es opcional. Es la cantidad máxima de tickets que se recuperarán y procesarán en un ciclo del conector. El valor predeterminado es |
Project Names |
Es opcional. Son los nombres de los proyectos separados por comas. |
Issue Statuses |
Es opcional. Son los estados de los problemas separados por una coma. |
Assignees |
Es opcional. Son los nombres completos de los usuarios separados por una coma. |
Issue Types |
Es opcional. Tipos de problemas separados por una coma. |
Issue Priorities |
Es opcional. Son las prioridades de los problemas separadas por una coma. |
Issue Components |
Es opcional. Componentes del problema separados por una coma. |
Proxy Server Address |
Es opcional. Es la dirección del servidor proxy que se usará. |
Proxy Username |
Es opcional. Es el nombre de usuario del proxy con el que se autenticará. |
Proxy Password |
Es opcional. Es la contraseña del proxy con la que se realizará la autenticación. |
Environment Field Name |
Es opcional. Describe el nombre del campo en el que se almacena el nombre del entorno. Si no se encuentra el campo de entorno, el entorno es el predeterminado. El valor predeterminado es |
Environment Regex Pattern |
Es opcional. Es un patrón de regex que se ejecuta en el valor que se encuentra en el campo "Nombre del campo de entorno". Se usa para permitir que el usuario manipule el campo de entorno con la lógica de regex. El valor predeterminado es |
Use Jira Project as Environment |
Es opcional. Usa el proyecto de Jira como entorno o usa el nombre del campo de entorno como entorno. |
Verify SSL |
Obligatorio. Si se selecciona, la integración valida el certificado SSL cuando se conecta al servidor de Jira. Habilitada de forma predeterminada. |
Reglas de conector
Compatibilidad con proxy
El conector admite proxy.
Lista dinámica y lista de entidades bloqueadas
El conector admite reglas de listas dinámicas y de entidades bloqueadas solo para etiquetas específicas dentro de Jira.
Trabajos
Trabajo de cierre de sincronización
Descripción
Cierra tickets en Jira si se cerraron las alertas o los casos correspondientes de Google SecOps, y sincroniza el estado de cierre y los campos personalizados de Jira con Google SecOps.
Parámetros
| Parámetro | Descripción |
|---|---|
API Root |
Obligatorio. Es la URL raíz de la API de la instancia de Jira. El valor predeterminado es |
Username |
Es opcional. Es el nombre de usuario (correo electrónico) que se usa para conectarse a Jira. El requisito de este parámetro depende del método de autenticación elegido:
|
API Token |
Obligatorio. Es la credencial de autenticación que se usa para conectarse a Jira. |
Project Names |
Obligatorio. Son los nombres de los proyectos de Jira separados por una coma que el trabajo debe supervisar. El valor predeterminado es |
Environment |
Es opcional. Es el nombre del entorno. |
Days Backwards |
Obligatorio. Es la cantidad máxima de días para sincronizar el estado de los tickets hacia atrás. El valor predeterminado es |
Job Scope |
Obligatorio. Es el alcance de la sincronización del trabajo. Opciones:
El valor predeterminado es |
Supported Closed Statuses |
Obligatorio. Lista separada por comas de los estados cerrados de Jira que se consideran cerrados en Google SecOps (por ejemplo,
El valor predeterminado es |
Closed Reason Mapping |
Obligatorio. Es un diccionario JSON que asigna los estados cerrados de Jira a los motivos de cierre y las causas raíz de Google SecOps. Admite la asignación a campos personalizados y requiere una clave |
Custom Fields Mapping |
Es opcional. Es un objeto JSON que define las asignaciones entre los nombres visibles de los campos personalizados de Google SecOps y los nombres de los campos personalizados de Jira para la sincronización de datos de Jira a Google SecOps. Para obtener detalles y ejemplos de configuración, consulta Asignación de motivos de cierre y campos personalizados. |
Asignación de motivos de cierre y campos personalizados
Usa los siguientes detalles y ejemplos para configurar asignaciones personalizadas de motivos de cierre y campos personalizados.
Asignación de motivos de cierre
Define cómo se asignan los estados de cierre de Jira a los motivos de cierre y las causas raíz de los casos o las alertas de Google SecOps.
-
Ejemplo de asignación de JSON estándar:
{ "Done": { "reason": "Malicious", "root_cause": "Other" }, "Fallback": { "reason": "Maintenance", "root_cause": "Other" } }Si un ticket de Jira se cierra con el estado
Done, el caso o la alerta de Google SecOps se cierra con el motivoMaliciousy la causa raízOther. Si el ticket se cierra con un estado que no se asignó de forma explícita (por ejemplo,Closed), el sistema usa de forma predeterminada la configuración deFallback. -
Ejemplo de asignación de campos personalizados:
Si tienes campos personalizados en Jira llamados
Jira reasonyJira rootcause, configura la asignación de JSON de la siguiente manera:{ "Done": { "reason": "Jira reason", "root_cause": "Jira rootcause" }, "Fallback": { "reason": "Maintenance", "root_cause": "Other" } }Requisitos:
- El valor extraído del campo personalizado
Jira reasondebe resolverse en una de las siguientes cadenas exactas:Malicious,Maintenance,InconclusiveoNot malicious. De lo contrario, el sistema volverá a los valores deFallback. - Para el alcance del trabajo de
Case, los valores de la causa raíz se deben configurar en los parámetros de configuración de administrador. Para el alcance del trabajoAlert, no se requiere ninguna configuración de administrador y se acepta cualquier valor proporcionado en el campo personalizado.
- El valor extraído del campo personalizado
Asignación de campos personalizados
Esta asignación funciona exclusivamente para sincronizar los valores de los campos personalizados de Jira con Google SecOps. Especifica pares clave-valor en los que la clave sea el nombre visible del campo personalizado de Google SecOps y el valor sea el nombre del campo personalizado de Jira:
{
"SOAR Custom field": "Jira ticket id"
}
En este ejemplo, el valor del campo Jira ticket id de Jira se sincroniza directamente con el campo SOAR Custom field de Google SecOps.
Trabajo de sincronización de comentarios
Descripción
Sincroniza los comentarios entre el caso de Google SecOps y el ticket de Jira correspondiente. La sincronización es bidireccional, es decir, de Google SecOps a Jira y de Jira a Google SecOps.
Cuando el trabajo crea un comentario, aplica el prefijo. Si un usuario de Google SecOps comenta en el caso de Google SecOps, el trabajo crea y sincroniza el comentario del usuario en el ticket de Jira correspondiente con el parámetro Prefijo de comentario de Chronicle.
Esta función se agregó con dos propósitos:
- Visibilidad.
- Evitar que los comentarios agregados por el trabajo se vuelvan a sincronizar con el otro lado y causen un bucle.
Parámetros
| Parámetro | Descripción |
|---|---|
API Root |
Obligatorio. Es la URL raíz de la API de la instancia de Jira. El valor predeterminado es |
Username |
Es opcional. Es el nombre de usuario (correo electrónico) que se usa para conectarse a Jira. El requisito de este parámetro depende del método de autenticación elegido:
|
API Token |
Obligatorio. Es la credencial de autenticación que se usa para conectarse a Jira. |
Project Names |
Obligatorio. Son los nombres de los proyectos de Jira separados por una coma que el trabajo debe supervisar. El valor predeterminado es |
Environment |
Es opcional. Es el nombre del entorno. |
Siemplify Comment Prefix |
Obligatorio. Es el prefijo que agrega el trabajo de sincronización a los comentarios creados para los tickets de Jira. El valor predeterminado es |
Jira Comment Prefix |
Obligatorio. Es el prefijo que agrega el trabajo de sincronización a los comentarios de los casos de alertas de Google SecOps. El valor predeterminado es |
¿Necesitas más ayuda? Obtén respuestas de miembros de la comunidad y profesionales de Google SecOps.