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}).

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:

  1. 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.

  2. 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).

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

  • Si se proporciona, el sistema usa la autenticación básica.
  • Si se deja vacío, el sistema usa de forma predeterminada la autenticación de token del portador (obligatoria para las cuentas de servicio).

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, PROJ-123).

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, PROJ-123).

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 SEC).

Summary

Obligatorio.

Un título o resumen breve del problema.

Issue Type

Obligatorio.

Es el nombre del tipo de problema (como Task, Bug o Incident).

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 SEC).

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 Task, Bug o Incident).

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, {"customfield_10001": "Value"}).

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, SEC-123).

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, SEC-123).

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:

  • Implementación de SaaS: La ruta de acceso es interna a la plataforma alojada, como /attachments/.
  • Implementación del agente remoto: La ruta de acceso debe ser una ruta de directorio absoluta y válida en la máquina local en la que está instalado el agente remoto. Por ejemplo, C:\temp\attachments para Windows o /var/tmp/attachments/ para Linux.
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, SEC-123, SEC-456).

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.

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 Relation Type se establece en Blocks, este problema muestra la relación is blocked by en la IU de Jira.

Outward Issue IDs

Obligatorio.

Es la clave abreviada de la incidencia de Jira saliente.

Por ejemplo, si Relation Type se establece en Blocks, este problema muestra la relación blocks en la IU de Jira.

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 Blocks.

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

Successfully linked issue ISSUE_ID with the following issues in Jira: ISSUE_IDS.

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, Bug,Task).

El valor predeterminado es Bug.

Priorities

Es opcional.

Es una lista separada por comas de los niveles de prioridad por los que se debe filtrar (por ejemplo, High,Medium).

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 YYYY/MM/DD).

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 YYYY/MM/DD).

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, Open,In Progress).

Created Before

Es opcional.

Es la fecha de creación más reciente por la que se filtrará. Formato: YYYY/MM/DD o desplazamiento relativo (por ejemplo, -24h, -7d). Si no se proporciona, no se usará el filtro.

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 Equal o Contains, debes seleccionar un campo que no sea Select One para evitar un error de ejecución.

Los valores posibles son los siguientes:

  • Name
  • Inward
  • Outward

El valor predeterminado es Select One.

Filter Logic

Es opcional.

Es el operador lógico que se aplica al filtro.

Los valores posibles son los siguientes:

  • Not Specified
  • Equal
  • Contains

El valor predeterminado es Not Specified.

Filter Value

Es opcional.

Es el valor de cadena específico que se usa para filtrar según los valores de Filter Key y Filter Logic seleccionados.

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 50.

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

Successfully found relation types for the provided criteria in Jira.

The filter was not applied, because parameter "Filter Value" has an empty value.

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:

  • Implementación de SaaS: La ruta de acceso es interna a la plataforma alojada, como /attachments/.
  • Implementación del agente remoto: La ruta de acceso debe ser una ruta de directorio absoluta y válida en la máquina local en la que está instalado el agente remoto. Por ejemplo, C:\temp\attachments para Windows o /var/tmp/attachments/ para Linux.

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 Project Assignable Users.

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

Successfully found the following users in Jira for project PROJECT_NAME: USER_LIST

The following users were not found in Jira for project PROJECT_NAME: USER_LIST

None of the provided users were found in the project PROJECT_NAME

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 device_product.

EventClassId

Es opcional.

Es el nombre del campo que se usa para determinar el nombre del evento (subtipo).

El valor predeterminado es name.

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 60.

API Root

Obligatorio.

La raíz de la API de la instancia de Jira.

El valor predeterminado es https://{jira_address}.

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:

  • Si se proporciona, el sistema usa la autenticación básica.
  • Si se deja vacío, el sistema usa de forma predeterminada la autenticación de token del portador (obligatoria para las cuentas de servicio).

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 5.

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 10.

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 https://{jira_address}.

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:

  • Si se proporciona, el sistema usa la autenticación básica.
  • Si se deja vacío, el sistema usa de forma predeterminada la autenticación de token del portador (obligatoria para las cuentas de servicio).
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 project names separated by a comma.

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 1.

Job Scope

Obligatorio.

Es el alcance de la sincronización del trabajo. Opciones:

  • Case: Sincroniza los problemas de Jira a nivel del caso. Asegúrate de que el contexto contenga el JIRA_ISSUE_KEY.
  • Alert: Sincroniza los problemas de Jira a nivel de la alerta. En el caso de los casos creados por el conector, la clave del ticket de Jira se extrae automáticamente. En los casos simulados, establece manualmente la clave de contexto en JIRA_ISSUE_KEY.

El valor predeterminado es Alert.

Supported Closed Statuses

Obligatorio.

Lista separada por comas de los estados cerrados de Jira que se consideran cerrados en Google SecOps (por ejemplo, Done, Closed).

  • De SecOps a Jira: El trabajo usa el primer valor de la lista (por ejemplo, Done) como el estado de resolución cuando se cierra el ticket de Jira.
  • De Jira a SecOps: El estado de cierre del ticket de Jira debe existir en esta lista para que se produzca la sincronización.

El valor predeterminado es Done.

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 Fallback obligatoria. Para obtener detalles y ejemplos de configuración, consulta Asignación de motivos de cierre y campos personalizados.

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 motivo Malicious y la causa raíz Other. 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 de Fallback.

  • Ejemplo de asignación de campos personalizados:

    Si tienes campos personalizados en Jira llamados Jira reason y Jira 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 reason debe resolverse en una de las siguientes cadenas exactas: Malicious, Maintenance, Inconclusive o Not malicious. De lo contrario, el sistema volverá a los valores de Fallback.
    • 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 trabajo Alert, no se requiere ninguna configuración de administrador y se acepta cualquier valor proporcionado en el 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:

  1. Visibilidad.
  2. 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 https://{jira_address}.

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:

  • Si se proporciona, el sistema usa la autenticación básica.
  • Si se deja vacío, el sistema usa de forma predeterminada la autenticación de token del portador (obligatoria para las cuentas de servicio).
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 project names separated by comma.

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 Google SecOps:.

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 Jira Comment Sync Job:.

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