このページは Cloud Translation API によって翻訳されました。

ConnectWise

統合バージョン: 17.0

Google Security Operations と連携するように ConnectWise Integration を構成する

ConnectWise Manage で公開鍵と秘密鍵を設定する

ConnectWise Manage と Google SecOps の統合を作成するには、API キーを指定する必要があります。API キーは、インテグレーションアカウント用に ConnectWise Manage によって生成される公開鍵と秘密鍵です。

ConnectWise Manage で API キーを作成するには:

ConnectWise Manage で、[System] > [Members] をクリックし、既存のメンバーを選択するか、新しいメンバーを作成します。選択したメンバーに、統合の設定に必要なすべての権限があることを確認します。
[Member Maintenance] 画面で [API Keys] タブをクリックし、[New Item] をクリックします。
[説明] フィールドに、新しく作成した鍵の説明を入力します。例: Google SecOps Integration。
[保存] をクリックして、新しい項目を保存します。

2 つの API キーが生成され、[公開鍵] フィールドと [秘密鍵] フィールドに表示されます。秘密鍵は作成時にのみ表示されます。

Google SecOps で ConnectWise 統合を構成する

Google SecOps で統合を構成する方法について詳しくは、統合を構成するをご覧ください。

統合のパラメータ

次のパラメータを使用して統合を構成します。

パラメータの表示名	種類	デフォルト値	必須	説明
API ルート	文字列	https://{CompanyURL}/v4_6_Release/apis/3.0/	はい	ConnectWise インスタンスのアドレス。
会社名	文字列	なし	はい
公開鍵	文字列	なし	はい
秘密鍵	文字列	なし	はい
クライアント ID	文字列	なし	はい	ConnectWise アプリケーションのクライアント ID。

操作

チケットにコメントを追加する

説明

ConnectWise のチケットに新しいコメントを追加します。

パラメータ

パラメータ名	種類	デフォルト値		説明
チケット ID	文字列	なし	はい	ConnectWise チケット ID。例: 608718
コメント	文字列	なし	はい	チケットに添付するコメントの内容。
内部	チェックボックス	オフ	はい	チェックすると、コメントが内部セクションに配置されます。

パラメータ名

種類

デフォルト値

説明

チケット ID

文字列

なし

はい

ConnectWise チケット ID。

例: 608718

文字列

なし

はい

チケットに添付するコメントの内容。

内部

チェックボックス

オフ

はい

チェックすると、コメントが内部セクションに配置されます。

実行

このアクションはすべてのエンティティに対して実行されます。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
ticket_id	なし	なし

JSON の結果

N/A

チケットを閉じる

説明

ConnectWise チケットをクローズします。

パラメータ

パラメータ名	種類	デフォルト値	必須	説明
チケット ID	文字列	なし	はい	ConnectWise チケット ID。例: 608718。
カスタムの終了ステータス	文字列	なし	いいえ	特定のシステムでカスタムのクローズステータス（完了など）が使用されている場合。

パラメータ名

種類

デフォルト値

必須

説明

チケット ID

文字列

なし

はい

ConnectWise チケット ID。

例: 608718。

カスタムの終了ステータス

文字列

なし

いいえ

特定のシステムでカスタムのクローズステータス（完了など）が使用されている場合。

実行

このアクションはすべてのエンティティに対して実行されます。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
ticket_id	True/False	ticket_id:False

JSON の結果

N/A

エンティティ拡充

なし

分析情報

なし

アラートチケットを作成する

説明

新しい Google SecOps アラートごとに ConnectWise チケットを作成します。

パラメータ

パラメータ名	種類	デフォルト値	必須	説明
会社	文字列	なし	はい	会社名。
ボード	文字列	なし	はい	ボード名。
ステータス	文字列	なし	はい	例: 未割り当て
優先度	文字列	なし	はい	例: 優先度 3 - 通常の対応
Initial Description（最初の説明）	文字列	なし	○	なし
オーナー名	文字列	なし	いいえ	このチケットを割り当てる ConnectWise メンバーの名前。例: connectwise_user_1。

実行

このアクションはすべてのエンティティに対して実行されます。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
ticket_id	なし	なし

JSON の結果

N/A

チケットを作成

説明

ConnectWise チケットを作成します。

パラメータ

パラメータ名	種類	デフォルト値	必須	説明
会社	文字列	なし	はい	会社名。
ボード	文字列	なし	はい	ボード名
概要	文字列	なし	○	なし
ステータス	文字列	なし	はい	例: 未割り当て。
優先度	文字列	なし	はい	例: 優先度 3 - 通常の対応
オーナー名	文字列	なし	いいえ	このチケットの割り当て先となる ConnectWise メンバーの名前。例: connectwise_user_1

実行

このアクションはすべてのエンティティに対して実行されます。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
ticket_id	True/False	ticket_id:False

JSON の結果

N/A

チケットを削除

説明

ID で ConnectWise チケットを削除します。

パラメータ

パラメータ名	種類	デフォルト値	必須	説明
チケット ID	文字列	なし	はい	削除するチケットの ID。例: 607167

パラメータ名

種類

デフォルト値

必須

説明

チケット ID

文字列

なし

はい

削除するチケットの ID。

例: 607167

実行

このアクションはすべてのエンティティに対して実行されます。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success:False

JSON の結果

N/A

チケットを取得

説明

ID で ConnectWise チケットを取得し、チケットの JSON をファイルとして添付します。

パラメータ

パラメータ名	種類	デフォルト値	必須	説明
チケット ID	文字列	なし	はい	ID でチケットを取得します。

実行

このアクションはすべてのエンティティに対して実行されます。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
ticket_json	なし	なし

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

説明

接続をテストします。

パラメータ

なし

実行

このアクションはすべてのエンティティに対して実行されます。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success:False

JSON の結果

N/A

更新チケット

説明

ConnectWIse でチケットの詳細を更新します。

パラメータ

パラメータ名	種類	デフォルト値	必須	説明
パラメータ	タイプ	デフォルト値	必須	説明
チケット ID	文字列	なし	はい	更新するチケットの ID。例: 609620
概要	文字列	なし	いいえ	更新された概要。
型名	文字列	なし	いいえ	例: アプリケーション
サブタイプ名	文字列	なし	いいえ	例: Adobe
項目名	文字列	なし	いいえ	例: 開発
ステータス	文字列	なし	いいえ	新しいチケットのステータス。例: `In Progress (plan of action)`

実行

このアクションはすべてのエンティティに対して実行されます。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
ticket_id	True/False	ticket_id:False

JSON の結果

N/A

チケットに添付ファイルを追加する

説明

ConnectWise でチケットに添付ファイルを追加します。

パラメータ

パラメータ名	タイプ	デフォルト値	必須	説明
チケット ID	文字列	なし	はい	ドキュメントを追加する必要があるチケットの ID を指定します。
Base64 エンコードされたファイル	文字列	なし	はい	添付ファイルとして追加する必要がある base64 でエンコードされたファイルを指定します。
ファイル名	文字列	{filename}.{extension}	はい	添付ファイルのファイル名を指定します。この値はタイトルとしても使用されます。注: アクションは、ファイルの正しい拡張子を提供する必要があります。
Display In Customer Portal（顧客ポータルに表示）	チェックボックス	オン	いいえ	有効にすると、添付ファイルがカスタマーポータルに表示されます。
オーナーのみが更新を許可する	チェックボックス	オン	いいえ	有効にすると、オーナーのみが添付ファイルを更新できるようになります。

実行

このアクションはすべてのエンティティに対して実行されます。

アクションの結果

スクリプトの結果

スクリプトの結果名	値のオプション	例
is_success	True/False	is_success:False

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

ケースウォール

結果のタイプ	値 / 説明	タイプ
出力メッセージ *	アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。 201 ステータスコードが報告された場合（is_success=true）: 「ConnectWise のチケット {ticket_id} にファイルが添付ファイルとして正常に追加されました。」アクションが失敗し、ハンドブックの実行が停止します。重大なエラーが報告された場合: 「アクション「チケットに添付ファイルを追加」の実行エラー。理由: {0}」.format(error.Stacktrace)」 400 ステータスコードが報告された場合:「アクション「チケットに添付ファイルを追加」の実行エラー。理由: {errors/message}。'' 無効な「Filename」形式が指定された場合: 「アクション「チケットに添付ファイルを追加」の実行エラー。理由: 「ファイル名」の値が必要な形式に準拠していません。形式: {filename}.{extension}.''	全般

結果のタイプ

値 / 説明

タイプ

出力メッセージ *

アクションが失敗したり、ハンドブックの実行を停止したりすることはありません。

201 ステータスコードが報告された場合（is_success=true）: 「ConnectWise のチケット {ticket_id} にファイルが添付ファイルとして正常に追加されました。」

アクションが失敗し、ハンドブックの実行が停止します。

重大なエラーが報告された場合: 「アクション「チケットに添付ファイルを追加」の実行エラー。理由: {0}」.format(error.Stacktrace)」

400 ステータスコードが報告された場合:「アクション「チケットに添付ファイルを追加」の実行エラー。理由: {errors/message}。''

無効な「Filename」形式が指定された場合: 「アクション「チケットに添付ファイルを追加」の実行エラー。理由: 「ファイル名」の値が必要な形式に準拠していません。形式: {filename}.{extension}.''

全般

ジョブ

クローズされたチケットと閉じたチケットを同期する

説明

ConnectWise でクローズされたチケットと、Google SecOps で無視されたアラートを同期します。

パラメータ

パラメータ名	種類	デフォルト値	説明
API ルート	文字列	なし	なし
会社名	文字列	なし	なし
API 公開鍵	文字列	なし	なし
API 秘密鍵	文字列	なし	なし
Script Name	文字列	なし	なし

コメントを同期する

説明

Google SecOps のケースと ConnectWise のチケットの間でコメントを同期します。

パラメータ

パラメータ名	種類	デフォルト値	説明
API ルート	文字列	https://<ホスト名>/v4_6_Release/apis/3.0/	なし
会社名	文字列	なし	なし
API 公開鍵	文字列	なし	なし
API 秘密鍵	文字列	なし	なし
Script Name	文字列	なし	なし

さらにサポートが必要な場合 コミュニティメンバーや Google SecOps のプロフェッショナルから回答を得ることができます。

ConnectWise

Google Security Operations と連携するように ConnectWise Integration を構成する

ConnectWise Manage で公開鍵と秘密鍵を設定する

Google SecOps で ConnectWise 統合を構成する

統合のパラメータ

操作

チケットにコメントを追加する

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

チケットを閉じる

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

エンティティ拡充

分析情報

アラート チケットを作成する

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

チケットを作成

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

チケットを削除

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

チケットを取得

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

Ping

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

更新チケット

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

チケットに添付ファイルを追加する

説明

パラメータ

実行

アクションの結果

スクリプトの結果

JSON の結果

ケースウォール

ジョブ

クローズされたチケットと閉じたチケットを同期する

説明

パラメータ

コメントを同期する

説明

パラメータ

アラートチケットを作成する