Criando Tickets para Checks de Postura Falhados

Pré-requisitos

• Usuário com Permissões para procurar espaços e Criar itens de trabalho

Passo 1: Configurando as Configurações Necessárias no Jira

Para configurar as configurações no Jira:

1. Na sua conta Atlassian, clique no seu perfil no canto superior direito e clique em Configurações da Conta.

2. Na aba Segurança, na seção Tokens de API, clique em Criar e gerenciar Tokens de API.

3. Você pode criar um token de API com ou sem escopos:

   1. Para criar um token de API com escopos:

      1. Clique em Criar Token de API com escopos.

      2. Adicione um Nome e data de expiração.
         Nota: Recomendamos selecionar a data de expiração máxima de 365 dias.

      3. Clique em Próximo e selecione o aplicativo Jira

      4. Clique em Próximo e selecione o escopo write:jira-work

      5. Clique em Criar.

   2. Para criar um token de API sem escopos:

      1. Clique em Criar Token de API.

      2. Adicione um Nome e data de expiração.
         Nota: Recomendamos selecionar a data de expiração máxima de 365 dias.

      3. Clique em Criar.

4. Copie e salve o token para que ele possa ser inserido no CMA.

5. Na sua conta Atlassian, na barra lateral, clique nos três pontos ao lado de Espaços.

6. Clique em Gerenciar espaços.

7. Copie e salve a Chave do espaço onde você deseja que os tickets sejam criados para que possa ser inserida no CMA.

8. Se você criou um token com escopos, em um navegador da web, entre em https://<your-site>.atlassian.net/_edge/tenant_info e copie o valor do cloudId para que ele possa ser inserido no CMA.
   Se você não criou um token com escopo, esta etapa não é necessária.

Passo 2: Configurando o Webhook no CMA

Para configurar o webhook no CMA:

1. No CMA, navegue para Conta > Assinaturas.

2. Na aba Webhooks, clique em Novo.

3. Adicione um Nome.

4. No menu suspenso Começar a partir do modelo, selecione Jira Criar Ticket de Checagem de Postura.

5. No campo URL:

   1. Para um token de API com escopos: https://api.atlassian.com/ex/jira/<cloudId>/rest/api/2/issue, onde <cloudId> é o cloudId que você copiou no Passo 1.

   2. Para um token de API sem escopos: https://<your-site>.atlassian.net/rest/api/2/issue, onde <your-site> é o nome do seu site Jira.

6. Adicionar o Nome de Usuário do usuário que criou o token de API no passo 1.

7. No campo Senha, insira a chave de API que você criou no passo 1.

8. Na seção Corpo Personalizado, substitua <YOUR-SPACE-KEY> pela chave de espaço que você copiou no passo 1.

9. (Opcional) Se o seu espaço não usar o tipo de trabalho Tarefa, ou exigir campos adicionais para novos itens de trabalho, edite o corpo conforme necessário.

10. Clique em Teste.
    Um item de teste foi criado no espaço Jira, e a mensagem Teste passou com sucesso é exibida. Você pode excluir o item de teste posteriormente.

11. Clique em Salvar.

Requisitos

• Usuário com a função itil

Passo 1: Configurando as Configurações Obrigatórias no ServiceNow

Para configurar as configurações no ServiceNow:

1. Inicie sessão em sua conta ServiceNow como administrador e navegue até Administração de Usuário > Usuários.

2. Clique em Novo.

3. Digite um User ID e endereço de e-mail e selecione Acesso apenas ao serviço web.

4. Clique em Enviar.

5. Abra o registro do usuário que você criou:

   1. Clique em Definir Senha e, em seguida, Gerar Senha. Copie e salve a senha para que possa ser inserida no CMA.

   2. Clique em Salvar Senha.  

   3. Na aba Funções, clique Editar e adicionar a função itil

   4. Clique em Salvar

Passo 2: Configurando o Webhook no CMA

Para configurar o webhook no CMA:

1. No CMA, acesse Conta > Assinaturas.

2. Na aba Webhooks, clique Novo.

3. Adicione um Nome.

4. No menu suspenso Começar a partir do modelo, selecione ServiceNow Criar Ticket de Verificação de Postura.

5. No campo URL, substitua <YOUR-INSTANCE-NAME> pelo nome da sua instância ServiceNow, de modo que o URL seja https://<instance>.service-now.com/api/now/table/incident.

   O nome da sua instância é a primeira parte do seu URL do ServiceNow. Por exemplo, se você entrar em https://acme.service-now.com, o nome da instância é acme, e o URL é https://acme.service-now.com/api/now/table/incident.

6. No campo Nome de Usuário , insira o ID do Usuário do ServiceNow que você criou no Passo 1.

7. No campo Senha , insira a senha do usuário ServiceNow que você criou no Passo 1.

8. (Opcional) Na seção Corpo Personalizado, altere a prioridade, urgência e impacto padrão dos incidentes, ou adicione campos como grupo de atribuição.

9. Clique em Teste.
   Um incidente de teste é criado no ServiceNow, e a mensagem Teste passou com sucesso é exibida. Você pode resolver ou fechar o item de trabalho de teste posteriormente.

10. Clique em Salvar.

Se a criação do ticket falhar, a mensagem de erro exibe o status retornado pelo sistema de tickets:

• 401 (Não Autorizado): As credenciais estão incorretas ou o token expirou. Verifique os campos Nome de Usuário e Senha do webhook, e clique em Teste. Para Jira, use o endereço de e-mail do usuário e o token da API. Se o token expirou, crie um novo token e atualize o campo Senha do webhook.

• 403 (Proibido): O usuário não possui as permissões necessárias. Para Jira, verifique se o usuário tem permissões de Navegar espaços e Criar itens de trabalho no espaço relevante. Para ServiceNow, verifique se o usuário possui a função de itil.

• 400 (Solicitação Incorreta): O sistema de tickets rejeitou o corpo da solicitação. Verifique se há uma chave de espaço incorreta ou um campo obrigatório ausente no Corpo Personalizado.

• ID do Ticket ausente: O ticket foi criado, mas Cato não pôde ler seu ID na resposta. Verifique se o mapeamento de resposta do webhook corresponde ao modelo.