ServiceDesk Plus
Versão da integração: 5.0
Configurar o ServiceDesk Plus para funcionar com o Google Security Operations
- Para gerar a chave de API, em Bloco do usuário, acesse Administrador > Técnicos.
- Para gerar a chave de API do técnico, clique no ícone de edição ao lado dele. Por outro lado, se você quiser gerar a chave de API para um novo técnico, clique no link Adicionar novo técnico, insira os detalhes do técnico e conceda permissão de login.
- Clique em Gerar link no bloco de detalhes da chave de API. Você pode selecionar um período para a expiração da chave usando o ícone de calendário ou simplesmente manter a mesma chave para sempre.
- Se uma chave já tiver sido gerada para o técnico, um link Regenerar link vai aparecer.
Configurar a integração do ServiceDesk Plus 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:
| Parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
| Raiz da API | String | http://{IP OR FQDN}:8080/api/v3/ | Raiz da API do ServiceDesk Plus. |
Ações
Adicionar nota
Descrição
Quando quiser adicionar mais informações, incluindo informações técnicas, a uma solicitação específica com base nas suas observações, use "Adicionar observações". Você também pode usar observações para atualizar o status da solicitação.
Parâmetros
| Parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
| ID da solicitação | String | N/A | O ID das solicitações. |
| Observação | String | N/A | O conteúdo da observação. |
| Is Public | Caixa de seleção | Desmarcado | Se a observação será pública ou não. |
Executar em
Essa ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Insights
N/A
Resultado do script
| Nome do resultado do script | Opções de valor | Exemplo |
|---|---|---|
| sucesso | Verdadeiro/Falso | success:False |
Resultado do JSON
N/A
Adicionar observação e aguardar resposta
Descrição
Adicione uma observação e aguarde que as novas observações sejam adicionadas à solicitação.
Parâmetros
| Parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
| ID da solicitação | String | N/A | O ID das solicitações. |
| Observação | String | N/A | O conteúdo da observação. |
| Is Public | Caixa de seleção | N/A | Se a observação será pública ou não. |
Executar em
Essa ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Insights
N/A
Resultado do script
| Nome do resultado do script | Opções de valor | Exemplo |
|---|---|---|
| new_notes | N/A | N/A |
Resultado do JSON
N/A
Fechar solicitação
Descrição
Quando um solicitante estiver completamente satisfeito com o atendimento da solicitação e o problema relatado tiver sido resolvido, a solicitação poderá ser encerrada.
Parâmetros
| Parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
| ID da solicitação | String | N/A | O ID da solicitação. |
| Comentário | String | N/A | Comentário de encerramento. |
| Resolução confirmada | Caixa de seleção | N/A | Se a resolução da solicitação foi confirmada ou não. |
Executar em
Essa ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Insights
N/A
Resultado do script
| Nome do resultado do script | Opções de valor | Exemplo |
|---|---|---|
| sucesso | Verdadeiro/Falso | success:False |
Resultado do JSON
N/A
Criar solicitação de alerta
Descrição
Crie uma solicitação relacionada a um alerta do Google SecOps.
Parâmetros
| Parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
| Assunto | String | N/A | O assunto da solicitação. |
| Solicitante | String | N/A | O solicitante da solicitação. Se não for especificado, será definido como o usuário da chave de API. |
| Status | String | N/A | O status da solicitação. |
| Técnico | String | N/A | O nome do técnico atribuído à solicitação. |
| Prioridade | String | N/A | A prioridade da solicitação. |
| Urgência | String | N/A | A urgência da solicitação. |
| Categoria | String | N/A | A categoria da solicitação. |
| Modelo de solicitação | String | N/A | O modelo da solicitação. |
| Tipo de solicitação | String | N/A | O tipo da solicitação. Exemplo: incidente, solicitação de serviço |
| Vencimento (ms) | String | N/A | A data de vencimento da solicitação em milissegundos. |
| Modo | String | N/A | O modo da solicitação. |
| Nível | String | N/A | O nível da solicitação. |
| Site | String | N/A | O site da solicitação. |
| Grupo | String | N/A | O grupo da solicitação. |
| Impacto | String | N/A | O impacto da solicitação. |
Executar em
Essa ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Insights
N/A
Resultado do script
| Nome do resultado do script | Opções de valor | Exemplo |
|---|---|---|
| sucesso | Verdadeiro/Falso | success:False |
Resultado do JSON
N/A
Criar solicitação
Descrição
Se houver uma falha ou um problema no sistema, crie um problema, ou seja, envie uma solicitação à equipe da help desk de TI. Há diferentes modos de fazer uma solicitação: usando um formulário on-line, enviando uma notificação por e-mail e fazendo uma ligação telefônica. O ServiceDesk Plus oferece opções para registrar detalhes de uma solicitação originada em qualquer uma das formas mencionadas acima.
Parâmetros
| Parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
| Assunto | String | N/A | O assunto da solicitação. |
| Solicitante | String | N/A | O solicitante da solicitação. Se não for especificado, será definido como o usuário da chave de API. |
| Descrição | String | N/A | A descrição da solicitação. |
| Status | String | N/A | O status da solicitação. |
| Técnico | String | N/A | O nome do técnico atribuído à solicitação. |
| Prioridade | String | N/A | A prioridade da solicitação. |
| Urgência | String | N/A | A urgência da solicitação. |
| Categoria | String | N/A | A categoria da solicitação. |
| Modelo de solicitação | String | N/A | O modelo da solicitação. |
| Tipo de solicitação | String | N/A | O tipo da solicitação. Exemplo: incidente, solicitação de serviço |
| Vencimento (ms) | String | N/A | A data de vencimento da solicitação em milissegundos. |
| Modo | String | N/A | O modo da solicitação. |
| Nível | String | N/A | O nível da solicitação. |
| Site | String | N/A | O site da solicitação. |
| Grupo | String | N/A | O grupo da solicitação. |
| Impacto | String | N/A | O impacto da solicitação. |
Executar em
Essa ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Insights
N/A
Resultado do script
| Nome do resultado do script | Opções de valor | Exemplo |
|---|---|---|
| request_id | N/A | N/A |
Resultado do JSON
{
"isvipuser": "No",
"subcategory": null,
"resolvedtime": "0",
"site": "Chicago",
"timespentonreq": "0hrs 0min",
"technician": "Shawn Adams",
"responseduebytime": "1556101814544",
"shortdescription": "Testing the API adding request",
"fr_duetime": "1556101814544",
"subject": "Testing API 2",
"impact": "Affects Business",
"city": "London",
"group": null,
"approval_status": null,
"area": null,
"requesttype": "Convert the Incident to Change",
"yettoreplycount": null,
"priority": "High",
"respondedtime": "0",
"asset": null,
"createdby": "Demo",
"duebytime": "1556164814544",
"department": null,
"status": "Work Inprogress",
"category": "General",
"fcr": "false",
"description": "Testing the API adding request",
"closurecode": null,
"workorderid": "123",
"completedtime": "0",
"requesttemplate": "Default Request",
"requester": "Catrin Folkesson",
"createdtime": "1556092814544",
"technician_loginname": "adams",
"editing_status": "0",
"level": "Tier 1",
"country": "India",
"is_catalog_template": "false",
"sla": "High SLA",
"item": null,
"closurecomments": null,
"mode": "SMS",
"editorid": "null",
"impactdetails": null,
"urgency": "High"
}
Get Request
Descrição
Recupera informações sobre uma solicitação.
Parâmetros
| Parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
| ID da solicitação | String | N/A | O ID da solicitação. |
Executar em
Essa ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Insights
N/A
Resultado do script
| Nome do resultado do script | Opções de valor | Exemplo |
|---|---|---|
| sucesso | Verdadeiro/Falso | success:False |
Resultado do JSON
{
"isvipuser": "No",
"subcategory": null,
"resolvedtime": "0",
"site": "Chicago",
"timespentonreq": "0hrs 0min",
"technician": "Shawn Adams",
"responseduebytime": "1556101814544",
"shortdescription": "Testing the API adding request",
"fr_duetime": "1556101814544",
"subject": "Testing API 2",
"impact": "Affects Business",
"city": "London",
"group": null,
"approval_status": null,
"area": null,
"requesttype": "Convert the Incident to Change",
"yettoreplycount": null,
"priority": "High",
"respondedtime": "0",
"asset": null,
"createdby": "Demo",
"duebytime": "1556164814544",
"department": null,
"status": "Work Inprogress",
"category": "General",
"fcr": "false",
"description": "Testing the API adding request",
"closurecode": null,
"workorderid": "123",
"completedtime": "0",
"requesttemplate": "Default Request",
"requester": "Catrin Folkesson",
"createdtime": "1556092814544",
"technician_loginname": "adams",
"editing_status": "0",
"level": "Tier 1",
"country": "India",
"is_catalog_template": "false",
"sla": "High SLA",
"item": null,
"closurecomments": null,
"mode": "SMS",
"editorid": "null",
"impactdetails": null,
"urgency": "High"
}
Ping
Descrição
Teste a conectividade com a instância do ServiceDesk Plus.
Parâmetros
N/A
Executar em
Essa ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Insights
N/A
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 solicitação
Descrição
Atualiza uma solicitação.
Parâmetros
| Parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
| ID da solicitação | String | N/A | O ID da solicitação a ser atualizada. |
| Solicitante | String | N/A | O solicitante da solicitação. Se não for especificado, será definido como o usuário da chave de API. |
| Descrição | String | N/A | A descrição da solicitação. |
| Status | String | N/A | O status da solicitação. |
| Técnico | String | N/A | O nome do técnico atribuído à solicitação. |
| Prioridade | String | N/A | A prioridade da solicitação. |
| Urgência | String | N/A | A urgência da solicitação. |
| Categoria | String | N/A | A categoria da solicitação. |
| Modelo de solicitação | String | N/A | O modelo da solicitação. |
| Tipo de solicitação | String | N/A | O tipo da solicitação. Exemplo: incidente, solicitação de serviço |
| Vencimento (ms) | String | N/A | A data de vencimento da solicitação em milissegundos. |
| Modo | String | N/A | O modo da solicitação. |
| Nível | String | N/A | O nível da solicitação. |
| Site | String | N/A | O site da solicitação. |
| Grupo | String | N/A | O grupo da solicitação. |
| Impacto | String | N/A | O impacto da solicitação. |
Executar em
Essa ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Insights
N/A
Resultado do script
| Nome do resultado do script | Opções de valor | Exemplo |
|---|---|---|
| sucesso | Verdadeiro/Falso | success:False |
Resultado do JSON
{
"isvipuser": "No",
"subcategory": null,
"resolvedtime": "0",
"site": "Chicago",
"timespentonreq": "0hrs 0min",
"technician": "Shawn Adams",
"responseduebytime": "1556101814544",
"shortdescription": "Testing the API adding request",
"fr_duetime": "1556101814544",
"subject": "Testing API 2",
"impact": "Affects Business",
"city": "London",
"group": null,
"approval_status": null,
"area": null,
"requesttype": "Convert the Incident to Change",
"yettoreplycount": null,
"priority": "High",
"respondedtime": "0",
"asset": null,
"createdby": "Demo",
"duebytime": "1556164814544",
"department": null,
"status": "Work Inprogress",
"category": "General",
"fcr": "false",
"description": "Testing the API adding request",
"closurecode": null,
"workorderid": "123",
"completedtime": "0",
"requesttemplate": "Default Request",
"requester": "Catrin Folkesson",
"createdtime": "1556092814544",
"technician_loginname": "adams",
"editing_status": "0",
"level": "Tier 1",
"country": "India",
"is_catalog_template": "false",
"sla": "High SLA",
"item": null,
"closurecomments": null,
"mode": "SMS",
"editorid": "null",
"impactdetails": null,
"urgency": "High"
}
Aguardar atualização do campo
Descrição
Aguarde a mudança de um campo de solicitação para o valor desejado.
Parâmetros
| Parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
| ID da solicitação | String | N/A | O ID da solicitação. |
| Nome do campo | String | N/A | O nome do campo a ser atualizado. |
| Valores | String | N/A | Valores desejados para o campo especificado. |
Executar em
Essa ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Insights
N/A
Resultado do script
| Nome do resultado do script | Opções de valor | Exemplo |
|---|---|---|
| new_value | N/A | N/A |
Resultado do JSON
N/A
Aguardar atualização de status
Descrição
Aguarde a atualização do status de uma solicitação para o status desejado.
Parâmetros
| Parâmetro | Tipo | Valor padrão | Descrição |
|---|---|---|---|
| ID da solicitação | String | N/A | O ID da solicitação. |
| status | String | N/A | Status de solicitação desejados, separados por vírgula. |
Executar em
Essa ação é executada em todas as entidades.
Resultados da ação
Enriquecimento de entidades
N/A
Insights
N/A
Resultado do script
| Nome do resultado do script | Opções de valor | Exemplo |
|---|---|---|
| new_status | N/A | N/A |
Resultado do JSON
N/A
Precisa de mais ajuda? Receba respostas de membros da comunidade e profissionais do Google SecOps.