Mengintegrasikan Jira dengan Google SecOps

Versi integrasi: 50.0

Dokumen ini menjelaskan cara mengintegrasikan Jira dengan Google Security Operations.

Kasus penggunaan

Integrasi Jira menggunakan kemampuan Google SecOps untuk mendukung kasus penggunaan berikut:

  • Pembuatan tiket otomatis: Buat masalah Jira secara otomatis dari pemberitahuan Google SecOps menggunakan Konektor Jira untuk menyederhanakan penyerahan tugas antara tim keamanan dan IT.

  • Sinkronisasi dua arah: Jaga konsistensi di seluruh platform dengan menyinkronkan perubahan status dan komentar secara otomatis antara tiket Jira dan kasus Google SecOps menggunakan tugas sinkronisasi khusus.

  • Pengayaan insiden: Lampirkan bukti, log, dan screenshot langsung ke masalah Jira menggunakan tindakan Upload Lampiran untuk memberikan konteks lengkap kepada petugas perbaikan.

  • Pengelolaan tugas dinamis: Perbarui, tetapkan, atau tautkan masalah Jira terkait langsung dari playbook Google SecOps untuk mengotomatiskan prosedur operasi standar (SOP).

Sebelum memulai

Sebelum mengonfigurasi integrasi Jira di platform Google SecOps, pastikan Anda memiliki hal berikut:

  • Kompatibilitas produk: Akses ke instance Jira Cloud atau lingkungan Jira Data Center (Lokal).

  • URL root API: URL dasar instance Jira Anda (misalnya, https://yourdomain.atlassian.net).

  • Kredensial autentikasi:

    • Jira Cloud: Nama pengguna dan Token API Atlassian yang valid.

    • Jira Data Center (Lokal): Kombinasi nama pengguna dan sandi standar yang valid.

  • Akses jaringan: Pastikan platform Google SecOps (atau agen jarak jauh) dapat mencapai endpoint Jira API.

Menyiapkan autentikasi untuk Jira Cloud

Untuk terhubung ke Jira Cloud, Anda harus membuat token API dari akun Atlassian Anda:

  1. Login ke akun Atlassian Anda.

  2. Klik Create API Token.

  3. Di kolom Label, masukkan nama singkat untuk token (seperti "Integrasi SecOps Google") lalu klik Buat.

  4. Klik Salin ke papan klip, lalu tempelkan token di tempat yang aman untuk disimpan.

Parameter integrasi

Integrasi Jira memerlukan parameter berikut:

Parameter Deskripsi
Api Root

Wajib.

URL dasar instance Jira.

Nilai defaultnya adalah https://JIRA_ADDRESS.
Username

Wajib.

Nama pengguna yang digunakan untuk terhubung ke Jira.

Persyaratan untuk kolom ini berbeda di berbagai produk Jira:

  • Untuk Jira Cloud, Anda harus memasukkan alamat email yang terkait dengan akun Anda.
  • Untuk Jira Data Center, masukkan nama pengguna standar Anda.
Api Token

Wajib.

Kredensial autentikasi yang digunakan untuk terhubung ke Jira.

Persyaratan autentikasi berbeda di seluruh produk Jira. Lihat bagian Sebelum memulai untuk mengetahui petunjuk khusus tentang cara mengautentikasi dengan Jira Cloud atau Jira Data Center.
Verify SSL

Opsional.

Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke server Jira.

Dinonaktifkan secara default.

Untuk mengetahui petunjuk tentang cara mengonfigurasi integrasi di Google SecOps, lihat Mengonfigurasi integrasi.

Anda dapat melakukan perubahan di tahap selanjutnya, jika diperlukan. Setelah mengonfigurasi instance integrasi, Anda dapat menggunakannya dalam playbook. Untuk mengetahui informasi selengkapnya tentang cara mengonfigurasi dan mendukung beberapa instance, lihat Mendukung beberapa instance.

Tindakan

Untuk mengetahui informasi selengkapnya tentang tindakan, lihat Merespons tindakan tertunda dari Ruang Kerja Anda dan Melakukan tindakan manual.

Tambahkan Komentar

Gunakan tindakan Tambahkan Komentar untuk menulis dan menambahkan komentar ke masalah Jira yang ada.

Cara ini efektif untuk mendokumentasikan temuan, memberikan info terbaru, dan berkolaborasi dengan anggota tim langsung dari Google SecOps.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Tambahkan Komentar memerlukan parameter berikut:

Parameter Deskripsi
Issue Key

Wajib.

ID unik masalah Jira (misalnya, PROJ-123).
Comment

Wajib.

Teks yang akan ditambahkan ke masalah Jira.

Output tindakan

Tindakan Tambahkan Komentar memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Tambahkan Komentar:

Nama hasil skrip Nilai
comment_id ID unik komentar yang baru dibuat di Jira.

Menetapkan Masalah

Gunakan tindakan Tetapkan Masalah untuk menetapkan masalah Jira kepada pengguna tertentu.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Tetapkan Masalah memerlukan parameter berikut:

Parameter Deskripsi
Issue Key

Wajib.

ID unik masalah Jira (misalnya, PROJ-123).
Assignee

Wajib.

Nama atau alamat email pengguna yang akan diberi tugas untuk menangani masalah.
Jira Username

Opsional.

Nama pengguna Jira orang yang memulai tindakan penetapan.

Output tindakan

Tindakan Tetapkan Masalah memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Tetapkan Masalah:

Nama hasil skrip Nilai
success true atau false

Buat Masalah Pemberitahuan

Gunakan tindakan Create Alert Issue untuk membuat tiket baru di Jira untuk pemberitahuan tertentu.

Tindakan ini terutama digunakan dalam playbook untuk meningkatkan insiden keamanan ke tim IT atau engineering untuk penyelidikan atau perbaikan lebih lanjut.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Create Alert Issue memerlukan parameter berikut:

Parameter Deskripsi
Project Key

Wajib.

Kunci singkat unik dari project Jira tempat masalah dibuat (seperti SEC).
Summary

Wajib.

Judul atau ringkasan singkat masalah.
Issue Type

Wajib.

Nama jenis masalah (seperti Task, Bug, atau Incident).

Output tindakan

Tindakan Create Alert Issue memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat tindakan berhasil membuat masalah:

{
   "summary": "Sample issue",
   "description": "Create Enrich entities action using Insights API (IOC search). Write connector for alerts.",
   "project": {
      "key": "PR",
      "name": "Project 1",
      "projectTypeKey": "software"
   },
   "issuetype": {
     "name": "Task",
     "subtask": false
   },
   "status": {
      "name": "DONE",
      "statusCategory": {
         "name": "Done",
         "key": "done"
      }
   },
   "priority": {
      "name": "Medium",
      "id": "3"
   },
   "creator": {
      "displayName": "user1",
      "emailAddress": "john_doe@example.com"
   },
   "assignee": {
      "displayName": "user2",
      "emailAddress": "john_doe@example.com"
   },
   "created": "2018-06-19T15:23:13.701+0300",
   "updated": "2018-09-18T10:02:06.347+0300"
}
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Buat Masalah Pemberitahuan:

Nama hasil skrip Nilai
issue_key Kunci singkat unik dari masalah Jira yang baru dibuat (misalnya, SEC-456).

Buat Masalah

Gunakan tindakan Create Issue untuk membuat tiket baru dalam project Jira.

Tindakan ini memberikan opsi penyesuaian yang luas, termasuk kemampuan untuk menentukan komponen, label, dan kolom kustom menggunakan JSON, sehingga cocok untuk alur kerja pembuatan tiket yang kompleks.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Buat Masalah memerlukan parameter berikut:

Parameter Deskripsi
Project Key

Wajib.

Kunci singkat unik dari project Jira tempat masalah dibuat (seperti SEC).
Summary

Wajib.

Judul atau ringkasan singkat masalah.
Description

Opsional.

Deskripsi mendetail tentang masalahnya.
Issue Type

Wajib.

Nama jenis masalah (seperti Task, Bug, atau Incident).
Jira Username

Opsional.

Nama pengguna Jira orang yang memulai tindakan.
Assignee

Opsional.

ID pengguna yang diberi tugas untuk menangani masalah.
Components

Opsional.

Daftar komponen Jira yang dipisahkan koma untuk dikaitkan dengan masalah.
Labels

Opsional.

Daftar label yang dipisahkan koma untuk ditambahkan ke masalah.
Custom Fields

Opsional.

Objek JSON yang berisi kolom dan nilai tambahan untuk ditetapkan selama pembuatan (misalnya, {"customfield_10001": "Value"}).

Nilai yang diberikan dalam parameter ini diprioritaskan dan menimpa pemetaan kolom lainnya jika terjadi konflik.

Output tindakan

Tindakan Create Issue memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Buat Masalah:

{
   "summary": "Sample issue",
   "description": "Create Enrich entities action using Insights API (IOC search). Write connector for alerts. In a couple of days we will have access to an instance.",
   "project": {
      "key": "PR",
      "name": "Project 1",
      "projectTypeKey": "software"
   },
   "issuetype": {
      "name": "Task",
      "description": "A task that needs to be done.",
      "subtask": false
   },
   "status": {
      "name": "DONE",
      "statusCategory": {
         "name": "Done",
         "key": "done",
         "colorName": "green"
      }
   },
   "priority": {
      "name": "Medium",
      "id": "3"
   },
   "resolution": {
      "name": "Done",
      "description": "Work has been completed on this issue."
   },
   "creator": {
      "displayName": "user1",
      "emailAddress": "john_doe@example.com",
      "active": true,
      "timeZone": "Asia/Jerusalem"
   },
   "assignee": {
      "displayName": "user2",
      "emailAddress": "john_doe@example.com",
      "active": true
   },
   "reporter": {
      "displayName": "user1",
      "emailAddress": "john_doe@example.com"
   },
   "labels": [
      "Label1"
   ],
   "attachment": [
      {
         "id": "1001",
         "filename": "file.rar",
         "mimeType": "binary/octet-stream",
         "size": 15420,
         "created": "2018-06-19T15:23:07.369+0300"
      }
   ],
   "created": "2018-06-19T15:23:13.701+0300",
   "updated": "2018-09-18T10:02:06.347+0300",
   "resolutiondate": "2018-09-18T10:02:06.340+0300",
   "watches": {
      "watchCount": 1,
      "isWatching": false
   }
}
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Buat Masalah:

Nama hasil skrip Nilai
issue_key Kunci singkat unik dari masalah Jira yang baru dibuat (misalnya, SEC-789).

Menghapus Masalah

Gunakan tindakan Hapus Masalah untuk menghapus masalah secara permanen dari Jira.

Tindakan ini biasanya digunakan untuk membersihkan tiket duplikat atau menghapus data pengujian yang dihasilkan selama pengembangan playbook.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Hapus Masalah memerlukan parameter berikut:

Parameter Deskripsi
Issue Key

Wajib.

Kunci singkat unik dari masalah Jira yang akan dihapus (misalnya, SEC-123).

Output tindakan

Tindakan Hapus Masalah memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Hapus Masalah:

Nama hasil skrip Nilai
success true atau false

Download Lampiran

Gunakan tindakan Download Lampiran untuk mengambil semua file yang dilampirkan ke masalah Jira tertentu. Jika lampiran adalah file .eml, tindakan ini juga akan mendownload file apa pun yang ada dalam email tersebut.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Download Lampiran memerlukan parameter berikut:

Parameter Deskripsi
Issue Key

Wajib.

Kunci singkat unik masalah Jira (misalnya, SEC-123).
Download Path

Opsional.

Jalur lokal atau internal ke folder tempat tindakan menyimpan lampiran yang didownload.

Format yang diperlukan bergantung pada jenis deployment Anda:

  • Deployment SaaS: Jalurnya bersifat internal untuk platform yang dihosting, seperti /attachments/.
  • Deployment Agen Jarak Jauh: Jalur harus berupa jalur direktori absolut yang valid di komputer lokal tempat agen jarak jauh diinstal. Misalnya, C:\temp\attachments untuk Windows atau /var/tmp/attachments/ untuk Linux.
Download Attachments to the Case Wall

Opsional.

Jika dipilih, tindakan ini akan mendownload lampiran masalah Jira langsung ke dinding kasus Google SecOps saat ini.

Ada batasan ukuran untuk lampiran yang ditambahkan ke repositori kasus. File berukuran besar mungkin gagal diupload.

Dinonaktifkan secara default.

Output tindakan

Tindakan Download Lampiran memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Download Lampiran:

[
  {
    "download_path": "downloads/Security_Evidence.eml",
    "attachment_details": {
      "id": "10007",
      "filename": "Security_Evidence.eml",
      "author": {
        "displayName": "Security Analyst",
        "emailAddress": "analyst@example.com",
        "active": true,
        "timeZone": "Asia/Calcutta"
      },
      "created": "2024-05-25T20:27:09.066+0530",
      "size": 12049140,
      "mimeType": "message/rfc822"
    }
  },
  {
    "download_path": "downloads/Logs_Attachment.txt",
    "attachment_details": {
      "id": "10005",
      "filename": "Logs_Attachment.txt",
      "author": {
        "displayName": "System Admin",
        "emailAddress": "admin@example.com",
        "active": true,
        "timeZone": "Asia/Calcutta"
      },
      "created": "2024-05-16T11:48:24.141+0530",
      "size": 43,
      "mimeType": "text/plain"
    }
  }
]
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Download Lampiran:

Nama hasil skrip Nilai
is_success true atau false

Mendapatkan Masalah

Gunakan tindakan Get Issues untuk mengambil detail lengkap satu atau beberapa masalah Jira.

Tindakan ini berguna untuk memperkaya kasus Google SecOps dengan metadata tiket saat ini (seperti status, penerima tugas, dan prioritas).

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Get Issues memerlukan parameter berikut:

Parameter Deskripsi
Issue Keys

Wajib.

Daftar kunci masalah Jira yang dipisahkan koma untuk diambil (misalnya, SEC-123, SEC-456).

Output tindakan

Tindakan Get Issues memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Get Issues:

{
  "issues_details_list": [
    {
      "key": "TES-65",
      "summary": "New summary",
      "description": "Detailed description of the security incident.",
      "project": {
        "key": "TES",
        "name": "test-project1",
        "projectTypeKey": "software"
      },
      "issuetype": {
        "name": "Bogue",
        "subtask": false
      },
      "status": {
        "name": "Fini",
        "statusCategory": {
          "name": "Terminé",
          "key": "done"
        }
      },
      "priority": {
        "name": "Medium",
        "id": "3"
      },
      "assignee": {
        "displayName": "Vasil Daskalov",
        "emailAddress": "vasil.daskalov@siemplify.co"
      },
      "creator": {
        "displayName": "admin@siemplifylab.local",
        "emailAddress": "admin@siemplifylab.local"
      },
      "created": "2021-08-31T12:15:22.089+0000",
      "updated": "2021-11-11T13:16:50.552+0000",
      "resolution": {
        "name": "Terminé",
        "description": "Ce ticket a été traité."
      },
      "labels": [],
      "components": []
    }
  ]
}
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Get Issues:

Nama hasil skrip Nilai
issues_details_list Daftar yang berisi metadata lengkap untuk masalah Jira yang diminta.

Gunakan tindakan Tautkan Masalah untuk membuat hubungan antara beberapa masalah Jira.

Tindakan ini terutama digunakan dalam playbook untuk menghubungkan insiden keamanan terkait atau untuk melacak dependensi antar-tiket investigasi.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Tautkan Masalah memerlukan parameter berikut:

Parameter Deskripsi
Inward Issue ID

Wajib.

Daftar ID masalah masuk yang dipisahkan koma.

Misalnya, jika Relation Type disetel ke Blocks, masalah ini akan menampilkan hubungan is blocked by di UI Jira.
Outward Issue IDs

Wajib.

Kunci singkat masalah Jira keluar.

Misalnya, jika Relation Type disetel ke Blocks, masalah ini akan menampilkan hubungan blocks di UI Jira.
Relation Type

Wajib.

Jenis link yang akan dibuat antara masalah.

Anda dapat menemukan daftar jenis hubungan yang tersedia dengan menjalankan tindakan List Relation Types.

Nilai defaultnya adalah Blocks.

Output tindakan

Tindakan Tautkan Masalah memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Pesan output

Tindakan Tautkan Masalah dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

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

Action tidak dapat menemukan masalah tujuan berikut di Jira: ISSUE_IDS.

 Tindakan berhasil
Error executing action "Link Issues". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Masalah Link:

Nama hasil skrip Nilai
success true atau false

Masalah Daftar

Gunakan tindakan List Issues untuk menelusuri dan mengambil daftar kunci masalah Jira berdasarkan kriteria pemfilteran tertentu.

Tindakan ini berguna untuk mengidentifikasi tiket yang ada yang cocok dengan konteks pemberitahuan untuk menghindari duplikasi atau melakukan pembaruan massal dalam playbook.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan List Issues menyediakan parameter pemfilteran opsional berikut. Jika tidak ada parameter yang diberikan, tindakan akan menampilkan semua masalah yang dapat diakses oleh pengguna integrasi.

Parameter Deskripsi
Project Names

Opsional.

Daftar nama project yang dipisahkan koma untuk ditelusuri.
Summary

Opsional.

Jika disediakan, tindakan akan memfilter masalah berdasarkan ringkasan atau judul tertentu.
Description

Opsional.

Jika diberikan, tindakan akan memfilter masalah berdasarkan teks yang ada dalam deskripsi.
Issue Types

Opsional.

Daftar jenis masalah yang dipisahkan koma (misalnya, Bug,Task).

Nilai defaultnya adalah Bug.
Priorities

Opsional.

Daftar tingkat prioritas yang dipisahkan koma untuk memfilter menurutnya (misalnya, High,Medium).
Created From

Opsional.

Jika diberikan, tindakan akan memfilter masalah yang dibuat pada atau setelah tanggal ini (dalam format YYYY/MM/DD).
Updated From

Opsional.

Jika diberikan, tindakan akan memfilter masalah yang diperbarui pada atau setelah tanggal ini (dalam format YYYY/MM/DD).
Assignees

Opsional.

Daftar ID penerima tugas yang dipisahkan koma untuk memfilter.
Reporter

Opsional.

Daftar ID pelapor yang dipisahkan koma untuk memfilter.
Statuses

Opsional.

Daftar status masalah yang dipisahkan koma untuk difilter menurut (misalnya, Open,In Progress).

Output tindakan

Tindakan List Issues memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan List Issues:

[ 
  "PR-123", 
  "PR-124",
  "SEC-789"
]
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Buat Daftar Masalah:

Nama hasil skrip Nilai
issues Daftar yang berisi kunci singkat unik dari masalah Jira yang ditemukan.

Mencantumkan Jenis Hubungan

Gunakan tindakan List Relation Types untuk mengambil daftar semua jenis hubungan link yang tersedia yang dikonfigurasi di instance Jira Anda.

Tindakan ini berguna untuk memvalidasi nilai input yang valid untuk tindakan Tautkan Masalah.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan List Relation Types memerlukan parameter berikut:

Parameter Deskripsi
Filter Key

Opsional.

Kolom yang digunakan untuk memfilter jenis relasi.

Jika Logika Filter disetel ke Equal atau Contains, Anda harus memilih kolom selain Select One untuk menghindari error eksekusi.

Kemungkinan nilainya adalah sebagai berikut:

  • Name
  • Inward
  • Outward

Nilai defaultnya adalah Select One.
Filter Logic

Opsional.

Operator logika yang diterapkan ke filter.

Kemungkinan nilainya adalah sebagai berikut:

  • Not Specified
  • Equal
  • Contains

Nilai defaultnya adalah Not Specified.
Filter Value

Opsional.

Nilai string spesifik yang digunakan untuk memfilter berdasarkan Filter Key dan Filter Logic yang dipilih.

Jika tidak ada nilai yang diberikan, filter tidak diterapkan meskipun kunci dan logika dipilih.
Max Records To Return

Opsional.

Jumlah maksimum record yang akan ditampilkan dalam hasil.

Nilai defaultnya adalah 50.

Output tindakan

Tindakan List Relation Types memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Tabel repositori kasus

Tindakan List Relation Types memberikan tabel berikut:

Nama tabel: Available Relation

Kolom tabel:

  • Nama
  • Ke dalam
  • Keluar
Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan List Relation Types:

[{
    "id": "10000",
    "name": "Blocks",
    "inward": "is blocked by",
    "outward": "blocks"
}]
Pesan output

Tindakan List Relation Types dapat menampilkan pesan output berikut:

Pesan output Deskripsi pesan

Successfully found relation types for the provided criteria in Jira.

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

 Tindakan berhasil.
Error executing action "List Relation types". Reason: ERROR_REASON

Tindakan gagal.

Periksa koneksi ke server, parameter input, atau kredensial.
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan List Relation Types:

Nama hasil skrip Nilai
is_success true atau false

Ping

Gunakan tindakan Ping untuk menguji konektivitas ke Jira.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tidak ada.

Output tindakan

Tindakan Ping memberikan output berikut:

Jenis output tindakan Ketersediaan
Lampiran repositori kasus Tidak tersedia
Link repositori kasus Tidak tersedia
Tabel repositori kasus Tidak tersedia
Tabel pengayaan Tidak tersedia
Hasil JSON Tidak tersedia
Pesan output Tersedia
Hasil skrip Tersedia
Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Ping:

Nama hasil skrip Nilai
success true atau false

Masalah Update

Deskripsi

Memperbarui 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 pemrakarsa 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.

Terus Berjalan

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 absolut file yang akan diupload, dipisahkan dengan koma.

Format yang diperlukan bergantung pada jenis deployment Anda:

  • Deployment SaaS: Jalurnya bersifat internal untuk platform yang dihosting, seperti /attachments/.
  • Deployment Agen Jarak Jauh: Jalur harus berupa jalur direktori absolut yang valid di komputer lokal tempat agen jarak jauh diinstal. Misalnya, C:\temp\attachments untuk Windows atau /var/tmp/attachments/ untuk Linux.

Terus Berjalan

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

Telusuri Pengguna

Telusuri pengguna di Jira.

Entity

Tindakan ini tidak dijalankan pada 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

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 "Sandi" jika ada autentikasi On-prem, menggunakan kombinasi nama pengguna dan sandi
Mundur Beberapa Hari Bilangan bulat 5 Tidak Jumlah maksimum hari sebelumnya 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 melakukan autentikasi.
Nama Kolom Lingkungan String "" Tidak

Menjelaskan 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 "Sandi" 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 Google SecOps dan tiket Jira yang sesuai. Sinkronisasi bersifat dua arah—yaitu, dari Google SecOps ke Jira dan dari Jira ke Google SecOps.

Saat membuat komentar, tugas akan menerapkan awalan. Jika pengguna Google SecOps memberikan komentar 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:

  1. Visibilitas.
  2. 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 "Sandi" 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.