Configurar o spoke do GovNotify

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 1 min. de leitura
  • Integre ServiceNow instância e do GovNotify conta usando a autenticação JWT para autenticar ServiceNow solicitações.

    Antes de Iniciar

    • Solicite a assinatura do IntegrationHub.
    • Ativar o spoke 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
        • a chave secreta ou a chave de assinatura é: 3d844edf-8d35-48ac-975b-e847b4f122b0
        Para obter mais informações, consulte Cabeçalhos na documentação da REST API do 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 na sua instância ServiceNow.
      1. Navegar até OAuth de Sistema > Chaves de JWT.
      2. Abra o registro, GovNotify Key.
      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 na sua instância ServiceNow.
      1. Navegar até OAuth de Sistema > Provedores JWT.
      2. Abra o registro, Provedor JWT GovNotify.
      3. Na guia Declarações padrão, clique no registro iss.
      4. Insira o valor de iss (ID de serviço) que você copiou da chave de API em Valorda declaração.
      5. Clique em Atualizar.
    4. Configure o registro de credencial padrão na sua instância ServiceNow.
      1. Navegar até Spoke do GovNotify > Credenciais.
      2. Abra o registro, GovNotify Cred.
      3. Em 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 na sua instância ServiceNow.
      1. Navegar até Conexões e Credenciais > Aliases de conexão e credencial.
      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, GovNotify Cred.
        URL de conexão URL para conectar à conta do GovNotify. Insira https://api.notifications.service.gov.uk.
      5. Clique em Enviar.