Esta página foi traduzida pela API Cloud Translation.

ConnectWise

Versão da integração: 17.0

Configurar a integração do ConnectWise para trabalhar com o Google Security Operations

Configurar chaves públicas e privadas no ConnectWise Manage

Para criar uma integração entre o ConnectWise Manage e o Google SecOps com o ConnectWise Manage, você precisa fornecer chaves de API. As chaves de API são chaves públicas e privadas geradas pelo ConnectWise Manage para a conta de integração.

Para criar chaves de API no ConnectWise Manage:

No ConnectWise Manage, clique em System > Members e selecione um membro ou crie um novo. Verifique se o membro selecionado tem todos os direitos necessários para configurar a integração.
Na tela "Manutenção de membros", clique na guia Chaves de API e em Novo item.
No campo Descrição, insira a descrição das chaves recém-criadas. Por exemplo, Integração do Google SecOps.
Clique em Salvar para salvar o novo item.

As duas chaves de API são geradas e mostradas nos campos "Chave pública" e "Chave privada". A chave privada é mostrada apenas no momento da criação.

Configurar a integração do ConnectWise no Google SecOps

Para instruções detalhadas sobre como configurar uma integração no Google SecOps, consulte Configurar integrações.

Parâmetros de integração

Use os seguintes parâmetros para configurar a integração:

Nome de exibição do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
Raiz da API	String	https://{CompanyURL}/v4_6_Release/apis/3.0/	Sim	Endereço da instância do ConnectWise.
Nome da empresa	String	N/A	Sim
Chave pública	String	N/A	Sim
Chave privada	String	N/A	Sim
ID do cliente	String	N/A	Sim	ID do cliente do aplicativo ConnectWise.

Ações

Adicionar comentário ao tíquete

Descrição

Adicionar um novo comentário a um tíquete no ConnectWise.

Parâmetros

Nome do parâmetro	Tipo	Valor padrão		Descrição
ID do tíquete	String	N/A	Sim	ID do tíquete do ConnectWise. Exemplo: 608718
Comentário	String	N/A	Sim	Conteúdo do comentário a ser anexado a um tíquete.
Interno	Caixa de seleção	Desmarcado	Sim	Se marcada, coloca o comentário na seção interna.

Nome do parâmetro

Tipo

Valor padrão

Descrição

ID do tíquete

String

N/A

Sim

ID do tíquete do ConnectWise.

Exemplo: 608718

Comentário

String

N/A

Sim

Conteúdo do comentário a ser anexado a um tíquete.

Interno

Caixa de seleção

Desmarcado

Sim

Se marcada, coloca o comentário na seção interna.

Executar em

Essa ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
ticket_id	N/A	N/A

Resultado do JSON

N/A

Encerrar tíquete

Descrição

Encerrar um tíquete do ConnectWise.

Parâmetros

Nome do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
ID do tíquete	String	N/A	Sim	ID do tíquete do ConnectWise. Exemplo: 608718.
Status de fechamento personalizado	String	N/A	Não	Se o sistema específico usar um status fechado personalizado, por exemplo, "Concluído".

Nome do parâmetro

Tipo

Valor padrão

É obrigatório

Descrição

ID do tíquete

String

N/A

Sim

ID do tíquete do ConnectWise.

Exemplo: 608718.

Status de fechamento personalizado

String

N/A

Não

Se o sistema específico usar um status fechado personalizado, por exemplo, "Concluído".

Executar em

Essa ação é executada em todas as entidades.

Resultados da ação

Resultados do script

Nome do resultado do script	Opções de valor	Exemplo
ticket_id	Verdadeiro/Falso	ticket_id:False

Resultado do JSON

N/A

Enriquecimento de entidades

N/A

Insights

N/A

Criar tíquete de alertas

Descrição

Crie um ticket do ConnectWise para cada novo alerta do Google SecOps.

Parâmetros

Nome do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
Empresa	String	N/A	Sim	Nome da empresa.
Jogos de tabuleiro	String	N/A	Sim	Nome do Jamboard.
Status	String	N/A	Sim	Exemplo: não atribuído
Prioridade	String	N/A	Sim	Exemplo: prioridade 3: resposta normal
Descrição inicial	String	N/A	Sim	N/A
Nome do proprietário	String	N/A	Não	Nome do membro do ConnectWise para atribuir este tíquete. Exemplo: connectwise_user_1.

Executar em

Essa ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
ticket_id	N/A	N/A

Resultado do JSON

N/A

Criar tíquete

Descrição

Crie um tíquete do ConnectWise.

Parâmetros

Nome do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
Empresa	String	N/A	Sim	Nome da empresa.
Jogos de tabuleiro	String	N/A	Sim	Nome do Jamboard
Resumo	String	N/A	Sim	N/A
Status	String	N/A	Sim	Por exemplo, "Não atribuída".
Prioridade	String	N/A	Sim	Exemplo: prioridade 3: resposta normal
Nome do proprietário	String	N/A	Não	Nome do membro do ConnectWise para atribuir este tíquete. Exemplo: connectwise_user_1

Executar em

Essa ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
ticket_id	Verdadeiro/Falso	ticket_id:False

Resultado do JSON

N/A

Excluir ingresso

Descrição

Exclui um tíquete do ConnectWise pelo ID.

Parâmetros

Nome do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
ID do tíquete	String	N/A	Sim	O ID do ingresso a ser excluído. Exemplo: 607167

Nome do parâmetro

Tipo

Valor padrão

É obrigatório

Descrição

ID do tíquete

String

N/A

Sim

O ID do ingresso a ser excluído.

Exemplo: 607167

Executar em

Essa ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/Falso	is_success:False

Resultado do JSON

N/A

Comprar ingresso

Descrição

Receba um tíquete do ConnectWise por ID e anexe o JSON do tíquete como um arquivo.

Parâmetros

Nome do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
ID do tíquete	String	N/A	Sim	Extrai um tíquete por ID.

Executar em

Essa ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
ticket_json	N/A	N/A

Resultado do 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

Descrição

Teste a conectividade.

Parâmetros

N/A

Executar em

Essa ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/Falso	is_success:False

Resultado do JSON

N/A

Atualizar ingresso

Descrição

Atualize os detalhes do tíquete no ConnectWise.

Parâmetros

Nome do parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
Parâmetro	Tipo	Valor padrão	É obrigatório	Descrição
ID do tíquete	String	N/A	Sim	O ID do ingresso a ser atualizado. Exemplo: 609620
Resumo	String	N/A	Não	Resumo atualizado.
Nome do tipo	String	N/A	Não	Exemplo: aplicativo
Nome do subtipo	String	N/A	Não	Exemplo: Adobe
Nome do item	String	N/A	Não	Exemplo: desenvolvimento
Status	String	N/A	Não	Novo status do tíquete. Exemplo: `In Progress (plan of action)`

Executar em

Essa ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
ticket_id	Verdadeiro/Falso	ticket_id:False

Resultado do JSON

N/A

Adicionar anexo ao tíquete

Descrição

Adicione um anexo ao tíquete no ConnectWise.

Parâmetros

Nome dos parâmetros	Tipo	Valor padrão	É obrigatório	Descrição
ID do tíquete	String	N/A	Sim	Especifique o ID do tíquete a que o documento precisa ser adicionado.
Arquivo codificado em Base64	String	N/A	Sim	Especifique o arquivo codificado em base64 que precisa ser adicionado como anexo.
Nome do arquivo	String	{filename}.{extension}	Sim	Especifique o nome do arquivo por trás do anexo. Esse valor também é usado como título. Observação:a ação precisa fornecer a extensão correta para o arquivo.
Mostrar no portal do cliente	Caixa de seleção	Selecionado	Não	Se ativado, o anexo será mostrado no portal do cliente.
Permitir atualização apenas do proprietário	Caixa de seleção	Selecionado	Não	Se ativada, a ação só permite que o proprietário atualize o anexo.

Executar em

Essa ação é executada em todas as entidades.

Resultados da ação

Resultado do script

Nome do resultado do script	Opções de valor	Exemplo
is_success	Verdadeiro/Falso	is_success:False

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

Painel de casos

Tipo de resultado	Valor / Descrição	Tipo
Mensagem de saída*	A ação não pode falhar nem interromper a execução de um playbook: Se o código de status 201 for informado (is_success=true): "Um arquivo foi adicionado como anexo ao tíquete {ticket_id} no ConnectWise." A ação precisa falhar e interromper a execução de um playbook: Se um erro crítico for informado: "Erro ao executar a ação "Adicionar anexo ao tíquete". Motivo: {0}''.format(error.Stacktrace)." Se o código de status 400 for informado: "Erro ao executar a ação "Adicionar anexo ao tíquete". Motivo: {errors/message}.'' Se um formato "Nome do arquivo" inválido for fornecido: "Erro ao executar a ação "Adicionar anexo ao tíquete". Motivo: o valor "Nome do arquivo" não segue o formato necessário. Formato: {filename}.{extension}.''	Geral

Tipo de resultado

Valor / Descrição

Tipo

Mensagem de saída*

A ação não pode falhar nem interromper a execução de um playbook:

Se o código de status 201 for informado (is_success=true): "Um arquivo foi adicionado como anexo ao tíquete {ticket_id} no ConnectWise."

A ação precisa falhar e interromper a execução de um playbook:

Se um erro crítico for informado: "Erro ao executar a ação "Adicionar anexo ao tíquete". Motivo: {0}''.format(error.Stacktrace)."

Se o código de status 400 for informado: "Erro ao executar a ação "Adicionar anexo ao tíquete". Motivo: {errors/message}.''

Se um formato "Nome do arquivo" inválido for fornecido: "Erro ao executar a ação "Adicionar anexo ao tíquete". Motivo: o valor "Nome do arquivo" não segue o formato necessário. Formato: {filename}.{extension}.''

Geral

Jobs

Sincronizar tíquetes fechados e dispensados

Descrição

Sincronize tíquetes fechados no ConnectWise e alertas dispensados no Google SecOps.

Parâmetros

Nome do parâmetro	Tipo	Valor padrão	Descrição
Raiz da API	String	N/A	N/A
Nome da empresa	String	N/A	N/A
Chave pública da API	String	N/A	N/A
Chave privada da API	String	N/A	N/A
Nome do script	String	N/A	N/A

Sincronizar comentários

Descrição

Sincronize comentários entre casos do Google SecOps e tíquetes do ConnectWise.

Parâmetros

Nome do parâmetro	Tipo	Valor padrão	Descrição
Raiz da API	String	https://<Nome do host>/v4_6_Release/apis/3.0/	N/A
Nome da empresa	String	N/A	N/A
Chave pública da API	String	N/A	N/A
Chave privada da API	String	N/A	N/A
Nome do script	String	N/A	N/A

Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.