Jira

Versión de integración: 41.0

Configura Jira para que funcione con Google Security Operations

Crea un token de API

Crea un token de API desde tu cuenta de Atlassian:

  1. Accede a tu cuenta de Atlassian.
  2. Haz clic en Crear token de API.
  3. En el diálogo que aparece, ingresa una Etiqueta memorable y concisa para tu token, y haz clic en Crear.
  4. Haz clic en Copiar al portapapeles y, luego, pega el token en un lugar seguro para guardarlo.

Configura la integración de Jira en Google SecOps

Si quieres obtener instrucciones detalladas para configurar una integración en Google SecOps, consulta Configura 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 String N/A No Nombre de la instancia para la que deseas configurar la integración.
Descripción String N/A No Es la descripción de la instancia.
Raíz de la API String https://{jira_address} Sí Dirección de la instancia de Jira.
Nombre de usuario String N/A Sí Es un nombre de usuario que se debe usar para conectarse a Jira.
Token de API Contraseña N/A Sí

Es el token generado en la consola de Jira.

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

Acciones

Agregar comentario

Descripción

Redactar 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 String N/A Sí

Es la clave del problema.

Ejemplo: ABC-123
Comentario String N/A Sí Es el contenido del comentario que se agregará al problema.

Ejecutar en

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

Asigna el problema

Descripción

Asigna un problema a un usuario específico. El nombre de usuario de Jira podría ser, por ejemplo, el nombre o el correo electrónico. En el caso de la nueva API de Jira, la acción intenta encontrar una coincidencia para el asignatario y asignar un problema según el correo electrónico del usuario, y, luego, 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.
Usuario asignado String N/A Sí Es el nuevo asignatario del problema.
Nombre de usuario de Jira String N/A No Nombre de usuario de Jira del iniciador de la acción.

Ejecutar en

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

Crea un problema de alerta

Descripción

Asigna un incidente a un grupo en particular.

Parámetros

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

Ejecutar en

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 problema

Descripción

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

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
Clave del proyecto String N/A Sí Es la clave del proyecto en el que se creará el problema.
Resumen String N/A Sí Es el resumen del problema.
Descripción String N/A Sí Es la descripción del problema.
Tipo de problema String N/A Sí Es el tipo de problema.
Usuario asignado String N/A No Es el nuevo asignatario del problema.
Nombre de usuario de Jira String N/A No Nombre de usuario de Jira del iniciador de 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.
Etiquetas 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 usarán durante la creación del problema.

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

Ejemplo: {"field":"value"}

Ejecutar en

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

Borrar problema

Descripción

Borra un problema.

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 borrará.

Ejecutar en

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

Obtén una clave de problema y descarga todos los archivos adjuntos. Si uno de ellos es un archivo EML, también se descargará dentro de los archivos adjuntos.

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
Clave del problema String N/A Sí Es la clave del problema.
Ruta de descarga String N/A No Ruta de acceso en la que se guardan los archivos adjuntos.
Descargar archivos adjuntos en el muro de casos Casilla de verificación Desmarcado 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.

Ejecutar en

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
 }

Obtener problemas

Descripción

Obtiene los detalles de un problema por claves.

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
Claves de problemas String N/A Sí Claves de los problemas que se recuperarán, separadas por comas.

Ejecutar en

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
 }

Problemas de la lista

Descripción

Buscar problemas

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
Nombres de proyectos String N/A No Nombres de los proyectos en los que se realizará la búsqueda, separados por comas.
Resumen String N/A No Es el resumen por el que se filtrará.
Descripción String N/A No Es la descripción por la que se filtrará.
Tipos de problemas String Error No Son los tipos de problemas por los que se filtrará.
Prioridades String N/A No Es la prioridad por la que se filtrará.
Creado a partir de String N/A No

Es la fecha de creación más antigua por la que se puede filtrar.

Formato: AAAA/MM/DD
Actualizado desde String N/A No

Es la fecha de actualización más antigua por la que se puede filtrar.

Formato: AAAA/MM/DD
Destinatarios String N/A No Nombre de los usuarios asignados por los que se filtrará, separados por comas.
Creador del informe String N/A No Es el nombre de los denunciantes por los que se filtrará la búsqueda, separados por comas.
Estados String N/A No Estados por los que se filtrará, separados por comas.

Ejecutar en

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 Verdadero/Falso issues:False
Resultado de JSON
[ "PR-123", "PR-124"]

Ping

Descripción

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

Parámetros

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

Ejecutar en

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

Actualiza un problema. En la nueva API de Jira, la acción intenta encontrar una coincidencia para el asignatario y así asignarle 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 Es la nueva descripción del problema.
Tipo de problema String N/A No Es el nuevo tipo de problema.
Usuario asignado String N/A No Es el nuevo asignatario del problema.
Nombre de usuario de Jira String N/A No Es el nombre de usuario de Jira del iniciador de 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 del problema.

Nota: Este parámetro tiene prioridad y todos los campos se reemplazan con 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.

Ejecutar en

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/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 problema.

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
Clave del problema String N/A Sí Rutas de acceso a archivos
Rutas de acceso de los archivos String N/A Sí Son las rutas de los archivos que se subirán, separadas por comas.

Ejecutar en

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 varios problemas en Jira

Parámetros

Parámetro Tipo Valor predeterminado Es obligatorio Descripción
ID del problema entrante String N/A Sí

Especifica una lista separada por comas de los IDs de problemas internos.

Por ejemplo, si el tipo de relación es "Bloquea", en la IU 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 IU verás este problema con la relación "blocks".
Tipo de relación String Bloqueos Sí Especifica el tipo de relación que se usará para vincular varios problemas. En la acción "List Relation Types", se encuentra disponible una lista de todos los tipos de relaciones disponibles.

Ejecutar en

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
Muro 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 informa el código de estado 201 para algunos problemas (is_success = true): "Se vinculó correctamente el problema "{problema de origen}" con los siguientes problemas en Jira: {problemas de destino}".

Si se informa el código de estado 404 y el error "Issue Does Not Exist" para un problema (is_success=true): "Action wasn't able to find the following destination issues in Jira: {jira issues that were not found}".

Si se informa el código de estado 404 y el error "Issue Does Not Exist" para todos los problemas (is_success=false): "No se encontró 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 un error grave, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, se mostrará el mensaje "Error al ejecutar la acción". Reason: {0}''.format(error.Stacktrace)

Si no se encuentra el problema de la fuente: "Error al ejecutar la acción". Motivo: No se encontró el problema de la fuente "{source issue}" en Jira. Revisa la ortografía".

Si el código de estado es 404 y no es el error "Issue Does Not Exist" para al menos uno, se mostrará el mensaje "Error executing action". Motivo: {mensajes de error}.

 General

Enumera los tipos de relaciones

Descripción

Enumera los tipos de relaciones disponibles en Jira.

Parámetros

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

Selecciona una opción

Valores posibles:

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

No especificado

Valores posibles:

  • No especificado
  • Igual
  • Contiene
 No Especifica qué lógica de filtro se debe aplicar. La lógica de filtrado funciona según el valor proporcionado en el parámetro "Clave del filtro".
Valor del filtro String N/A No

Especifica qué valor se debe usar en el filtro.

Si se selecciona "Igual a", 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 según el valor proporcionado en el parámetro "Clave del filtro".
Cantidad máxima de registros que se pueden devolver Número entero 50 No Especifica la cantidad de registros que se devolverán. Si no se proporciona nada, la acción devuelve 50 registros.

Ejecutar en

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"
}]
Muro 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): "Se encontraron correctamente los tipos de relación para los criterios proporcionados en Jira".

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

Si el parámetro "Filter Value" está vacío (is_success=true): "No se aplicó 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 "Clave de filtro" está establecido en "Seleccionar uno" y la "Lógica del filtro" está establecida en "Igual a" o "Contiene": Se produjo un error al ejecutar la acción "{nombre de la acción}". Motivo: Debes seleccionar un campo del parámetro "Clave de filtro".

Si se proporciona un valor no válido para Max Records to Return: "Error al ejecutar la acción "{action name}". Motivo: Se proporcionó un valor no válido para "Max Records to Return": . Se debe proporcionar un número positivo"."

Si se informa un error grave, como credenciales incorrectas, falta de conexión con el servidor o algún otro problema, se muestra el siguiente mensaje: "Se produjo un error al ejecutar la acción "{nombre de la acción}". Reason: {0}''.format(error.Stacktrace)

 General
Tabla del muro de casos

Nombre de la tabla: Relación disponible

Columnas de la tabla:

  • Nombre: nombre
  • Hacia adentro
  • Hacia afuera
 General

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

Lista de direcciones de correo electrónico separadas por comas para las que se devolverán los usuarios.
User Names Optional

Lista de nombres de usuario separados por comas para los que se devolverán 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 salida de la acción
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/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 completó correctamente.
Error executing action "Search Users". Reason: ERROR_REASON

No se pudo realizar la acción.

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

Conectores

Conector de Jira

Descripción

Recuperar problemas de Jira en Google SecOps

Configura el conector de Jira en Google SecOps

Si quieres obtener instrucciones detalladas para configurar un conector en Google SecOps, consulta Cómo configurar el conector.

Parámetros del conector

Usa los siguientes parámetros para configurar el conector:

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

Es el token generado en la consola de Jira.

Nota: Este parámetro se puede usar para contener la cadena "Contraseña" en caso de autenticación local, con la combinación de nombre de usuario y contraseña.
Días hacia atrás Número entero 5 No Cantidad máxima de días hacia atrás desde los que se extraerán las alertas.
Cantidad máxima de entradas por ciclo Número entero 10 No Cantidad máxima de tickets que se recuperarán y procesarán en un ciclo del conector.
Nombres de proyectos String N/A No Nombres de proyectos separados por una coma.
Estados de los problemas String N/A No Estados de los problemas separados por comas.
Destinatarios String N/A No Nombres completos de los usuarios separados por una coma.
Tipos de problemas String N/A No Tipos de problemas separados por comas.
Prioridades de los problemas String N/A No Prioridades de los problemas separadas por una coma.
Componentes del problema String N/A No Componentes del problema separados por comas.
Dirección del servidor proxy String N/A No Es la dirección del servidor proxy que se usará.
Nombre de usuario del proxy String N/A No Nombre de usuario del proxy con el que se realizará la autenticación.
Contraseña de proxy Contraseña N/A No Contraseña del proxy para la autenticación.
Nombre del campo del entorno String "" No

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

Si no se encuentra el campo del entorno, se usa el entorno predeterminado.
Patrón de expresión regular del entorno String .* No

Es un patrón de regex que se ejecutará en el valor que se encuentra en el campo "Nombre del campo del entorno".

El valor predeterminado es .* para capturar todo y devolver el valor sin cambios.

Se usa para permitir que el usuario manipule el campo del entorno a través de la lógica de regex.

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

Reglas del conector

Compatibilidad con proxy

El conector admite proxy.

Listas dinámicas y listas de bloqueo

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

Trabajos

Trabajo de cierre de sincronización

Descripción

Cerrar tickets en Jira si se cerraron las alertas correspondientes de Google SecOps

Parámetros

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

Es el token generado en la consola de Jira.

Nota: Este parámetro se puede usar para contener la cadena "Contraseña" en caso de autenticación local, con la combinación de nombre de usuario y contraseña.
Nombres de proyectos String Nombres de proyectos separados por una coma Sí Nombres de proyectos de Jira separados por comas que el trabajo debe supervisar.
Máx. de días hacia atrás Número entero 1 Sí Cantidad máxima de días para sincronizar el estado de los tickets hacia atrás.

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.

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

Cuando el trabajo 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 el ticket correspondiente de Jira con el parámetro Prefijo de comentario de Chronicle.

Esta función se agregó con dos propósitos:

  1. Visibilidad.
  2. Evita que los comentarios agregados 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 String https://{jira_address} Sí Es la URL raíz de la API de la instancia de Jira.
Nombre de usuario String N/A Sí Nombre de usuario para conectarse a la instancia de Jira.
Token de API Contraseña N/A Sí

Es el token generado en la consola de Jira.

Nota: Este parámetro se puede usar para contener la cadena "Contraseña" en caso de autenticación local, con la combinación de nombre de usuario y contraseña.
Nombres de proyectos String Nombres de proyectos separados por comas Sí Nombres de proyectos de Jira separados por comas que el trabajo debe supervisar.
Máx. de días hacia atrás Número entero 1 Sí Es la cantidad máxima de días para sincronizar el estado de los tickets hacia atrás.
Prefijo de comentario de Google SecOps String Google SecOps: Sí Es el prefijo que agrega el trabajo de sincronización a los comentarios creados para los tickets de Jira.
Prefijo del comentario de Jira String Trabajo de sincronización de comentarios de Jira: Sí Prefijo que agrega el trabajo de sincronización a los comentarios de los casos de alertas de SecOps de Google.

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