이 페이지는 Cloud Translation API를 통해 번역되었습니다.

ConnectWise

통합 버전: 17.0

Google Security Operations와 호환되도록 ConnectWise 통합 구성

ConnectWise Manage에서 공개 키 및 비공개 키 설정

ConnectWise Manage와 Google SecOps 통합(ConnectWise Manage) 간의 통합을 만들려면 API 키를 제공해야 합니다. API 키는 통합 계정을 위해 ConnectWise Manage에서 생성한 공개 키와 비공개 키입니다.

ConnectWise Manage에서 API 키를 만들려면 다음 단계를 따르세요.

ConnectWise Manage에서 System >Members를 클릭하고 기존 회원을 선택하거나 새 회원을 만듭니다. 선택한 회원에게 통합을 설정하는 데 필요한 모든 권한이 있는지 확인합니다.
회원 유지관리 화면에서 API 키 탭을 클릭한 다음 새 항목을 클릭합니다.
설명 필드에 새로 생성된 키에 대한 설명을 입력합니다. 예를 들어 Google SecOps 통합이 있습니다.
저장을 클릭하여 새 항목을 저장합니다.

두 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 - 일반 응답
초기 설명	문자열	해당 사항 없음	예	해당 사항 없음
소유자 이름	문자열	해당 사항 없음	아니요	이 티켓을 할당할 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": ""
            }
     }
}

핑

설명

연결을 테스트합니다.

매개변수

해당 사항 없음

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예시
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}	예	첨부파일 뒤에 파일 이름을 지정합니다. 이 값은 제목으로도 사용됩니다. 참고: 작업에서 파일의 올바른 확장자를 제공해야 합니다.
고객 포털에 표시	체크박스	선택	아니요	사용 설정하면 첨부파일이 고객 포털에 표시됩니다.
소유자만 업데이트 허용	체크박스	선택	아니요	사용 설정하면 소유자만 첨부파일을 업데이트할 수 있습니다.

실행

이 작업은 모든 항목에서 실행됩니다.

작업 결과

스크립트 결과

스크립트 결과 이름	값 옵션	예시
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} 티켓에 파일을 첨부파일로 추가했습니다.' 작업이 실패하고 플레이북 실행을 중지합니다. 심각한 오류가 보고된 경우: "Error executing action "Add Attachment To Ticket". 이유: {0}''.format(error.Stacktrace)' 400 상태 코드가 보고된 경우: "'티켓에 첨부파일 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: {errors/message}.'' 잘못된 '파일 이름' 형식이 제공된 경우: "'티켓에 첨부파일 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: '파일 이름' 값이 필요한 형식을 따르지 않습니다. 형식: {filename}.{extension}.''	일반

결과 유형

값 / 설명

유형

출력 메시지*

작업이 실패하거나 플레이북 실행을 중지하지 않습니다.

201 상태 코드가 보고된 경우 (is_success=true): 'ConnectWise의 {ticket_id} 티켓에 파일을 첨부파일로 추가했습니다.'

작업이 실패하고 플레이북 실행을 중지합니다.

심각한 오류가 보고된 경우: "Error executing action "Add Attachment To Ticket". 이유: {0}''.format(error.Stacktrace)'

400 상태 코드가 보고된 경우: "'티켓에 첨부파일 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: {errors/message}.''

잘못된 '파일 이름' 형식이 제공된 경우: "'티켓에 첨부파일 추가' 작업을 실행하는 동안 오류가 발생했습니다. 이유: '파일 이름' 값이 필요한 형식을 따르지 않습니다. 형식: {filename}.{extension}.''

일반

작업

종료된 티켓 및 닫은 티켓 동기화

설명

ConnectWise에서 종료된 티켓과 Google SecOps에서 닫은 알림을 동기화합니다.

매개변수

파라미터 이름	유형	기본값	설명
API 루트	문자열	해당 사항 없음	해당 사항 없음
회사 이름	문자열	해당 사항 없음	해당 사항 없음
API 공개 키	문자열	해당 사항 없음	해당 사항 없음
API 비공개 키	문자열	해당 사항 없음	해당 사항 없음
스크립트 이름	문자열	해당 사항 없음	해당 사항 없음

댓글 동기화

설명

Google SecOps 케이스와 ConnectWise 티켓 간에 댓글을 동기화합니다.

매개변수

파라미터 이름	유형	기본값	설명
API 루트	문자열	https://<호스트 이름>/v4_6_Release/apis/3.0/	해당 사항 없음
회사 이름	문자열	해당 사항 없음	해당 사항 없음
API 공개 키	문자열	해당 사항 없음	해당 사항 없음
API 비공개 키	문자열	해당 사항 없음	해당 사항 없음
스크립트 이름	문자열	해당 사항 없음	해당 사항 없음

도움이 더 필요하신가요? 커뮤니티 회원 및 Google SecOps 전문가로부터 답변을 받으세요.