Receber eventos na sua instância [ ServiceNow de Amazon SNS

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 4 min. de leitura

    • Receba eventos (Notificação, Confirmação de assinatura e Confirmação de cancelamento de assinatura) de Amazon SNS na sua instância ServiceNow.

    Antes de Iniciar

    • Solicitar uma assinatura de IntegrationHub
    • Ativar o spoke Amazon SNS
    • Função necessária: administrador

    Por Que e Quando Desempenhar Esta Tarefa

    Você pode receber eventos na sua instância [ ServiceNow de Amazon SNS mesmo sem configurar o spoke Amazon SNS. Para configurar o spoke Amazon SNS e usar as ações do spoke, consulte Configurar o Amazon SNS spoke.

    Criar segredo para Amazon SNS spoke

    Crie um segredo do cliente para autorizar solicitações de Amazon SNS.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Definição do Sistema > Scripts - Segundo Plano.
    2. Insira este comando no campo de texto Executar script (JavaScript executado no servidor) :
      gs.info(GlideSecureRandomUtil.getSecureRandomString(32));
    3. Clique em Executar script.
    4. Copie e registre o valor gerado para uso posterior.
      Segredo do cliente ou chave de autorização

    Criar um registro em Configurações do AWS

    Crie um registro em Configurações do AWS para autorizar solicitações de Amazon SNS spoke.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Configuração da AWS > Todas as configurações.
    2. Clique em Nova.
    3. No formulário, preencha os campos.
      Tabela 1. Formulário Configurações da AWS
      Campo Descrição
      Valor da propriedade Nome interno do subfluxo de assinatura do Amazon SNS. Por exemplo, amazon_sns_subscription.
      Nota:
      O subfluxo de assinatura do Amazon SNS é um subfluxo de amostra. Você deve criar uma cópia deste subfluxo e usá-lo para personalizar a gestão de eventos de acordo com seus requisitos. Nesse caso, especifique o nome interno do subfluxo personalizado.
      Nome da propriedade Nome para identificar o registro.
      Segredo do cliente Segredo do cliente gerado pelo script. Para obter informações sobre como gerar o segredo do cliente, consulte Criar segredo para Amazon SNS spoke.
    4. Clique com o botão direito no cabeçalho do formulário e selecione Salvar.
    5. Clique com o botão direito do mouse no cabeçalho do formulário e selecione Copiar sys_ide registre este valor para uso posterior.

    Registrar o caminho da API base do Amazon SNS spoke

    Registre o caminho da API base do Amazon SNS spoke para autorizar solicitações de Amazon SNS.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Navegar até Todos > Serviços web do sistema > Scripted Web Services > Scripted REST APIs.
    2. Abra o registro do Amazon SNS.
    3. Copie e registre o valor do caminho da API base para uso posterior.

    Criar tópico

    Use a ação do spoke Criar tópico para criar um tópico em Amazon SNS para sua instância ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Em Flow Designer, crie um fluxo e inclua a ação de spoke Criar tópico.
      Para obter informações sobre como criar fluxos em Flow Designer, consulte Criação de fluxos.
    2. Personalize o fluxo para fornecer estes valores como entradas para a ação de spoke Criar tópico:
      Campo Descrição
      Região Área geográfica da AWS onde a infraestrutura está hospedada.
      Nome do Tópico Nome para identificar o tópico.
    3. Teste o fluxo e verifique a guia Execuções para garantir que o fluxo seja executado conforme o esperado.

    Criar uma assinatura

    Use a ação do spoke Criar assinatura para criar uma assinatura em Amazon SNS para sua instância ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Em Flow Designer, crie um fluxo e inclua a ação do spoke Criar assinatura.
      Para obter informações sobre como criar fluxos em Flow Designer, consulte Criação de fluxos.
    2. Personalize o fluxo para fornecer estes valores como entradas para a ação do spoke Criar assinatura:
      Campo Descrição
      Região Área geográfica da AWS onde a infraestrutura está hospedada.
      ARN do tópico ARN para identificar exclusivamente o tópico necessário. Assinaturas são criadas para este tópico.
      Protocolo HTTPS
      Endpoint URL do endpoint neste formato: https://<servicenow-instance> .service-now.com/<base-api-path> /<aws-configuration-sys_id> /<client-secret> .
      Nota:
      Para obter informações sobre como obter os valores necessários, consulte Registrar o caminho da API base do Amazon SNS spoke, Criar um registro em Configurações do AWSe Criar segredo para Amazon SNS spoke.
    3. Teste o fluxo.
      O fluxo aciona internamente o subfluxo de assinatura do Amazon SNS padrão.
    4. Na guia Execuções, abra o registro associado à execução do subfluxo.
      Nota:
      Certifique-se de verificar os detalhes de execução do subfluxo de assinatura do Amazon SNS padrão, não o fluxo que você criou.
    5. Na página Detalhes da execução, selecione RUNTIME VALUE.
    6. Copie e registre o valor de Token para uso posterior.
      Este token de confirmação é necessário para Confirmar assinatura.
      Valor do token no tempo de execução.
      Nota:
      Certifique-se de usar o token de confirmação para Confirmar assinatura dentro do período de validade.

    Resultado

    A assinatura do tópico necessário em Amazon SNS para sua instância ServiceNow foi criada.

    Confirmar assinatura

    Use a ação do spoke Confirmar assinatura para confirmar a assinatura em Amazon SNS para sua instância ServiceNow.

    Antes de Iniciar

    Função necessária: administrador

    Procedimento

    1. Em Flow Designer, crie uma cópia do subfluxo de assinatura do Amazon SNS padrão.
      Para obter informações sobre como usar subfluxos em Flow Designer, consulte Criação de subfluxos.
    2. Em Flow Designer, crie um fluxo que inclua a cópia do subfluxo padrão.
      Para obter informações sobre como criar fluxos em Flow Designer, consulte Criação de fluxos.
    3. Personalize o subfluxo para incluir a ação do spoke Confirmar assinatura.
    4. Personalize o subfluxo para fornecer estes valores como entradas para a ação do spoke Confirmar assinatura:
      Campo Descrição
      Região Área geográfica da AWS onde a infraestrutura está hospedada.
      ARN do tópico ARN para identificar exclusivamente o tópico necessário. Assinaturas são criadas para este tópico.
      Token Token de confirmação gerado após a criação da assinatura. Consulte Criar uma assinaturapara obter mais informações.
      Nota:
      Certifique-se de usar o token de confirmação para confirmar a assinatura dentro do período de validade.
    5. Teste o fluxo e verifique a guia Execuções para garantir que o fluxo seja executado conforme o esperado.

    Resultado

    A assinatura Amazon SNS da sua instância ServiceNow foi confirmada.