Jira

Versión de integración: 41.0

Configurar Jira para que funcione con Google Security Operations

Crear un token de API

Crea un token de API desde tu cuenta de Atlassian:

  1. Inicia sesión en tu cuenta de Atlassian.
  2. Haz clic en Crear token de API.
  3. En el cuadro de diálogo que aparece, escribe una etiqueta memorable y concisa para tu token y haz clic en Crear.
  4. Haz clic en Copiar al portapapeles y, a continuación, pega el token en un lugar seguro para guardarlo.

Configurar la integración de Jira en Google SecOps

Para obtener instrucciones detalladas sobre cómo configurar una integración en Google SecOps, consulta Configurar integraciones.

Parámetros de integración

Usa los siguientes parámetros para configurar la integración:

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombre de la instancia Cadena N/A No Nombre de la instancia para la que quiere configurar la integración.
Descripción Cadena N/A No Descripción de la instancia.
Raíz de la API Cadena https://{jira_address} Sí Dirección de la instancia de Jira.
Nombre de usuario Cadena N/A Sí Nombre de usuario que se debe usar para conectarse a Jira.
Token de API Contraseña N/A Sí

Token generado en la consola de Jira.

Nota: Este parámetro se puede usar para incluir la cadena "Password" en caso de autenticación local, mediante la combinación de nombre de usuario y contraseña.
Verificar SSL Casilla Desmarcada No Usa esta casilla si tu conexión de Jira requiere una verificación SSL.
Ejecutar de forma remota Casilla Desmarcada No Marca el campo para ejecutar la integración configurada de forma remota. Una vez marcada, aparece la opción para seleccionar al usuario remoto (agente).

Acciones

Añadir comentario

Descripción

Escribir comentarios sobre un problema es una forma eficaz de documentar más elementos sobre él y participar con los miembros del equipo.

Parámetros

Parámetros Tipo Valor predeterminado Es obligatorio Descripción
Clave del problema Cadena N/A Sí

Clave del problema.

Ejemplo: ABC-123
Comentario Cadena N/A Sí El contenido del comentario que se va a añadir al problema.

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
comment_id N/A N/A
Resultado de JSON
N/A

Assign Issue

Descripción

Asigna un problema a un usuario específico. El nombre de usuario de Jira podría ser, por ejemplo, nombre o correo. En la nueva API de Jira, la acción intenta encontrar una coincidencia para el asignatario con el fin de asignar un problema en función del correo electrónico del usuario y, a continuación, lo intenta con el campo displayName.

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
Clave del problema Cadena N/A Sí Clave del problema.
Usuario asignado Cadena N/A Sí El nuevo usuario asignado al problema.
Nombre de usuario de Jira Cadena N/A No Nombre de usuario de Jira del iniciador de la acció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
correcto Verdadero/Falso success:False

Crear problema asociado a la alerta

Descripción

Asigna un incidente a un grupo concreto.

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
Clave de proyecto Cadena N/A Sí Clave del proyecto en el que se va a crear la incidencia.
Resumen Cadena N/A Sí El resumen del problema.
Tipo de problema Cadena N/A Sí El tipo de problema.

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
issue_key N/A N/A
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
}

Crear incidencia

Descripción

Crea una incidencia en un proyecto. El nombre de usuario de Jira podría ser, por ejemplo, nombre o correo. En la nueva API de Jira, la acción intenta encontrar una coincidencia para el asignatario con el fin de asignar un problema en función del correo electrónico del usuario y, a continuación, lo intenta con el campo displayName.

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
Clave de proyecto Cadena N/A Sí Clave del proyecto en el que se va a crear la incidencia.
Resumen Cadena N/A Sí El resumen del problema.
Descripción Cadena N/A Sí La descripción del problema.
Tipo de problema Cadena N/A Sí El tipo de problema.
Usuario asignado Cadena N/A No El nuevo usuario asignado al problema.
Nombre de usuario de Jira Cadena N/A No Nombre de usuario de Jira del iniciador de la acción.
Componentes Cadena N/A No

El campo de componentes del problema.

Este parámetro acepta varios valores como una cadena separada por comas.
Etiquetas Cadena N/A No

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 utilizarán durante la creación del problema.

Nota: Este parámetro tiene prioridad y todos los campos se sobrescriben con el valor que se proporciona para este parámetro.

Ejemplo: {"field":"value"}

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
issue_key N/A N/A
Resultado de JSON
N/A

Eliminar problema

Descripción

Eliminar un problema.

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
Clave del problema Cadena N/A Sí Clave del problema que se va a eliminar.

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
correcto Verdadero/Falso success:False
Resultado de JSON
N/A

Descargar archivos adjuntos

Descripción

Obtener una clave de incidencia y descargar todos los archivos adjuntos. Si uno de ellos es un archivo EML, descárgalo también en los archivos adjuntos.

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
Clave del problema Cadena N/A Sí La clave del problema.
Ruta de descarga Cadena N/A No Ruta en la que se guardan los archivos adjuntos.
Descargar archivos adjuntos en el panel de casos Casilla Desmarcada No Si está habilitada, la acción descarga los archivos adjuntos del problema de Jira en el muro del caso de alerta de Google SecOps actual.

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/Falso is_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
 }

Get Issues

Descripción

Obtener los detalles de un problema por claves.

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
Teclas de problema Cadena N/A Sí Las claves de los problemas que se van a obtener, separadas 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
issues_details_list Verdadero/Falso issues_details_list: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
 }

List Issues

Descripción

Buscar problemas.

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombres de proyectos Cadena N/A No Nombres de los proyectos en los que se va a buscar, separados por comas.
Resumen Cadena N/A No El resumen por el que se va a filtrar.
Descripción Cadena N/A No La descripción por la que se va a filtrar.
Tipos de problemas Cadena Error No Los tipos de problemas por los que filtrar.
Prioridades Cadena N/A No La prioridad por la que se va a filtrar.
Creado a partir de Cadena N/A No

La fecha de creación más antigua por la que filtrar.

Formato: AAAA/MM/DD.
Actualizado desde Cadena N/A No

La fecha de actualización más antigua por la que filtrar.

Formato: AAAA/MM/DD.
Asignados Cadena N/A No Nombre de los asignatarios por los que se va a filtrar, separados por comas.
Informador Cadena N/A No Nombre de los reporteros por los que se va a filtrar, separados por comas.
Estados Cadena N/A No Estados por los que se va a filtrar, separados 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
problemas Verdadero/Falso issues:False
Resultado de JSON
[ "PR-123", "PR-124"]

Ping

Descripción

Verifica que el usuario tiene una conexión a Jira a través de su dispositivo.

Parámetros

Esta acción no tiene parámetros de entrada.

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
correcto Verdadero/Falso success:False
Resultado de JSON
N/A

Problema con la actualización

Descripción

Actualizar un problema. En la nueva API de Jira, la acción intenta encontrar una coincidencia para el asignatario con el fin de asignar un problema en función del correo electrónico del usuario y, a continuación, lo intenta con el campo displayName.

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
Clave del problema Cadena N/A Sí La clave del problema que se va a actualizar.
Estado Cadena N/A No Especifica el nombre de la transición pertinente para cambiar el estado de este problema al nuevo estado deseado.
Resumen Cadena N/A No El nuevo resumen del problema.
Descripción Cadena N/A No La nueva descripción del problema.
Tipo de problema Cadena N/A No El nuevo tipo de problema.
Usuario asignado Cadena N/A No El nuevo usuario asignado al problema.
Nombre de usuario de Jira Cadena N/A No Nombre de usuario de Jira del iniciador de la acción.
Componentes Cadena N/A No

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 utilicen durante la creación del problema.

Nota: Este parámetro tiene prioridad y todos los campos se sobrescriben con el valor que se proporciona para este parámetro.

Ejemplo: {"field":"value"}
Etiquetas Cadena N/A No

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
Correcto Verdadero/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

Añade un archivo adjunto a un problema.

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
Clave del problema Cadena N/A Sí Rutas de archivo.
Rutas de archivo Cadena N/A Sí Las rutas de los archivos que se van a subir, separadas 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
is_success Verdadero/Falso is_success:False
Resultado de JSON
N/A

Descripción

Vincular varias incidencias en Jira.

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID de problema de entrada Cadena N/A Sí

Especifica una lista de IDs de problemas internos separados por comas.

Por ejemplo, si el tipo de relación es "Bloquea", en la interfaz de usuario verás este problema con la relación "Bloqueado por".
IDs de problemas externos CSV N/A Sí

Especifica el ID del problema externo.

Por ejemplo, si el tipo de relación es "Blocks", en la interfaz de usuario vería este problema con la relación "blocks".
Tipo de relación Cadena Bloques Sí Especifica el tipo de relación que se usará para vincular varios problemas. En la acción "List Relation Types" (Lista de tipos de relaciones) se muestra una lista de todos los tipos de relaciones disponibles.

Fecha de ejecución

Esta acción no se ejecuta en 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/Falso is_success:False
Resultado de JSON
N/A
Panel de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si se devuelve el código de estado 201 en algunos problemas (is_success = true): "Successfully linked issue "{source issue}" with the following issues in Jira: {destination issues}".

Si se informa del código de estado 404 y del error "Issue Does Not Exist" (El problema no existe) en un problema (is_success=true): "Action wasn't able to find the following destination issues in Jira: {jira issues that were not found}" (La acción no ha podido encontrar los siguientes problemas de destino en Jira: {jira issues that were not found}).

Si se informa del código de estado 404 y del error "Issue Does Not Exist" (is_success=false) en todos los problemas: "None of the destination issues were found in Jira" ("No se ha encontrado ninguno de los problemas de destino en Jira").

La acción debería fallar y detener la ejecución de la guía:

Si se informa de un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error: "Error al ejecutar la acción". Motivo: {0}''.format(error.Stacktrace)

Si no se encuentra el problema de origen: "Error al ejecutar la acción". Motivo: no se ha encontrado el problema de origen "{source issue}" en Jira. Comprueba la ortografía".

Si el código de estado 404 y no es el error "Issue Does Not Exist" (El problema no existe) en al menos uno de los casos: "Error al ejecutar la acción". Motivo: {error messages}.

 General

Mostrar tipos de relaciones

Descripción

Lista los tipos de relación disponibles en Jira.

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
Teclas de filtro DDL

Selecciona una opción.

Valores posibles:

  • Nombre
  • Hacia dentro
  • Outward
 No Especifica la clave que se debe usar para filtrar {item type}.
Lógica de filtro DDL

Sin especificar

Valores posibles:

  • Sin especificar
  • Igual
  • Contiene
 No Especifica la lógica de filtro que se debe aplicar. La lógica de filtrado funciona en función del valor proporcionado en el parámetro "Clave de filtro".
Valor de filtro Cadena N/A No

Especifica el valor que se debe usar en el filtro.

Si se selecciona "Igual", la acción intentará encontrar la coincidencia exacta entre los resultados.

Si se selecciona "Contiene", la acción intentará encontrar resultados que contengan la subcadena especificada.

Si no se proporciona nada en este parámetro, no se aplicará el filtro. La lógica de filtrado funciona en función del valor proporcionado en el parámetro "Clave de filtro".
Número máximo de registros que se devolverán Entero 50 No Especifica el número de registros que se deben devolver. Si no se proporciona nada, la acción devuelve 50 registros.

Fecha de ejecución

Esta acción no se ejecuta en 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/Falso is_success:False
Resultado de JSON
[{
    "id": "10000",
    "name": "Blocks",
    "inward": "is blocked by",
    "outward": "blocks",
    "self": "http://172.30.201.69:8080/rest/api/2/issueLinkType/10000"
}]
Panel de casos
Tipo de resultado Valor o descripción Tipo
Mensaje de salida*

La acción no debe fallar ni detener la ejecución de una guía:

Si hay datos disponibles (is_success = true): "Successfully found relation types for the provided criteria in Jira" ("Se han encontrado correctamente los tipos de relación para los criterios proporcionados en Jira").

Si los datos no están disponibles (is_success=false): "No se han encontrado tipos de relación para los criterios proporcionados en Jira"

Si el parámetro "Filter Value" está vacío (is_success=true): "The filter was not applied, because parameter "Filter Value" has an empty value." ("No se ha aplicado el filtro porque el parámetro "Filter Value" tiene un valor vacío").

La acción debería fallar y detener la ejecución de la guía:

Si el parámetro "Filter Key" tiene el valor "Select One" y el parámetro "Filter Logic" tiene el valor "Equal" o "Contains": Error al ejecutar la acción "{action name}". Motivo: debes seleccionar un campo del parámetro "Clave de filtro"."

Si se proporciona un valor no válido para el número máximo de registros que se devuelven: "Error al ejecutar la acción "{nombre de la acción}". Motivo: Se ha proporcionado un valor no válido para "Número máximo de registros que se devolverán": . Se debe proporcionar un número positivo"."

Si se informa de un error grave, como credenciales incorrectas, no hay conexión con el servidor u otro error: "Error al ejecutar la acción "{nombre de la acción}". Motivo: {0}''.format(error.Stacktrace)

 General
Tabla del panel de casos

Nombre de la tabla: Available Relation

Columnas de tabla:

  • Nombre - nombre
  • Hacia dentro
  • Outward - outward
 General

Buscar usuarios

Buscar usuarios en Jira.

Entidades

Esta acción no se ejecuta en entidades.

Entradas de acciones

Para configurar la acción, usa los siguientes parámetros:

Parámetros
User Email Addresses Optional

Lista separada por comas de las direcciones de correo electrónico de los usuarios que se van a devolver.
User Names Optional

Lista de nombres de usuario separados por comas de los usuarios que se van a devolver.
Project Optional

Nombre del proyecto en el que se buscarán las direcciones de correo. Si se proporciona, solo se devuelve Project Assignable Users.

Resultados de la acción

Tipo de salida de la acción
Adjunto del panel de casos N/A
Enlace del panel de casos N/A
Tabla del panel de casos N/A
Tabla de enriquecimiento N/A
Resultado de JSON Disponible
Resultado de la secuencia de comandos Disponible
Resultado de la secuencia de comandos
Nombre del resultado del script Valor
is_success Verdadero/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"
   }
 }
]
Panel de casos

La acción proporciona los siguientes mensajes de salida:

Mensaje resultante 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 ha realizado correctamente.
Error executing action "Search Users". Reason: ERROR_REASON

Ha fallado la acción.

Comprueba la conexión al servidor, los parámetros de entrada o las credenciales.

Conectores

Conector de Jira

Descripción

Obtener incidencias de Jira en Google SecOps.

Configurar Jira Connector en Google SecOps

Para obtener instrucciones detalladas sobre cómo configurar un conector en Google SecOps, consulta el artículo Configurar el conector.

Parámetros del conector

Utiliza los siguientes parámetros para configurar el conector:

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
DeviceProductField Cadena device_product Sí Nombre del campo que se usa para determinar el producto del dispositivo.
EventClassId Cadena name No Nombre del campo que se usa para determinar el nombre del evento (subtipo).
PythonProcessTimeout Cadena 60 Sí El límite de tiempo de espera (en segundos) del proceso de Python que ejecuta la secuencia de comandos actual.
Raíz de la API Cadena https://{jira_address} Sí La raíz de la API de la instancia de Jira.
Nombre de usuario Cadena N/A Sí N/A
Token de API Contraseña N/A Sí

Token generado en la consola de Jira.

Nota: Este parámetro se puede usar para incluir la cadena "Password" en caso de autenticación local, usando una combinación de nombre de usuario y contraseña.
Días hacia atrás Entero 5 No Número máximo de días anteriores a partir de los que se obtendrán las alertas.
Número máximo de incidencias por ciclo Entero 10 No Número máximo de incidencias que se obtendrán y procesarán en un ciclo del conector.
Nombres de proyectos Cadena N/A No Nombres de proyectos separados por comas.
Estados de problemas Cadena N/A No Estados de los problemas separados por comas.
Asignados Cadena N/A No Nombre y apellidos de los usuarios separados por comas.
Tipos de problemas Cadena N/A No Tipos de incidencias separados por comas.
Prioridades de los problemas Cadena N/A No Prioridades de los problemas separadas por comas.
Componentes del problema Cadena N/A No Componentes del problema separados por comas.
Dirección del servidor proxy Cadena N/A No Dirección del servidor proxy que se va a usar.
Nombre de usuario del proxy Cadena N/A No Nombre de usuario del proxy para autenticarse.
Contraseña del proxy Contraseña N/A No La contraseña del proxy para autenticarte.
Nombre del campo de entorno Cadena "" No

Describe el nombre del campo en el que se almacena el nombre del entorno.

Si no se encuentra el campo de entorno, se utiliza el entorno predeterminado.
Patrón de regex de entorno Cadena .* No

Una expresión regular que se aplicará al valor encontrado en el campo "Nombre del campo de entorno".

El valor predeterminado es .* para captar todos los valores y devolverlos sin cambios.

Se usa para permitir que el usuario manipule el campo del entorno mediante la lógica de expresiones regulares.

Si el patrón de expresión regular es nulo o está vacío, o si el valor del entorno es nulo, el resultado final del entorno será el entorno predeterminado.

Reglas de conectores

Compatibilidad con proxy

El conector admite proxies.

Lista dinámica y lista de bloqueo

El conector solo admite reglas de listas dinámicas y de listas de bloqueo para etiquetas específicas de Jira.

Empleo

Tarea de cierre de sincronización

Descripción

Cierra las incidencias de Jira si se han cerrado las alertas de Google SecOps correspondientes.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Raíz de la API Cadena https://{jira_address} Sí URL raíz de la API de la instancia de Jira.
Nombre de usuario Cadena N/A Sí Nombre de usuario para conectarse a la instancia de Jira.
Token de API Contraseña N/A Sí

Token generado en la consola de Jira.

Nota: Este parámetro se puede usar para incluir la cadena "Password" en caso de autenticación local, usando una combinación de nombre de usuario y contraseña.
Nombres de proyectos Cadena Nombres de proyectos separados por comas Sí Nombres de proyectos de Jira separados por comas que debe monitorizar el trabajo.
Máximo de días hacia atrás Entero 1 Sí Número máximo de días para sincronizar el estado de las entradas hacia atrás.

Tarea de sincronización de comentarios

Descripción

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

Este trabajo solo admite casos de SecOps de Google con la etiqueta Jira.

Cuando la tarea crea un comentario, aplica el prefijo. Si un usuario de SecOps de Google comenta en el caso de SecOps de Google, el trabajo crea y sincroniza el comentario del usuario en la incidencia de Jira correspondiente mediante el parámetro Prefijo de comentario de Chronicle.

Esta función se ha añadido por dos motivos:

  1. Visibilidad.
  2. Evita que los comentarios añadidos por el trabajo se vuelvan a sincronizar con el otro lado y provoquen un bucle.

Parámetros

Nombre visible del parámetro Tipo Valor predeterminado Es obligatorio Descripción
Raíz de la API Cadena https://{jira_address} Sí URL raíz de la API de la instancia de Jira.
Nombre de usuario Cadena N/A Sí Nombre de usuario para conectarse a la instancia de Jira.
Token de API Contraseña N/A Sí

Token generado en la consola de Jira.

Nota: Este parámetro se puede usar para incluir la cadena "Password" en caso de autenticación local, usando una combinación de nombre de usuario y contraseña.
Nombres de proyectos Cadena Nombres de proyectos separados por comas Sí Nombres de proyectos de Jira separados por comas que debe monitorizar el trabajo.
Máximo de días hacia atrás Entero 1 Sí Número máximo de días para sincronizar el estado de las incidencias hacia atrás.
Prefijo de comentario de Google SecOps Cadena Google SecOps: Sí Prefijo que añade la tarea de sincronización a los comentarios creados para las incidencias de Jira.
Prefijo de comentario de Jira Cadena Tarea de sincronización de comentarios de Jira: Sí Prefijo que añade el trabajo de sincronización a los comentarios de los casos de alerta de Google SecOps.

¿Necesitas más ayuda? Recibe respuestas de los miembros de la comunidad y de los profesionales de Google SecOps.