Cette page a été traduite par l'API Cloud Translation.

ConnectWise

Version de l'intégration : 17.0

Configurer l'intégration de ConnectWise pour qu'elle fonctionne avec Google Security Operations

Configurer des clés publiques et privées dans ConnectWise Manage

Pour créer une intégration entre ConnectWise Manage et l'intégration Google SecOps avec ConnectWise Manage, vous devez fournir des clés API. Les clés API sont des clés publiques et privées générées par ConnectWise Manage pour le compte d'intégration.

Pour créer des clés API dans ConnectWise Manage :

Dans ConnectWise Manage, cliquez sur System > Members (Système > Membres), puis sélectionnez un membre existant ou créez-en un. Assurez-vous que le membre sélectionné dispose de tous les droits nécessaires pour configurer l'intégration.
Sur l'écran "Member Maintenance" (Gestion des membres), cliquez sur l'onglet API Keys (Clés API), puis sur New Item (Nouvel élément).
Dans le champ Description, saisissez la description des clés nouvellement créées. Par exemple, l'intégration de Google SecOps.
Cliquez sur Enregistrer pour enregistrer le nouvel élément.

Les deux clés API sont générées et affichées dans les champs "Clé publique" et "Clé privée". La clé privée n'est affichée qu'au moment de sa création.

Configurer l'intégration de ConnectWise dans Google SecOps

Pour obtenir des instructions détaillées sur la configuration d'une intégration dans Google SecOps, consultez Configurer des intégrations.

Paramètres d'intégration

Utilisez les paramètres suivants pour configurer l'intégration :

Nom à afficher du paramètre	Type	Valeur par défaut	Obligatoire	Description
Racine de l'API	Chaîne	https://{CompanyURL}/v4_6_Release/apis/3.0/	Oui	Adresse de l'instance ConnectWise.
Nom de l'entreprise	Chaîne	N/A	Oui
Clé publique	Chaîne	N/A	Oui
Clé privée	Chaîne	N/A	Oui
ID client	Chaîne	N/A	Oui	ID client de l'application ConnectWise.

Actions

Ajouter un commentaire à une demande

Description

Ajoutez un commentaire à un ticket dans ConnectWise.

Paramètres

Nom du paramètre	Type	Valeur par défaut		Description
ID de la demande	Chaîne	N/A	Oui	ID de la demande ConnectWise. Exemple : 608718
Commentaire	Chaîne	N/A	Oui	Contenu du commentaire à joindre à une demande.
Interne	Case à cocher	Décochée	Oui	Si cette case est cochée, le commentaire est placé dans la section interne.

Nom du paramètre

Type

Valeur par défaut

Description

ID de la demande

Chaîne

N/A

Oui

ID de la demande ConnectWise.

Exemple : 608718

Commentaire

Chaîne

N/A

Oui

Contenu du commentaire à joindre à une demande.

Interne

Case à cocher

Décochée

Oui

Si cette case est cochée, le commentaire est placé dans la section interne.

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
ticket_id	N/A	N/A

Résultat JSON

N/A

Fermer la demande

Description

Fermez une demande ConnectWise.

Paramètres

Nom du paramètre	Type	Valeur par défaut	Obligatoire	Description
ID de la demande	Chaîne	N/A	Oui	ID de la demande ConnectWise. Exemple : 608718.
État de clôture personnalisé	Chaîne	N/A	Non	Si le système spécifique utilise un état fermé personnalisé, par exemple "Terminé".

Nom du paramètre

Type

Valeur par défaut

Obligatoire

Description

ID de la demande

Chaîne

N/A

Oui

ID de la demande ConnectWise.

Exemple : 608718.

État de clôture personnalisé

Chaîne

N/A

Non

Si le système spécifique utilise un état fermé personnalisé, par exemple "Terminé".

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Résultats du script

Nom du résultat du script	Options de valeur	Exemple
ticket_id	Vrai/Faux	ticket_id:False

Résultat JSON

N/A

Enrichissement d'entités

N/A

Insights

N/A

Créer une demande d'alerte

Description

Créez un ticket ConnectWise pour chaque nouvelle alerte Google SecOps.

Paramètres

Nom du paramètre	Type	Valeur par défaut	Obligatoire	Description
Entreprise	Chaîne	N/A	Oui	Nom de l'entreprise.
Tableau	Chaîne	N/A	Oui	Nom du tableau.
État	Chaîne	N/A	Oui	Exemple : Non attribué
Priorité	Chaîne	N/A	Oui	Exemple : Priorité 3 – Réponse normale
Description initiale	Chaîne	N/A	Oui	N/A
Nom du propriétaire	Chaîne	N/A	Non	Nom du membre ConnectWise auquel attribuer ce ticket. Exemple : connectwise_user_1.

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
ticket_id	N/A	N/A

Résultat JSON

N/A

Créer une demande

Description

Créez une demande ConnectWise.

Paramètres

Nom du paramètre	Type	Valeur par défaut	Obligatoire	Description
Entreprise	Chaîne	N/A	Oui	Nom de l'entreprise.
Tableau	Chaîne	N/A	Oui	Nom du tableau
Résumé	Chaîne	N/A	Oui	N/A
État	Chaîne	N/A	Oui	Par exemple, "Non attribué".
Priorité	Chaîne	N/A	Oui	Exemple : Priorité 3 – Réponse normale
Nom du propriétaire	Chaîne	N/A	Non	Nom du membre ConnectWise auquel attribuer ce ticket. Exemple : connectwise_user_1

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
ticket_id	Vrai/Faux	ticket_id:False

Résultat JSON

N/A

Supprimer un billet

Description

Supprimez un ticket ConnectWise par son ID.

Paramètres

Nom du paramètre	Type	Valeur par défaut	Obligatoire	Description
ID de la demande	Chaîne	N/A	Oui	ID de la demande à supprimer. Exemple : 607167

Nom du paramètre

Type

Valeur par défaut

Obligatoire

Description

ID de la demande

Chaîne

N/A

Oui

ID de la demande à supprimer.

Exemple : 607167

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
is_success	Vrai/Faux	is_success:False

Résultat JSON

N/A

Obtenir un billet

Description

Obtenez un ticket ConnectWise par ID et joignez le fichier JSON du ticket.

Paramètres

Nom du paramètre	Type	Valeur par défaut	Obligatoire	Description
ID de la demande	Chaîne	N/A	Oui	Récupérez un billet par son ID.

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
ticket_json	N/A	N/A

Résultat 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

Description

Testez la connectivité.

Paramètres

N/A

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
is_success	Vrai/Faux	is_success:False

Résultat JSON

N/A

Modifier un billet

Description

Mettez à jour les informations de la demande dans ConnectWise.

Paramètres

Nom du paramètre	Type	Valeur par défaut	Obligatoire	Description
Paramètre	Type	Valeur par défaut	Obligatoire	Description
ID de la demande	Chaîne	N/A	Oui	ID du billet à modifier. Exemple : 609620
Résumé	Chaîne	N/A	Non	Résumé modifié.
Nom du type	Chaîne	N/A	Non	Exemple : Application
Nom du sous-type	Chaîne	N/A	Non	Exemple : Adobe
Nom de l'élément	Chaîne	N/A	Non	Exemple : Développement
État	Chaîne	N/A	Non	Nouvel état de la demande. Exemple : `In Progress (plan of action)`

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
ticket_id	Vrai/Faux	ticket_id:False

Résultat JSON

N/A

Ajouter une pièce jointe à une demande

Description

Ajoutez une pièce jointe à la demande dans ConnectWise.

Paramètres

Nom des paramètres	Type	Valeur par défaut	Obligatoire	Description
ID de la demande	Chaîne	N/A	Oui	Spécifiez l'ID de la demande à laquelle le document doit être ajouté.
Fichier encodé en Base64	Chaîne	N/A	Oui	Spécifiez le fichier encodé en base64 à ajouter en pièce jointe.
Nom de fichier	Chaîne	{filename}.{extension}	Oui	Spécifiez le nom du fichier de la pièce jointe. Cette valeur est également utilisée comme titre. Remarque : L'action doit fournir la bonne extension pour le fichier.
Afficher dans le portail client	Case à cocher	Cochée	Non	Si cette option est activée, la pièce jointe s'affiche dans le portail client.
Autoriser la mise à jour par le propriétaire uniquement	Case à cocher	Cochée	Non	Si cette option est activée, seule le propriétaire peut modifier la pièce jointe.

Exécuter sur

Cette action s'exécute sur toutes les entités.

Résultats de l'action

Résultat du script

Nom du résultat du script	Options de valeur	Exemple
is_success	Vrai/Faux	is_success:False

Résultat 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"
    }
}

Mur des cas

Type de résultat	Valeur / Description	Type
Message de sortie*	L'action ne doit pas échouer ni arrêter l'exécution d'un playbook : Si le code d'état 201 est signalé (is_success=true) : "Fichier ajouté en pièce jointe à la demande {ticket_id} dans ConnectWise." L'action doit échouer et arrêter l'exécution d'un playbook : Si une erreur critique est signalée : "Erreur lors de l'exécution de l'action "Ajouter une pièce jointe à la demande". Raison : {0}''.format(error.Stacktrace)." Si le code d'état 400 est signalé : "Erreur lors de l'exécution de l'action "Ajouter une pièce jointe à la demande". Motif : {errors/message}.'' Si le format du nom de fichier n'est pas valide : "Erreur lors de l'exécution de l'action "Ajouter une pièce jointe à la demande". Motif : La valeur "Nom de fichier" ne respecte pas le format requis. Format : {nom de fichier}.{extension}.""	Général

Type de résultat

Valeur / Description

Type

Message de sortie*

L'action ne doit pas échouer ni arrêter l'exécution d'un playbook :

Si le code d'état 201 est signalé (is_success=true) : "Fichier ajouté en pièce jointe à la demande {ticket_id} dans ConnectWise."

L'action doit échouer et arrêter l'exécution d'un playbook :

Si une erreur critique est signalée : "Erreur lors de l'exécution de l'action "Ajouter une pièce jointe à la demande". Raison : {0}''.format(error.Stacktrace)."

Si le code d'état 400 est signalé : "Erreur lors de l'exécution de l'action "Ajouter une pièce jointe à la demande". Motif : {errors/message}.''

Si le format du nom de fichier n'est pas valide : "Erreur lors de l'exécution de l'action "Ajouter une pièce jointe à la demande". Motif : La valeur "Nom de fichier" ne respecte pas le format requis. Format : {nom de fichier}.{extension}.""

Général

Jobs

Synchroniser les demandes clôturées et ignorées

Description

Synchronisez les demandes clôturées dans ConnectWise et les alertes ignorées dans Google SecOps.

Paramètres

Nom du paramètre	Type	Valeur par défaut	Description
Racine de l'API	Chaîne	N/A	N/A
Nom de l'entreprise	Chaîne	N/A	N/A
Clé publique de l'API	Chaîne	N/A	N/A
Clé privée de l'API	Chaîne	N/A	N/A
Nom du script	Chaîne	N/A	N/A

Synchroniser les commentaires

Description

Synchronisez les commentaires entre les cas Google SecOps et les tickets ConnectWise.

Paramètres

Nom du paramètre	Type	Valeur par défaut	Description
Racine de l'API	Chaîne	https://<Nom d'hôte>/v4_6_Release/apis/3.0/	N/A
Nom de l'entreprise	Chaîne	N/A	N/A
Clé publique de l'API	Chaîne	N/A	N/A
Clé privée de l'API	Chaîne	N/A	N/A
Nom du script	Chaîne	N/A	N/A

Vous avez encore besoin d'aide ? Obtenez des réponses de membres de la communauté et de professionnels Google SecOps.