Receba eventos em sua instância ServiceNow de Amazon SNS

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 Integration Hub
• Ativar o Amazon SNS spoke
• Função necessária: administrador

Por Que e Quando Desempenhar Esta Tarefa

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

Criar segredo para o 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é Tudo > 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.
   

Criar um registro em Configurações da AWS

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

Antes de Iniciar

Função necessária: administrador

Procedimento

1. Navegar até Tudo > Configuração da AWS > Todas as configurações.
2. Clique em Nova.
3. No formulário, preencha os campos.

   Tabela 1. Formulário de 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á-la 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 o Amazon SNS spoke.

4. Clique com o botão direito no cabeçalho do formulário e clique em Salvar.
5. Clique com o botão direito do mouse no cabeçalho do formulário e clique em Copiar sys_id. Registre este valor para uso posterior.

Registrar o caminho da API base do Amazon SNS spoke

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

Antes de Iniciar

Função necessária: administrador

Procedimento

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

Criar tópico

Use a ação de 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 Workflow Studio, crie um fluxo e inclua a ação de spoke Criar tópico.
   Para obter informações sobre como criar fluxos em Workflow Studio, consulte Como criar fluxos.
2. Personalize o fluxo para fornecer esses 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 assinatura

Use a ação de 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 Workflow Studio, crie um fluxo e inclua a ação de spoke Criar assinatura.
   Para obter informações sobre como criar fluxos em Workflow Studio, consulte Como criar fluxos.
2. Personalize o fluxo para fornecer esses valores como entradas para a ação de 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. As assinaturas foram 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 da AWSe Criar segredo para o 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, clique em VALOR DO TEMPO DE EXECUÇÃO.
6. Copie e registre o valor de Token para uso posterior.
   Este token de confirmação é necessário para Confirmar assinatura.

   

   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 de 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 Workflow Studio, crie uma cópia do subfluxo de assinatura do Amazon SNS padrão.
   Para obter informações sobre como usar subfluxos em Workflow Studio, consulte Criação de subfluxos.
2. Em Workflow Studio, crie um fluxo que inclua a cópia do subfluxo padrão.
   Para obter informações sobre como criar fluxos em Workflow Studio, consulte Como criar fluxos.
3. Personalize o subfluxo para incluir a ação de spoke Confirmar assinatura.
4. Personalize o subfluxo para fornecer esses valores como entradas para a ação de 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. As assinaturas foram criadas para este tópico.
   Token	Token de confirmação gerado após a criação da assinatura. Consulte Criar assinatura, para 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 está confirmada.