Halaman ini diterjemahkan oleh Cloud Translation API.

Jira

Versi integrasi: 41.0

Mengonfigurasi Jira agar dapat berfungsi dengan Google Security Operations

Membuat token API

Buat token API dari akun Atlassian Anda:

Login ke Akun Atlassian.
Klik Create API token.
Dari dialog yang muncul, masukkan Label yang mudah diingat dan ringkas untuk token Anda, lalu klik Buat.
Klik Salin ke papan klip, lalu tempelkan token di tempat yang aman untuk disimpan.

Mengonfigurasi integrasi Jira di Google SecOps

Untuk mendapatkan petunjuk mendetail terkait cara mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi integrasi.

Parameter integrasi

Gunakan parameter berikut untuk mengonfigurasi integrasi:

Nama Tampilan Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Nama Instance	String	T/A	Tidak	Nama Instance yang ingin Anda konfigurasi integrasinya.
Deskripsi	String	T/A	Tidak	Deskripsi Instance.
Root API	String	https://{jira_address}	Ya	Alamat instance Jira.
Nama pengguna	String	T/A	Ya	Nama pengguna yang harus digunakan untuk terhubung ke Jira.
Token API	Sandi	T/A	Ya	Token yang dibuat di konsol Jira. Catatan: Parameter ini dapat digunakan untuk memuat string "Password" dalam kasus autentikasi On-prem, menggunakan kombinasi nama pengguna dan sandi.
Verifikasi SSL	Kotak centang	Tidak dicentang	Tidak	Gunakan kotak centang ini, jika koneksi Jira Anda memerlukan verifikasi SSL.
Menjalankan dari Jarak Jauh	Kotak centang	Tidak dicentang	Tidak	Centang kolom untuk menjalankan integrasi yang dikonfigurasi dari jarak jauh. Setelah dicentang, opsi akan muncul untuk memilih pengguna jarak jauh (agen).

Tindakan

Tambahkan Komentar

Deskripsi

Menulis komentar untuk suatu masalah adalah cara yang efektif untuk mendokumentasikan elemen lebih lanjut tentang suatu masalah dan berpartisipasi dengan anggota tim.

Parameter

Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Kunci Masalah	String	T/A	Ya	Kunci masalah dari masalah. Contoh: ABC-123
Komentar	String	T/A	Ya	Isi komentar yang akan ditambahkan ke masalah.

Jenis

Nilai Default

Wajib

Deskripsi

Kunci Masalah

String

T/A

Kunci masalah dari masalah.

Contoh: ABC-123

Komentar

String

T/A

Isi komentar yang akan ditambahkan ke masalah.

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

Nama Hasil Skrip	Opsi Nilai	Contoh
comment_id	T/A	T/A

Hasil JSON

N/A

Menetapkan Masalah

Deskripsi

Menetapkan masalah kepada pengguna tertentu. Nama pengguna Jira bisa berupa nama atau email. Untuk Jira API baru, tindakan ini mencoba menemukan kecocokan untuk penerima tugas guna menetapkan masalah berdasarkan email pengguna, lalu mencoba dengan kolom displayName.

Parameter

Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Kunci Masalah	String	T/A	Ya	Kunci masalah dari masalah.
Penerima tugas	String	T/A	Ya	Penerima tugas baru untuk masalah ini.
Nama Pengguna Jira	String	T/A	Tidak	Nama pengguna Jira dari pemrakarsa tindakan.

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

Nama Hasil Skrip	Opsi Nilai	Contoh
berhasil	Benar/Salah	success:False

Buat Masalah Pemberitahuan

Deskripsi

Menetapkan insiden ke grup tertentu.

Parameter

Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Kunci Project	String	T/A	Ya	Kunci project untuk membuat masalah.
Ringkasan	String	T/A	Ya	Ringkasan masalah.
Jenis Masalah	String	T/A	Ya	Jenis masalah.

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

Nama Hasil Skrip	Opsi Nilai	Contoh
issue_key	T/A	T/A

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

Buat Masalah

Deskripsi

Buat masalah dalam project. Nama pengguna Jira bisa berupa nama atau email, misalnya. Untuk Jira API baru, tindakan ini mencoba menemukan kecocokan untuk penerima tugas guna menetapkan masalah berdasarkan email pengguna, lalu mencoba dengan kolom displayName.

Parameter

Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Kunci Project	String	T/A	Ya	Kunci project untuk membuat masalah.
Ringkasan	String	T/A	Ya	Ringkasan masalah.
Deskripsi	String	T/A	Ya	Deskripsi masalah.
Jenis Masalah	String	T/A	Ya	Jenis masalah.
Penerima tugas	String	T/A	Tidak	Penerima tugas baru untuk masalah ini.
Nama Pengguna Jira	String	T/A	Tidak	Nama pengguna Jira dari pemrakarsa tindakan.
Komponen	String	T/A	Tidak	Kolom komponen masalah. Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma.
Label	String	T/A	Tidak	Kolom komponen masalah. Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma.
Kolom Kustom	JSON	T/A	Tidak	Tentukan objek JSON yang berisi semua kolom dan nilai yang akan digunakan selama pembuatan masalah. Catatan: Parameter ini memiliki prioritas dan semua kolom akan diganti dengan nilai yang diberikan untuk parameter ini. Contoh: {"field":"value"}

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

Nama Hasil Skrip	Opsi Nilai	Contoh
issue_key	T/A	T/A

Hasil JSON

N/A

Menghapus Masalah

Deskripsi

Menghapus masalah.

Parameter

Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Kunci Masalah	String	T/A	Ya	Kunci masalah yang akan dihapus.

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

Nama Hasil Skrip	Opsi Nilai	Contoh
berhasil	Benar/Salah	success:False

Hasil JSON

N/A

Mendownload Lampiran

Deskripsi

Dapatkan kunci Masalah dan download semua lampiran. Jika salah satunya adalah file EML, maka download juga di dalam lampiran.

Parameter

Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Kunci Masalah	String	T/A	Ya	Kunci masalah.
Jalur Download	String	T/A	Tidak	Jalur tempat menyimpan lampiran.
Mendownload Lampiran ke Repositori Kasus	Kotak centang	Tidak dicentang	Tidak	Jika diaktifkan, tindakan ini akan mendownload lampiran masalah Jira ke dinding kasus pemberitahuan Google SecOps saat ini.

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

Nama Hasil Skrip	Opsi Nilai	Contoh
is_success	Benar/Salah	is_success:False

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

Mendapatkan Masalah

Deskripsi

Mendapatkan detail masalah berdasarkan kunci.

Parameter

Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Tombol Masalah	String	T/A	Ya	Kunci masalah yang akan diambil, dipisahkan dengan koma.

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

Nama Hasil Skrip	Opsi Nilai	Contoh
issues_details_list	Benar/Salah	issues_details_list:False

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

Masalah Daftar

Deskripsi

Telusuri masalah.

Parameter

Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Nama Project	String	T/A	Tidak	Nama project yang akan ditelusuri, dipisahkan dengan koma.
Ringkasan	String	T/A	Tidak	Ringkasan yang akan difilter.
Deskripsi	String	T/A	Tidak	Deskripsi yang akan difilter.
Jenis Masalah	String	Bug	Tidak	Jenis masalah yang akan difilter.
Prioritas	String	T/A	Tidak	Prioritas yang akan difilter.
Dibuat Dari	String	T/A	Tidak	Tanggal pembuatan paling awal untuk memfilter. Format: YYYY/MM/DD.
Diperbarui dari	String	T/A	Tidak	Tanggal update paling awal untuk memfilter. Format: YYYY/MM/DD.
Penerima tugas	String	T/A	Tidak	Nama penerima tugas yang akan difilter, dipisahkan dengan koma.
Pelapor	String	T/A	Tidak	Nama pelapor yang akan difilter, dipisahkan dengan koma.
Status	String	T/A	Tidak	Status yang akan difilter, dipisahkan dengan koma.

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

Nama Hasil Skrip	Opsi Nilai	Contoh
masalah	Benar/Salah	masalah:Salah

Hasil JSON

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

Ping

Deskripsi

Memverifikasi bahwa pengguna memiliki koneksi ke Jira melalui perangkat pengguna.

Parameter

Tindakan ini tidak memiliki parameter input.

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

Nama Hasil Skrip	Opsi Nilai	Contoh
berhasil	Benar/Salah	success:False

Hasil JSON

N/A

Memperbarui Masalah

Deskripsi

Perbarui masalah. Untuk Jira API baru, tindakan ini mencoba menemukan kecocokan untuk penerima tugas guna menetapkan masalah berdasarkan email pengguna, lalu mencoba dengan kolom displayName.

Parameter

Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Kunci Masalah	String	T/A	Ya	Kunci masalah yang akan diperbarui.
Status	String	T/A	Tidak	Tentukan nama transisi yang relevan, untuk mentransisikan masalah ini ke status baru yang diinginkan.
Ringkasan	String	T/A	Tidak	Ringkasan baru masalah ini.
Deskripsi	String	T/A	Tidak	Deskripsi baru masalah.
Jenis Masalah	String	T/A	Tidak	Jenis masalah baru.
Penerima tugas	String	T/A	Tidak	Penerima tugas baru untuk masalah ini.
Nama Pengguna Jira	String	T/A	Tidak	Nama pengguna Jira dari inisiator tindakan.
Komponen	String	T/A	Tidak	Kolom komponen masalah. Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma.
Kolom Kustom	JSON	NA	Tidak	Tentukan objek JSON yang berisi semua kolom dan nilai yang digunakan selama pembuatan masalah. Catatan: Parameter ini memiliki prioritas dan semua kolom akan diganti dengan nilai yang diberikan untuk parameter ini. Contoh: {"field":"value"}
Label	String	T/A	Tidak	Kolom komponen masalah. Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma.

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

Nama Hasil Skrip	Opsi Nilai	Contoh
Berhasil	Benar/Salah	Berhasil:False

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

Upload Lampiran

Deskripsi

Menambahkan lampiran ke masalah.

Parameter

Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Kunci Masalah	String	T/A	Ya	Jalur File.
Jalur File	String	T/A	Ya	Jalur file yang akan diupload, dipisahkan dengan koma.

Run On

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

Nama Hasil Skrip	Opsi Nilai	Contoh
is_success	Benar/Salah	is_success:False

Hasil JSON

N/A

Masalah Penautan

Deskripsi

Menautkan beberapa masalah di Jira.

Parameter

Parameter	Jenis	Nilai Default	Wajib	Deskripsi
ID Masalah Masuk	String	T/A	Ya	Tentukan daftar ID masalah ke dalam yang dipisahkan koma. Misalnya, jika jenis relasinya adalah "Memblokir", maka di UI Anda akan melihat masalah ini dengan relasi "diblokir oleh".
ID Masalah Keluar	CSV	T/A	Ya	Tentukan ID masalah keluar. Misalnya, jika jenis relasinya adalah "Memblokir", maka di UI Anda akan melihat masalah ini dengan relasi "memblokir".
Jenis Hubungan	String	Blok	Ya	Tentukan jenis relasi yang akan digunakan untuk menautkan beberapa masalah. Daftar semua jenis relasi yang tersedia dapat dilihat di tindakan "List Relation Types".

Jenis

Nilai Default

Wajib

Deskripsi

ID Masalah Masuk

String

T/A

Tentukan daftar ID masalah ke dalam yang dipisahkan koma.

Misalnya, jika jenis relasinya adalah "Memblokir", maka di UI Anda akan melihat masalah ini dengan relasi "diblokir oleh".

ID Masalah Keluar

CSV

T/A

Tentukan ID masalah keluar.

Misalnya, jika jenis relasinya adalah "Memblokir", maka di UI Anda akan melihat masalah ini dengan relasi "memblokir".

Jenis Hubungan

String

Blok

Tentukan jenis relasi yang akan digunakan untuk menautkan beberapa masalah. Daftar semua jenis relasi yang tersedia dapat dilihat di tindakan "List Relation Types".

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip

Nama Hasil Skrip	Opsi Nilai	Contoh
is_success	Benar/Salah	is_success:False

Hasil JSON

N/A

Repositori Kasus

Jenis Hasil	Nilai / Deskripsi	Jenis
Pesan output*	Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika kode status 201 dilaporkan untuk beberapa masalah (is_success = true): "Successfully linked issue "{source issue}" with the following issues in Jira: {destination issues}". Jika kode status 404 dan error "Masalah Tidak Ada" dilaporkan untuk satu masalah (is_success=true): "Action wasn't able to find the following destination issues in Jira: {jira issues that were not found}". Jika kode status 404 dan error "Masalah Tidak Ada" dilaporkan untuk semua masalah (is_success=false): "Tidak ada masalah tujuan yang ditemukan di Jira." Tindakan akan gagal dan menghentikan eksekusi playbook: Jika terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error saat menjalankan tindakan". Alasan: {0}''.format(error.Stacktrace) Jika masalah sumber tidak ditemukan: "Error saat menjalankan tindakan". Alasan: masalah sumber "{source issue}" tidak ditemukan di Jira. Periksa ejaan. Jika kode status 404 dan bukan error "Masalah Tidak Ada" untuk setidaknya satu: "Error saat menjalankan tindakan". Alasan: {error messages}.	Umum

Jenis Hasil

Nilai / Deskripsi

Jenis

Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika kode status 201 dilaporkan untuk beberapa masalah (is_success = true): "Successfully linked issue "{source issue}" with the following issues in Jira: {destination issues}".

Jika kode status 404 dan error "Masalah Tidak Ada" dilaporkan untuk satu masalah (is_success=true): "Action wasn't able to find the following destination issues in Jira: {jira issues that were not found}".

Jika kode status 404 dan error "Masalah Tidak Ada" dilaporkan untuk semua masalah (is_success=false): "Tidak ada masalah tujuan yang ditemukan di Jira."

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika terjadi error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya: "Error saat menjalankan tindakan". Alasan: {0}''.format(error.Stacktrace)

Jika masalah sumber tidak ditemukan: "Error saat menjalankan tindakan". Alasan: masalah sumber "{source issue}" tidak ditemukan di Jira. Periksa ejaan.

Jika kode status 404 dan bukan error "Masalah Tidak Ada" untuk setidaknya satu: "Error saat menjalankan tindakan". Alasan: {error messages}.

Umum

Mencantumkan Jenis Hubungan

Deskripsi

Mencantumkan jenis hubungan yang tersedia di Jira.

Parameter

Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Kunci Filter	DDL	Pilih Satu Nilai yang Mungkin: Nama Ke dalam Keluar	Tidak	Tentukan kunci yang perlu digunakan untuk memfilter {item type}.
Logika Filter	DDL	Tidak Ditentukan Nilai yang Mungkin: Tidak Ditentukan Sama dengan Berisi	Tidak	Tentukan logika filter yang harus diterapkan. Logika pemfilteran berfungsi berdasarkan nilai yang diberikan dalam parameter "Kunci Filter".
Nilai Filter	String	T/A	Tidak	Tentukan nilai yang akan digunakan dalam filter. Jika "Sama dengan" dipilih, tindakan akan mencoba menemukan kecocokan persis di antara hasil. Jika "Berisi" dipilih, tindakan akan mencoba menemukan hasil yang berisi substring yang ditentukan. Jika tidak ada yang diberikan dalam parameter ini, filter tidak akan diterapkan. Logika pemfilteran berfungsi berdasarkan nilai yang diberikan dalam parameter "Kunci Filter".
Jumlah Maksimum Data yang Akan Ditampilkan	Bilangan bulat	50	Tidak	Tentukan jumlah data yang akan ditampilkan. Jika tidak ada yang diberikan, tindakan akan menampilkan 50 data.

Run On

Tindakan ini tidak dijalankan di entity.

Hasil Tindakan

Hasil Skrip

Nama Hasil Skrip	Opsi Nilai	Contoh
is_success	Benar/Salah	is_success:False

Hasil JSON

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

Repositori Kasus

Jenis Hasil	Nilai / Deskripsi	Jenis
Pesan output*	Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika data tersedia (is_success = true): "Successfully found relation types for the provided criteria in Jira". Jika data tidak tersedia (is_success=false): "No relation types were found for the provided criteria in Jira" (Tidak ada jenis hubungan yang ditemukan untuk kriteria yang diberikan di Jira) Jika parameter "Nilai Filter" kosong (is_success=true): "Filter tidak diterapkan, karena parameter "Nilai Filter" memiliki nilai kosong." Tindakan akan gagal dan menghentikan eksekusi playbook: Jika parameter "Kunci Filter" disetel ke "Pilih Satu" dan "Logika Filter" disetel ke "Sama dengan" atau "Berisi": Error saat menjalankan tindakan "{action name}". Alasan: Anda harus memilih kolom dari parameter "Kunci Filter"." Jika nilai tidak valid diberikan untuk Jumlah Maksimal Data yang Akan Ditampilkan: "Error saat menjalankan tindakan "{nama tindakan}". Alasan: "Nilai tidak valid diberikan untuk "Jumlah Maksimum Data yang Akan Ditampilkan": . Angka positif harus diberikan"." Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya dilaporkan: "Error saat menjalankan tindakan "{nama tindakan}". Alasan: {0}''.format(error.Stacktrace)	Umum
Tabel Repositori Kasus	Nama Tabel: Tersedia Relasi Kolom Tabel: Nama - nama Ke dalam - ke dalam Keluar - keluar	Umum

Jenis Hasil

Nilai / Deskripsi

Jenis

Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika data tersedia (is_success = true): "Successfully found relation types for the provided criteria in Jira".

Jika data tidak tersedia (is_success=false): "No relation types were found for the provided criteria in Jira" (Tidak ada jenis hubungan yang ditemukan untuk kriteria yang diberikan di Jira)

Jika parameter "Nilai Filter" kosong (is_success=true): "Filter tidak diterapkan, karena parameter "Nilai Filter" memiliki nilai kosong."

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika parameter "Kunci Filter" disetel ke "Pilih Satu" dan "Logika Filter" disetel ke "Sama dengan" atau "Berisi": Error saat menjalankan tindakan "{action name}". Alasan: Anda harus memilih kolom dari parameter "Kunci Filter"."

Jika nilai tidak valid diberikan untuk Jumlah Maksimal Data yang Akan Ditampilkan: "Error saat menjalankan tindakan "{nama tindakan}". Alasan: "Nilai tidak valid diberikan untuk "Jumlah Maksimum Data yang Akan Ditampilkan": . Angka positif harus diberikan"."

Jika error fatal, seperti kredensial salah, tidak ada koneksi ke server, atau error lainnya dilaporkan: "Error saat menjalankan tindakan "{nama tindakan}". Alasan: {0}''.format(error.Stacktrace)

Umum

Tabel Repositori Kasus

Nama Tabel: Tersedia Relasi

Kolom Tabel:

Nama - nama
Ke dalam - ke dalam
Keluar - keluar

Umum

Telusuri Pengguna

Telusuri pengguna di Jira.

Entity

Tindakan ini tidak dijalankan di entity.

Input tindakan

Untuk mengonfigurasi tindakan, gunakan parameter berikut:

Parameter
`User Email Addresses`	Opsional Daftar alamat email yang dipisahkan koma untuk menampilkan pengguna.
`User Names`	Opsional Daftar nama pengguna yang dipisahkan koma untuk menampilkan pengguna.
`Project`	Opsional Nama project untuk menelusuri alamat email. Jika disediakan, hanya `Project Assignable Users` yang ditampilkan.

Output tindakan

Jenis output tindakan
Lampiran repositori kasus	T/A
Link repositori kasus	T/A
Tabel repositori kasus	T/A
Tabel pengayaan	T/A
Hasil JSON	Tersedia
Hasil skrip	Tersedia

Hasil skrip

Nama hasil skrip	Nilai
is_success	Benar/Salah

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

Repositori kasus

Tindakan ini memberikan pesan output berikut:

Pesan output Deskripsi pesan

Pesan output	Deskripsi pesan
`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`	Tindakan berhasil.
`Error executing action "Search Users". Reason: ERROR_REASON`	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

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

Tindakan berhasil.

Error executing action "Search Users".
      Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.

Konektor

Konektor Jira

Deskripsi

Ambil masalah dari Jira ke Google SecOps.

Mengonfigurasi Konektor Jira di Google SecOps

Untuk mendapatkan petunjuk mendetail tentang cara mengonfigurasi konektor di Google SecOps, lihat Mengonfigurasi konektor.

Parameter konektor

Gunakan parameter berikut untuk mengonfigurasi konektor:

Parameter	Jenis	Nilai Default	Wajib	Deskripsi
DeviceProductField	String	device_product	Ya	Nama kolom yang digunakan untuk menentukan produk perangkat.
EventClassId	String	nama	Tidak	Nama kolom yang digunakan untuk menentukan nama peristiwa (sub-jenis).
PythonProcessTimeout	String	60	Ya	Batas waktu tunggu (dalam detik) untuk proses python yang menjalankan skrip saat ini.
Root API	String	https://{jira_address}	Ya	Root API instance Jira.
Nama pengguna	String	T/A	Ya	T/A
Token API	Sandi	T/A	Ya	Token yang dibuat di konsol Jira. Catatan: Parameter ini dapat digunakan untuk memuat string "Password" jika ada autentikasi On-prem, menggunakan kombinasi nama pengguna dan sandi
Mundur Beberapa Hari	Bilangan bulat	5	Tidak	Jumlah maksimum hari ke belakang untuk menarik pemberitahuan.
Tiket Maksimum Per Siklus	Bilangan bulat	10	Tidak	Jumlah maksimum tiket yang akan diambil dan diproses dalam satu siklus konektor.
Nama Project	String	T/A	Tidak	Nama project yang dipisahkan dengan koma.
Status Masalah	String	T/A	Tidak	Status masalah dipisahkan dengan koma.
Penerima tugas	String	T/A	Tidak	Nama lengkap pengguna yang dipisahkan dengan koma.
Jenis Masalah	String	T/A	Tidak	Jenis masalah yang dipisahkan dengan koma.
Prioritas Masalah	String	T/A	Tidak	Prioritas masalah yang dipisahkan dengan koma.
Komponen Masalah	String	T/A	Tidak	Komponen masalah yang dipisahkan dengan koma.
Alamat Server Proxy	String	T/A	Tidak	Alamat server proxy yang akan digunakan.
Nama Pengguna Proxy	String	T/A	Tidak	Nama pengguna proxy untuk melakukan autentikasi.
Sandi Proxy	Sandi	T/A	Tidak	Sandi proxy untuk mengautentikasi.
Nama Kolom Lingkungan	String	""	Tidak	Mendeskripsikan nama kolom tempat nama lingkungan disimpan. Jika kolom lingkungan tidak ditemukan, lingkungan yang digunakan adalah lingkungan default.
Pola Regex Lingkungan	String	.*	Tidak	Pola regex untuk dijalankan pada nilai yang ditemukan di kolom "Nama Kolom Lingkungan". Defaultnya adalah .* untuk mencakup semua dan menampilkan nilai tanpa perubahan. Digunakan untuk mengizinkan pengguna memanipulasi kolom lingkungan melalui logika regex. Jika pola regex adalah null atau kosong, atau nilai lingkungan adalah null, hasil lingkungan akhir adalah lingkungan default.

Aturan Konektor

Dukungan Proxy

Konektor mendukung proxy.

Daftar dinamis dan daftar blokir

Konektor hanya mendukung aturan daftar dinamis dan daftar blokir untuk label tertentu di dalam Jira.

Pekerjaan

Tugas Penutupan Sinkronisasi

Deskripsi

Menutup tiket di Jira jika pemberitahuan Google SecOps yang sesuai telah ditutup.

Parameter

Nama Tampilan Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Root API	String	https://{jira_address}	Ya	URL root API instance Jira.
Nama pengguna	String	T/A	Ya	Nama pengguna untuk terhubung ke instance Jira.
Token API	Sandi	T/A	Ya	Token yang dibuat di konsol Jira. Catatan: Parameter ini dapat digunakan untuk memuat string "Password" jika ada autentikasi On-prem, menggunakan kombinasi nama pengguna dan sandi
Nama Project	String	nama project yang dipisahkan dengan koma	Ya	Nama project Jira yang dipisahkan dengan koma yang harus dipantau oleh tugas.
Maksimum Hari Mundur	Bilangan bulat	1	Ya	Jumlah maksimum hari untuk menyinkronkan status tiket ke belakang.

Tugas Sinkronisasi Komentar

Deskripsi

Menyinkronkan komentar antara kasus SecOps Google dan tiket Jira yang sesuai. Sinkronisasi bersifat dua arah—yaitu, dari Google SecOps ke Jira dan dari Jira ke Google SecOps.

Pekerjaan ini hanya mendukung kasus SecOps Google dengan tag Jira.

Saat membuat komentar, tugas akan menerapkan awalan. Jika pengguna Google SecOps berkomentar dalam kasus Google SecOps, tugas akan membuat dan menyelaraskan komentar pengguna dalam tiket Jira yang sesuai menggunakan parameter Awalan Komentar Chronicle.

Fitur ini ditambahkan untuk dua tujuan:

Visibilitas.
Mencegah komentar yang ditambahkan oleh tugas disinkronkan lagi ke sisi lain, dan menyebabkan loop.

Parameter

Nama Tampilan Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Root API	String	https://{jira_address}	Ya	URL root API instance Jira.
Nama pengguna	String	T/A	Ya	Nama pengguna untuk terhubung ke instance Jira.
Token API	Sandi	T/A	Ya	Token yang dibuat di konsol Jira. Catatan: Parameter ini dapat digunakan untuk memuat string "Password" jika ada autentikasi On-prem, menggunakan kombinasi nama pengguna dan sandi
Nama Project	String	nama project yang dipisahkan dengan koma	Ya	Nama project Jira yang dipisahkan dengan koma yang harus dipantau oleh tugas.
Maksimum Hari Mundur	Bilangan bulat	1	Ya	Jumlah maksimum hari untuk menyinkronkan status tiket ke belakang.
Awalan Komentar Google SecOps	String	Google SecOps:	Ya	Awalan yang ditambahkan oleh tugas sinkronisasi ke komentar yang dibuat untuk tiket Jira.
Awalan Komentar Jira	String	Tugas Sinkronisasi Komentar Jira:	Ya	Awalan yang ditambahkan oleh tugas sinkronisasi ke komentar kasus pemberitahuan Google SecOps.

Perlu bantuan lain? Dapatkan jawaban dari anggota Komunitas dan profesional Google SecOps.