Intégration à PagerDuty

  • Rversion finale: Yokohama
  • Mis à jour 30 janv. 2025
  • 9 minutes de lecture

    • L’intégration de votre Gestion des actifs logiciels application à l’application PagerDuty vous permet de suivre vos abonnements logiciels et de récupérer les licences inutilisées.

    Important :
    Minimisez les risques de sécurité et protégez les informations en accordant l’accès uniquement aux autorisations nécessaires de l’utilisateur ou de l’API.
    Tableau 1. Autorisations utilisateur minimales
    Processus Rôle d’utilisateur requis dans l’application PagerDuty Périmètres d’authentification
    Télécharger les abonnements
    • Créer une application OAuth : Gestionnaire
    • Génération de jetons : observateur
    • OAuth inclus dans le champ d’application : users :read
    • OAuth utilisateur classique : lecture
    Pull user activity (Transférer l’activité utilisateur)
    • Créer une application OAuth : Gestionnaire
    • Génération de jetons : observateur
    • OAuth inclus dans le champ d’application : oncalls :read
    • OAuth utilisateur classique : lecture
    Récupérer l'abonnement Créer une application OAuth et une génération de jetons : administrateur général
    • OAuth dans le champ d’application : users :write
    • OAuth utilisateur classique : lecture/écriture

    Créer une PagerDuty application

    Créez une PagerDuty application à intégrer à votre ServiceNow instance.

    Avant de commencer

    PagerDuty Rôle requis : consultez la table Autorisations utilisateur minimales .

    Procédure

    1. À partir d’un navigateur Web, ouvrez PagerDuty.
    2. Connectez-vous à votre compte PagerDuty.
    3. Accéder au mode développeur.
      • Si vous êtes connecté avec un compte de développeur, vous pouvez accéder automatiquement au mode développeur.
      • Si vous êtes connecté avec un compte client, vous devez accéder manuellement au mode développeur.
      1. Dans l’en-tête de la page, sélectionnez l’icône de menu (icône Menu).
      2. Sélectionnez le mode développeur.
        Vous êtes redirigé vers la page Mes applications en mode développeur.
    4. Sur la page Mes applications, sélectionnez Créer une application.
    5. Renseignez les champs du formulaire Créer une application.
      Tableau 2. Formulaire Créer une application
      Champ Description
      Nom de l'application Nom de l’application PagerDuty . Par exemple, Intégration ServiceNow.
      Description brève Brève description de l’application.
      Catégorie Catégorie d’application. Sélectionnez Gestion des API dans la liste Catégorie.
      Nous aimerions vous aider à publier une application publique pour tous les PagerDuty utilisateurs. Avez-vous l’intention de publier l’application pour tous les PagerDuty utilisateurs et l’écosystème d’applications ? Option qui vous permet de rendre votre application publique en la publiant pour tous les PagerDuty utilisateurs. Ce champ est facultatif.
    6. Sélectionnez Enregistrer.
      PagerDuty enregistre votre application, puis vous renvoie à la page Mes applications.
    7. Facultatif : Configurez des paramètres d’application supplémentaires.
      1. Sur la page Mes applications, sélectionnez votre PagerDuty application.
        La page de configuration de l’application s’ouvre.
      2. Dans le champ URL du site web de l’application , saisissez l’URL du site web via laquelle les utilisateurs peuvent en savoir plus sur votre application.
      3. Dans le champ URL de l’icône , entrez l’URL d’un fichier image hébergé que vous souhaitez utiliser comme icône d’application.
        Les icônes doivent mesurer 50 px x x 50 px.
      4. Sélectionnez Enregistrer.

    Ajouter la fonctionnalité OAuth 2.0 à votre PagerDuty application

    Après avoir créé une application, ajoutez la PagerDuty fonctionnalité OAuth 2.0 pour l’autoriser à administrer des PagerDuty données spécifiques à l’utilisateur et à y accéder.

    Avant de commencer

    PagerDuty Rôle requis : consultez la table Autorisations utilisateur minimales .

    Procédure

    1. Sur la page Mes applications de votre PagerDuty compte, sélectionnez votre PagerDuty application.
      La page de configuration de l’application s’ouvre.
    2. Dans la section Fonctionnalité, localisez OAuth 2, puis sélectionnez Ajouter.
      La page OAuth 2 s’ouvre.
    3. Dans la section Ajouter une fonctionnalité OAuth 2, saisissez l’URL du fournisseur OAuth vers lequel les utilisateurs sont redirigés après authentification dans le champ URL de redirection .
      Entrez https://<nom-instance>/oauth_redirect.do, où <nom-instance> correspond au nom de votre ServiceNow instance.
    4. Sélectionnez Enregistrer.
    5. Dans la section Jetons, copiez les valeurs des champs ID client et Secret client .
      Conservez-les dans un endroit sûr pour une utilisation ultérieure.
    6. Dans la section Champs d’application, sélectionnez OAuth inclus dans le champ d’application ou OAuth utilisateur classique.
      Pour plus d’informations sur les étendues d’autorisation, reportez-vous à la table Autorisations utilisateur minimales .

    Créer un profil d'intégration PagerDuty

    Créez un profil d’intégration PagerDuty pour suivre les abonnements logiciels et optimiser la gestion des licences pour vos PagerDuty applications.

    Avant de commencer

    Pour créer un profil d’intégration, demandez le module d’extension PagerDutyGestion des actifs logiciels - Gestion des licences SaaS (sn_sam_saas_int) auprès de ServiceNow Store.

    ServiceNow Rôle requis : sam_integrator ou admin

    Important :
    Vous devez cocher la case Spoke PagerDuty pour cette intégration lors de l’installation des fonctionnalités facultatives sur la Application Manager page. Pour plus d’informations sur le choix des applications SaaS requises, reportez-vous à la section Demander le Gestion des licences SaaS.

    Pourquoi et quand exécuter cette tâche

    Si vous utilisez Software Asset Workspace, l’option de création du profil d’intégration PagerDuty dans Interface utilisateur principale est inactive.

    Procédure

    1. Accédez au profil d’intégration.
      InterfaceAction
      Interface utilisateur principale
      1. Accédez à la Tout > Actifs Logiciels > Licence SaaS > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez le profil d’intégration PagerDuty.
      Espace de travail des ressources logicielles
      1. Accédez à la Opérations de licence > Abonnements de l'utilisateur > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez PagerDuty dans la liste déroulante.
      4. Sélectionnez Continuer.
    2. Renseignez les champs du formulaire.
      Tableau 3. Formulaire Profil d’intégration
      Champ Description
      Nom d'affichage Nom du profil d’intégration. Par exemple, Intégration PagerDuty.
      Statut État du profil d'intégration.
      • Si vous n’avez pas publié le profil d’intégration, ce champ est automatiquement défini sur Brouillon.
      • Si vous avez déjà publié le profil d’intégration, ce champ est automatiquement défini sur Publié.
      Type de profil Type de profil d'intégration.

      Ce champ est automatiquement défini sur PagerDuty Abonnement.
    3. Examinez les rôles d’utilisateur requis ou les autorisations d’API spécifiés dans le champ de configuration du fournisseur pour chaque processus afin de minimiser les risques de sécurité et d’optimiser SaaS les licences.
      Remarque :
      Pour plus d’informations, consultez Table des autorisations utilisateur minimales .
      1. Dans la section Télécharger le flux secondaire d’abonnement, vérifiez que le champ Flux secondaire est défini sur Abonnements de téléchargement PagerDuty.
        Remarque :
        La case Télécharger les abonnements est cochée par défaut et vous ne pouvez pas la désactiver.
      2. Dans la section Calculer le flux secondaire d’activité, vérifiez que le champ Flux secondaire est défini sur PagerDuty Mettre à jour l’activité de l’utilisateur.
        Remarque :
        La case Télécharger l’activité est cochée par défaut. Si vous l’effacez, la tâche SAM - Refresh <displayname> Activity planifiée d’activité n’est pas créée.
        Dans le champ Analyser l’activité utilisateur , vous pouvez également sélectionner la date et l’heure à partir desquelles vous souhaitez analyser l’activité utilisateur. Par défaut, vous pouvez analyser l’activité des utilisateurs jusqu’à 60 jours avant la date actuelle et afficher les événements effectués par des utilisateurs individuels à partir du moment où vous créez ce profil.
        Remarque :
        Gestion des actifs logiciels extrait les événements à partir du moment où vous commencez à analyser l’activité de l’utilisateur, quelle que soit la date de création du profil.
        Vous pouvez modifier cette valeur dans le champ Seuil de la dernière activité de vos règles de réclamation de logiciel. Pour plus d'informations, consultez Examiner une règle de réclamation de logiciel.
      3. Dans la section Récupérer le flux secondaire d’abonnement, vérifiez que le champ Flux secondaire est défini sur PagerDuty Récupérer l’abonnement.
        Remarque :
        La case Récupérer les abonnements est cochée par défaut. Si vous ne souhaitez pas récupérer les abonnements, vous pouvez décocher cette case. Si vous l’effacez, les candidats à la suppression sont créés, mais le flux secondaire d’abonnement de récupération n’est pas déclenché ou le processus de réclamation n’est pas initié.
    4. Sélectionnez Enregistrer.
      Votre ServiceNow instance crée une ébauche de profil d’intégration.

      Le champ Connexion et informations d’identification s’affiche et est automatiquement défini sur sn_pagerduty_spoke. PagerDuty.

    5. Ouvrez l’enregistrement des alias de connexion et d’informations d’identification en sélectionnant l’icône d’aperçu (icône d’aperçu)en regard du champ Connexion et informations d’identification , puis en sélectionnant Ouvrir l’enregistrement dans l’aperçu de l’enregistrement.
    6. Dans le formulaire Alias de connexion et d’informations d’identification, sélectionnez le lien connexe Créer une nouvelle connexion et informations d’identification .
    7. Renseignez les champs de la boîte de dialogue.
      Tableau 4. Boîte de dialogue Créer une connexion et des informations d’identification
      Champ Description
      Nom Nom de la connexion. Par exemple, Connexion PagerDuty.
      ID client OAuth ID client qui est affecté à votre PagerDuty application.
      Secret client OAuth Clé secrète du client qui est affectée à votre PagerDuty application.
      URL de redirection OAuth URL du fournisseur OAuth vers lequel les utilisateurs sont redirigés après authentification. Entrez https://<nom-instance>/oauth_redirect.do, où <nom-instance> correspond au nom de votre ServiceNow instance.
    8. Sélectionnez Créer et obtenir un jeton OAuth.
      Remarque :
      Pour connaître le rôle requis pour effectuer cette étape, consultez la table Autorisations utilisateur minimales .
      Vous êtes redirigé vers la PagerDuty page Comptes.
    9. Sélectionnez le même PagerDuty compte que celui que vous avez utilisé pour créer votre PagerDuty application.
    10. Lorsque vous êtes invité à autoriser <pagerduty-app-name> à utiliser votre compte, sélectionnez Autoriser.
      Votre ServiceNow instance crée un jeton OAuth pour PagerDuty le formulaire de profil d’intégration, puis vous renvoie automatiquement au formulaire de profil d’intégration.
    11. Sur le formulaire de profil d’intégration, sélectionnez Valider la connexion pour vérifier les détails de connexion et d’informations d’identification de cette intégration.

      La validation de la connexion vérifie les API Télécharger les abonnements et Calculer l’activité, mais pas les API Récupérer les abonnements.

    12. Une fois la connexion vérifiée, sélectionnez Publier.
    13. Dans la boîte de dialogue Publier la confirmation, sélectionnez OK.
      Remarque :
      Si vous décochez la case Télécharger l’activité après la publication du profil d’intégration, vous devez revalider les connexions, puis republier le profil d’intégration, car les événements suivants se produisent :
      • Le champ État du formulaire de profil d’intégration devient Brouillon.
      • Le bouton Valider la connexion s’affiche sur le formulaire.
      • La tâche actuelle SAM - Refresh <displayname> Activity est supprimée.

    Que faire ensuite

    Une fois l’intégration connectée, votre ServiceNow instance crée automatiquement des modèles logiciels, des règles de réclamation et des abonnements logiciels qui sont actualisés quotidiennement.

    Si vous souhaitez configurer plusieurs profils d’intégration avec des connexions uniques, créez des alias enfants pour gérer différentes configurations et paramètres pour chaque profil d’intégration. Pour plus d'informations, consultez Créer un alias enfant pour configurer plusieurs profils d’intégration.

    Passez en revue toutes les règles de réclamation générées automatiquement pour récupérer les abonnements utilisateur. Pour plus d'informations, consultez Examiner une règle de réclamation de logiciel.

    Créez des autorisations logicielles pour les modèles logiciels générés automatiquement afin de suivre les logiciels utilisés par rapport aux logiciels possédés.
    Le rapprochement s’exécute également sur vos abonnements en tant que tâche planifiée ou à la demande. Vous pouvez afficher vos résultats de rapprochement dans la console de licence (Gestion des actifs logiciels application classique) ou dans la vue Utilisation de la licence (Software Asset Workspace). Utilisez ces résultats pour déterminer votre position en matière de conformité de licence et corriger toute non-conformité.