Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

ConnectWise

Dokumen ini menjelaskan cara mengintegrasikan ConnectWise dengan Google Security Operations.

Mengonfigurasi Integrasi ConnectWise agar dapat berfungsi dengan Google Security Operations

Menyiapkan kunci publik dan pribadi di ConnectWise Manage

Untuk membuat integrasi antara ConnectWise Manage dan integrasi Google SecOps dengan ConnectWise Manage, Anda harus memberikan kunci API. Kunci API adalah kunci publik dan pribadi yang dibuat oleh ConnectWise Manage untuk akun integrasi.

Untuk membuat kunci API di ConnectWise Manage:

Di ConnectWise Manage, klik System > Members, lalu pilih anggota yang ada atau buat anggota baru. Pastikan anggota yang Anda pilih memiliki semua hak yang diperlukan untuk menyiapkan integrasi.
Di layar Member Maintenance, klik tab API Keys, lalu klik New Item.
Di kolom Deskripsi, masukkan deskripsi untuk kunci yang baru dibuat. Misalnya, Integrasi Google SecOps.
Klik Simpan untuk menyimpan item baru.

Kedua kunci API dibuat dan ditampilkan di kolom Kunci Publik dan Kunci Pribadi. Kunci pribadi hanya ditampilkan pada saat dibuat.

Mengonfigurasi integrasi ConnectWise di Google SecOps

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

Parameter integrasi

Gunakan parameter berikut untuk mengonfigurasi integrasi:

Nama Tampilan Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Root API	String	https://{CompanyURL}/v4_6_Release/apis/3.0/	Ya	Alamat untuk instance ConnectWise.
Nama Perusahaan	String	T/A	Ya
Kunci Publik	String	T/A	Ya
Kunci Pribadi	String	T/A	Ya
ID Klien	String	T/A	Ya	Client ID aplikasi ConnectWise.

Tindakan

Menambahkan Komentar ke Tiket

Deskripsi

Menambahkan komentar baru ke tiket di ConnectWise.

Parameter

Nama Parameter	Jenis	Nilai Default		Deskripsi
ID tiket	String	T/A	Ya	ID tiket ConnectWise. Contoh: 608718
Komentar	String	T/A	Ya	Konten komentar yang akan dilampirkan ke tiket.
Internal	Kotak centang	Tidak dicentang	Ya	Jika dicentang, akan menempatkan komentar di bagian internal.

Nama Parameter

Jenis

Nilai Default

Deskripsi

ID tiket

String

T/A

ID tiket ConnectWise.

Contoh: 608718

Komentar

String

T/A

Konten komentar yang akan dilampirkan ke tiket.

Internal

Kotak centang

Tidak dicentang

Jika dicentang, akan menempatkan komentar di bagian internal.

Terus Berjalan

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

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

Hasil JSON

N/A

Tutup Tiket

Deskripsi

Menutup tiket ConnectWise.

Parameter

Nama Parameter	Jenis	Nilai Default	Wajib	Deskripsi
ID tiket	String	T/A	Ya	ID tiket ConnectWise. Contoh: 608718.
Status Tutup Kustom	String	T/A	Tidak	Jika sistem tertentu menggunakan status tertutup kustom, misalnya Selesai.

Nama Parameter

Jenis

Nilai Default

Wajib

Deskripsi

ID tiket

String

T/A

ID tiket ConnectWise.

Contoh: 608718.

Status Tutup Kustom

String

T/A

Tidak

Jika sistem tertentu menggunakan status tertutup kustom, misalnya Selesai.

Terus Berjalan

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

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

Hasil JSON

N/A

Pengayaan Entity

T/A

Insight

T/A

Buat Tiket Pemberitahuan

Deskripsi

Buat tiket ConnectWise untuk setiap pemberitahuan Google SecOps baru.

Parameter

Nama Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Perusahaan	String	T/A	Ya	Nama perusahaan.
Papan	String	T/A	Ya	Nama papan.
Status	String	T/A	Ya	Contoh: Belum ditetapkan
Prioritas	String	T/A	Ya	Contoh: Prioritas 3 - Respons Normal
Deskripsi Awal	String	T/A	Ya	T/A
Nama Pemilik	String	T/A	Tidak	Nama anggota ConnectWise untuk menetapkan tiket ini. Contoh: connectwise_user_1.

Terus Berjalan

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

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

Hasil JSON

N/A

Buat Tiket

Deskripsi

Buat tiket ConnectWise.

Parameter

Nama Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Perusahaan	String	T/A	Ya	Nama perusahaan.
Papan	String	T/A	Ya	Nama Jamboard
Ringkasan	String	T/A	Ya	T/A
Status	String	T/A	Ya	Misalnya, Belum ditetapkan.
Prioritas	String	T/A	Ya	Contoh: Prioritas 3 - Respons Normal
Nama Pemilik	String	T/A	Tidak	Nama anggota ConnectWise untuk menetapkan tiket ini. Contoh: connectwise_user_1

Terus Berjalan

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

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

Hasil JSON

N/A

Hapus Tiket

Deskripsi

Menghapus tiket ConnectWise berdasarkan ID.

Parameter

Nama Parameter	Jenis	Nilai Default	Wajib	Deskripsi
ID tiket	String	T/A	Ya	ID tiket yang akan dihapus. Contoh: 607167

Nama Parameter

Jenis

Nilai Default

Wajib

Deskripsi

ID tiket

String

T/A

ID tiket yang akan dihapus.

Contoh: 607167

Terus Berjalan

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

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

Hasil JSON

N/A

Dapatkan Tiket

Deskripsi

Mendapatkan tiket ConnectWise menurut ID dan melampirkan JSON tiket sebagai file.

Parameter

Nama Parameter	Jenis	Nilai Default	Wajib	Deskripsi
ID tiket	String	T/A	Ya	Mengambil tiket berdasarkan ID.

Terus Berjalan

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

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

Hasil JSON

{
  "773256":
   {
     "customerUpdatedFlag": false,
     "estimatedTimeCost": 0.0,
     "recordType": "ServiceTicket",
     "siteName": "Main",
     "billTime": "NoDefault",
     "site":
       {
         "_info":
           {
             "site_href": "",
             "mobileGuid": "c5e7be2e-af3b-461f-a637-1b3e7e24bdc6"
           },
         "id": 23188, "name": "Main"
        },
     "currency":
       {
         "symbol": "$",
         "isoCode": "USD",
         "_info": {
                   "currency_href": ""
                   },
         "name": "US Dollars", "id": 7
        },
     "estimatedProductCost": 0.0,
     "estimatedExpenseRevenue": 0.0,
     "contactName": "user name",
     "addressLine1": "110 Fifth Avenue ",
     "billingMethod": "ActualRates",
     "id": 773256,
     "impact": "Medium",
     "city": "New York",
     "billProducts": "NoDefault",
     "businessUnitId": 20,
     "zip": "10011",
     "estimatedExpenseCost": 0.0,
     "mobileGuid": "f7b5a0eb-6038-4e14-a661-05c393917841",
     "closedFlag": false,
     "enteredBy": "Siemplify",
     "priority":
        {
          "sort": 6,
          "_info":
             {
               "image_href": "",
               "priority_href": ""
             },
          "id": 4,
          "name": "Priority 3 - Normal Response"
         },
     "source":
         {
           "_info":
             {
                "source_href": ""
              },
           "id": 2,
           "name": "Customer Phone Call"
          },
      "automaticEmailCcFlag": false,
      "board":
         {
           "_info":
             {
                "board_href": ""
             },
          "id": 70,
          "name": "Siemplify - T&M"
          },
     "customFields":
        [{
           "numberOfDecimals": 0,
           "caption": "2nd Shift",
           "type": "Checkbox",
           "id": 20,
           "entryMethod": "EntryField"
         },
         {
            "numberOfDecimals": 0,
            "caption": "3rd Shift",
            "type": "Checkbox",
            "id": 21,
            "entryMethod": "EntryField"
           },
          {
            "numberOfDecimals": 0,
            "caption": "Huddle Rvw",
            "type": "Checkbox",
            "id": 22,
            "entryMethod": "EntryField"
           }],
     "contactEmailAddress": "john_doe@example.com",
     "Status":
          {
            "_info": {"status_href": ""},
            "id": 1351,
            "name": "Unassigned"
           },
     "contactPhoneNumber": "(800) 555‑0175",
     "dateResponded": "2019-01-17T09:21:03Z",
     "isInSla": false,
     "company":
           {
             "_info":
                 {"mobileGuid": "42fcabed-a0f6-4171-bd7a-ca563ba45f7c",
                  "company_href": ""},
             "identifier": "Siemplify",
             "id": 18304,
             "name": "Siemplify"
           },
     "automaticEmailContactFlag": false,
     "hasChildTicket": false,
     "billExpenses": "NoDefault",
     "estimatedTimeRevenue": 0.0,
     "locationId": 119,
     "estimatedProductRevenue": 0.0,
     "automaticEmailResourceFlag": false,
     "dateEntered": "2019-01-17T09:21:03Z",
     "approved": true,
     "severity": "Medium",
     "resolveMinutes": 0,
     "serviceLocation":
           {
              "_info":
                   {"location_href": ""},
              "id": 6,
              "name": "Remote"
            },
     "resPlanMinutes": 0,
     "stateIdentifier": "NY",
     "dateResplan": "2019-01-17T09:21:03Z",
     "subBillingMethod": "ActualRates",
     "Country":
           {
              "_info":
                   {"country_href": ""},
              "id": 1,
              "name": "United States"
            },
     "respondMinutes": 0,
     "allowAllClientsPortalView": false,
     "hasMergedChildTicketFlag": false,
     "summary": "TikcetApiTest",
     "contact":
           {
             "_info":
                  {"contact_href": "",
                   "mobileGuid": "c86377ec-7726-4057-aca2-e992b550140f"
                  },
            "id": 59249,
            "name": "user name"
            },
     "team":
           {
             "_info":
                  {"team_href": ""},
             "id": 78,
             "name": "Siemplify"
           },
     "addressLine2": "5th Floor",
     "_info":
           {
             "configurations_href": "",
             "tasks_href": "",
             "updatedBy": "Siemplify",
             "expenseEntries_href": "",
             "lastUpdated": "2019-01-17T09:21:03Z",
             "products_href": "",
             "activities_href": "",
             "Timeentries_href":"",
             "notes_href": "",
             "documents_href": "",
             "scheduleentries_href": ""
            }
     }
}

Ping

Deskripsi

Uji Konektivitas.

Parameter

T/A

Terus Berjalan

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

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

Hasil JSON

N/A

Perbarui Tiket

Deskripsi

Perbarui detail tiket di ConnectWise.

Parameter

Nama Parameter	Jenis	Nilai Default	Wajib	Deskripsi
Parameter	Jenis	Nilai Default	Wajib Diisi	Deskripsi
ID tiket	String	T/A	Ya	ID tiket yang akan diperbarui. Contoh: 609620
Ringkasan	String	T/A	Tidak	Ringkasan yang diperbarui.
Nama Jenis	String	T/A	Tidak	Contoh: Aplikasi
Nama SubType	String	T/A	Tidak	Contoh: Adobe
Nama Item	String	T/A	Tidak	Contoh: Pengembangan
Status	String	T/A	Tidak	Status tiket baru. Contoh: `In Progress (plan of action)`

Terus Berjalan

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

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

Hasil JSON

N/A

Menambahkan Lampiran ke Tiket

Deskripsi

Tambahkan lampiran ke tiket di ConnectWise.

Parameter

Nama Parameter	Jenis	Nilai Default	Wajib	Deskripsi
ID tiket	String	T/A	Ya	Tentukan ID tiket yang akan ditambahkan dokumen.
File Berenkode Base64	String	T/A	Ya	Tentukan file berenkode base64 yang perlu ditambahkan sebagai lampiran.
Nama file	String	{filename}.{extension}	Ya	Tentukan nama file di belakang lampiran. Nilai ini juga digunakan sebagai judul. Catatan: Tindakan harus memberikan ekstensi yang benar untuk file.
Tampilkan Di Portal Pelanggan	Kotak centang	Dicentang	Tidak	Jika diaktifkan, lampiran akan ditampilkan di portal pelanggan.
Izinkan Update Khusus Pemilik	Kotak centang	Dicentang	Tidak	Jika diaktifkan, tindakan ini hanya mengizinkan pemilik untuk memperbarui lampiran.

Terus Berjalan

Tindakan ini dijalankan di semua entity.

Hasil Tindakan

Hasil Skrip

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

Hasil JSON

{
    "id": 280,
    "title": "QWEqqqq",
    "fileName": "s.json",
    "serverFileName": "24e7db8d-41b5-4bd0-9db3-a60d46143afe.json",
    "owner": "Admin1",
    "linkFlag": false,
    "imageFlag": false,
    "publicFlag": false,
    "htmlTemplateFlag": false,
    "readOnlyFlag": true,
    "size": 22131,
    "urlFlag": false,
    "guid": "b9fc3fc6-f368-40bb-bc06-233f4d6a299c",
    "_info": {
        "lastUpdated": "2022-05-10T14:02:23Z",
        "updatedBy": "Admin1"
    }
}

Repositori Kasus

Jenis Hasil	Nilai / Deskripsi	Jenis
Pesan output*	Tindakan tidak boleh gagal atau menghentikan eksekusi playbook: Jika kode status 201 dilaporkan (is_success=true): "Successfully added a file as attachment to ticket {ticket_id} in ConnectWise." Tindakan akan gagal dan menghentikan eksekusi playbook: Jika error kritis dilaporkan: "Error executing action "Add Attachment To Ticket". Reason: {0}''.format(error.Stacktrace)." Jika kode status 400 dilaporkan: "Error executing action "Add Attachment To Ticket". Alasan: {errors/message}.'' Jika format "Nama file" yang tidak valid diberikan: "Error executing action "Add Attachment To Ticket". Alasan: Nilai "Nama file" tidak mengikuti format yang diperlukan. Format: {filename}.{extension}.''	Umum

Jenis Hasil

Nilai / Deskripsi

Jenis

Pesan output*

Tindakan tidak boleh gagal atau menghentikan eksekusi playbook:

Jika kode status 201 dilaporkan (is_success=true): "Successfully added a file as attachment to ticket {ticket_id} in ConnectWise."

Tindakan akan gagal dan menghentikan eksekusi playbook:

Jika error kritis dilaporkan: "Error executing action "Add Attachment To Ticket". Reason: {0}''.format(error.Stacktrace)."

Jika kode status 400 dilaporkan: "Error executing action "Add Attachment To Ticket". Alasan: {errors/message}.''

Jika format "Nama file" yang tidak valid diberikan: "Error executing action "Add Attachment To Ticket". Alasan: Nilai "Nama file" tidak mengikuti format yang diperlukan. Format: {filename}.{extension}.''

Umum

Pekerjaan

Menyinkronkan Tiket yang Ditutup dan Dihapus

Deskripsi

Menyinkronkan tiket yang ditutup di ConnectWise dan pemberitahuan yang diabaikan di Google SecOps.

Parameter

Nama Parameter	Jenis	Nilai Default	Deskripsi
Root API	String	T/A	T/A
Nama Perusahaan	String	T/A	T/A
Kunci Publik API	String	T/A	T/A
Kunci Pribadi API	String	T/A	T/A
Nama Skrip	String	T/A	T/A

Menyinkronkan Komentar

Deskripsi

Menyinkronkan komentar antara kasus Google SecOps dan tiket ConnectWise.

Parameter

Nama Parameter	Jenis	Nilai Default	Deskripsi
Root API	String	https://<Nama Host>/v4_6_Release/apis/3.0/	T/A
Nama Perusahaan	String	T/A	T/A
Kunci Publik API	String	T/A	T/A
Kunci Pribadi API	String	T/A	T/A
Nama Skrip	String	T/A	T/A

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