ConnectWise

Versione integrazione: 17.0

Configura l'integrazione di ConnectWise in modo che funzioni con Google Security Operations

Configurare le chiavi pubbliche e private in ConnectWise Manage

Per creare un'integrazione tra ConnectWise Manage e Google SecOps con ConnectWise Manage, devi fornire le chiavi API. Le chiavi API sono chiavi pubbliche e private generate da ConnectWise Manage per l'account di integrazione.

Per creare chiavi API in ConnectWise Manage:

  1. In ConnectWise Manage, fai clic su System > Members e seleziona un membro esistente o creane uno nuovo. Assicurati che il membro selezionato disponga di tutti i diritti necessari per configurare l'integrazione.
  2. Nella schermata Manutenzione membri, fai clic sulla scheda Chiavi API, quindi su Nuovo elemento.
  3. Nel campo Descrizione, inserisci la descrizione delle chiavi appena create. Ad esempio, integrazione di Google SecOps.
  4. Fai clic su Salva per salvare il nuovo elemento.

Le due chiavi API vengono generate e visualizzate nei campi Chiave pubblica e Chiave privata. La chiave privata viene visualizzata solo al momento della creazione.

Configura l'integrazione di ConnectWise in Google SecOps

Per istruzioni dettagliate su come configurare un'integrazione in Google SecOps, vedi Configurare le integrazioni.

Parametri di integrazione

Utilizza i seguenti parametri per configurare l'integrazione:

Nome visualizzato del parametro Tipo Valore predefinito È obbligatorio Descrizione
Radice API Stringa https://{CompanyURL}/v4_6_Release/apis/3.0/ Sì Indirizzo dell'istanza ConnectWise.
Nome azienda Stringa N/D Sì
Chiave pubblica Stringa N/D Sì
Chiave privata Stringa N/D Sì
ID client Stringa N/D Sì ID client dell'applicazione ConnectWise.

Azioni

Aggiungere un commento al ticket

Descrizione

Aggiungi un nuovo commento a un ticket in ConnectWise.

Parametri

Nome parametro Tipo Valore predefinito Descrizione
ID ticket Stringa N/D Sì

ID ticket ConnectWise.

Esempio: 608718
Commento Stringa N/D Sì Contenuto del commento da allegare a un ticket.
Interno Casella di controllo Deselezionata Sì Se selezionata, inserisce il commento nella sezione interna.

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
ticket_id N/D N/D
Risultato JSON
N/A

Chiudi ticket

Descrizione

Chiudere un ticket ConnectWise.

Parametri

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
ID ticket Stringa N/D Sì

ID ticket ConnectWise.

Esempio: 608718.
Stato di chiusura personalizzato Stringa N/D No Se il sistema specifico utilizza uno stato chiuso personalizzato, ad esempio Completato.

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Risultati script
Nome del risultato dello script Opzioni di valore Esempio
ticket_id Vero/Falso ticket_id:False
Risultato JSON
N/A
Arricchimento delle entità

N/D

Approfondimenti

N/D

Crea ticket avvisi

Descrizione

Crea un ticket ConnectWise per ogni nuovo avviso Google SecOps.

Parametri

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
Società Stringa N/D Sì Nome dell'azienda.
Bacheca Stringa N/D Sì Nome della scheda.
Stato Stringa N/D Sì Esempio: Non assegnato
Priorità Stringa N/D Sì Esempio: priorità 3 - Risposta normale
Descrizione iniziale Stringa N/D Sì N/D
Nome proprietario Stringa N/D No

Nome del membro di ConnectWise a cui assegnare questo ticket.

Esempio: connectwise_user_1.

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
ticket_id N/D N/D
Risultato JSON
N/A

Crea ticket

Descrizione

Crea un ticket ConnectWise.

Parametri

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
Società Stringa N/D Sì Nome dell'azienda.
Bacheca Stringa N/D Sì Nome lavagna
Riepilogo Stringa N/D Sì N/D
Stato Stringa N/D Sì ad es. Non assegnata.
Priorità Stringa N/D Sì Esempio: priorità 3 - Risposta normale
Nome proprietario Stringa N/D No Nome del membro di ConnectWise a cui assegnare questo ticket. Esempio: connectwise_user_1

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
ticket_id Vero/Falso ticket_id:False
Risultato JSON
N/A

Elimina biglietto

Descrizione

Elimina un ticket ConnectWise in base all'ID.

Parametri

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
ID ticket Stringa N/D Sì

L'ID del ticket da eliminare.

Esempio: 607167

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
is_success Vero/Falso is_success:False
Risultato JSON
N/A

Ottieni biglietto

Descrizione

Recupera un ticket ConnectWise per ID e allega il JSON del ticket come file.

Parametri

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
ID ticket Stringa N/D Sì Recupera un ticket in base all'ID.

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
ticket_json N/D N/D
Risultato 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": ""
            }
     }
}

Dindin

Descrizione

Testa la connettività.

Parametri

N/D

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
is_success Vero/Falso is_success:False
Risultato JSON
N/A

Aggiorna biglietto

Descrizione

Aggiorna i dettagli del ticket in ConnectWise.

Parametri

Nome parametro Tipo Valore predefinito È obbligatorio Descrizione
Parametro Tipo Valore predefinito È obbligatorio Descrizione
ID ticket Stringa N/D Sì

L'ID del ticket da aggiornare.

Esempio: 609620
Riepilogo Stringa N/D No Riepilogo aggiornato.
Digita nome Stringa N/D No Esempio: Application
Nome sottotipo Stringa N/D No Esempio: Adobe
Nome elemento Stringa N/D No Esempio: Sviluppo
Stato Stringa N/D No

Nuovo stato del ticket.

Esempio: In Progress (plan of action)

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
ticket_id Vero/Falso ticket_id:False
Risultato JSON
N/A

Aggiungere un allegato al ticket

Descrizione

Aggiungi un allegato al ticket in ConnectWise.

Parametri

Nome parametri Tipo Valore predefinito È obbligatorio Descrizione
ID ticket Stringa N/D Sì Specifica l'ID della richiesta a cui deve essere aggiunto il documento.
File con codifica Base64 Stringa N/D Sì Specifica il file con codifica base64 da aggiungere come allegato.
Nome del file Stringa {filename}.{extension} Sì

Specifica il nome del file dietro l'allegato. Questo valore viene utilizzato anche come titolo.

Nota:l'azione deve fornire l'estensione corretta per il file.
Mostra nel portale clienti Casella di controllo Selezionata No Se attivato, l'allegato viene visualizzato nel portale clienti.
Consenti aggiornamento solo al proprietario Casella di controllo Selezionata No Se abilitata, l'azione consente solo al proprietario di aggiornare l'allegato.

Run On

Questa azione viene eseguita su tutte le entità.

Risultati dell'azione

Risultato script
Nome del risultato dello script Opzioni di valore Esempio
is_success Vero/Falso is_success:False
Risultato 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"
    }
}
Bacheca casi
Tipo di risultato Valore / Descrizione Tipo
Messaggio di output*

L'azione non deve non riuscire né interrompere l'esecuzione di un playbook:

Se viene segnalato il codice di stato 201 (is_success=true): "Successfully added a file as attachment to ticket {ticket_id} in ConnectWise." (È stato aggiunto correttamente un file come allegato al ticket {ticket_id} in ConnectWise.)

L'azione deve non riuscire e interrompere l'esecuzione di un playbook:

Se viene segnalato un errore critico: "Errore durante l'esecuzione dell'azione "Aggiungi allegato al ticket". Motivo: {0}''.format(error.Stacktrace)."

Se viene segnalato il codice di stato 400: "Errore durante l'esecuzione dell'azione "Aggiungi allegato al ticket". Motivo: {errors/message}.''

Se viene fornito un formato "Nome file" non valido: "Errore durante l'esecuzione dell'azione "Aggiungi allegato al ticket". Motivo: il valore "Nome file" non segue il formato necessario. Formato: {filename}.{extension}.''

 Generale

Job

Sincronizzare i ticket chiusi e ignorati

Descrizione

Sincronizza i ticket chiusi in ConnectWise e gli avvisi ignorati in Google SecOps.

Parametri

Nome parametro Tipo Valore predefinito Descrizione
Root API Stringa N/D N/D
Nome azienda Stringa N/D N/D
Chiave pubblica API Stringa N/D N/D
Chiave privata API Stringa N/D N/D
Nome script Stringa N/D N/D

Sincronizzare i commenti

Descrizione

Sincronizza i commenti tra i casi di Google SecOps e i ticket ConnectWise.

Parametri

Nome parametro Tipo Valore predefinito Descrizione
Root API Stringa https://<Host Name>/v4_6_Release/apis/3.0/ N/D
Nome azienda Stringa N/D N/D
Chiave pubblica API Stringa N/D N/D
Chiave privata API Stringa N/D N/D
Nome script Stringa N/D N/D

Hai bisogno di ulteriore assistenza? Ricevi risposte dai membri della community e dai professionisti di Google SecOps.