Testando integrações de emissão de bilhetes configuradas

Para o Jira configurado e ServiceNow as integrações, você pode testar a conexão para garantir que toda a configuração no Security Hub e no seu Jira ou ServiceNow ambiente esteja completa.

O recurso de tíquete de teste criará um tíquete com o título deTESTING Test CreateTicketV2 Finding. O tíquete de teste é preenchido com dados de amostra, como ID da conta e região da conta em que o teste é realizado, detalhes do recurso de amostra e amostra de AWS Finding JSON.

Testando integrações usando o console

Use as etapas a seguir para testar sua integração:

1. No painel de navegação do Security Hub, escolha Integrações.

2. Na guia Integrações configuradas, escolha a integração que você deseja testar.

3. Na página de visão geral da sua integração, escolha Criar tíquete de teste.

4. Se o teste for bem-sucedido, uma mensagem de sucesso junto com um link para o tíquete de teste será exibida. Se o teste não for bem-sucedido, um erro para o teste será exibido. Com base na mensagem de erro, resolva os problemas de configuração no Security Hub ou em seu ambiente Jira ou Service Now.

nota

O recurso de tíquete de teste tem como objetivo ajudar a verificar a funcionalidade de ponta a ponta na configuração de uma nova conexão ou quando você faz alterações em uma conexão existente. Esse recurso criará um novo ticket em seu ambiente Jira ou Service Now toda vez que for usado e não se destina a ser usado para verificação regular de sua conexão.

Testando com o AWS CLI

Para testar sua integração usando oAWS CLI, use o create-ticket-v2 comando com o --mode DRYRUN parâmetro:

aws securityhub create-ticket-v2 \
  --mode DRYRUN \
  --region <your-region> \
  --connector-id <your-connector-id> \
  --finding-metadata-uid "TEST_FINDING"
        

Exemplo

O exemplo a seguir mostra como testar uma integração:

aws securityhub create-ticket-v2 \
  --mode DRYRUN \
  --region us-east-1 \
  --connector-id "a1b2c3d4-5678-90ab-cdef-EXAMPLE11111" \
  --finding-metadata-uid "TEST_FINDING"
        

Resposta bem-sucedida

Uma resposta bem-sucedida retorna o seguinte:

{
    "TicketId": "a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6",
    "TicketSrcUrl": "https://your-instance.service-now.com/nav_to.do?uri=x_aws_se_0_finding.do?sys_id=a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6"
}
        

A TicketSrcUrl resposta fornece um link direto para visualizar o tíquete de teste em seu Jira ou ServiceNow ambiente.

Se o teste falhar, uma mensagem de erro será exibida indicando o problema de configuração que precisa ser resolvido.

Solucionando erros de integração com a nuvem do Jira

Ao testar sua integração com o Jira Cloud a partir do Security Hub, as seguintes mensagens de erro podem ser retornadas. Essas mensagens de erro podem fornecer informações sobre onde pode estar o problema de configuração com o conector e como resolvê-lo.

Mensagens de erro de integração com o Jira Cloud

Erro	Mensagem de erro	Causa provável e resolução
ConflictException	Não é possível encontrar o projeto jira	Causa provável: o projeto no conector está incorreto ou credentials/permissions problema nos impedindo de acessar o projeto. Resolução provável: adicione o projeto correto ao conector ou reautentique-se no Jira com as credenciais corretas.
ConflictException	Tipo de problema do Security Hub não encontrado	Causa provável: o problema ou o tipo de problema na instalação do aplicativo não está associado ao projeto. Resolução provável: execute a etapa de pré-requisito para instalar o aplicativo Jira em seu ambiente Jira e associar o aplicativo ao projeto.