Configurar o do GovNotify spoke

  • Versão de lançamento: Yokohama
  • Atualizado 30 de jan. de 2025
  • 1 min. de leitura

    • Integre a instância ServiceNow e a conta do GovNotify usando a autenticação JWT para autenticar solicitações ServiceNow.

    Antes de Iniciar

    • Solicitar uma assinatura de Integration Hub.
    • Ative o spoke do do GovNotify.
    • Função necessária: administrador

    Procedimento

    1. Na conta do GovNotify, crie uma chave de API.
      1. Faça login na sua conta do GovNotify como administrador.
      2. Navegar até Integração de API e clique em Chaves de API.
      3. Clique em Criar uma chave de API.
      4. No formulário, forneça um nome para a chave de API e selecione o tipo de chave necessário.
        Crie uma chave de API.
      5. Clique em “Continuar”.
        A chave de API é exibida neste formato: {key_name}-{iss-uuid}-{secret-key-uuid}. Por exemplo, se a chave de API for my_test_key-26785a09-ab16-4eb0-8407-a37497a57506-3d844edf-8d35-48ac-975b-e847b4f122b0:
        • O nome da chave de API é: my_test_key
        • iss (ID de serviço) é: 26785a09-ab16-4eb0-8407-a37497a57506
        • chave secreta ou chave de assinatura é: 3d844edf-8d35-48ac-975b-e847b4f122b0
        Para obter mais informações, consulte Cabeçalhos na documentação da REST API GovNotify.
      6. Clique em Copiar chave de API para a área de transferência e registre o valor para uso posterior.
        Copie a chave de API.
    2. Configure o registro de chave JWT padrão em sua instância ServiceNow.
      1. Navegar até OAuth de Sistema > Chaves de JWT.
      2. Abra o registro, Chave GovNotify.
      3. Insira a chave de assinatura que você copiou da chave de API em Chave de assinatura.
      4. Clique em Atualizar.
    3. Configure o registro do provedor JWT padrão em sua instância ServiceNow.
      1. Navegar até OAuth de Sistema > Provedores JWT.
      2. Abra o registro, Provedor JWT GovNotify.
      3. Na guia Sinistros padrão, clique no registro de emissão.
      4. Insira o valor iss (ID de serviço) que você copiou da chave de API em Valor de declaração.
      5. Clique em Atualizar.
    4. Configure o registro de credencial padrão em sua instância ServiceNow.
      1. Navegar até Spoke do GovNotify > Credenciais.
      2. Abra o registro, Cred GovNotify.
      3. Para Provedor JWT, selecione o provedor JWT que você configurou.
      4. Clique em Atualizar.
    5. Configure a conexão padrão e o registro de alias de credencial em sua instância ServiceNow.
      1. Navegar até Conexões e Credenciais > Aliases de conexão e credenciais.
      2. Abra o registro GovNotify.
      3. Na guia Conexões, clique em Novo.
      4. No formulário, preencha estes valores.
        Tabela 1. Formulário de conexão HTTP
        Campo Descrição
        Credencial Registro de credencial que você configurou. Por exemplo, Cred GovNotify.
        URL de conexão URL para se conectar à conta do GovNotify. Insira https://api.notifications.service.gov.uk.
      5. Clique em Enviar.