Mengintegrasikan ServiceNow dengan Google SecOps

Dokumen ini menjelaskan cara mengintegrasikan ServiceNow dengan Google Security Operations (Google SecOps).

Kasus penggunaan

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

• Tiket insiden otomatis: Buat insiden ServiceNow secara otomatis dari notifikasi keamanan yang berasal dari SIEM atau alat keamanan lainnya.

• Pengayaan dan respons insiden: Sederhanakan alur kerja respons insiden dengan mengurangi pembuatan tiket manual dan memperkaya insiden dengan informasi yang relevan dari pemberitahuan asal.

• Perbaikan phishing: Otomatiskan langkah-langkah investigasi phishing yang berulang, seperti mengumpulkan header email, menyelidiki lampiran, dan menelusuri email serupa, yang mempercepat waktu respons.

• Orkestrasi perbaikan kerentanan: Mengorkestrasi alur kerja perbaikan kerentanan dengan otomatis membuat permintaan perubahan ServiceNow untuk tindakan patching atau mitigasi berdasarkan hasil pemindaian kerentanan.

• Otomatisasi siklus proses pengguna: Otomatiskan tugas penyediaan dan pencabutan akses pengguna di berbagai sistem (kontrol akses, platform email, aplikasi) berdasarkan pemicu dari alur kerja ServiceNow.

• Konteks threat intelligence: Memperkaya notifikasi keamanan dengan data threat intelligence yang bersumber langsung dari platform ServiceNow, sehingga memberikan lebih banyak konteks bagi analis untuk memprioritaskan tindakan respons.

Sebelum memulai

Sebelum mengonfigurasi integrasi di platform Google SecOps, pastikan Anda telah menyelesaikan prasyarat berikut:

• Akun pengguna ServiceNow: Akun pengguna khusus dengan izin yang memadai untuk membuat kueri, membuat, dan memperbarui data target.
• Peran ServiceNow: Pastikan akun memiliki peran sistem yang diperlukan (sn_incident_write dan itil) dan konfigurasi akses pengguna kustom untuk mengizinkan akses guna membaca komentar jurnal.
• Konektivitas jaringan: Konfigurasi jaringan yang memungkinkan traffic dari alamat IP Google SecOps atau infrastruktur agen jarak jauh Anda mencapai endpoint instance ServiceNow.
• Detail autentikasi: Tentukan kebijakan autentikasi organisasi Anda. Anda dapat melakukan autentikasi menggunakan Autentikasi Dasar standar atau autentikasi OAuth 2.0.

Mengonfigurasi akses pengguna di ServiceNow

Agar integrasi dapat menyinkronkan komentar, memperbarui kolom, dan menjalankan tindakan dengan lancar, Anda harus melakukan tugas administratif berikut di platform ServiceNow.

Untuk petunjuk spesifik tentang cara menggunakan antarmuka ServiceNow, lihat dokumentasi produk ServiceNow resmi.

1. Buat peran khusus: Buka Roles > New dan buat peran baru yang dikhususkan untuk menangani akses komentar API.
2. Buat aturan Daftar Kontrol Akses (ACL) baru: Integrasi memerlukan akses baca ke tabel sys_journal_field untuk melacak komentar dan catatan kerja. Buka Kontrol Akses > Baru. Anda harus login dengan akun yang memiliki izin yang ditingkatkan untuk membuat aturan ini.

3. Konfigurasikan parameter ACL:

   • Setel Type ke record.
   • Tetapkan Operation ke read.
   • Di kolom Name, pilih Journal Entry sys_journal_field dari drop-down pertama, dan pilih -- None -- dari drop-down kedua.
   Penting: Drop-down kedua harus ditetapkan secara eksplisit ke -- None --. Jika Anda memilih * (karakter pengganti), API akan gagal mengambil komentar.
   • Buka daftar Requires role di bagian bawah formulir dan tambahkan peran komentar kustom yang baru dibuat. Klik Submit.

4. Tetapkan peran ke akun integrasi: Buka Users, buka akun integrasi khusus Anda, dan berikan peran berikut:

   • Peran khusus yang Anda buat untuk membaca komentar.
   • sn_incident_write: Diperlukan untuk interaksi dasar, seperti tindakan Get Incident dan Update Incident.
   • itil: Diperlukan untuk tindakan CMDB dan fungsi pencarian manajemen konfigurasi aset terkait.
   Catatan: Peran ini memberikan izin dasar yang diperlukan untuk berinteraksi dengan insiden standar dan entity konfigurasi. Mengakses tabel ServiceNow lainnya mungkin memerlukan konfigurasi peran tambahan berdasarkan batasan ACL unik lingkungan Anda.

Opsi konfigurasi autentikasi

Integrasi ServiceNow mendukung tiga metode autentikasi yang berbeda. Pilih salah satu opsi konfigurasi berikut yang sesuai dengan persyaratan keamanan organisasi Anda.

Opsi 1: Alur Kredensial Klien OAuth 2.0 (Direkomendasikan)

Metode ini menggunakan Pemberian Kredensial Klien OAuth 2.0 bersama dengan peniruan identitas pengguna untuk membatasi akses data dengan aman tanpa mengekspos sandi pengguna statis ke platform.

Tahap 1: Membuat endpoint OAuth di ServiceNow

1. Telusuri Application Registries di menu navigasi ServiceNow, lalu klik New.
2. Pilih New Inbound Integration Experience.
3. Dari daftar jenis koneksi, pilih OAuth - Client credentials grant.
4. Di kolom Name, berikan nama deskriptif untuk konfigurasi endpoint.
5. Berikan nama atau ID Penyedia OAuth yang diperlukan untuk membuat konteks profil identitas.
6. Di kolom OAuth application user, pilih akun pengguna ServiceNow khusus yang akan ditiru identitasnya dan digunakan untuk semua aktivitas API otomatis.
7. Klik Kirim atau Simpan.
8. Buka kembali data registry yang baru dibuat untuk menyalin dan mengamankan Client ID dan Client Secret yang dihasilkan.

Catatan: Jika Anda membuka objek kredensial ini langsung dari tampilan "Application Registry" klasik, kolom Default Grant type akan otomatis diisi sebagai Resource Owner Password Credentials. Biarkan setelan default ini apa adanya.

Tahap 2: Konfigurasi di dalam Google SecOps

1. Di Google SecOps, buka Automation > Integrations Setup, lalu buka jendela konfigurasi ServiceNow.
2. Masukkan Api Root Anda (ganti domain placeholder default dengan URL instance ServiceNow yang sebenarnya).
3. Berikan Client ID dan Client Secret yang dibuat selama Fase 1.
4. Pastikan kolom Username, Password, dan Refresh Token dibiarkan kosong sepenuhnya.
5. Centang kotak setelan Use Oauth Authentication.
6. Klik Test untuk memvalidasi parameter menggunakan uji ping konektivitas. Jika berhasil, klik Save.

Opsi 2: Autentikasi Dasar

Metode ini menggunakan validasi kredensial langsung. Penyiapannya mudah, tetapi mungkin dibatasi jika perusahaan Anda menerapkan autentikasi multi-faktor (MFA) atau memblokir header autentikasi dasar.

1. Di ServiceNow, pastikan pengguna integrasi Anda memiliki Username dan Password lokal.
2. Saat mengonfigurasi integrasi di Google SecOps, berikan Api Root (mengganti domain placeholder default dengan URL instance ServiceNow yang sebenarnya), Username, dan Password.
3. Biarkan kolom terkait OAuth kosong dan pastikan Use Oauth Authentication dinonaktifkan (kotak centang tidak dicentang).
4. Klik Test untuk memvalidasi parameter koneksi. Jika berhasil, klik Simpan.

Opsi 3: Alur Token Refresh

Gunakan metode ini jika organisasi Anda memerlukan kontrol keamanan OAuth menggunakan rantai token refresh untuk mengambil token akses secara terprogram di balik layar.

1. Selesaikan Tahap 1 di instance ServiceNow Anda untuk membuat Client ID dan Client Secret.
2. Selesaikan langkah-langkah di bagian Membuat Token Refresh untuk mengambil string token otorisasi yang valid.
3. Di Google SecOps, buka jendela konfigurasi instance integrasi ServiceNow.
4. Isi parameter sepenuhnya menggunakan kredensial yang telah Anda konfigurasi:
   • Api Root (ganti domain placeholder default dengan URL instance ServiceNow Anda yang sebenarnya).
   • Username
   • Password
   • Client ID
   • Rahasia Klien
5. Centang kotak Use Oauth Authentication.
6. Tempelkan string token yang Anda ambil dari alur kerja bagian Membuat Token Refresh ke kolom Token Refresh.
7. Klik Test untuk memvalidasi parameter koneksi. Jika berhasil, klik Simpan.

Membuat Token Refresh (Google SecOps)

Untuk membuat token refresh, Anda harus mengonfigurasi integrasi untuk sementara agar menjalankan tindakan bantuan.

1. Di Google SecOps, buka Automation > Integrations Setup.
2. Pastikan kotak centang Use Oauth Authentication tetap tidak dicentang untuk langkah penyiapan awal ini.
3. Konfigurasikan instance integrasi ServiceNow sementara menggunakan Api Root, Username, Password, Client ID, dan Client Secret, lalu klik Save.
4. Simulasikan kasus atau buka kasus yang ada.
5. Jalankan tindakan Get Oauth Token ServiceNow secara manual pada kasus.
6. Salin nilai refresh_token dari hasil JSON tindakan untuk digunakan di kolom Token Refresh saat mengonfigurasi instance integrasi akhir.

Parameter integrasi

Integrasi ServiceNow memerlukan parameter berikut:

Parameter	Deskripsi
Api Root	Wajib. Root API instance ServiceNow. Nilai defaultnya adalah https://INSTANCE.service-now.com/api/now/v1/.
Username	Wajib. Nama pengguna akun ServiceNow.
Password	Wajib. Sandi akun ServiceNow.
Incident Table	Opsional. Nama atau jalur tabel API yang akan digunakan untuk tindakan terkait insiden dan pengambilan data. Secara default, integrasi menggunakan jalur table/incident.
Verify SSL	Opsional. Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke server ServiceNow. Diaktifkan secara default.
Client ID	Opsional. Client ID untuk integrasi ServiceNow, yang diperlukan untuk autentikasi OAuth 2.0 menggunakan kredensial klien. Anda dapat melakukan autentikasi menggunakan token refresh atau kredensial klien. Jika token refresh dan kredensial klien dikonfigurasi, integrasi akan menggunakan token refresh untuk autentikasi.
Client Secret	Opsional. Rahasia klien untuk integrasi ServiceNow, yang diperlukan untuk autentikasi OAuth 2.0 menggunakan kredensial klien. Anda dapat melakukan autentikasi menggunakan token refresh atau kredensial klien. Jika token refresh dan kredensial klien dikonfigurasi, integrasi akan menggunakan token refresh untuk autentikasi.
Refresh Token	Opsional. Token refresh untuk integrasi ServiceNow, yang diperlukan untuk autentikasi OAuth 2.0 menggunakan token refresh. Masa berlaku token refresh yang dikonfigurasi ini akan berakhir setiap 90 hari. Anda dapat melakukan autentikasi menggunakan token refresh atau kredensial klien. Jika token refresh dan kredensial klien dikonfigurasi, integrasi akan menggunakan token refresh untuk autentikasi.
Use Oauth Authentication	Opsional. Jika dipilih, integrasi akan menggunakan OAuth 2.0 untuk melakukan autentikasi. Autentikasi OAuth 2.0 memerlukan penetapan kredensial klien (Client ID dan Client Secret) atau Refresh Token. Dinonaktifkan secara default.

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 Lampiran

Gunakan tindakan Add Attachment untuk menambahkan lampiran ke data tabel di ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Tambahkan Lampiran memerlukan parameter berikut:

Parameter	Deskripsi
Table Name	Wajib. Nama tabel yang berisi data tempat lampiran ditambahkan.
Record Sys ID	Wajib. ID sistem (sys_id) data tempat lampiran ditambahkan.
File Path	Wajib. Daftar jalur absolut yang dipisahkan koma untuk file yang akan dilampirkan.
Mode	Opsional. Perilaku tindakan saat file dengan nama yang sama sudah ada dalam data. Kemungkinan nilainya adalah sebagai berikut: Add New Attachment: Tindakan ini akan menambahkan file sebagai lampiran baru yang terpisah. File dengan nama yang sama diizinkan. Overwrite Existing Attachment: Tindakan ini akan menggantikan lampiran yang ada yang memiliki nama yang sama. Nilai defaultnya adalah Add New Attachment.

Output tindakan

Tindakan Add Attachment 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 Add Attachment:

{
    "result": {
        "size_bytes": "742",
        "file_name": "placeholder_document.txt",
        "sys_mod_count": "0",
        "average_image_color": "",
        "image_width": "",
        "sys_updated_on": "2025-01-01 10:00:00",
        "sys_tags": "",
        "table_name": "incident",
        "sys_id": "TEST_SYS_ID_ATTACH_123456789",
        "image_height": "",
        "sys_updated_by": "admin",
        "download_link": "https://placeholder.service-now.com/api/now/attachment/TEST_SYS_ID_ATTACH_123456789/file",
        "content_type": "multipart/form-data",
        "sys_created_on": "2025-01-01 10:00:00",
        "size_compressed": "438",
        "compressed": "true",
        "state": "pending",
        "table_sys_id": "TEST_SYS_ID_RECORD_ABCDEFG",
        "chunk_size_bytes": "700000",
        "hash": "test_hash_0000000000000000000000000000000000000000000000000000000000000000",
        "sys_created_by": "admin"
    }
}

Pesan output

Tindakan Add Attachment dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully added the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS Action wasn't able to add the following attachments to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS No attachments were added to the record with a Sys ID RECORD_SYS_ID from a table TABLE_NAME in ServiceNow: FILE_PATHS	Tindakan berhasil.
Error executing action "Add Attachment". 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 Add Attachment:

Nama hasil skrip	Nilai
is_success	true atau false

Tambahkan Komentar

Gunakan tindakan Add Comment untuk menambahkan komentar ke insiden ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Add Comment memerlukan parameter berikut:

Parameter	Deskripsi
Incident Number	Wajib. Nomor insiden yang akan ditambahi komentar, dalam format INCINCIDENT_NUMBER.
Comment	Wajib. Komentar yang akan ditambahkan ke insiden.

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
is_success	true atau false

Tambahkan Komentar dan Tunggu Balasan

Gunakan tindakan Add Comment and Wait for Reply untuk menambahkan komentar ke insiden ServiceNow, lalu jeda eksekusi playbook hingga komentar atau balasan baru ditambahkan ke insiden tersebut. Output tindakan adalah konten komentar baru.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Tambahkan Komentar dan Tunggu Balasan memerlukan parameter berikut:

Parameter	Deskripsi
Incident Number	Wajib. Nomor insiden yang akan ditambahi komentar, dalam format INCINCIDENT_NUMBER.
Comment	Wajib. Komentar yang akan ditambahkan ke insiden.

Output tindakan

Tindakan Tambahkan Komentar dan Tunggu Balasan 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 dan Tunggu Balasan:

Nama hasil skrip	Nilai
new_comment

Tambahkan Komentar ke Rekaman

Gunakan tindakan Add Comment To Record untuk menambahkan komentar atau catatan kerja ke data tabel tertentu di ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Catatan: Jika Anda mengaktifkan parameter Wait For Reply, tindakan akan berjalan dalam mode asinkron. Saat menggunakan mode asinkron, sesuaikan nilai waktu tunggu skrip di Google SecOps IDE berdasarkan waktu tunggu yang diharapkan untuk balasan.

Input tindakan

Tindakan Add Comment To Record memerlukan parameter berikut:

Parameter	Deskripsi
Table Name	Wajib. Nama tabel yang akan ditambahi komentar atau catatan.
Type	Wajib. Jenis komentar atau catatan yang akan ditambahkan. Kemungkinan nilainya adalah sebagai berikut: Comment Work Note Nilai defaultnya adalah Comment.
Record Sys ID	Wajib. ID sistem (sys_id) untuk menambahkan komentar atau catatan kerja.
Text	Wajib. Konten komentar atau catatan kerja.
Wait For Reply	Opsional. Jika dipilih, tindakan akan berjalan secara asinkron dan menjeda eksekusi hingga komentar atau catatan kerja baru ditambahkan ke data. Tindakan ini akan melacak komentar jika Anda menambahkan komentar, dan catatan pekerjaan jika Anda menambahkan catatan pekerjaan. Catatan: Jika diaktifkan, tindakan ini akan berjalan dalam mode asinkron. Sesuaikan nilai waktu tunggu skrip di Google SecOps IDE berdasarkan perkiraan waktu tunggu balasan. Dinonaktifkan secara default.

Output tindakan

Tindakan Tambahkan Komentar ke Data 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 Add Comment To Record:

{
    "sys_id": "4355183607523010ff23f6fd7c1ed0a8",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "Test comment content.",
    "sys_created_by": "admin",
    "element": "comments"
}

Pesan output

Tindakan Add Comment To Record dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully added COMMENT_OR_NOTE " CONTENT" to TABLE_NAME with Sys_ID SYS_ID in ServiceNow.	Tindakan berhasil.
Error executing action "Add Comment To Record". 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 Add Comment To Record:

Nama hasil skrip	Nilai
is_success	true atau false

Tambahkan Insiden Induk

Gunakan tindakan Add Parent Incident untuk menambahkan insiden induk untuk insiden di ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Add Parent Incident memerlukan parameter berikut:

Parameter	Deskripsi
Parent Incident Number	Wajib. Nomor insiden induk, dalam format INCINCIDENT_NUMBER (misalnya, INC0000051). Tindakan ini menambahkan semua insiden di Child Incident Numbers sebagai turunan untuk insiden induk.
Child Incident Numbers	Wajib. Comma separated list berisi nomor insiden yang akan ditetapkan sebagai insiden turunan untuk insiden induk yang ditentukan, dalam format INCINCIDENT_NUMBER (misalnya, INC0000051).

Output tindakan

Tindakan Add Parent Incident 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 Add Parent Incident:

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "2a100a1c2fc42010c518532a2799b621",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}

Pesan output

Tindakan Add Parent Incident dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully set PARENT_INCIDENT_NUMBER as the "Parent Incident" for the following incidents in ServiceNow: CHILD_INCIDENT_NUMBERS.	Tindakan berhasil.
Error executing action "Add Parent Incident". Reason: ERROR_REASON	Tindakan gagal. Periksa koneksi ke server, parameter input, atau kredensial.

Tutup Insiden

Gunakan tindakan Close Incident untuk menutup insiden ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Penting: Untuk menjalankan tindakan ini, Anda harus menetapkan peran sn_incident_write kepada pengguna di ServiceNow. Untuk mengetahui detail selengkapnya, buka Mengonfigurasi akses pengguna di ServiceNow.

Input tindakan

Tindakan Close Incident memerlukan parameter berikut:

Parameter	Deskripsi
Incident Number	Wajib. Jumlah insiden yang akan ditutup, dalam format INCINCIDENT_NUMBER.
Close Reason	Wajib. Alasan penutupan insiden.
Resolution Code	Wajib. Kode penyelesaian untuk insiden. Kemungkinan nilainya adalah sebagai berikut: Duplicate Known error No resolution provided Resolved by caller Resolved by change Resolved by problem Resolved by request Solution provided Workaround provided User error Nilai defaultnya adalah Solution provided.
Close Notes	Wajib. Catatan penutupan untuk insiden.

Output tindakan

Tindakan Close Incident 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 Close Incident:

Nama hasil skrip	Nilai
is_success	true atau false

Membuat Insiden Pemberitahuan

Gunakan tindakan Create Alert Incident untuk membuat insiden baru di ServiceNow berdasarkan detail pemberitahuan yang memulai operasi playbook.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Create Alert Incident memerlukan parameter berikut:

Parameter	Deskripsi
Impact	Wajib. Tingkat dampak insiden. Penting: Anda harus menggunakan Nilai ServiceNow, misalnya, 1, bukan Label, misalnya, 1 - High. Kemungkinan nilainya adalah sebagai berikut: 1 untuk Tinggi 2 untuk Medium 3 untuk Rendah Nilai defaultnya adalah 1.
Urgency	Wajib. Tingkat urgensi insiden. Penting: Anda harus menggunakan Nilai ServiceNow (misalnya, 1), bukan Label (misalnya, 1 - High). Kemungkinan nilainya adalah sebagai berikut 1 untuk Tinggi 2 untuk Medium 3 untuk Rendah Nilai defaultnya adalah 1.
Category	Opsional. Kategori insiden. Penting: Anda harus menggunakan Nilai ServiceNow, misalnya, database, bukan Label, misalnya, Database.
Assignment Group ID	Opsional. Nama lengkap grup yang akan ditugaskan untuk menangani insiden.
Assigned User ID	Opsional. Nama lengkap pengguna yang akan ditugaskan untuk menangani insiden.
Description	Opsional. Deskripsi insiden.

Output tindakan

Tindakan Create Alert Incident 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 Alert Incident:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010005",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by":
    "admin", "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "1",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 05:13:25",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 05:13:25",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 07:13:25",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 05:13:25",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}

Hasil skrip

Tabel berikut mencantumkan nilai untuk output hasil skrip saat menggunakan tindakan Create Alert Incident:

Nama hasil skrip	Nilai
is_success	true atau false

Buat Insiden

Gunakan tindakan Create Incident untuk membuat insiden baru di ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Create Incident memerlukan parameter berikut:

Parameter	Deskripsi
Short Description	Wajib. Deskripsi singkat insiden.
Impact	Wajib. Tingkat dampak insiden. Penting: Anda harus menggunakan Nilai ServiceNow, misalnya, 1, bukan Label, misalnya, 1 - High. Kemungkinan nilainya adalah sebagai berikut: 1 untuk Tinggi 2 untuk Medium 3 untuk Rendah Nilai defaultnya adalah 1.
Urgency	Wajib. Tingkat urgensi insiden. Penting: Anda harus menggunakan Nilai ServiceNow (misalnya, 1), bukan Label (misalnya, 1 - High). Kemungkinan nilainya adalah sebagai berikut 1 untuk Tinggi 2 untuk Medium 3 untuk Rendah Nilai defaultnya adalah 1.
Category	Opsional. Kategori insiden. Penting: Anda harus menggunakan Nilai ServiceNow, misalnya, database, bukan Label, misalnya, Database.
Assignment Group ID	Opsional. Nama lengkap grup yang akan ditugaskan untuk menangani insiden.
Assigned User ID	Opsional. Nama lengkap pengguna yang akan ditugaskan untuk menangani insiden.
Description	Opsional. Deskripsi insiden.
Custom Fields	Opsional. String berformat JSON yang berisi nama kolom dan nilai yang sesuai untuk diperbarui (misalnya, {"location":"London", "category":"database"}). Anda dapat menggunakan parameter ini untuk mengubah kolom yang tidak ditentukan secara eksplisit sebagai input tindakan.

Output tindakan

Tindakan Create Incident 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 Incident:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010005",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by":
    "admin", "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "1",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 05:13:25",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "4187b92c-7aaa-40ec-a032-833dd5a854e6",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 05:13:25",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 07:13:25",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 05:13:25",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}

Hasil skrip

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

Nama hasil skrip	Nilai
incident_number	INCIDENT_NUMBER

Create Record

Gunakan tindakan Create Record untuk membuat data baru di berbagai tabel ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Create Record memerlukan parameter berikut:

Parameter	Deskripsi
Table Name	Opsional. Nama tabel ServiceNow tempat data baru dibuat (misalnya, incident).
Object Json Data	Opsional. Objek JSON yang berisi pasangan nilai kolom yang diperlukan untuk menentukan data baru (seperti kolom insiden atau atribut item CMDB).

Output tindakan

Tindakan Create Record 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 Record:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010021",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "3",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "5",
    "state": "1",
    "sys_id": "ID",
    "opened_at": "2020-07-10 08:24:34",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": " ",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 08:24:34",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": " ",
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": " ",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 08:24:34",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "3",
    "reopen_count": "0"
}

Hasil skrip

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

Nama hasil skrip	Nilai
object_sys_id	OBJECT_SYS_ID

Download Lampiran

Gunakan tindakan Download Attachments untuk mendownload file dan dokumen yang dilampirkan ke data ServiceNow tertentu ke folder lokal di lingkungan Google SecOps Anda.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Download Attachments memerlukan parameter berikut:

Parameter	Deskripsi
Table Name	Wajib. Nama tabel ServiceNow yang berisi data untuk mendownload lampiran (seperti incident).
Record Sys ID	Wajib. ID sistem (sys_id) dari data tempat lampiran didownload.
Download Folder Path	Wajib. Jalur absolut ke folder di lingkungan Google SecOps tempat lampiran yang didownload disimpan.
Overewrite	Opsional. Jika dipilih, tindakan ini akan menimpa file dengan nama yang sama. Dinonaktifkan secara default.

Output tindakan

Tindakan Download Attachments 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 Download Attachments:

{
    "result": [
        {"absolute_file_path" : ["PATH"]
            "size_bytes": "187",
            "file_name": "example.txt",
            "sys_mod_count": "1",
            "average_image_color": "",
            "image_width": "",
            "sys_updated_on": "2020-10-19 09:58:39",
            "sys_tags": "",
            "table_name": "problem",
            "sys_id": "SYS_ID",
            "image_height": "",
            "sys_updated_by": "system",
            "download_link": "https://example.service-now.com/api/now/attachment/ID/file",
            "content_type": "text/plain",
            "sys_created_on": "2020-10-19 09:58:38",
            "size_compressed": "172",
            "compressed": "true",
            "state": "available",
            "table_sys_id": "57771d002f002010c518532a2799b6cc",
            "chunk_size_bytes": "700000",
            "hash": "a4fbb8ab71268903845b59724835274ddc66e095de553c5e0c1da8fecd04ee45",
            "sys_created_by": "admin"
        }
    ]
}

Pesan output

Tindakan Download Lampiran dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully downloaded the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME Action wasn't able to download the following attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME Action wasn't able to download attachments related to the record with Sys ID SYS_ID from table TABLE_NAME in ServiceNow: FILENAME	Tindakan berhasil.
Error executing action "Download Attachments". 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 Download Lampiran:

Nama hasil skrip	Nilai
is_success	true atau false

Mendapatkan Detail Insiden Anak

Gunakan tindakan Get Child Incident Details untuk mengambil informasi tentang insiden turunan berdasarkan insiden induk di ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Get Child Incident Details memerlukan parameter berikut:

Parameter	Deskripsi
Parent Incident Number	Wajib. Nomor insiden induk yang digunakan untuk mengambil detail insiden turunan, dalam format INCINCIDENT_NUMBER.
Max Child Incident To Return	Opsional. Jumlah maksimum insiden turunan yang ditampilkan tindakan dari insiden induk. Nilai defaultnya adalah 50.

Output tindakan

Tindakan Get Child Incident Details 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 Get Child Incident Details menyediakan tabel berikut:

Nama tabel: Child Incident Details

Kolom tabel:

• Sys ID (dipetakan sebagai sys_id)
• Nomor (dipetakan sebagai number)
• Short Description (dipetakan sebagai short_description)
• Created At (dipetakan sebagai sys_created_on)

Hasil JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Get Child Incident Details:

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  ATF Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "2a100a1c2fc42010c518532a2799b621",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}

Pesan output

Tindakan Get Child Incident Details dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully retrieved information about child incidents related to the PARENT_INCIDENT_NUMBER incident in ServiceNow. Action wasn't able to retrieve information about the child incidents in ServiceNow. Reason: incident PARENT_INCIDENT_NUMBER was not found. No child incidents were found.	Tindakan berhasil.
Error executing action "Get Child Incident Details". 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 Get Child Incident Details:

Nama hasil skrip	Nilai
is_success	true atau false

Mendapatkan Detail Data CMDB

Gunakan tindakan Get CMDB Record Details untuk mendapatkan data CMDB mendetail dari class yang sama di ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Penting: Tindakan ini mengharuskan Anda menetapkan peran itil kepada pengguna di ServiceNow. Untuk mengetahui detail selengkapnya, lihat Mengonfigurasi akses pengguna di ServiceNow.

Input tindakan

Tindakan Get CMDB Record Details memerlukan parameter berikut:

Parameter	Deskripsi
Class Name	Wajib. Nama class CMDB tempat mengambil kumpulan data, seperti cmdb_ci_appl. Untuk mengetahui informasi selengkapnya tentang nama class, lihat Melihat dan mengedit definisi dan metadata class.
Sys ID	Wajib. Daftar ID sistem (sys_id) yang dipisahkan koma dari data CMDB yang detailnya akan diambil.
Max Records To Return	Opsional. Jumlah maksimum relasi data yang akan ditampilkan untuk setiap jenis relasi (seperti relates to atau depends on). Nilai defaultnya adalah 50.

Output tindakan

Tindakan Get CMDB Record Details 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 CMDB Record Details:

{
    "result": {
        "outbound_relations": [
            {
                "sys_id": "56f3a7ad7f701200bee45f19befa910f",
                "type": {
                    "display_value": "Members::Member of",
                    "link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
                    "value": "ID"
                },
                "target": {
                    "display_value": "Example",
                    "link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
                    "value": "ID"
                }
            }
        ],
        "attributes": {
            "attested_date": "",
            "skip_sync": "false",
            "operational_status": "1",
            "caption": "",
            "cluster_type": "",
            "sys_updated_on": "2016-01-06 19:04:07",
            "attestation_score": "",
            "discovery_source": "",
            "first_discovered": "",
            "sys_updated_by": "example.user",
            "cluster_status": "",
            "due_in": "",
            "sys_created_on": "2016-01-06 16:47:15",
            "sys_domain": {
                "display_value": "global",
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "install_date": "",
            "invoice_number": "",
            "gl_account": "",
            "sys_created_by": "example.user",
            "warranty_expiration": "",
            "cluster_version": "",
            "asset_tag": "",
            "fqdn": "",
            "change_control": "",
            "owned_by": "",
            "checked_out": "",
            "sys_domain_path": "/",
            "delivery_date": "",
            "maintenance_schedule": "",
            "install_status": "1",
            "cost_center": "",
            "attested_by": "",
            "supported_by": "",
            "dns_domain": "",
            "name": "SAP-LB-Win-Cluster",
            "assigned": "",
            "purchase_date": "",
            "subcategory": "Cluster",
            "short_description": "",
            "assignment_group": "",
            "managed_by": "",
            "managed_by_group": "",
            "last_discovered": "",
            "can_print": "false",
            "sys_class_name": "cmdb_ci_win_cluster",
            "manufacturer": "",
            "sys_id": "SYS_ID",
            "cluster_id": "",
            "po_number": "",
            "checked_in": "",
            "sys_class_path": "/!!/!5/!$",
            "vendor": "",
            "mac_address": "",
            "company": "",
            "model_number": "",
            "justification": "",
            "department": "",
            "assigned_to": "",
            "start_date": "",
            "cost": "",
            "comments": "",
            "sys_mod_count": "1",
            "serial_number": "",
            "monitor": "false",
            "model_id": "",
            "ip_address": "",
            "duplicate_of": "",
            "sys_tags": "",
            "cost_cc": "USD",
            "support_group": "",
            "order_date": "",
            "schedule": "",
            "environment": "",
            "due": "",
            "attested": "false",
            "unverified": "false",
            "correlation_id": "",
            "attributes": "",
            "location": "",
            "asset": "",
            "category": "Resource",
            "fault_count": "0",
            "lease_id": ""
        },
        "inbound_relations": [
            {
                "sys_id": "3b3d95297f701200bee45f19befa910c",
                "type": {
                    "display_value": "Depends on::Used by",
                    "link": "https://example.service-now.com/api/now/table/cmdb_rel_type/ID",
                    "value": "ID"
                },
                "target": {
                    "display_value": "IP-Router-3",
                    "link": "https://example.service-now.com/api/now/cmdb/instance/cmdb_ci/ID",
                    "value": "ID"
                }
            }
        ]
    }
}

Pesan output

Tindakan Get CMDB Record Details dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully returned details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST. Action wasn't able to return details for CMDB records in the Class CLASS_NAME from ServiceNow for the following Sys IDs: SYS_ID_LIST Action wasn't able to return details for CMDB records in the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found. Action wasn't able to return details for CMDB record with Sys ID SYS_ID in the Class CLASS_NAME in Service Now. Reason: Record with Sys ID SYS_ID was not found in Class CLASS_NAME. Information about the provided Sys IDs was not found.	Tindakan berhasil.
Error executing action "Get CMDB Record Details". 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 Get CMDB Record Details:

Nama hasil skrip	Nilai
is_success	true atau false

Mendapatkan Insiden

Gunakan tindakan Get Incident untuk mengambil informasi tentang insiden ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Get Incident memerlukan parameter berikut:

Parameter	Deskripsi
Incident Number	Wajib. ID unik insiden ServiceNow yang akan diambil, dalam format INCINCIDENT_NUMBER.

Output tindakan

Tindakan Get Incident 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 Incident:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": "2012",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010041",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "10",
    "notify": "1",
    "resolved_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": "2020-07-10 12:53:06",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "priority": "1",
    "state": "7",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 12:18:04",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "sdf",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": "0",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": "Closed by Caller",
    "business_duration": "1970-01-01 00:00:00",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 13:13:57",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": "1970-01-01 00:35:02",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "false",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 14:33:28",
    "severity": "3",
    "incident_state": "7",
    "resolved_at": "2020-07-10 12:53:06",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 12:18:04",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": "Closed/Resolved by Caller",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}

Hasil skrip

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

Nama hasil skrip	Nilai
incident_number	INCIDENT_NUMBER

Mendapatkan Token OAuth

Gunakan tindakan Get Oauth Token untuk mendapatkan token refresh OAuth untuk ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Catatan:

Tindakan ini mengharuskan Anda menetapkan parameter integrasi berikut:

• Username
• Password
• Client ID
• Client Secret

Input tindakan

Tidak ada.

Output tindakan

Tindakan Get Oauth Token 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 Oauth Token:

{
    "access_token": "Na4Kb1oWpFcYNUnyAjsYldiTMxYF1Cz79Q",
    "refresh_token": "0ryCENbbvfggZbNG9rFFd8_C8X0UgAQSMQkPJNStGwEEt0qNt-F1lw",
    "scope": "useraccount",
    "token_type": "Bearer",
    "expires_in": 1799
}

Pesan output

Tindakan Get Oauth Token dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully generated Oauth tokens for ServiceNow. Now navigate to the configuration tab and put "refresh_token" value in the "Refresh Token" parameter. Note: "Username" and "Password" parameters can be emptied.	Tindakan berhasil.
Error executing action "Get Oauth Token". 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 Get Oauth Token:

Nama hasil skrip	Nilai
is_success	true atau false

Mendapatkan Detail Rekaman

Gunakan tindakan Get Record Details untuk mengambil informasi tentang data tabel tertentu di ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Get Record Details memerlukan parameter berikut:

Parameter	Deskripsi
Table Name	Wajib. Nama tabel ServiceNow yang berisi data yang akan diambil informasinya (seperti incident).
Record Sys ID	Wajib. ID sistem (sys_id) dari data ServiceNow tertentu yang ingin diambil detailnya.
Fields	Opsional. Daftar yang dipisahkan koma dari kolom (kolom) tertentu yang akan ditampilkan dari data yang diambil (seperti sys_id,number,short_description). Jika tidak ada nilai yang diberikan, tindakan akan menampilkan kolom default untuk data.

Output tindakan

Tindakan Get Record Details 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 Record Details:

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-20 07:19:11",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010009",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-20 07:19:11",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-20 07:18:56",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "Assessment :  ATF Assessor",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": {
                "link": "https://example.service-now.com/api/now/table/incident/ID",
                "value": "ID"
            },
            "sys_id": "SYS_ID",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": "",
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
            "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}

Pesan output

Tindakan Get Record Details dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully retrieved information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow. Action wasn't able to retrieve information about the TABLE_NAME record with a Sys ID RECORD_SYS_ID in ServiceNow. Reason: ERROR_REASON.	Tindakan berhasil.
Error executing action "Get Record Details". 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 Dapatkan Detail Data:

Nama hasil skrip	Nilai
is_success	true atau false

Mendapatkan Detail Pengguna

Gunakan tindakan Get User Details untuk mengambil informasi tentang pengguna menggunakan parameter sys_id di ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Get User Details memerlukan parameter berikut:

Parameter	Deskripsi
User Sys IDs	Opsional. Daftar ID sistem yang dipisahkan koma yang sesuai dengan pengguna yang detailnya akan diambil (seperti sys_id_1,sys_id_2).
Emails	Opsional. Daftar alamat email yang dipisahkan koma yang sesuai dengan pengguna yang detailnya akan diambil (seperti [e-mail],[e-mail]).

Output tindakan

Tindakan Get User Details 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 Get User Details menyediakan tabel berikut:

Nama tabel: User Details

Kolom tabel:

• Sys ID (dipetakan sebagai sys_id)
• Nama (dipetakan sebagai name)
• Nama pengguna (dipetakan sebagai user_name)
• Email (dipetakan sebagai email)

Hasil JSON

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

{
    "result": [
        {
            "calendar_integration": "1",
            "country": "",
            "last_position_update": "",
            "user_password": "example",
            "last_login_time": "",
            "source": "",
            "sys_updated_on": "2020-08-29 02:42:42",
            "building": "",
            "web_service_access_only": "false",
            "notification": "2",
            "enable_multifactor_authn": "false",
            "sys_updated_by": "user@example",
            "sys_created_on": "2012-02-18 03:04:52",
            "agent_status": "",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "",
            "vip": "false",
            "sys_created_by": "admin",
            "longitude": "",
            "zip": "",
            "home_phone": "",
            "time_format": "",
            "last_login": "",
            "default_perspective": "",
            "geolocation_tracked": "false",
            "active": "true",
            "sys_domain_path": "/",
            "cost_center": {
                "link": "https://example.service-now.com/api/now/table/cmn_cost_center/ID",
                "value": "ID"
            },
            "phone": "",
            "name": "Example User",
            "employee_number": "",
            "password_needs_reset": "false",
            "gender": "Male",
            "city": "",
            "failed_attempts": "",
            "user_name": "example.user",
            "latitude": "",
            "roles": "",
            "title": "",
            "sys_class_name": "sys_user",
            "sys_id": "SYS_ID",
            "internal_integration_user": "false",
            "ldap_server": "",
            "mobile_phone": "",
            "street": "",
            "company": {
                "link": "https://example.service-now.com/api/now/table/core_company/ID",
                "value": "ID"
            },
            "department": {
                "link": "https://dev98773.service-now.com/api/now/table/cmn_department/ID",
                "value": "ID"
            },
            "first_name": "Example",
            "email": "[e-mail]",
            "introduction": "",
            "preferred_language": "",
            "manager": "",
            "business_criticality": "3",
            "locked_out": "false",
            "sys_mod_count": "4",
            "last_name": "User",
            "photo": "",
            "avatar": "063e38383730310042106710ce41f13b",
            "middle_name": "",
            "sys_tags": "",
            "time_zone": "",
            "schedule": "",
            "on_schedule": "",
            "date_format": "",
            "location": {
                "link": "https://example.service-now.com/api/now/table/cmn_location/ID",
                "value": "ID"
            }
        }
    ]
}

Pesan output

Tindakan Get User Details dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully retrieved information about users from ServiceNow with the following Sys IDs: SYS_ID_LIST. Action wasn't able to retrieve information about the users in ServiceNow with the following Sys IDs: SYS_ID_LIST. Information about the users with specified Sys IDs was not found in ServiceNow.	Tindakan berhasil.
Error executing action "Get User Details". 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 Get User Details:

Nama hasil skrip	Nilai
is_success	true atau false

Mencantumkan Data CMDB

Gunakan tindakan List CMDB Records untuk mencantumkan data CMDB dari class yang sama di ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Penting: Tindakan ini mengharuskan Anda menetapkan peran itil kepada pengguna di ServiceNow. Untuk mengetahui detail selengkapnya, buka Mengonfigurasi akses pengguna di ServiceNow.

Membuat filter kueri

Parameter Query Filter menerima string kueri standar yang dienkode ServiceNow (sysparm_query). Anda dapat membuat string ini langsung dalam antarmuka ServiceNow (misalnya, dengan membuat filter pada tampilan daftar dan memilih Copy query) atau dengan membuatnya secara manual.

Untuk mengetahui petunjuk tentang cara membuat dan menggunakan string ini, lihat String kueri yang dienkode dalam dokumentasi ServiceNow.

Input tindakan

Tindakan List CMDB Records memerlukan parameter berikut:

Parameter	Deskripsi
Class Name	Wajib. Nama class CMDB tempat mengambil kumpulan data, seperti cmdb_ci_appl. Untuk mengetahui informasi selengkapnya tentang nama class ServiceNow, lihat Melihat dan mengedit definisi dan metadata class.
Query Filter	Opsional. String kueri yang dienkode yang digunakan untuk memfilter data yang ditampilkan (seperti sys_idLIKE1^sys_idSTARTSWITH0). Anda dapat membuat string kueri yang valid menggunakan opsi Copy query di tampilan daftar ServiceNow. Untuk informasi selengkapnya, lihat String kueri yang dienkode.
Max Records To Return	Opsional. Jumlah maksimum data yang akan diambil berdasarkan filter yang diterapkan. Nilai defaultnya adalah 50.

Output tindakan

Tindakan List CMDB Records 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 CMDB Records menyediakan tabel berikut:

Nama tabel: CLASS_NAME Records

Kolom tabel:

• Nama (dipetakan sebagai name)
• Sys ID (dipetakan sebagai sys_id)

Hasil JSON

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

{
    "result": [
        {
            "sys_id": "SYS_ID",
            "name": "Example server"
        }
    ]
}

Pesan output

Tindakan List CMDB Records dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully listed CMDB records for the Class CLASS_NAME in ServiceNow. Action wasn't able to list CMDB records for the Class CLASS_NAME in ServiceNow. Reason: Class CLASS_NAME was not found in Service Now.".format(Class name)	Tindakan berhasil.
Error executing action "List CMDB Records". 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 CMDB Records:

Nama hasil skrip	Nilai
is_success	true atau false

Mencantumkan Komentar Rekaman

Gunakan tindakan List Record Comments untuk mencantumkan komentar yang terkait dengan data tabel tertentu di ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan List Record Comments memerlukan parameter berikut:

Parameter	Deskripsi
Table Name	Wajib. Nama tabel ServiceNow yang berisi data yang komentarnya akan dicantumkan (seperti incident).
Record Sys ID	Wajib. ID sistem (sys_id) data yang komentarnya akan dicantumkan.
Type	Wajib. Jenis komentar atau catatan yang akan diambil. Kemungkinan nilainya adalah sebagai berikut: Comment Work Note Nilai defaultnya adalah Comment.
Max Results To Return	Opsional. Jumlah maksimum komentar atau catatan kerja yang akan ditampilkan. Nilai defaultnya adalah 50.

Output tindakan

Tindakan List Record Comments 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 Record Comments:

{
    "sys_id": "SYS_ID",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "test",
    "sys_created_by": "admin",
    "element": "comments"
}

Pesan output

Tindakan List Record Comments dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow. No CONTENT_TYPE were found for TABLE_NAME with Sys ID SYS_ID in ServiceNow.	Tindakan berhasil.
Error executing action "List Record Comments". 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 Record Comments:

Nama hasil skrip	Nilai
is_success	true atau false

Mencantumkan Rekaman yang Terkait dengan Pengguna

Gunakan tindakan List Records Related To User untuk mencantumkan data dari tabel yang terkait dengan pengguna di ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Cantumkan Data yang Terkait dengan Pengguna memerlukan parameter berikut:

Parameter	Deskripsi
Table Name	Wajib. Nama tabel ServiceNow untuk menelusuri data terkait (seperti incident).
Usernames	Wajib. Daftar nama pengguna yang dipisahkan koma untuk mengambil data terkait.
Max Days Backwards	Wajib. Jumlah hari ke belakang dari tanggal saat ini untuk menelusuri data terkait. Nilai defaultnya adalah 1.
Max Records To Return	Opsional. Jumlah maksimum data yang akan ditampilkan untuk setiap pengguna. Nilai defaultnya adalah 50.

Output tindakan

Tindakan List Records Related To User 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 Records Related To User:

{
    "result": [
        {
            "parent": "",
            "made_sla": "true",
            "caused_by": "",
            "watch_list": "",
            "upon_reject": "cancel",
            "sys_updated_on": "2020-10-19 14:18:40",
            "child_incidents": "0",
            "hold_reason": "",
            "approval_history": "",
            "skills": "",
            "number": "INC0010008",
            "resolved_by": "",
            "sys_updated_by": "admin",
            "opened_by": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "user_input": "",
            "sys_created_on": "2020-10-19 14:18:40",
            "sys_domain": {
                "link": "https://example.service-now.com/api/now/table/sys_user_group/global",
                "value": "global"
            },
            "state": "1",
            "sys_created_by": "admin",
            "knowledge": "false",
            "order": "",
            "calendar_stc": "",
            "closed_at": "",
            "cmdb_ci": "",
            "delivery_plan": "",
            "contract": "",
            "impact": "3",
            "active": "true",
            "work_notes_list": "",
            "business_service": "",
            "priority": "5",
            "sys_domain_path": "/",
            "rfc": "",
            "time_worked": "",
            "expected_start": "",
            "opened_at": "2020-10-19 14:18:20",
            "business_duration": "",
            "group_list": "",
            "work_end": "",
            "caller_id": {
                "link": "https://example.service-now.com/api/now/table/sys_user/ID",
                "value": "ID"
            },
            "reopened_time": "",
            "resolved_at": "",
            "approval_set": "",
            "subcategory": "",
            "work_notes": "",
            "short_description": "TEST",
            "close_code": "",
            "correlation_display": "",
            "delivery_task": "",
            "work_start": "",
            "assignment_group": "",
            "additional_assignee_list": "",
            "business_stc": "",
            "description": "",
            "calendar_duration": "",
            "close_notes": "",
            "notify": "1",
            "service_offering": "",
            "sys_class_name": "incident",
            "closed_by": "",
            "follow_up": "",
            "parent_incident": "",
            "sys_id": "SYS_ID",
            "contact_type": "",
            "reopened_by": "",
            "incident_state": "1",
            "urgency": "3",
            "problem_id": "",
            "company": {
                "link": "https://example.service-now.com/api/now/table/core_company/ID",
                "value": "ID"
            },
            "reassignment_count": "0",
            "activity_due": "",
            "assigned_to": "",
            "severity": "3",
            "comments": "",
            "approval": "not requested",
            "sla_due": "",
         "comments_and_work_notes": "",
            "due_date": "",
            "sys_mod_count": "0",
            "reopen_count": "0",
            "sys_tags": "",
            "escalation": "0",
            "upon_approval": "proceed",
            "correlation_id": "",
            "location": "",
            "category": "inquiry"
        }
    ]
}

Pesan output

Tindakan List Records Related To User dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully retrieved related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST. Action wasn't able to retrieve related records from the table TABLE_NAME in ServiceNow for the following users: USERNAME_LIST. No related table records were retrieved for the provided users.	Tindakan berhasil.
Error executing action "List Records Related To User". 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 Records Related To User:

Nama hasil skrip	Nilai
is_success	true atau false

Ping

Gunakan tindakan Ping untuk menguji konektivitas ke ServiceNow.

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
is_success	true atau false

Perbarui Insiden

Gunakan tindakan Update Incident untuk memperbarui informasi insiden.

Tindakan ini tidak berjalan di entity Google SecOps.

Penting: Untuk menjalankan tindakan ini, Anda harus menetapkan peran sn_incident_write kepada pengguna di ServiceNow. Untuk mengetahui detail selengkapnya, buka Mengonfigurasi akses pengguna di ServiceNow.

Input tindakan

Tindakan Update Incident memerlukan parameter berikut:

Parameter	Deskripsi
Incident Number	Wajib. ID unik insiden ServiceNow yang akan diperbarui, dalam format INCINCIDENT_NUMBER.
Short Description	Opsional. Deskripsi singkat untuk insiden.
Impact	Opsional. Tingkat dampak untuk insiden. Penting: Anda harus menggunakan Nilai ServiceNow, misalnya, 1, bukan Label, misalnya, 1 - High. Kemungkinan nilainya adalah sebagai berikut: 1 untuk Tinggi 2 untuk Medium 3 untuk Rendah Nilai defaultnya adalah 1.
Urgency	Opsional. Tingkat urgensi insiden. Penting: Anda harus menggunakan Nilai ServiceNow (misalnya, 1), bukan Label (misalnya, 1 - High). Kemungkinan nilainya adalah sebagai berikut 1 untuk Tinggi 2 untuk Medium 3 untuk Rendah Nilai defaultnya adalah 1.
Category	Opsional. Kategori untuk insiden. Penting: Anda harus menggunakan Nilai ServiceNow, misalnya, database, bukan Label, misalnya, Database.
Assignment Group ID	Opsional. Nama lengkap grup yang akan ditugaskan untuk menangani insiden.
Assigned User ID	Opsional. Nama lengkap pengguna yang akan ditugaskan untuk menangani insiden.
Description	Opsional. Deskripsi insiden.
Incident State	Opsional. Nilai ServiceNow yang mendasari untuk status insiden (misalnya, 1 atau in_progress), bukan Label (misalnya, New atau In Progress).
Custom Fields	Opsional. String berformat JSON yang berisi nama kolom dan nilai yang sesuai untuk diperbarui (misalnya, {"location":"London", "category":"database"}). Anda dapat menggunakan parameter ini untuk mengubah kolom yang tidak ditentukan secara eksplisit sebagai input tindakan.

Output tindakan

Tindakan Update Incident 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 JSON

Contoh berikut menunjukkan output hasil JSON yang diterima saat menggunakan tindakan Update Incident:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": "2012",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010041",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "10",
    "notify": "1",
    "resolved_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": "2020-07-10 12:53:06",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "1",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "priority": "1",
    "state": "7",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 12:18:04",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": "sdf",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": "0",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": "Closed by Caller",
    "business_duration": "1970-01-01 00:00:00",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 13:13:57",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": "1970-01-01 00:35:02",
    "caller_id": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "active": "false",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": "2020-07-10 14:33:28",
    "severity": "3",
    "incident_state": "7",
    "resolved_at": "2020-07-10 12:53:06",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 12:18:04",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": "Closed/Resolved by Caller",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "1",
    "reopen_count": "0"
}

Hasil skrip

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

Nama hasil skrip	Nilai
incident_number	INCIDENT_NUMBER

Memperbarui Data

Gunakan tindakan Update Record untuk mengubah data yang ada milik berbagai tabel di ServiceNow.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Update Record memerlukan parameter berikut:

Parameter	Deskripsi
Table Name	Opsional. Nama tabel ServiceNow yang berisi data yang akan diperbarui (seperti incident).
Object Json Data	Wajib. Objek JSON yang berisi pasangan nilai kolom untuk diterapkan ke data (seperti {"short_description": "Updated description"}).
Record Sys ID	Wajib. ID sistem (sys_id) dari data tertentu yang akan diperbarui.

Output tindakan

Tindakan Update Record 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 Update Record:

{
    "sys_tags": " ",
    "user_input": " ",
    "calendar_stc": " ",
    "subcategory": " ",
    "watch_list": " ",
    "follow_up": " ",
    "made_sla": "true",
    "sys_created_by": "admin",
    "sla_due": " ",
    "number": "INC0010021",
    "group_list": " ",
    "reassignment_count": "0",
    "assigned_to": " ",
    "sys_mod_count": "0",
    "notify": "1",
    "resolved_by": " ",
    "upon_reject": "cancel",
    "additional_assignee_list": " ",
    "category": "inquiry",
    "closed_at": " ",
    "parent_incident": " ",
    "cmdb_ci": " ",
    "contact_type": " ",
    "impact": "3",
    "rfc": " ",
    "expected_start": " ",
    "knowledge": "false",
    "sys_updated_by": "admin",
    "caused_by": " ",
    "comments": " ",
    "closed_by": " ",
    "priority": "5",
    "state": "1",
    "sys_id": "SYS_ID",
    "opened_at": "2020-07-10 08:24:34",
    "child_incidents": "0",
    "work_notes": " ",
    "delivery_task": " ",
    "short_description": " ",
    "comments_and_work_notes": " ",
    "time_worked": " ",
    "upon_approval": "proceed",
    "company": " ",
    "business_stc": " ",
    "correlation_display": " ",
    "sys_class_name": "incident",
    "delivery_plan": " ",
    "escalation": "0",
    "description": " ",
    "parent": " ",
    "close_notes": " ",
    "business_duration": " ",
    "problem_id": " ",
    "sys_updated_on": "2020-07-10 08:24:34",
    "approval_history": " ",
    "approval_set": " ",
    "business_service": " ",
    "reopened_by": " ",
    "calendar_duration": " ",
    "caller_id": " ",
    "active": "true",
    "approval": "not requested",
    "service_offering": " ",
    "sys_domain_path": "/",
    "hold_reason": " ",
    "activity_due": " ",
    "severity": "3",
    "incident_state": "1",
    "resolved_at": " ",
    "location": " ",
    "due_date": " ",
    "work_start": " ",
    "work_end": " ",
    "work_notes_list": " ",
    "sys_created_on": "2020-07-10 08:24:34",
    "correlation_id": " ",
    "contract": " ",
    "reopened_time": " ",
    "opened_by": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user/ID",
        "value": "ID"
    },
    "close_code": " ",
    "assignment_group": " ",
    "sys_domain": {
        "link": "https://example.service-now.com/api/now/v1/table/sys_user_group/global",
        "value": "global"
    },
    "order": " ",
    "urgency": "3",
    "reopen_count": "0"
}

Hasil skrip

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

Nama hasil skrip	Nilai
record_sys_id	RECORD_SYS_ID

Tunggu Komentar

Gunakan tindakan Wait For Comments untuk menjeda eksekusi playbook hingga komentar atau catatan kerja ditambahkan ke data tabel tertentu di ServiceNow.

Catatan: Tindakan ini beroperasi secara asinkron. Anda harus menyesuaikan nilai waktu tunggu skrip di IDE Google SecOps jika waktu tunggu yang diharapkan untuk komentar melebihi waktu tunggu default.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Wait For Comments memerlukan parameter berikut:

Parameter	Deskripsi
Table Name	Wajib. Nama tabel ServiceNow yang berisi data yang akan ditunggu komentarnya (seperti incident).
Record Sys ID	Wajib. ID sistem (sys_id) dari data yang akan dipantau untuk komentar.
Type	Wajib. Jenis komentar atau catatan yang harus ditunggu oleh tindakan. Kemungkinan nilainya adalah sebagai berikut: Comment Work Note Nilai defaultnya adalah Comment.
Wait Mode	Wajib. Kondisi yang menentukan kapan tindakan berhenti menunggu dan dilanjutkan. Kemungkinan nilainya adalah sebagai berikut: Until Timeout: Tindakan ini akan menunggu selama seluruh periode waktu tunggu, lalu menampilkan semua komentar yang terkumpul. Until First Message: Tindakan ini akan menunggu hingga komentar atau catatan kerja baru pertama diposting setelah tindakan dimulai. Until Specific Text: Tindakan akan menunggu hingga komentar atau catatan kerja yang berisi teks yang ditentukan dalam Text diposting. Catatan: Jika dipilih, Anda juga harus menetapkan Text. Nilai defaultnya adalah Until Timeout.
Text	Opsional. String teks tertentu yang ditunggu oleh tindakan dalam komentar atau catatan kerja baru. Parameter ini hanya digunakan jika Until Specific Text dipilih untuk nilai Wait Mode.

Output tindakan

Tindakan Wait For Comments 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 Wait For Comments:

{
    "sys_id": "SYS_ID",
    "sys_created_on": "2021-09-03 10:29:48",
    "name": "incident",
    "element_id": "552c48888c033300964f4932b03eb092",
    "sys_tags": "",
    "value": "test",
    "sys_created_by": "admin",
    "element": "comments"
}

Pesan output

Tindakan Wait For Comments dapat menampilkan pesan output berikut:

Pesan output	Deskripsi pesan
Successfully returned CONTENT_TYPE related to TABLE_NAME with Sys ID SYS_ID in ServiceNow. No new CONTENT_TYPE were added during the timeframe of action execution to TABLE_NAME with Sys ID SYS_ID in ServiceNow.	Tindakan berhasil.
Error executing action "Wait For Comments". 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 Tunggu Komentar:

Nama hasil skrip	Nilai
is_success	true atau false

Menunggu Update Kolom

Gunakan tindakan Wait for Field Update untuk menjeda eksekusi playbook hingga kolom tertentu dalam data ServiceNow diperbarui ke salah satu nilai yang diharapkan.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Wait for Field Update memerlukan parameter berikut:

Parameter	Deskripsi
Table Name	Wajib. Nama tabel ServiceNow yang berisi data yang akan dipantau (seperti incident).
Record Sys ID	Wajib. ID sistem (sys_id) dari data yang akan dipantau untuk update kolom.
Field - Column Name	Wajib. Nama kolom (kolom) yang dipantau oleh tindakan untuk mengetahui adanya perubahan.
Field - Values	Wajib. Daftar nilai yang dipisahkan koma yang, jika ditemukan di kolom yang dipantau, akan menyebabkan tindakan berhenti menunggu dan melanjutkan (seperti In Progress,Resolved).

Output tindakan

Tindakan Wait for Field Update 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 Wait for Field Update:

Nama hasil skrip	Nilai
updated_field	UPDATED_FIELD

Menunggu Pembaruan Status

Gunakan tindakan Wait for Status Update untuk menjeda eksekusi playbook hingga status (keadaan) insiden ServiceNow tertentu diperbarui ke salah satu nilai yang diharapkan.

Tindakan ini tidak berjalan di entity Google SecOps.

Input tindakan

Tindakan Wait for Status Update memerlukan parameter berikut:

Parameter	Deskripsi
Incident Number	Wajib. ID unik insiden ServiceNow yang akan dipantau, dalam format INCINCIDENT_NUMBER.
Statuses	Wajib. Comma separated list status insiden yang, jika tercapai, akan menyebabkan tindakan berhenti menunggu dan melanjutkan (seperti In Progress,Resolved).

Output tindakan

Tindakan Wait for Status Update 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 Wait for Status Update:

Nama hasil skrip	Nilai
new_status	STATUS

Konektor

Untuk mempelajari lebih lanjut cara mengonfigurasi konektor di Google SecOps, lihat Menyerap data (konektor).

Catatan: Untuk mencegah kehilangan data, konektor menggunakan Perataan Peristiwa. Jika pemberitahuan mentah berisi daftar entitas (seperti beberapa alamat email, nama host, atau alamat IP), konektor akan otomatis meratakannya menjadi peristiwa yang terpisah dan unik.

Misalnya, satu pemberitahuan mentah yang berisi tiga alamat email berbeda diserap sebagai tiga peristiwa terpisah, yang masing-masing berisi satu alamat email yang berbeda.

Proses ini memastikan bahwa setiap entity diindeks dengan benar sebagai aset unik, sehingga dapat sepenuhnya ditelusuri dan ditindaklanjuti dalam playbook.

ServiceNow Connector

Gunakan ServiceNow Connector untuk mengambil insiden dari ServiceNow.

Catatan: Konektor ini mendukung proxy, daftar dinamis, dan daftar yang tidak diizinkan.

Menggunakan daftar kueri dinamis

Di ServiceNow Connector, daftar dinamis mengubah sysparm_query yang digunakan konektor untuk mengkueri ServiceNow. Hal ini memberikan kemampuan untuk memfilter data berdasarkan kolom yang didukung untuk jenis data.

Untuk menentukan filter, konfigurasikan setiap item daftar dinamis agar berisi satu pasangan nilai kolom dalam format berikut: FIELD_NAME=VALUE.

Misalnya: category=security.

Jika Use whitelist as a blacklist diaktifkan, konektor akan membalikkan logika kueri, sehingga menyebabkan daftar dinamis berfungsi sebagai daftar yang tidak diizinkan, bukan sebagai filter.

Input konektor

ServiceNow Connector memerlukan parameter berikut:

Parameter	Deskripsi
Product Field Name	Wajib. Nama kolom tempat nama produk disimpan. Nama produk terutama memengaruhi pemetaan. Untuk menyederhanakan dan meningkatkan proses pemetaan untuk konektor, nilai default di-resolve ke nilai pengganti yang direferensikan dari kode. Setiap input yang tidak valid untuk parameter ini akan di-resolve ke nilai penggantian secara default. Nilai defaultnya adalah Product Name.
Event Field Name	Wajib. Nama kolom yang menentukan nama peristiwa (subjenis). Nilai defaultnya adalah sys_class_name.
Rule Generator	Opsional. Nama kolom yang nilainya menentukan kueri atau set aturan tertentu yang akan diterapkan selama pengambilan data.
Api Root	Wajib. Root API instance ServiceNow. Nilai defaultnya adalah https://INSTANCE.service-now.com/api/now/v1/.
Username	Wajib. Nama pengguna akun ServiceNow.
Password	Wajib. Sandi akun ServiceNow.
Verify SSL	Opsional. Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke server ServiceNow. Diaktifkan secara default.
Use sys_domain Environment	Opsional. Jika dipilih, konektor akan menggunakan kolom sys_domain ServiceNow sebagai lingkungan untuk kasus yang diserap. Jika kolom ini tidak ada atau tidak tersedia, konektor akan ditetapkan secara default ke nilai yang ditentukan dalam parameter Environment.
Days Backwards	Opsional. Jumlah hari ke belakang dari waktu saat ini untuk mengambil data. Parameter ini digunakan untuk operasi konektor awal, atau sebagai nilai pengganti jika stempel waktu konektor sebelumnya telah habis masa berlakunya. Nilai defaultnya adalah 5.
Disable Overflow	Opsional. Jika dipilih, konektor akan mengabaikan mekanisme overflow Google SecOps.
Max Incidents Per Cycle	Opsional. Jumlah maksimum insiden yang akan diambil selama setiap iterasi konektor. Nilai defaultnya adalah 10.
Environments Whitelist	Opsional. Daftar lingkungan (domain) yang dipisahkan koma untuk diserap konektor ke Google SecOps, seperti env1,env2.
Use whitelist as a blacklist	Opsional. Jika dipilih, konektor akan menggunakan daftar dinamis sebagai daftar yang tidak diizinkan. Dinonaktifkan secara default.
PythonProcessTimeout	Wajib. Batas waktu tunggu, dalam detik, untuk proses Python yang menjalankan skrip saat ini. Nilai defaultnya adalah 60.
Incident Table	Opsional. Nama atau jalur tabel API yang akan digunakan untuk tindakan terkait insiden dan pengambilan data. Secara default, integrasi menggunakan jalur table/incident.
Client ID	Opsional. Client ID untuk integrasi ServiceNow, yang diperlukan untuk autentikasi OAuth 2.0 menggunakan kredensial klien. Anda dapat melakukan autentikasi menggunakan token refresh atau kredensial klien. Jika token refresh dan kredensial klien dikonfigurasi, integrasi akan menggunakan token refresh untuk autentikasi.
Client Secret	Opsional. Rahasia klien untuk integrasi ServiceNow, yang diperlukan untuk autentikasi OAuth 2.0 menggunakan kredensial klien. Anda dapat melakukan autentikasi menggunakan token refresh atau kredensial klien. Jika token refresh dan kredensial klien dikonfigurasi, integrasi akan menggunakan token refresh untuk autentikasi.
Refresh Token	Opsional. Token refresh untuk integrasi ServiceNow, yang diperlukan untuk autentikasi OAuth 2.0 menggunakan token refresh. Masa berlaku token refresh yang dikonfigurasi ini akan berakhir setiap 90 hari. Anda dapat melakukan autentikasi menggunakan token refresh atau kredensial klien. Jika token refresh dan kredensial klien dikonfigurasi, integrasi akan menggunakan token refresh untuk autentikasi.
Assignment Group	Opsional. Nama grup tugas yang datanya harus diserap oleh konektor.
Use Oauth Authentication	Opsional. Jika dipilih, integrasi akan menggunakan OAuth 2.0 untuk melakukan autentikasi. Autentikasi OAuth 2.0 memerlukan penetapan kredensial klien (Client ID dan Client Secret) atau Refresh Token. Dinonaktifkan secara default.
Server Time Zone	Opsional. Zona waktu yang dikonfigurasi di server ServiceNow (seperti UTC atau Asia/Jerusalem). Nilai defaultnya adalah UTC.
Table Name	Opsional. Nama tabel tempat mengambil data, seperti incident.
Event Name	Opsional. Nama peristiwa Google SecOps yang dibuat saat data diserap (seperti ServiceNowEvent).
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.
Get User Information	Opsional. Jika dipilih, konektor juga akan mengambil informasi tentang pengguna yang terkait dengan insiden tersebut. Dinonaktifkan secara default.

Pekerjaan

Untuk mengetahui informasi selengkapnya tentang tugas, lihat Mengonfigurasi tugas baru dan Penjadwalan lanjutan.

ServiceNow - Menyinkronkan Insiden yang Ditutup

Gunakan tugas ServiceNow - Sync Closed Incidents untuk menyinkronkan insiden ServiceNow yang ditutup dengan pemberitahuan dan kasus Google SecOps yang sesuai.

Tugas ini memproses insiden ServiceNow yang diserap sebagai pemberitahuan dan kasus yang berisi tag ServiceNow dan nilai konteks TICKET_ID dengan nomor insiden.

Parameter tugas

Tugas ServiceNow - Sync Closed Incidents memerlukan parameter berikut:

Parameter	Deskripsi
API Root	Wajib Root API instance ServiceNow. Default-nya adalah https://INSTANCE.service-now.com/api/now/v1/.
Username	Wajib Nama pengguna instance ServiceNow.
Password	Wajib Sandi instance ServiceNow.
Verify SSL	Opsional Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke server ServiceNow. Diaktifkan secara default.
Client ID	Opsional Client ID untuk integrasi ServiceNow, yang diperlukan untuk autentikasi OAuth 2.0 menggunakan kredensial klien. Anda dapat melakukan autentikasi menggunakan token refresh atau kredensial klien. Jika token refresh dan kredensial klien dikonfigurasi, integrasi akan menggunakan token refresh untuk autentikasi.
Client Secret	Opsional Rahasia klien untuk integrasi ServiceNow, yang diperlukan untuk autentikasi OAuth 2.0 menggunakan kredensial klien. Anda dapat melakukan autentikasi menggunakan token refresh atau kredensial klien. Jika token refresh dan kredensial klien dikonfigurasi, integrasi akan menggunakan token refresh untuk autentikasi.
Refresh Token	Opsional Token refresh untuk integrasi ServiceNow, yang diperlukan untuk autentikasi OAuth 2.0 menggunakan token refresh. Masa berlaku token refresh yang dikonfigurasi ini akan berakhir setiap 90 hari. Anda dapat melakukan autentikasi menggunakan token refresh atau kredensial klien. Jika token refresh dan kredensial klien dikonfigurasi, integrasi akan menggunakan token refresh untuk autentikasi.
Use OAuth Authentication	Opsional Jika dipilih, integrasi akan menggunakan OAuth 2.0 untuk melakukan autentikasi. Autentikasi OAuth 2.0 memerlukan penetapan kredensial klien (Client ID dan Client Secret) atau Refresh Token. Dinonaktifkan secara default.
Max Hours Backwards	Opsional Jumlah jam ke belakang dari waktu saat ini untuk menelusuri dan menyinkronkan insiden yang ditutup. Default-nya adalah 24.
Table Name	Wajib Nama tabel database yang akan ditelusuri untuk menemukan insiden yang ditutup (misalnya, incident).

ServiceNow - Menyinkronkan Insiden

Gunakan tugas ServiceNow - Sync Incidents untuk menyinkronkan kolom dan lampiran insiden ServiceNow dengan kasus dan pemberitahuan terkait di Google SecOps.

Untuk menjalankan tugas ini, pengguna integrasi ServiceNow harus memiliki peran ITIL (itil). Untuk mengetahui informasi selengkapnya, lihat Peran sistem dasar dalam dokumentasi ServiceNow.

Persyaratan pekerjaan

Agar tugas berfungsi dengan benar, pastikan hal berikut dikonfigurasi pada kasus atau pemberitahuan Google SecOps (bergantung pada parameter Sync Level):

• Tag: Kasus harus memiliki tag ServiceNow Incident Sync.
• Nilai konteks: Kasus atau pemberitahuan harus memiliki kunci konteks TICKET_ID yang berisi daftar nomor insiden ServiceNow yang dipisahkan koma (misalnya, INC0000050,INC0000051). Tetapkan nilai konteks TICKET_ID menggunakan tindakan Set Scope Context Value dari integrasi Siemplify Utilities.

Parameter tugas

Tugas ServiceNow - Sync Incidents memerlukan parameter berikut:

Parameter	Deskripsi
API Root	Wajib Root API instance ServiceNow. Default-nya adalah https://INSTANCE.service-now.com/api/now/v1/.
Username	Opsional Nama pengguna instance ServiceNow. Saat melakukan autentikasi menggunakan autentikasi sandi dasar, parameter ini diperlukan.
Password	Opsional Sandi instance ServiceNow. Saat melakukan autentikasi menggunakan autentikasi sandi dasar, parameter ini diperlukan.
Sync Level	Wajib Tingkat sinkronisasi data tugas. Nilai yang mungkin: Case, Alert. Jumlah defaultnya adalah Case
Max Hours Backwards	Wajib Jumlah jam maksimum yang dihitung mundur dari waktu saat ini untuk menelusuri kasus yang akan disinkronkan. Default-nya adalah 24.
Verify SSL	Opsional Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke server ServiceNow. Diaktifkan secara default.
Use OAuth Authentication	Opsional Jika dipilih, tugas akan menggunakan autentikasi OAuth, bukan autentikasi dasar. Jika dipilih, parameter Client ID, Client Secret, dan Refresh Token wajib diisi. Dinonaktifkan secara default.
Client ID	Opsional Client ID aplikasi ServiceNow. Wajib jika Use OAuth Authentication dipilih.
Client Secret	Opsional Rahasia Klien aplikasi ServiceNow. Wajib jika Use OAuth Authentication dipilih.
Refresh Token	Opsional Token refresh untuk aplikasi ServiceNow. Wajib jika Use OAuth Authentication dipilih.

Komentar Data Tabel Sinkronisasi

Gunakan tugas Sync Table Record Comments untuk menyinkronkan komentar antara data tabel ServiceNow dan kasus Google SecOps.

Parameter tugas

Tugas Sync Table Record Comments memerlukan parameter berikut:

Parameter	Deskripsi
API Root	Wajib Root API instance ServiceNow. Default-nya adalah https://INSTANCE.service-now.com/api/now/v1/.
Username	Wajib Nama pengguna instance ServiceNow.
Password	Wajib Sandi instance ServiceNow.
Verify SSL	Opsional Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke server ServiceNow. Diaktifkan secara default.
Client ID	Opsional Client ID untuk integrasi ServiceNow, yang diperlukan untuk autentikasi OAuth 2.0 menggunakan kredensial klien. Anda dapat melakukan autentikasi menggunakan token refresh atau kredensial klien. Jika token refresh dan kredensial klien dikonfigurasi, integrasi akan menggunakan token refresh untuk autentikasi.
Client Secret	Opsional Rahasia klien untuk integrasi ServiceNow, yang diperlukan untuk autentikasi OAuth 2.0 menggunakan kredensial klien. Anda dapat melakukan autentikasi menggunakan token refresh atau kredensial klien. Jika token refresh dan kredensial klien dikonfigurasi, integrasi akan menggunakan token refresh untuk autentikasi.
Refresh Token	Opsional Token refresh untuk integrasi ServiceNow, yang diperlukan untuk autentikasi OAuth 2.0 menggunakan token refresh. Masa berlaku token refresh yang dikonfigurasi ini akan berakhir setiap 90 hari. Anda dapat melakukan autentikasi menggunakan token refresh atau kredensial klien. Jika token refresh dan kredensial klien dikonfigurasi, integrasi akan menggunakan token refresh untuk autentikasi.
Use OAuth Authentication	Opsional Jika dipilih, integrasi akan menggunakan OAuth 2.0 untuk melakukan autentikasi. Autentikasi OAuth 2.0 memerlukan penetapan kredensial klien (Client ID dan Client Secret) atau Refresh Token. Dinonaktifkan secara default.
Table Name	Wajib Nama tabel ServiceNow untuk menelusuri data yang akan disinkronkan komentarnya (misalnya, incident).

Menyinkronkan komentar data tabel menurut tag

Gunakan tugas Sync Table Record Comments By Tag untuk menyinkronkan komentar antara data tabel ServiceNow dan kasus Google SecOps.

Persyaratan pekerjaan

Agar tugas berfungsi dengan benar, kasus Google SecOps harus memiliki dua tag berikut:

• ServiceNow TABLE_NAME (dengan <var class="readonly">TABLE_NAME</var> adalah nama tabel ServiceNow, seperti incident).
• ServiceNow TicketId: TICKET_ID (dengan <var class="readonly">TICKET_ID</var> adalah ID atau nomor sistem data yang sesuai).

Parameter tugas

Tugas Sync Table Record Comments By Tag memerlukan parameter berikut:

Parameter	Deskripsi
API Root	Wajib Root API instance ServiceNow. Default-nya adalah https://INSTANCE.service-now.com/api/now/v1/.
Username	Wajib Nama pengguna instance ServiceNow.
Password	Mandatory Sandi instance ServiceNow.
Table Name	Wajib Nama tabel database yang akan ditelusuri, seperti incident.
Verify SSL	Opsional Jika dipilih, integrasi akan memvalidasi sertifikat SSL saat terhubung ke server ServiceNow. Diaktifkan secara default.

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