Diese Seite wurde von der Cloud Translation API übersetzt.

ConnectWise

Integrationsversion: 17.0

ConnectWise-Integration für die Verwendung mit Google Security Operations konfigurieren

Öffentliche und private Schlüssel in ConnectWise Manage einrichten

Wenn Sie eine Integration zwischen ConnectWise Manage und Google SecOps erstellen möchten, müssen Sie API-Schlüssel angeben. API-Schlüssel sind öffentliche und private Schlüssel, die von ConnectWise Manage für das Integrationskonto generiert werden.

So erstellen Sie API-Schlüssel in ConnectWise Manage:

Klicken Sie in ConnectWise Manage auf System > Members (System > Mitglieder) und wählen Sie entweder ein vorhandenes Mitglied aus oder erstellen Sie ein neues. Prüfen Sie, ob das ausgewählte Mitglied alle erforderlichen Rechte zum Einrichten der Integration hat.
Klicken Sie auf dem Bildschirm „Member Maintenance“ (Mitgliederverwaltung) auf den Tab API Keys (API-Schlüssel) und dann auf New Item (Neues Element).
Geben Sie im Feld Beschreibung die Beschreibung für die neu erstellten Schlüssel ein. Ein Beispiel ist die Google SecOps-Integration.
Klicken Sie auf Speichern, um das neue Element zu speichern.

Die beiden API-Schlüssel werden generiert und in den Feldern „Öffentlicher Schlüssel“ und „Privater Schlüssel“ angezeigt. Der private Schlüssel wird nur bei der Erstellung angezeigt.

ConnectWise-Integration in Google SecOps konfigurieren

Eine detaillierte Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Integrationsparameter

Verwenden Sie die folgenden Parameter, um die Integration zu konfigurieren:

Anzeigename des Parameters	Typ	Standardwert	Ist obligatorisch	Beschreibung
API-Stamm	String	https://{CompanyURL}/v4_6_Release/apis/3.0/	Ja	Adresse für die ConnectWise-Instanz.
Name des Unternehmens	String	–	Ja
Öffentlicher Schlüssel	String	–	Ja
Privater Schlüssel	String	–	Ja
Client-ID	String	–	Ja	Client-ID der ConnectWise-Anwendung.

Aktionen

Kommentar zum Ticket hinzufügen

Beschreibung

Fügt einem Ticket in ConnectWise einen neuen Kommentar hinzu.

Parameter

Parametername	Typ	Standardwert		Beschreibung
Ticket-ID	String	–	Ja	ConnectWise-Ticket-ID. Beispiel: 608718
Kommentar	String	–	Ja	Kommentarinhalte, die an ein Ticket angehängt werden sollen.
Intern	Kästchen	Deaktiviert	Ja	Bei aktivierter Option wird der Kommentar in den internen Bereich verschoben.

Parametername

Typ

Standardwert

Beschreibung

Ticket-ID

String

–

ConnectWise-Ticket-ID.

Beispiel: 608718

Kommentar

String

–

Kommentarinhalte, die an ein Ticket angehängt werden sollen.

Intern

Kästchen

Deaktiviert

Bei aktivierter Option wird der Kommentar in den internen Bereich verschoben.

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
ticket_id	–	–

JSON-Ergebnis

N/A

Ticket schließen

Beschreibung

ConnectWise-Ticket schließen

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Ticket-ID	String	–	Ja	ConnectWise-Ticket-ID. Beispiel: 608718.
Benutzerdefinierter Schließstatus	String	–	Nein	Wenn das jeweilige System einen benutzerdefinierten geschlossenen Status verwendet, z. B. „Abgeschlossen“.

Parametername

Typ

Standardwert

Ist obligatorisch

Beschreibung

Ticket-ID

String

–

ConnectWise-Ticket-ID.

Beispiel: 608718.

Benutzerdefinierter Schließstatus

String

–

Nein

Wenn das jeweilige System einen benutzerdefinierten geschlossenen Status verwendet, z. B. „Abgeschlossen“.

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnisse

Name des Scriptergebnisses	Wertoptionen	Beispiel
ticket_id	Wahr/falsch	ticket_id:False

JSON-Ergebnis

N/A

Entitätsanreicherung

–

Statistiken

–

Ticket für Benachrichtigungen erstellen

Beschreibung

Erstellen Sie für jede neue Google SecOps-Benachrichtigung ein ConnectWise-Ticket.

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Unternehmen	String	–	Ja	Unternehmensname
Brettspiele	String	–	Ja	Name des Boards.
Status	String	–	Ja	Beispiel: Nicht zugewiesen
Priorität	String	–	Ja	Beispiel: Priorität 3 – Normale Antwort
Erste Beschreibung	String	–	Ja	–
Name des Eigentümers	String	–	Nein	Der Name des ConnectWise-Mitglieds, dem dieses Ticket zugewiesen werden soll. Beispiel: connectwise_user_1.

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
ticket_id	–	–

JSON-Ergebnis

N/A

Ticket erstellen

Beschreibung

ConnectWise-Ticket erstellen

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Unternehmen	String	–	Ja	Unternehmensname
Brettspiele	String	–	Ja	Name des Boards
Zusammenfassung	String	–	Ja	–
Status	String	–	Ja	z.B. „Nicht zugewiesen“.
Priorität	String	–	Ja	Beispiel: Priorität 3 – Normale Antwort
Name des Eigentümers	String	–	Nein	Der Name des ConnectWise-Mitglieds, dem dieses Ticket zugewiesen werden soll. Beispiel: connectwise_user_1

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
ticket_id	Wahr/falsch	ticket_id:False

JSON-Ergebnis

N/A

Ticket löschen

Beschreibung

ConnectWise-Ticket anhand der ID löschen

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Ticket-ID	String	–	Ja	Die ID des zu löschenden Tickets. Beispiel: 607167

Parametername

Typ

Standardwert

Ist obligatorisch

Beschreibung

Ticket-ID

String

–

Die ID des zu löschenden Tickets.

Beispiel: 607167

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_success	Wahr/falsch	is_success:False

JSON-Ergebnis

N/A

Ticket erhalten

Beschreibung

Rufen Sie ein ConnectWise-Ticket anhand der ID ab und hängen Sie das Ticket-JSON als Datei an.

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Ticket-ID	String	–	Ja	Ein Ticket nach ID abrufen.

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
ticket_json	–	–

JSON-Ergebnis

{
  "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

Beschreibung

Verbindung testen

Parameter

–

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_success	Wahr/falsch	is_success:False

JSON-Ergebnis

N/A

Ticket aktualisieren

Beschreibung

Aktualisieren Sie die Ticketdetails in ConnectWise.

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Parameter	Typ	Standardwert	Pflichtfeld	Beschreibung
Ticket-ID	String	–	Ja	Die ID des zu aktualisierenden Tickets. Beispiel: 609620
Zusammenfassung	String	–	Nein	Aktualisierte Zusammenfassung.
Typname	String	–	Nein	Beispiel: Anwendung
Name des Untertyps	String	–	Nein	Beispiel: Adobe
Bezeichnung	String	–	Nein	Beispiel: Entwicklung
Status	String	–	Nein	Neuer Ticketstatus. Beispiel: `In Progress (plan of action)`

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
ticket_id	Wahr/falsch	ticket_id:False

JSON-Ergebnis

N/A

Anhang an Ticket anhängen

Beschreibung

Fügen Sie dem Ticket in ConnectWise einen Anhang hinzu.

Parameter

Parametername	Typ	Standardwert	Ist obligatorisch	Beschreibung
Ticket-ID	String	–	Ja	Geben Sie die ID des Tickets an, dem das Dokument hinzugefügt werden soll.
Base64-codierte Datei	String	–	Ja	Geben Sie die Base64-codierte Datei an, die als Anhang hinzugefügt werden soll.
Dateiname	String	{filename}.{extension}	Ja	Geben Sie den Dateinamen des Anhangs an. Dieser Wert wird auch als Titel verwendet. Hinweis:Die Aktion muss die richtige Dateiendung für die Datei angeben.
Im Kundenportal anzeigen	Kästchen	Aktiviert	Nein	Wenn diese Option aktiviert ist, wird der Anhang im Kundenportal angezeigt.
Nur Eigentümer darf aktualisieren	Kästchen	Aktiviert	Nein	Wenn diese Option aktiviert ist, kann nur der Inhaber die Anlage aktualisieren.

Ausführen am

Diese Aktion wird für alle Elemente ausgeführt.

Aktionsergebnisse

Scriptergebnis

Name des Scriptergebnisses	Wertoptionen	Beispiel
is_success	Wahr/falsch	is_success:False

JSON-Ergebnis

{
    "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"
    }
}

Fall-Repository

Ergebnistyp	Wert / Beschreibung	Typ
Ausgabemeldung*	Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen. Wenn der Statuscode 201 gemeldet wird (is_success=true): „Eine Datei wurde erfolgreich als Anhang zum Ticket {ticket_id} in ConnectWise hinzugefügt.“ Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden: Wenn ein kritischer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Anhang zum Ticket hinzufügen‘. Grund: {0}''.format(error.Stacktrace)." Wenn der Statuscode 400 gemeldet wird: „Fehler beim Ausführen der Aktion ‚Anhang zum Ticket hinzufügen‘. Grund: {errors/message}.'' Wenn ein ungültiges „Filename“-Format angegeben wird: „Error executing action "Add Attachment To Ticket". Grund: Der Wert für „Dateiname“ entspricht nicht dem erforderlichen Format. Format: {filename}.{extension}.''	Allgemein

Ergebnistyp

Wert / Beschreibung

Typ

Ausgabemeldung*

Die Aktion darf nicht fehlschlagen und darf die Ausführung eines Playbooks nicht stoppen.

Wenn der Statuscode 201 gemeldet wird (is_success=true): „Eine Datei wurde erfolgreich als Anhang zum Ticket {ticket_id} in ConnectWise hinzugefügt.“

Die Aktion sollte fehlschlagen und die Playbook-Ausführung beenden:

Wenn ein kritischer Fehler gemeldet wird: „Fehler beim Ausführen der Aktion ‚Anhang zum Ticket hinzufügen‘. Grund: {0}''.format(error.Stacktrace)."

Wenn der Statuscode 400 gemeldet wird: „Fehler beim Ausführen der Aktion ‚Anhang zum Ticket hinzufügen‘. Grund: {errors/message}.''

Wenn ein ungültiges „Filename“-Format angegeben wird: „Error executing action "Add Attachment To Ticket". Grund: Der Wert für „Dateiname“ entspricht nicht dem erforderlichen Format. Format: {filename}.{extension}.''

Allgemein

Jobs

Geschlossene und abgelehnte Tickets synchronisieren

Beschreibung

Synchronisieren Sie geschlossene Tickets in ConnectWise und verworfene Benachrichtigungen in Google SecOps.

Parameter

Parametername	Typ	Standardwert	Beschreibung
API-Stamm	String	–	–
Name des Unternehmens	String	–	–
Öffentlicher API-Schlüssel	String	–	–
Privater API-Schlüssel	String	–	–
Skriptname	String	–	–

Kommentare synchronisieren

Beschreibung

Kommentare zwischen Google SecOps-Vorgängen und ConnectWise-Tickets synchronisieren.

Parameter

Parametername	Typ	Standardwert	Beschreibung
API-Stamm	String	https://<Host Name>/v4_6_Release/apis/3.0/	–
Name des Unternehmens	String	–	–
Öffentlicher API-Schlüssel	String	–	–
Privater API-Schlüssel	String	–	–
Skriptname	String	–	–

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten