Configurer le GovNotify spoke

  • Rversion finale: Xanadu
  • Mis à jour 1 août 2024
  • 1 minute de lecture

    • Intégrez ServiceNow l’instance et GovNotify le compte à l’aide de l’authentification JWT pour authentifier les ServiceNow demandes.

    Avant de commencer

    • Demander Hub d'intégration un abonnement
    • Activer le spoke GovNotify
    • Rôle requis : administrateur

    Procédure

    1. Dans le GovNotify compte, créez une clé API.
      1. Connectez-vous à votre GovNotify compte en tant qu’administrateur.
      2. Accédez à la Intégration d’API et cliquez sur Clés API.
      3. Cliquez sur Créer une clé API.
      4. Sur le formulaire, fournissez un nom pour la clé API et sélectionnez le type de clé requis.
        Créer une clé API.
      5. Cliquez sur Continuer.
        La clé API est affichée au format suivant : {key_name}-{iss-uuid}-{secret-key-uuid}. Par exemple, si la clé API est my_test_key-26785a09-ab16-4eb0-8407-a37497a57506-3d844edf-8d35-48ac-975b-e847b4f122b0 :
        • Le nom de la clé API est : my_test_key
        • ISS (ID de service) est : 26785a09-ab16-4eb0-8407-a37497a57506
        • La clé secrète ou la clé de signature est : 3D844EDF-8D35-48AC-975B-E847B4F122B0
        Pour plus d’informations, consultez En-têtes dans la documentation de l’API REST GovNotify.
      6. Cliquez sur Copier la clé API dans le presse-papiers et enregistrez la valeur pour une utilisation ultérieure.
        Copiez la clé API.
    2. Configurez l’enregistrement de clé JWT par défaut dans votre ServiceNow instance.
      1. Accédez à la OAuth système > Clés JWT.
      2. Ouvrez l’enregistrement, Clé GovNotify.
      3. Saisissez la clé de signature que vous avez copiée à partir de la clé API dans Clé de signature.
      4. Cliquez sur Mettre à jour.
    3. Configurez l’enregistrement du fournisseur JWT par défaut dans votre ServiceNow instance.
      1. Accédez à la OAuth système > Fournisseurs JWT.
      2. Ouvrez l’enregistrement, Fournisseur GovNotify JWT.
      3. Dans l’onglet Réclamations standard , cliquez sur l’enregistrement iss .
      4. Saisissez la valeur de l’ISS (ID de service) que vous avez copiée à partir de la clé API dans Valeur de réclamation.
      5. Cliquez sur Mettre à jour.
    4. Configurez l’enregistrement des informations d’identification par défaut dans votre ServiceNow instance.
      1. Accédez à la Spoke GovNotify > Informations d'identification.
      2. Ouvrez l’enregistrement, GovNotify Cred.
      3. Pour Fournisseur JWT, sélectionnez le fournisseur JWT que vous avez configuré.
      4. Cliquez sur Mettre à jour.
    5. Configurez l’enregistrement d’alias de connexion et d’informations d’identification par défaut dans votre ServiceNow instance.
      1. Accédez à la Connexions et informations d'identification > Alias de connexion et d'informations d'identification.
      2. Ouvrez l’enregistrement, GovNotify.
      3. Dans l'onglet Connexions, cliquez sur Nouveau.
      4. Renseignez ces valeurs sur le formulaire.
        Tableau 1. Formulaire Connexion HTTP(s)
        Champ Description
        Informations d'identification Enregistrement d’informations d’identification que vous avez configuré. Par exemple, GovNotify Cred.
        URL de connexion URL pour se connecter au GovNotify compte. Saisissez https://api.notifications.service.gov.uk.
      5. Cliquez sur Envoyer.