Mengintegrasikan Jira dengan Google SecOps

Dokumen ini menjelaskan cara mengintegrasikan Jira dengan Google Security Operations.

Catatan: Integrasi ini menggunakan satu atau beberapa komponen open source. Anda dapat mendownload salinan kode sumber lengkap integrasi ini dari bucket penyimpanan.

Kasus penggunaan

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

• Tiket otomatis: Buat masalah Jira secara otomatis dari pemberitahuan Google SecOps menggunakan Jira Connector untuk menyederhanakan penyerahan antara tim keamanan dan IT.

• Sinkronisasi dua arah: Pertahankan konsistensi di seluruh platform dengan menyinkronkan komentar dan perubahan status 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 Attachment untuk memberikan konteks lengkap kepada pihak yang melakukan remediasi.

• 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).

• Metode autentikasi: Pilih metode autentikasi.

  • Autentikasi dasar (Jira Cloud): Memerlukan nama pengguna (email) dan Token API Atlassian.
  • Autentikasi akun layanan (Jira Cloud): Memerlukan Token Akun Layanan dan Cloud ID Anda.
  • Autentikasi standar (Jira Data Center): Memerlukan nama pengguna dan sandi yang valid.

• URL root API: Format root API bergantung pada metode autentikasi Anda.

  • Standard/Basic: URL dasar instance Jira Anda (misalnya, https://yourdomain.atlassian.net).
  • Service account: URL proxy API Atlassian, yang harus menyertakan Cloud ID Anda (misalnya, https://api.atlassian.com/ex/jira/{cloud_id}).

Menyiapkan autentikasi untuk Jira Cloud

Untuk terhubung ke Jira Cloud menggunakan token API, ikuti petunjuk dalam dokumentasi Atlassian untuk membuat token.

Menyiapkan autentikasi untuk akun layanan

Untuk menggunakan autentikasi berbasis token (Token Pemilik) untuk Jira Cloud:

1. Lihat Memahami akun layanan untuk mengetahui detail selengkapnya tentang cara membuat akun layanan menggunakan Atlassian Admin console.

2. Ambil Cloud ID Anda dengan membuka: https://<your_tenant>.atlassian.net/_edge/tenant_info (dengan <your_tenant> adalah nama instance Atlassian spesifik Anda).

3. Saat mengonfigurasi integrasi, kosongkan kolom Username untuk memicu autentikasi Token Bearer.

Parameter integrasi

Integrasi Jira memerlukan parameter berikut:

Parameter	Deskripsi
Api Root	Wajib. URL dasar instance Jira. Catatan: Jika melakukan autentikasi menggunakan token akun layanan, URL harus mengikuti format ini: https://api.atlassian.com/ex/jira/{cloud_id}.
Username	Opsional. Nama pengguna (email) yang digunakan untuk terhubung ke Jira. Persyaratan untuk parameter ini bergantung pada metode autentikasi yang dipilih: Jika diberikan, sistem akan menggunakan autentikasi Dasar. Jika dibiarkan kosong, sistem akan menggunakan autentikasi Token Bearer secara default (diperlukan untuk akun layanan). Untuk mengetahui informasi selengkapnya tentang metode autentikasi, lihat Sebelum memulai.
Api Token	Wajib. Kredensial autentikasi yang digunakan untuk terhubung ke Jira. Kolom ini menerima token API, token akun layanan, atau sandi standar (untuk Pusat Data).
Verify SSL	Opsional. Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke server Jira.

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

Anda dapat melakukan perubahan pada 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 yang tertunda dari meja kerja Anda dan Menjalankan tindakan manual dalam kasus Anda.

Tambahkan Komentar

Gunakan tindakan Add Comment untuk menulis dan menambahkan komentar ke masalah Jira yang ada.

Ini adalah cara yang 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 Add Comment 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 Add Comment 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 Add Comment:

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

Tetapkan Masalah

Gunakan tindakan Assign Issue untuk menetapkan masalah Jira kepada pengguna tertentu.

Catatan: Persyaratan identifikasi berbeda di berbagai produk Jira:

• Jira Cloud: Mencocokkan penerima tugas berdasarkan alamat email terlebih dahulu, lalu berdasarkan nama tampilan.
• Jira Data Center: Mencocokkan penerima tugas berdasarkan nama pengguna Jira.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Assign Issue memerlukan parameter berikut:

Parameter	Deskripsi
Issue Key	Wajib. ID unik masalah Jira (misalnya, PROJ-123).
Assignee	Wajib. Nama atau alamat email pengguna yang akan ditugaskan untuk menangani masalah.
Jira Username	Opsional. Nama pengguna Jira dari orang yang memulai tindakan penetapan.

Output tindakan

Tindakan Assign 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	Tidak tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Hasil skrip

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

Nama hasil skrip	Nilai
success	true atau false

Membuat Masalah Pemberitahuan

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

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

Catatan: Jira API tidak mendukung pembuatan masalah dalam project "generasi berikutnya" (dikelola tim). Pastikan Anda menargetkan project "klasik" (dikelola perusahaan) standar.

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": "[e-mail]"
   },
   "assignee": {
      "displayName": "user2",
      "emailAddress": "[e-mail]"
   },
   "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 Create Alert Issue:

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 di 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 Create Issue memerlukan parameter berikut:

Catatan: Persyaratan identifikasi untuk Assignee dan Jira Username berbeda di berbagai produk Jira.

Lihat Sebelum memulai untuk mengetahui petunjuk spesifik tentang format ID yang diperlukan untuk lingkungan Anda.

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 masalah yang Anda alami.
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 ditugaskan untuk menangani masalah.
Components	Opsional. Comma separated list berisi komponen Jira yang akan 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 yang akan ditetapkan selama pembuatan (misalnya, {"customfield_10001": "Value"}). Nilai yang diberikan dalam parameter ini lebih diprioritaskan dan menimpa pemetaan kolom lain 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 Create Issue:

{
   "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": "[e-mail]",
      "active": true,
      "timeZone": "Asia/Jerusalem"
   },
   "assignee": {
      "displayName": "user2",
      "emailAddress": "[e-mail]",
      "active": true
   },
   "reporter": {
      "displayName": "user1",
      "emailAddress": "[e-mail]"
   },
   "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 Create Issue:

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

Hapus Masalah

Gunakan tindakan Delete Issue 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 Delete Issue memerlukan parameter berikut:

Parameter	Deskripsi
Issue Key	Wajib. Kunci singkat unik dari masalah Jira yang akan dihapus (misalnya, SEC-123).

Output tindakan

Tindakan Delete 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	Tidak tersedia
Pesan output	Tersedia
Hasil skrip	Tersedia

Hasil skrip

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

Nama hasil skrip	Nilai
success	true atau false

Download Lampiran

Gunakan tindakan Download Attachments 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 Attachments memerlukan parameter berikut:

Parameter	Deskripsi
Issue Key	Wajib. Kunci singkat unik dari 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 ke platform yang dihosting, seperti /attachments/. Deployment Agen Jarak Jauh: Jalur harus berupa jalur direktori yang absolut dan 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 repositori 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 Attachments 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 Attachments:

[
  {
    "download_path": "downloads/Security_Evidence.eml",
    "attachment_details": {
      "id": "10007",
      "filename": "Security_Evidence.eml",
      "author": {
        "displayName": "Security Analyst",
        "emailAddress": "[e-mail]",
        "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": "[e-mail]",
        "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 Attachments:

Nama hasil skrip	Nilai
is_success	true atau false

Mendapatkan Masalah

Gunakan tindakan Get Issues untuk mengambil detail lengkap untuk 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 Dapatkan Masalah 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": "[e-mail]"
      },
      "creator": {
        "displayName": "[e-mail]",
        "emailAddress": "[e-mail]"
      },
      "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.

Masalah Link

Gunakan tindakan Link Issues untuk membuat hubungan antara beberapa masalah Jira.

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

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Link Issues memerlukan parameter berikut:

Parameter	Deskripsi
Inward Issue ID	Wajib. Daftar ID masalah inward yang dipisahkan koma. Misalnya, jika Relation Type ditetapkan 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 ditetapkan ke Blocks, masalah ini akan menampilkan hubungan blocks di UI Jira.
Relation Type	Wajib. Jenis penautan yang akan dibuat di antara masalah. Anda dapat menemukan daftar jenis relasi yang tersedia dengan menjalankan tindakan List Relation Types. Nilai defaultnya adalah Blocks.

Output tindakan

Tindakan Link 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

Pesan output

Tindakan Link Issues dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully linked issue ISSUE_ID with the following issues in Jira: ISSUE_IDS. Tindakan 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 Link Issues:

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 update 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 terdapat 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 difilter (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 difilter.
Reporter	Opsional. Daftar ID pelapor yang dipisahkan koma untuk difilter.
Statuses	Opsional. Daftar status masalah yang dipisahkan koma untuk difilter (misalnya, Open,In Progress).
Created Before	Opsional. Tanggal pembuatan terbaru untuk memfilter. Format: YYYY/MM/DD atau offset relatif (misalnya, -24h, -7d). Jika tidak diberikan, filter tidak akan digunakan.
Custom JQL	Opsional. Kueri JQL kustom. Jika diberikan, semua filter lainnya akan diabaikan.

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 List Issues:

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

Membuat Daftar Jenis Relasi

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 Link Issues.

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 ditetapkan 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 pemfilteran berdasarkan Filter Key dan Filter Logic yang dipilih. Jika tidak ada nilai yang diberikan, filter tidak akan diterapkan meskipun kunci dan logika dipilih.
Max Records To Return	Opsional. Jumlah data maksimum 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 menyediakan tabel berikut:

Nama tabel: Available Relation

Kolom tabel:

• Nama
• Inward
• 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

Perbarui Masalah

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.
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 tersebut.
Nama Pengguna Jira	String	T/A	Tidak	Nama pengguna Jira dari pemrakarsa tindakan.
Komponen	String	T/A	Tidak	Kolom components pada 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 ditimpa dengan nilai yang diberikan untuk parameter ini. Contoh: {"field":"value"}
Label	String	T/A	Tidak	Kolom components pada masalah. Parameter ini menerima beberapa nilai sebagai string yang dipisahkan koma.

Dijalankan Pada

Tindakan ini berjalan di semua entity.

Hasil Tindakan

Hasil Skrip

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

Hasil JSON

{
   "comment":
     {
       "total": 0,
       "startAt": 0,
       "comments": [],
       "maxResults": 0
      },
   "creator":
     {
       "displayName": "user1",
       "name": "user1",
       "self": "",
       "avatarUrls":
          {
            "24x24": "",
            "16x16": "",
            "48x48": "",
            "32x32": ""
           },
        "emailAddress": "[e-mail]",
        "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": "[e-mail]",
        "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": "[e-mail]",
               "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": "[e-mail]",
           "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 ke platform yang dihosting, seperti /attachments/. Deployment Agen Jarak Jauh: Jalur harus berupa jalur direktori yang absolut dan valid di komputer lokal tempat agen jarak jauh diinstal. Misalnya, C:\temp\attachments untuk Windows atau /var/tmp/attachments/ untuk Linux.

Dijalankan Pada

Tindakan ini berjalan 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

Menelusuri pengguna di Jira.

Catatan: Untuk mendapatkan hasil yang lebih akurat, berikan parameter User Email Addresses.

Entity

Tindakan ini tidak berjalan 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 Comma separated list berisi nama pengguna yang akan ditampilkan.
Project	Opsional Nama project untuk menelusuri alamat email. Jika diberikan, 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.

Konfigurasi Pemetaan Alasan Penutupan

Parameter Closed Reason Mapping memerlukan struktur JSON. Anda dapat memetakan nilai statis atau meneruskan nama kolom Jira dinamis (misalnya, resolution, customfield_10010). Jika alasan dinamis yang diekstrak tidak valid atau tidak ada, tugas akan otomatis menggunakan pemetaan Fallback yang ditentukan.

Contoh konfigurasi JSON:

{
  "Done": {
    "reason": "Maintenance",
    "root_cause": "Other"
  },
  "Fallback": {
    "reason": "Maintenance",
    "root_cause": "Other"
  }
}

Konektor

Konektor Jira

Deskripsi

Mengambil masalah dari Jira ke Google SecOps.

Mengonfigurasi Konektor Jira di Google SecOps

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

Parameter konektor

Gunakan parameter berikut untuk mengonfigurasi konektor:

Parameter	Deskripsi
DeviceProductField	Wajib. Nama kolom yang digunakan untuk menentukan produk perangkat. Nilai defaultnya adalah device_product.
EventClassId	Opsional. Nama kolom yang digunakan untuk menentukan nama peristiwa (subjenis). Nilai defaultnya adalah name.
PythonProcessTimeout	Wajib. Batas waktu tunggu (dalam detik) untuk proses python yang menjalankan skrip saat ini. Nilai defaultnya adalah 60.
API Root	Wajib. Root API instance Jira. Catatan: Jika melakukan autentikasi menggunakan token akun layanan, URL harus mengikuti format ini: https://api.atlassian.com/ex/jira/{cloud_id}. Nilai defaultnya adalah https://{jira_address}.
Username	Opsional. Nama pengguna (email) yang digunakan untuk terhubung ke Jira. Persyaratan untuk parameter ini bergantung pada metode autentikasi yang dipilih: Jika diberikan, sistem akan menggunakan autentikasi Dasar. Jika dibiarkan kosong, sistem akan menggunakan autentikasi Token Bearer secara default (diperlukan untuk akun layanan). Untuk mengetahui informasi selengkapnya tentang metode autentikasi, lihat Sebelum memulai.
API Token	Wajib. Kredensial autentikasi yang digunakan untuk terhubung ke Jira. Catatan: Kolom ini menerima token API, token akun layanan, atau sandi standar (untuk Pusat Data).
Days Backwards	Opsional. Jumlah hari maksimum ke belakang untuk mengambil pemberitahuan. Nilai defaultnya adalah 5.
Max Tickets Per Cycle	Opsional. Jumlah maksimum tiket yang akan diambil dan diproses dalam satu siklus konektor. Nilai defaultnya adalah 10.
Project Names	Opsional. Nama project yang dipisahkan dengan koma.
Issue Statuses	Opsional. Status masalah dipisahkan dengan koma.
Assignees	Opsional. Nama lengkap pengguna yang dipisahkan dengan koma.
Issue Types	Opsional. Jenis masalah yang dipisahkan dengan koma.
Issue Priorities	Opsional. Prioritas masalah dipisahkan dengan koma.
Issue Components	Opsional. Komponen masalah dipisahkan dengan koma.
Proxy Server Address	Opsional. Alamat server proxy yang akan digunakan.
Proxy Username	Opsional. Nama pengguna proxy untuk melakukan autentikasi.
Proxy Password	Opsional. Sandi proxy untuk melakukan autentikasi.
Environment Field Name	Opsional. Menjelaskan nama kolom tempat nama lingkungan disimpan. Jika kolom environment tidak ditemukan, lingkungan tersebut adalah lingkungan default. Nilai defaultnya adalah "".
Environment Regex Pattern	Opsional. Pola ekspresi reguler yang akan dijalankan pada nilai yang ditemukan di kolom "Environment Field Name". Digunakan untuk memungkinkan pengguna memanipulasi kolom lingkungan menggunakan logika regex. Nilai defaultnya adalah .*.
Use Jira Project as Environment	Opsional. Gunakan project Jira sebagai lingkungan atau gunakan Nama Kolom Lingkungan sebagai lingkungan.
Verify SSL	Wajib. Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke server Jira. Diaktifkan secara default.

Aturan Konektor

Dukungan Proxy

Konektor mendukung proxy.

Daftar dinamis dan daftar yang tidak diizinkan

Konektor ini hanya mendukung aturan daftar dinamis dan daftar yang tidak diizinkan untuk label tertentu di dalam Jira.

Pekerjaan

Tugas Penutupan Sinkronisasi

Deskripsi

Tutup tiket di Jira jika pemberitahuan atau kasus Google SecOps yang sesuai telah ditutup, dan sinkronkan status penutupan dan kolom kustom dari Jira kembali ke Google SecOps.

Penting: Tetapkan kunci konteks JIRA_ISSUE_KEY di level kasus dan level pemberitahuan saat menguji atau menjalankan tugas pada kasus manual.

Parameter

Parameter	Deskripsi
API Root	Wajib. URL root API instance Jira. Catatan: Jika melakukan autentikasi menggunakan token akun layanan, URL harus mengikuti format ini: https://api.atlassian.com/ex/jira/{cloud_id}. Nilai defaultnya adalah https://{jira_address}.
Username	Opsional. Nama pengguna (email) yang digunakan untuk terhubung ke Jira. Persyaratan untuk parameter ini bergantung pada metode autentikasi yang dipilih: Jika diberikan, sistem akan menggunakan autentikasi Dasar. Jika dibiarkan kosong, sistem akan menggunakan autentikasi Token Bearer secara default (diperlukan untuk akun layanan).
API Token	Wajib. Kredensial autentikasi yang digunakan untuk terhubung ke Jira. Catatan: Kolom ini menerima token API, token akun layanan, atau sandi standar (untuk Pusat Data).
Project Names	Wajib. Nama project Jira yang dipisahkan dengan koma yang harus dipantau oleh tugas. Nilai defaultnya adalah project names separated by a comma.
Environment	Opsional. Nama lingkungan.
Days Backwards	Wajib. Jumlah hari maksimum untuk menyinkronkan status tiket ke belakang. Nilai defaultnya adalah 1.
Job Scope	Wajib. Cakupan untuk sinkronisasi tugas. Opsi: Case: Menyinkronkan masalah Jira di tingkat kasus. Pastikan konteks berisi JIRA_ISSUE_KEY. Alert: Menyinkronkan masalah Jira di tingkat pemberitahuan. Untuk kasus yang dibuat konektor, kunci tiket Jira akan diekstrak secara otomatis. Untuk kasus simulasi, tetapkan kunci konteks ke JIRA_ISSUE_KEY secara manual. Nilai defaultnya adalah Alert.
Supported Closed Statuses	Wajib. Daftar status ditutup Jira yang dipisahkan koma yang diperlakukan sebagai ditutup di Google SecOps (misalnya, Done, Closed). SecOps ke Jira: Tugas menggunakan nilai pertama dalam daftar (misalnya, Done) sebagai status penyelesaian saat menutup tiket Jira. Jira ke SecOps: Status penutupan tiket Jira harus ada dalam daftar ini agar sinkronisasi dapat dilakukan. Nilai defaultnya adalah Done.
Closed Reason Mapping	Wajib. Kamus JSON yang memetakan status ditutup Jira ke alasan penutupan dan penyebab utama Google SecOps. Mendukung pemetaan ke kolom kustom dan memerlukan kunci Fallback wajib. Untuk mengetahui detail dan contoh konfigurasi, lihat Pemetaan kolom kustom dan alasan ditutup.
Custom Fields Mapping	Opsional. Objek JSON yang menentukan pemetaan antara nama tampilan kolom kustom Google SecOps dan nama kolom kustom Jira untuk sinkronisasi data dari Jira ke Google SecOps. Untuk mengetahui detail dan contoh konfigurasi, lihat Pemetaan kolom kustom dan alasan ditutup.

Pemetaan alasan penutupan dan kolom kustom

Gunakan detail dan contoh berikut untuk mengonfigurasi pemetaan kustom untuk alasan penutupan dan kolom kustom.

Pemetaan Alasan Penutupan

Menentukan cara status penutupan Jira dipetakan ke alasan penutupan dan penyebab utama kasus atau pemberitahuan Google SecOps.

• Contoh Pemetaan JSON Standar:

  {
    "Done": {
      "reason": "Malicious",
      "root_cause": "Other"
    },
    "Fallback": {
      "reason": "Maintenance",
      "root_cause": "Other"
    }
  }
  

  Jika tiket Jira ditutup dengan status Done, kasus atau pemberitahuan Google SecOps akan ditutup dengan alasan Malicious dan penyebab utama Other. Jika tiket ditutup dengan status yang tidak dipetakan secara eksplisit (misalnya, Closed), sistem akan menggunakan setelan default sistem Fallback.

• Contoh Pemetaan Kolom Kustom:

  Jika Anda memiliki kolom kustom di Jira bernama Jira reason dan Jira rootcause, konfigurasikan pemetaan JSON sebagai berikut:

  {
    "Done": {
      "reason": "Jira reason",
      "root_cause": "Jira rootcause"
    },
    "Fallback": {
      "reason": "Maintenance",
      "root_cause": "Other"
    }
  }
  

  Persyaratan:

  • Nilai yang diekstrak dari kolom kustom Jira reason harus di-resolve ke salah satu string persis berikut: Malicious, Maintenance, Inconclusive, atau Not malicious. Jika tidak, sistem akan kembali ke nilai Fallback.
  • Untuk cakupan tugas Case, nilai penyebab utama harus dikonfigurasi di setelan admin. Untuk cakupan tugas Alert, konfigurasi admin tidak diperlukan, dan nilai apa pun yang diberikan di kolom khusus akan diterima.

Pemetaan Kolom Kustom

Pemetaan ini berfungsi secara eksklusif untuk menyinkronkan nilai kolom kustom dari Jira ke Google SecOps. Tentukan key-value pair dengan kuncinya adalah nama tampilan kolom kustom Google SecOps dan nilainya adalah nama kolom kustom Jira:

{
  "SOAR Custom field": "Jira ticket id"
}

Dalam contoh ini, nilai dari kolom Jira Jira ticket id disinkronkan langsung ke kolom Google SecOps SOAR Custom field.

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 tugas membuat komentar, tugas tersebut akan menerapkan awalan. Jika pengguna Google SecOps memberikan komentar dalam kasus Google SecOps, tugas akan membuat dan menyinkronkan komentar pengguna di tiket Jira yang sesuai menggunakan parameter Chronicle Comment Prefix.

Fitur ini ditambahkan untuk dua tujuan:

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

Catatan: Tugas ini hanya mendukung kasus Google SecOps dengan tag Jira.

Tugas ini menggunakan nilai TICKET_ID yang disimpan dalam konteks kasus untuk mengidentifikasi masalah yang sesuai di Jira. Nilai ini otomatis diisi dalam konteks kasus saat tiket dibuat menggunakan tindakan Create Issue atau Create Alert Issue.

Parameter

Parameter	Deskripsi
API Root	Wajib. URL root API instance Jira. Catatan: Jika melakukan autentikasi menggunakan token akun layanan, URL harus mengikuti format ini: https://api.atlassian.com/ex/jira/{cloud_id}. Nilai defaultnya adalah https://{jira_address}.
Username	Opsional. Nama pengguna (email) yang digunakan untuk terhubung ke Jira. Persyaratan untuk parameter ini bergantung pada metode autentikasi yang dipilih: Jika diberikan, sistem akan menggunakan autentikasi Dasar. Jika dibiarkan kosong, sistem akan menggunakan autentikasi Token Bearer secara default (diperlukan untuk akun layanan).
API Token	Wajib. Kredensial autentikasi yang digunakan untuk terhubung ke Jira. Catatan: Kolom ini menerima token API, token akun layanan, atau sandi standar (untuk Pusat Data).
Project Names	Wajib. Nama project Jira yang dipisahkan dengan koma yang harus dipantau oleh tugas. Nilai defaultnya adalah project names separated by comma.
Environment	Opsional. Nama lingkungan.
Siemplify Comment Prefix	Wajib. Awalan yang ditambahkan oleh tugas sinkronisasi ke komentar yang dibuat untuk tiket Jira. Nilai defaultnya adalah Google SecOps:.
Jira Comment Prefix	Wajib. Awalan yang ditambahkan oleh tugas sinkronisasi ke komentar kasus pemberitahuan Google SecOps. Nilai defaultnya adalah Jira Comment Sync Job:.

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