Esta página foi traduzida pela API Cloud Translation.

Jira

Versão da integração: 41.0

Configure o Jira para funcionar com o Google Security Operations

Crie um token de API

Crie um token de API a partir da sua conta da Atlassian:

Inicie sessão na sua conta da Atlassian.
Clique em Criar token de API.
Na caixa de diálogo apresentada, introduza uma etiqueta memorável e concisa para o seu token e clique em Criar.
Clique em Copiar para a área de transferência e, em seguida, cole o token num local seguro para o guardar.

Configure a integração do Jira no Google SecOps

Para obter instruções detalhadas sobre como configurar uma integração no Google SecOps, consulte o artigo Configure integrações.

Parâmetros de integração

Use os seguintes parâmetros para configurar a integração:

Nome a apresentar do parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Nome da instância	String	N/A	Não	Nome da instância para a qual pretende configurar a integração.
Descrição	String	N/A	Não	Descrição da instância.
Raiz da API	String	https://{jira_address}	Sim	Endereço da instância do Jira.
Nome de utilizador	String	N/A	Sim	Um nome de utilizador que deve ser usado para estabelecer ligação ao Jira.
Chave da API	Palavra-passe	N/A	Sim	Token gerado na consola do Jira. Nota: este parâmetro pode ser usado para conter a string "Password" no caso da autenticação no local, usando a combinação de nome de utilizador e palavra-passe.
Validar SSL	Caixa de verificação	Desmarcado	Não	Use esta caixa de verificação se a sua ligação ao Jira exigir uma validação SSL.
Executar remotamente	Caixa de verificação	Desmarcado	Não	Selecione o campo para executar a integração configurada remotamente. Depois de selecionada, a opção aparece para selecionar o utilizador remoto (agente).

Ações

Adicionar comentário

Descrição

Compor comentários sobre um problema é uma forma eficaz de documentar mais elementos sobre um problema e participar com os membros da equipa.

Parâmetros

Parâmetros	Tipo	Valor predefinido	É obrigatório	Descrição
Chave do problema	String	N/A	Sim	A chave do problema. Exemplo: ABC-123
Comentário	String	N/A	Sim	O conteúdo do comentário a adicionar ao problema.

Tipo

Valor predefinido

É obrigatório

Descrição

Chave do problema

String

N/A

Sim

A chave do problema.

Exemplo: ABC-123

Comentário

String

N/A

Sim

O conteúdo do comentário a adicionar ao problema.

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valores	Exemplo
comment_id	N/A	N/A

Resultado JSON

N/A

Atribuir problema

Descrição

Atribuir um problema a um utilizador específico. O nome de utilizador do Jira pode ser, por exemplo, o nome ou o email. Para a nova API Jira, a ação tenta encontrar uma correspondência para o responsável pela atribuição de um problema com base no email do utilizador e, em seguida, tenta com o campo displayName.

Parâmetros

Parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Chave do problema	String	N/A	Sim	A chave do problema.
Atribuído a	String	N/A	Sim	O novo destinatário do problema.
Nome de utilizador do Jira	String	N/A	Não	O nome de utilizador do Jira do iniciador da ação.

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valores	Exemplo
êxito	Verdadeiro/Falso	success:False

Crie um problema de alerta

Descrição

Atribuir um incidente a um grupo específico.

Parâmetros

Parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Chave do projeto	String	N/A	Sim	A chave do projeto no qual quer criar o problema.
Resumo	String	N/A	Sim	O resumo do problema.
Tipo de problema	String	N/A	Sim	O tipo de problema.

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valores	Exemplo
issue_key	N/A	N/A

Resultado 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
}

Criar problema

Descrição

Crie um problema num projeto. O nome de utilizador do Jira pode ser, por exemplo, o nome ou o email. Para a nova API Jira, a ação tenta encontrar uma correspondência para o responsável pela atribuição de um problema com base no email do utilizador e, em seguida, tenta com o campo displayName.

Parâmetros

Parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Chave do projeto	String	N/A	Sim	A chave do projeto no qual criar um problema.
Resumo	String	N/A	Sim	O resumo do problema.
Descrição	String	N/A	Sim	A descrição do problema.
Tipo de problema	String	N/A	Sim	O tipo de problema.
Atribuído a	String	N/A	Não	O novo destinatário do problema.
Nome de utilizador do Jira	String	N/A	Não	O nome de utilizador do Jira do iniciador da ação.
Componentes	String	N/A	Não	O campo de componentes do problema. Este parâmetro aceita vários valores como uma string separada por vírgulas.
Etiquetas	String	N/A	Não	O campo de componentes do problema. Este parâmetro aceita vários valores como uma string separada por vírgulas.
Campos personalizados	JSON	N/A	Não	Especifique um objeto JSON que contenha todos os campos e valores que vão ser usados durante a criação do problema. Nota: este parâmetro tem prioridade e todos os campos são substituídos pelo valor fornecido para este parâmetro. Exemplo: {"field":"value"}

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valores	Exemplo
issue_key	N/A	N/A

Resultado JSON

N/A

Elimine o problema

Descrição

Elimine um problema.

Parâmetros

Parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Chave do problema	String	N/A	Sim	A chave do problema a eliminar.

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valores	Exemplo
êxito	Verdadeiro/Falso	success:False

Resultado JSON

N/A

Transferir anexos

Descrição

Obtenha uma chave do problema e transfira todos os anexos. Se um deles for um ficheiro EML, transfira também os anexos.

Parâmetros

Parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Chave do problema	String	N/A	Sim	A chave do problema.
Caminho de transferência	String	N/A	Não	O caminho onde guardar os anexos.
Transfira anexos para o mural do registo	Caixa de verificação	Desmarcado	Não	Se estiver ativada, a ação transfere os anexos do problema do Jira para o mural do registo de alerta do Google SecOps atual.

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valores	Exemplo
is_success	Verdadeiro/Falso	is_success:False

Resultado 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
 }

Obtenha problemas

Descrição

Obtenha os detalhes de um problema por chaves.

Parâmetros

Parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Teclas de emissão	String	N/A	Sim	As chaves dos problemas a obter separadas por uma vírgula.

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valores	Exemplo
issues_details_list	Verdadeiro/Falso	issues_details_list:False

Resultado 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 com listas

Descrição

Pesquise problemas.

Parâmetros

Parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Nomes dos projetos	String	N/A	Não	Os nomes dos projetos nos quais pesquisar, separados por vírgulas.
Resumo	String	N/A	Não	O resumo pelo qual filtrar.
Descrição	String	N/A	Não	A descrição pela qual filtrar.
Tipos de problemas	String	Erro	Não	Os tipos de problemas pelos quais filtrar.
Prioridades	String	N/A	Não	A prioridade pela qual filtrar.
Criado a partir de	String	N/A	Não	A data de criação mais antiga pela qual filtrar. Formato: AAAA/MM/DD.
Atualizado a partir de	String	N/A	Não	A data de atualização mais antiga pela qual filtrar. Formato: AAAA/MM/DD.
Beneficiários	String	N/A	Não	O nome dos responsáveis pelo filtro, separados por vírgulas.
Autor do relatório	String	N/A	Não	O nome dos denunciantes pelo qual filtrar, separado por vírgulas.
Estados	String	N/A	Não	Os estados pelos quais filtrar, separados por vírgulas.

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valores	Exemplo
problemas	Verdadeiro/Falso	issues:False

Resultado JSON

[ "PR-123", "PR-124"]

Tchim-tchim

Descrição

Verifica se o utilizador tem uma ligação ao Jira através do respetivo dispositivo.

Parâmetros

Esta ação não tem parâmetros de entrada.

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valores	Exemplo
êxito	Verdadeiro/Falso	success:False

Resultado JSON

N/A

Problema com a atualização

Descrição

Atualize um problema. Para a nova API Jira, a ação tenta encontrar uma correspondência para o destinatário para atribuir um problema com base no email do utilizador e, em seguida, tenta com o campo displayName.

Parâmetros

Parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Chave do problema	String	N/A	Sim	A chave do problema a atualizar.
Estado	String	N/A	Não	Especifique o nome da transição relevante para transitar este problema para o novo estado pretendido.
Resumo	String	N/A	Não	O novo resumo do problema.
Descrição	String	N/A	Não	A nova descrição do problema.
Tipo de problema	String	N/A	Não	O novo tipo de problema.
Atribuído a	String	N/A	Não	O novo destinatário do problema.
Nome de utilizador do Jira	String	N/A	Não	O nome de utilizador do Jira do iniciador da ação.
Componentes	String	N/A	Não	O campo de componentes do problema. Este parâmetro aceita vários valores como uma string separada por vírgulas.
Campos personalizados	JSON	NA	Não	Especifique um objeto JSON que contenha todos os campos e valores usados durante a criação do problema. Nota: este parâmetro tem prioridade e todos os campos são substituídos pelo valor fornecido para este parâmetro. Exemplo: {"field":"value"}
Etiquetas	String	N/A	Não	O campo de componentes do problema. Este parâmetro aceita vários valores como uma string separada por vírgulas.

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valores	Exemplo
Concluído	Verdadeiro/Falso	Success:False

Resultado 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
}

Carregar anexo

Descrição

Adicione um anexo a um problema.

Parâmetros

Parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Chave do problema	String	N/A	Sim	Caminhos de ficheiros.
Caminhos de ficheiros	String	N/A	Sim	Os caminhos dos ficheiros a carregar, separados por vírgulas.

Executar em

Esta ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valores	Exemplo
is_success	Verdadeiro/Falso	is_success:False

Resultado JSON

N/A

Problemas com links

Descrição

Associe vários problemas no Jira.

Parâmetros

Parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
ID do problema de entrada	String	N/A	Sim	Especifique uma lista de IDs de problemas internos separados por vírgulas. Por exemplo, se o tipo de relação for "Blocks", na IU, verá este problema com a relação "bloqueado por".
IDs de problemas externos	CSV	N/A	Sim	Especifique o ID do problema externo. Por exemplo, se o tipo de relação for "Blocks", na IU, verá este problema com a relação "blocks".
Tipo de relação	String	Blocos	Sim	Especifique o tipo de relação que vai ser usado para associar vários problemas. Pode encontrar uma lista de todos os tipos de relações disponíveis na ação "List Relation Types" (Listar tipos de relações).

Parâmetro

Tipo

Valor predefinido

É obrigatório

Descrição

ID do problema de entrada

String

N/A

Sim

Especifique uma lista de IDs de problemas internos separados por vírgulas.

Por exemplo, se o tipo de relação for "Blocks", na IU, verá este problema com a relação "bloqueado por".

IDs de problemas externos

CSV

N/A

Sim

Especifique o ID do problema externo.

Por exemplo, se o tipo de relação for "Blocks", na IU, verá este problema com a relação "blocks".

Tipo de relação

String

Blocos

Sim

Especifique o tipo de relação que vai ser usado para associar vários problemas. Pode encontrar uma lista de todos os tipos de relações disponíveis na ação "List Relation Types" (Listar tipos de relações).

Executar em

Esta ação não é executada em entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valores	Exemplo
is_success	Verdadeiro/Falso	is_success:False

Resultado JSON

N/A

Case Wall

Tipo de resultado	Valor / descrição	Tipo
Mensagem de saída*	A ação não deve falhar nem parar a execução de um guia interativo: Se o código de estado 201 for comunicado para alguns problemas (is_success = true): "Successfully linked issue "{source issue}" with the following issues in Jira: {destination issues}". Se o código de estado 404 e o erro "O problema não existe" forem comunicados para um problema (is_success=true): "Não foi possível encontrar os seguintes problemas de destino no Jira: {jira issues that were not found}". Se o código de estado 404 e o erro "O problema não existe" forem comunicados para todos os problemas (is_success=false): "Nenhum dos problemas de destino foi encontrado no Jira." A ação deve falhar e parar a execução de um guia interativo: Se for comunicado um erro fatal, como credenciais incorretas, sem ligação ao servidor ou outro: "Erro ao executar a ação". Motivo: {0}''.format(error.Stacktrace) Se não for encontrado o problema de origem: "Erro ao executar a ação". Motivo: o problema de origem "{source issue}" não foi encontrado no Jira. Verifique a ortografia. Se o código de estado 404 e não for o erro "O problema não existe" para, pelo menos, um dos seguintes: "Erro ao executar a ação". Motivo: {error messages}.	Geral

Tipo de resultado

Valor / descrição

Tipo

Mensagem de saída*

A ação não deve falhar nem parar a execução de um guia interativo:

Se o código de estado 201 for comunicado para alguns problemas (is_success = true): "Successfully linked issue "{source issue}" with the following issues in Jira: {destination issues}".

Se o código de estado 404 e o erro "O problema não existe" forem comunicados para um problema (is_success=true): "Não foi possível encontrar os seguintes problemas de destino no Jira: {jira issues that were not found}".

Se o código de estado 404 e o erro "O problema não existe" forem comunicados para todos os problemas (is_success=false): "Nenhum dos problemas de destino foi encontrado no Jira."

A ação deve falhar e parar a execução de um guia interativo:

Se for comunicado um erro fatal, como credenciais incorretas, sem ligação ao servidor ou outro: "Erro ao executar a ação". Motivo: {0}''.format(error.Stacktrace)

Se não for encontrado o problema de origem: "Erro ao executar a ação". Motivo: o problema de origem "{source issue}" não foi encontrado no Jira. Verifique a ortografia.

Se o código de estado 404 e não for o erro "O problema não existe" para, pelo menos, um dos seguintes: "Erro ao executar a ação". Motivo: {error messages}.

Geral

Apresentar tipos de relações

Descrição

Liste os tipos de relações disponíveis no Jira.

Parâmetros

Parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Tecla de filtro	LDD	Selecione uma opção Valores possíveis: Nome Para dentro Para fora	Não	Especifique a chave que tem de ser usada para filtrar {item type}.
Lógica de filtragem	LDD	Não especificado Valores possíveis: Não especificado Igual Contém	Não	Especifique a lógica de filtro que deve ser aplicada. A lógica de filtragem está a funcionar com base no valor fornecido no parâmetro "Chave do filtro".
Valor do filtro	String	N/A	Não	Especifique o valor que deve ser usado no filtro. Se a opção "Igual a" estiver selecionada, a ação tenta encontrar a correspondência exata entre os resultados. Se a opção "Contém" estiver selecionada, a ação tenta encontrar resultados que contenham a substring especificada. Se não for fornecido nada neste parâmetro, o filtro não é aplicado. A lógica de filtragem está a funcionar com base no valor fornecido no parâmetro "Chave do filtro".
Máximo de registos a devolver	Número inteiro	50	Não	Especifique o número de registos a devolver. Se não for fornecido nada, a ação devolve 50 registos.

Executar em

Esta ação não é executada em entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valores	Exemplo
is_success	Verdadeiro/Falso	is_success:False

Resultado JSON

[{
    "id": "10000",
    "name": "Blocks",
    "inward": "is blocked by",
    "outward": "blocks",
    "self": "http://172.30.201.69:8080/rest/api/2/issueLinkType/10000"
}]

Case Wall

Tipo de resultado	Valor / descrição	Tipo
Mensagem de saída*	A ação não deve falhar nem parar a execução de um guia interativo: Se os dados estiverem disponíveis (is_success = true): "Successfully found relation types for the provided criteria in Jira" (Foram encontrados com êxito tipos de relações para os critérios fornecidos no Jira). Se os dados não estiverem disponíveis (is_success=false): "Não foram encontrados tipos de relações para os critérios fornecidos no Jira" Se o parâmetro "Valor do filtro" estiver vazio (is_success=true): "O filtro não foi aplicado porque o parâmetro "Valor do filtro" tem um valor vazio." A ação deve falhar e parar a execução de um guia interativo: Se o parâmetro "Chave de filtro" estiver definido como "Selecionar Um" e a "Lógica de filtro" estiver definida como "Igual a" ou "Contém": erro ao executar a ação "{action name}". Motivo: tem de selecionar um campo no parâmetro "Chave de filtro"." Se for fornecido um valor inválido para o número máximo de registos a devolver: "Erro ao executar a ação "{action name}". Motivo: foi fornecido um valor inválido para "Max Records to Return": . Deve ser fornecido um número positivo"." Se for comunicado um erro fatal, como credenciais incorretas, sem ligação ao servidor ou outro: "Erro ao executar a ação "{action name}". Motivo: {0}''.format(error.Stacktrace)	Geral
Tabela de parede da caixa	Nome da tabela: relação disponível Colunas da tabela: Nome – nome Para dentro – para dentro Para fora – para fora	Geral

Tipo de resultado

Valor / descrição

Tipo

Mensagem de saída*

A ação não deve falhar nem parar a execução de um guia interativo:

Se os dados estiverem disponíveis (is_success = true): "Successfully found relation types for the provided criteria in Jira" (Foram encontrados com êxito tipos de relações para os critérios fornecidos no Jira).

Se os dados não estiverem disponíveis (is_success=false): "Não foram encontrados tipos de relações para os critérios fornecidos no Jira"

Se o parâmetro "Valor do filtro" estiver vazio (is_success=true): "O filtro não foi aplicado porque o parâmetro "Valor do filtro" tem um valor vazio."

A ação deve falhar e parar a execução de um guia interativo:

Se o parâmetro "Chave de filtro" estiver definido como "Selecionar Um" e a "Lógica de filtro" estiver definida como "Igual a" ou "Contém": erro ao executar a ação "{action name}". Motivo: tem de selecionar um campo no parâmetro "Chave de filtro"."

Se for fornecido um valor inválido para o número máximo de registos a devolver: "Erro ao executar a ação "{action name}". Motivo: foi fornecido um valor inválido para "Max Records to Return": . Deve ser fornecido um número positivo"."

Se for comunicado um erro fatal, como credenciais incorretas, sem ligação ao servidor ou outro: "Erro ao executar a ação "{action name}". Motivo: {0}''.format(error.Stacktrace)

Geral

Tabela de parede da caixa

Nome da tabela: relação disponível

Colunas da tabela:

Nome – nome
Para dentro – para dentro
Para fora – para fora

Geral

Pesquisar utilizadores

Pesquise utilizadores no Jira.

Entidades

Esta ação não é executada em entidades.

Dados de ações

Para configurar a ação, use os seguintes parâmetros:

Parâmetros
`User Email Addresses`	Opcional Lista de endereços de email separados por vírgulas para os quais devolver os utilizadores.
`User Names`	Opcional Lista separada por vírgulas de nomes de utilizador para os quais devolver os utilizadores.
`Project`	Opcional Nome do projeto no qual pesquisar endereços de email. Se for fornecido, apenas é devolvido o valor de `Project Assignable Users`.

Resultados da ação

Tipo de saída da ação
Fixação à parede da caixa	N/A
Link da parede da caixa	N/A
Mesa de parede para caixas	N/A
Tabela de enriquecimento	N/A
Resultado JSON	Disponível
Resultado do script	Disponível

Resultado do script

Nome do resultado do script	Valor
is_success	Verdadeiro/Falso

Resultado 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"
   }
 }
]

Parede da caixa

A ação fornece as seguintes mensagens de saída:

Mensagem de saída Descrição da mensagem

Mensagem de saída	Descrição da mensagem
`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`	Ação efetuada com êxito.
`Error executing action "Search Users". Reason: ERROR_REASON`	Falha na ação. Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

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

Ação efetuada com êxito.

Error executing action "Search Users".
      Reason: ERROR_REASON

Falha na ação.

Verifique a ligação ao servidor, os parâmetros de entrada ou as credenciais.

Conetores

Conetor do Jira

Descrição

Obtenha problemas do Jira para o Google SecOps.

Configure o conetor do Jira no Google SecOps

Para ver instruções detalhadas sobre como configurar um conetor no Google SecOps, consulte o artigo Configurar o conetor.

Parâmetros do conetor

Use os seguintes parâmetros para configurar o conector:

Parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
DeviceProductField	String	device_product	Sim	O nome do campo usado para determinar o produto do dispositivo.
EventClassId	String	nome	Não	O nome do campo usado para determinar o nome do evento (subtipo).
PythonProcessTimeout	String	60	Sim	O limite de tempo (em segundos) para o processo Python que executa o script atual.
Raiz da API	String	https://{jira_address}	Sim	A raiz da API da instância do Jira.
Nome de utilizador	String	N/A	Sim	N/A
Chave da API	Palavra-passe	N/A	Sim	Token gerado na consola do Jira. Nota: este parâmetro pode ser usado para conter a string "Password" no caso da autenticação no local, usando a combinação de nome de utilizador e palavra-passe
Dias para trás	Número inteiro	5	Não	Número máximo de dias anteriores a partir dos quais obter alertas.
Máximo de bilhetes por ciclo	Número inteiro	10	Não	Número máximo de pedidos a obter e processar num ciclo do conetor.
Nomes dos projetos	String	N/A	Não	Nomes de projetos separados por uma vírgula.
Estados dos problemas	String	N/A	Não	Os estados dos problemas separados por uma vírgula.
Beneficiários	String	N/A	Não	Nomes completos dos utilizadores separados por uma vírgula.
Tipos de problemas	String	N/A	Não	Tipos de problemas separados por uma vírgula.
Prioridades dos problemas	String	N/A	Não	Prioridades dos problemas separadas por uma vírgula.
Componentes do problema	String	N/A	Não	Indique os componentes do problema separados por uma vírgula.
Endereço do servidor proxy	String	N/A	Não	O endereço do servidor proxy a usar.
Nome de utilizador do proxy	String	N/A	Não	O nome de utilizador do proxy para autenticação.
Palavra-passe do proxy	Palavra-passe	N/A	Não	A palavra-passe do proxy para autenticação.
Nome do campo do ambiente	String	""	Não	Descreve o nome do campo onde o nome do ambiente está armazenado. Se o campo do ambiente não for encontrado, o ambiente é o ambiente predefinido.
Padrão de regex do ambiente	String	.*	Não	Um padrão de regex a executar no valor encontrado no campo "Nome do campo do ambiente". A predefinição é .* para captar tudo e devolver o valor inalterado. Usado para permitir que o utilizador manipule o campo do ambiente através da lógica de regex. Se o padrão regex for nulo ou estiver vazio, ou o valor do ambiente for nulo, o resultado final do ambiente é o ambiente predefinido.

Regras do conetor

Suporte de proxy

O conetor suporta proxy.

Lista dinâmica e lista de bloqueios

O conetor suporta regras de listas dinâmicas e listas de bloqueio apenas para etiquetas específicas no Jira.

Empregos

Tarefa de encerramento da sincronização

Descrição

Feche pedidos no Jira se os alertas correspondentes do Google SecOps tiverem sido fechados.

Parâmetros

Nome a apresentar do parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Raiz da API	String	https://{jira_address}	Sim	URL raiz da API da instância do Jira.
Nome de utilizador	String	N/A	Sim	Nome de utilizador para estabelecer ligação à instância do Jira.
Chave da API	Palavra-passe	N/A	Sim	Token gerado na consola do Jira. Nota: este parâmetro pode ser usado para conter a string "Password" no caso da autenticação no local, usando a combinação de nome de utilizador e palavra-passe
Nomes dos projetos	String	Nomes dos projetos separados por uma vírgula	Sim	Nomes de projetos do Jira separados por uma vírgula que a tarefa deve monitorizar.
Máximo de dias para trás	Número inteiro	1	Sim	Número máximo de dias para sincronizar o estado dos pedidos retroativamente.

Tarefa de sincronização de comentários

Descrição

Sincronizar comentários entre o registo do Google SecOps e o registo do Jira correspondente. A sincronização é bidirecional, ou seja, do Google SecOps para o Jira e do Jira para o Google SecOps.

Esta tarefa suporta registos do Google SecOps apenas com a etiqueta Jira.

Quando a tarefa cria um comentário, aplica o prefixo. Se um utilizador do Google SecOps comentar no registo do Google SecOps, a tarefa cria e sincroniza o comentário do utilizador no registo do Jira correspondente através do parâmetro Prefixo do comentário do Chronicle.

Esta funcionalidade é adicionada para dois fins:

Visibilidade.
Impedir que os comentários adicionados pela tarefa sejam sincronizados novamente com o outro lado e provocar um ciclo.

Parâmetros

Nome a apresentar do parâmetro	Tipo	Valor predefinido	É obrigatório	Descrição
Raiz da API	String	https://{jira_address}	Sim	URL raiz da API da instância do Jira.
Nome de utilizador	String	N/A	Sim	Nome de utilizador para estabelecer ligação à instância do Jira.
Chave da API	Palavra-passe	N/A	Sim	Token gerado na consola do Jira. Nota: este parâmetro pode ser usado para conter a string "Password" no caso da autenticação no local, usando a combinação de nome de utilizador e palavra-passe
Nomes dos projetos	String	Nomes dos projetos separados por vírgulas	Sim	Nomes de projetos do Jira separados por vírgulas que a tarefa deve monitorizar.
Máximo de dias para trás	Número inteiro	1	Sim	Número máximo de dias para sincronizar o estado dos pedidos retroativamente.
Prefixo de comentário do Google SecOps	String	Google SecOps:	Sim	Prefixo adicionado pela tarefa de sincronização aos comentários criados para pedidos do Jira.
Prefixo de comentário do Jira	String	Tarefa de sincronização de comentários do Jira:	Sim	Prefixo adicionado pela tarefa de sincronização aos comentários do registo de alerta do Google SecOps.

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais da Google SecOps.