Google menggunakan teknologi AI untuk menerjemahkan konten ke dalam bahasa pilihan Anda. Terjemahan AI mungkin mengandung kesalahan.

Mengintegrasikan Zendesk dengan Google SecOps

Dokumen ini menjelaskan cara mengintegrasikan Zendesk dengan Google Security Operations.

Kasus penggunaan

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

Mengotomatiskan pembuatan tiket insiden: Buat tiket Zendesk secara otomatis dari notifikasi keamanan untuk memastikan setiap insiden dilacak dan ditetapkan ke tim yang tepat.
Sederhanakan komunikasi analis: Tambahkan komentar dan catatan internal ke tiket langsung dari playbook agar pemangku kepentingan tetap mendapatkan informasi tanpa perlu keluar dari platform.
Standardisasi alur kerja respons: Terapkan makro Zendesk ke tiket untuk mengotomatiskan tindakan berulang dan memastikan penanganan yang konsisten terhadap masalah keamanan umum.
Lacak penyelesaian tiket: Ambil detail tiket dan pembaruan status secara berkala untuk menyinkronkan siklus proses insiden di kedua platform.
Menelusuri konteks historis: Buat kueri tiket yang ada berdasarkan kata kunci untuk menemukan insiden historis terkait dan mempercepat investigasi saat ini.

Sebelum memulai

Sebelum mengonfigurasi integrasi di Google SecOps, verifikasi persyaratan berikut di lingkungan Zendesk Anda:

Token API: Administrator harus membuat token API yang valid untuk mengautentikasi koneksi. Untuk mengetahui petunjuk mendetail, lihat Mengelola akses token API ke Zendesk API.
Izin akun: Pastikan akun yang digunakan untuk membuat token API memiliki izin yang memadai untuk membuat dan memperbarui tiket di grup target. API mewarisi izin pengguna yang melakukan autentikasi. Artinya, token API yang dibuat oleh administrator dibatasi oleh izin peran yang ditetapkan administrator tersebut.
Akses token: Aktifkan Akses Token di setelan Zendesk API Anda untuk mengizinkan integrasi berkomunikasi dengan Zendesk API.

Parameter integrasi

Integrasi Zendesk memerlukan parameter berikut:

Parameter Deskripsi

Parameter	Deskripsi
`Server Address`	Wajib. URL instance Zendesk Anda. Nilai defaultnya adalah `https://{subdomain}.zendesk.com`.
`User Email Address`	Wajib. Alamat email akun pengguna Zendesk yang digunakan untuk mengautentikasi koneksi.
`Api Token`	Wajib. Token API unik yang dibuat dalam setelan administrator Zendesk Anda.

Server Address

Wajib.

URL instance Zendesk Anda.

Nilai defaultnya adalah https://{subdomain}.zendesk.com.

User Email Address

Wajib.

Alamat email akun pengguna Zendesk yang digunakan untuk mengautentikasi koneksi.

Api Token

Wajib.

Token API unik yang dibuat dalam setelan administrator Zendesk Anda.

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.

Menambahkan Komentar ke Tiket

Menambahkan komentar ke tiket yang ada.

Parameter

Parameter	Jenis	Nilai Default	Deskripsi
ID tiket	String	T/A	Nomor tiket.
Isi Komentar	String	T/A	T/A
Nama Penulis	String	T/A	T/A
Internal Note	Boolean	T/A	T/A

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di semua entity.

Hasil Tindakan

Pengayaan Entity

T/A

Insight

T/A

Hasil Skrip

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

Hasil JSON

N/A

Menerapkan Makro pada Tiket

Menerapkan makro ke tiket.

Parameter

Parameter	Jenis	Nilai Default	Deskripsi
ID tiket	String	T/A	Nomor tiket.
Macro Title	String	T/A	T/A

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di semua entity.

Hasil Tindakan

Pengayaan Entity

T/A

Insight

T/A

Hasil Skrip

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

Hasil JSON

N/A

Buat Tiket

Membuat tiket dengan properti tertentu.

Batasan Umum

Email dengan karakter unicode tidak didukung oleh Zendesk API. Hal ini memengaruhi parameter "Email CC". Tindakan hanya akan mengabaikannya

Parameter

Parameter	Jenis	Nilai Default	Deskripsi
Subjek	String	T/A	T/A
Deskripsi	String	T/A	T/A
Pengguna yang Ditetapkan	String	T/A	Nama lengkap pengguna.
Grup Penetapan	String	T/A	Nama grup.
Prioritas	String	T/A	Prioritas akan berupa salah satu dari berikut: mendesak, tinggi, normal, atau rendah.
Jenis Tiket	String	T/A	Prioritas akan berupa salah satu dari berikut: mendesak, tinggi, normal, atau rendah.
Tag	String	T/A	T/A
Internal Note	Kotak centang	Tidak dicentang	Tentukan apakah komentar harus bersifat publik atau internal. Tidak dicentang berarti akan bersifat publik, dicentang berarti akan bersifat internal saja
CC Email	CSV	T/A	Tentukan daftar alamat email yang dipisahkan koma, yang juga akan menerima notifikasi pembuatan tiket. Catatan: maksimal 48 CC email dapat ditambahkan. Ini adalah batasan Zendesk.
Memvalidasi CC Email	Boolean	Dicentang	Jika diaktifkan, tindakan akan mencoba memeriksa apakah pengguna dengan email yang diberikan dalam parameter "Email CC" ada. Jika setidaknya satu pengguna tidak ada, tindakan akan gagal. Jika parameter ini dinonaktifkan, tindakan tidak akan melakukan pemeriksaan ini.

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di semua entity.

Hasil Tindakan

Pengayaan Entity

T/A

Insight

T/A

Hasil Skrip

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

Hasil JSON

N/A

Repositori Kasus

Jenis hasil	Nilai/Deskripsi	Jenis
Pesan output*	Jika "Validate Email CCs" diaktifkan dan setidaknya satu email tidak ditemukan (gagal): Error executing action "{action name}". Alasan: pengguna dengan email berikut tidak ditemukan: {entity.identifier}. Periksa ejaan atau nonaktifkan parameter "Validasi CC Email". jika setidaknya satu input bukan alamat email yang valid: Error executing action "{action name}". Alasan: pengguna dengan email berikut tidak ditemukan: {entity.identifier}. Periksa ejaan atau nonaktifkan parameter "Validasi CC Email".	Umum

Jenis hasil

Nilai/Deskripsi

Jenis

Pesan output*

Jika "Validate Email CCs" diaktifkan dan setidaknya satu email tidak ditemukan (gagal): Error executing action "{action name}". Alasan: pengguna dengan email berikut tidak ditemukan: {entity.identifier}. Periksa ejaan atau nonaktifkan parameter "Validasi CC Email".

jika setidaknya satu input bukan alamat email yang valid: Error executing action "{action name}". Alasan: pengguna dengan email berikut tidak ditemukan: {entity.identifier}. Periksa ejaan atau nonaktifkan parameter "Validasi CC Email".

Umum

Mendapatkan Detail Tiket

Mendapatkan detail tiket, komentar, dan lampiran berdasarkan ID tiket.

Parameter

Parameter	Jenis	Nilai Default	Deskripsi
ID tiket	String	T/A	ID tiket.

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di semua entity.

Hasil Tindakan

Pengayaan Entity

T/A

Insight

T/A

Hasil Skrip

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

Hasil JSON

{
   "Details":
      {
        "ticket":
           {
             "follower_ids": [],
             "via":
               {
                     "source":
                           {"to": {},
                            "from": {},
                            "rel": "None"},
                    "channel": "web"
                },
              "updated_at": "2019-02-03T10:08:00Z",
              "submitter_id": 360638872459,
              "assignee_id": 360638872459,
              "brand_id": 360000159559,
              "id": 2,
              "custom_fields": [],
              "satisfaction_rating": "None",
              "sharing_agreement_ids": [],
              "allow_attachments": "True",
              "collaborator_ids": [],
              "priority": "high",
              "subject": "Test",
              "type": "incident",
              "status": "open",
              "description": "Test Test Test",
              "tags": ["test"],
              "forum_topic_id": "None",
              "organization_id": 360018882419,
              "due_at": "None",
              "is_public": "True",
              "requester_id": 360638872459,
              "followup_ids": [],
              "recipient": "None",
              "problem_id": "None",
              "url": "https://siemplifyhelp.zendesk.com/api/v2/tickets/2.json", "fields": [],
              "created_at": "2019-02-03T10:08:00Z",
              "raw_subject": "Test",
              "email_cc_ids": [],
              "allow_channelback": "False",
              "has_incidents": "False",
              "group_id": 360000361099,
              "external_id": "None"
           }
       },
    "Comments":
       [{
          "body": "Test Test Test",
          "plain_body": "Test Test Test",
          "via":
           {
              "source":
                      {"to": {},
                       "from": {},
                       "rel": "None"},
              "channel": "web"
            },
          "attachments":
           [{
              "thumbnails": [],
              "url": "https://siemplifyhelp.zendesk.com/api/v2/attachments/360701661660.json",
              "file_name": "Siemplify 10 2018-12-11 (1).lic",
              "content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "height": "None",
               "width": "None",
               "mapped_content_url": "https://siemplifyhelp.zendesk.com/attachments/token/GeO6Xbc5I009xGRKLwWd7u7Qv/?name=Siemplify+10+2018-12-11+%281%29.lic",
               "content_type": "application/unknown",
               "inline": "False",
               "id": 360701661660,
               "size": 1272
            }],
          "audit_id": 393260420939,
          "created_at": "2019-02-03T10:08:00Z",
          "id": 393260420979,
          "author_id": 360638872459,
          "html_body": "<div> Test Test Test < br >< /div>",
          "type": "Comment",
          "public": "True",
          "metadata":
            {
               "system":
                  {
                     "latitude": 32.066599999999994,
                     "client": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/71.0.3578.98 Safari/537.36",
                      "ip_address": "1.1.1.1",
                      "location": "Tel Aviv, 05, Israel",
                      "longitude": 34.764999999999986
                   },
               "custom": {}
             }
         }],
     "Attachments": [{"test.txt": ""}]
 }

Ping

Menguji Konektivitas.

Parameter

T/A

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di semua entity.

Hasil Tindakan

Pengayaan Entity

T/A

Insight

T/A

Hasil Skrip

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

Hasil JSON

N/A

Telusuri Tiket

Menelusuri tiket berdasarkan kata kunci.

Parameter

Parameter	Jenis	Nilai Default	Deskripsi
Kueri Penelusuran	String	T/A	Konten kueri (contoh: type:ticket status:pending).

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di semua entity.

Hasil Tindakan

Pengayaan Entity

T/A

Insight

T/A

Hasil Skrip

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

Hasil JSON

N/A

Perbarui Tiket

Memperbarui detail tiket yang ada

Parameter

Parameter	Jenis	Nilai Default	Deskripsi
ID tiket	String	T/A	Nomor tiket.
Subjek	String	T/A	Subjek tiket.
Pengguna yang Ditetapkan	String	T/A	Nama lengkap pengguna.
Grup Penetapan	String	T/A	Nama grup.
Prioritas	String	T/A	Prioritas akan berupa salah satu dari berikut: mendesak, tinggi, normal, atau rendah.
Jenis Tiket	String	T/A	Jenis tiket akan berupa salah satu dari berikut: masalah, insiden, pertanyaan, atau tugas.
Tag	String	T/A	Tag yang akan ditambahkan ke tiket.
Status	String	T/A	Statusnya akan berupa salah satu dari berikut: baru, terbuka, menunggu keputusan, ditahan, diselesaikan, atau ditutup.
Komentar Tambahan	String	T/A	Jika Anda ingin menambahkan komentar ke tiket, tentukan teks yang ingin Anda tambahkan sebagai komentar di sini.
Internal Note	Kotak centang	Tidak dicentang	Tentukan apakah komentar harus bersifat publik atau internal. Tidak dicentang berarti akan bersifat publik, dicentang berarti akan bersifat internal saja

Kasus penggunaan

T/A

Dijalankan Pada

Tindakan ini berjalan di semua entity.

Hasil Tindakan

Pengayaan Entity

T/A

Insight

T/A

Hasil Skrip

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

Hasil JSON

N/A

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