Intégration avec Confluence Cloud

  • Rversion finale: Washingtondc
  • Mis à jour 1 févr. 2024
  • 7 minutes de lecture

    • Vous pouvez intégrer votre ServiceNow instance à l’application Confluence Cloud pour suivre vos abonnements logiciels et récupérer les licences inutilisées.

    Remarque :
    Actuellement, cette intégration ne prend en charge qu’une seule intégration de site par profil.

    Créer une Confluence Cloud application OAuth 2.0 (3LO)

    Créez une Confluence Cloud application OAuth 2.0 (3LO) pour activer l’accès à l’API Confluence Cloud .

    Avant de commencer

    Atlassian Rôle requis : administrateur du site

    Procédure

    1. À partir d’un navigateur Web, ouvrez le portail Atlassian Developer.
    2. Connectez-vous à votre compte administrateur de site.
    3. Dans l’en-tête de page du portail, cliquez sur l’icône de votre profil, puis sélectionnez Developer Console.
      La page Mes applications de la Atlassian Developer Console s’ouvre.
    4. Cliquez sur le menu Créer une application, puis sélectionnez Intégration OAuth 2.0 (3LO).
      La page Créer une intégration OAuth 2.0 (3LO) s’ouvre.
    5. Entrez un nom pour l’application OAuth 2.0 (3LO) dans le champ Nom .
    6. Cochez la case J’accepte d’être lié par les conditions d’utilisation pour les développeurs d’Atlassian , puis cliquez sur Créer.
      La vue d’ensemble et les paramètres de votre application nouvellement créée s’ouvrent.
    7. Configurez les paramètres d’autorisation de votre application.
      1. Dans le volet de navigation de gauche, sélectionnez Autorisation.
      2. Cliquez sur Configurer pour le type d’autorisation OAuth 2.0 (3LO).
        La page Autorisations de code OAuth 2.0 (3LO) pour les applications s’ouvre.
      3. Dans le champ URL de rappel , saisissez l’URL du fournisseur OAuth vers lequel les utilisateurs sont redirigés après authentification.
        Entrez https:// instance.service-now.com/oauth_redirect.do, où <instance> est le nom de votre ServiceNow instance.
      4. Cliquez sur Enregistrer les changements.
    8. Configurez les périmètres de l’API pour votre application.
      Les périmètres d’API spécifient le niveau d’accès de l’application aux Atlassian API.
      1. Dans le volet de navigation de gauche, sélectionnez Autorisations.
      2. Dans la liste des API disponibles, localisez l’API Confluence, puis cliquez sur Ajouter.
        Le bouton Ajouter une action passe automatiquement au bouton Configurer l’action.
      3. Cliquez sur Configurer.
        La page API Confluence s’ouvre.
      4. Ajoutez les périmètres suivants pour l’API Confluence :
        • Rechercher des résumés de contenu et d’espace Confluence
        • Lire les groupes d’utilisateurs
        • Créer, supprimer et mettre à jour des groupes d’utilisateurs
        • Lire l’utilisateur
    9. Récupérez l’ID client et le secret client affectés à votre application.
      1. Dans le volet de navigation de gauche, sélectionnez Paramètres.
      2. Dans la section Détails de l’authentification, copiez les valeurs des champs ID client et Secret .
        Conservez-les dans un endroit sûr pour une utilisation ultérieure.

    Créer un profil d'intégration Confluence Cloud

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

    Avant de commencer

    Pour créer un profil d’intégration Confluence Cloud , demandez le module d’extension Gestion des actifs logiciels - Gestion des licences SaaS (com.sn_sam_saas_int) à partir de ServiceNow Store.

    Atlassian Rôle requis : administrateur du site

    ServiceNow Rôle requis : sam_integrator, sn_confluence_spoke.confluence_cloud_admin

    Pourquoi et quand exécuter cette tâche

    Si vous utilisez Software Asset Workspace, l’option permettant de créer le profil d’intégration dans l’interface Confluence Cloud utilisateur principale est inactive.

    Procédure

    1. Accédez au profil d’intégration.
      InterfaceAction
      Interface utilisateur principale
      1. Accédez à la Tous > Actifs Logiciels > Licence SaaS > Profils d'intégration directe.
      2. Sélectionnez Nouveau.
      3. Sélectionnez Profil d’intégration Confluence Cloud.
      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 Confluence Cloud dans la liste déroulante.
      4. Sélectionnez Continuer.
    2. Renseignez les champs du formulaire.
      Tableau 1. Formulaire Profil d’intégration
      Champ Valeur
      Nom d'affichage Nom du profil d’intégration. Par exemple, Confluence Cloud Integration.
      Connexion et information d'identification Alias de connexion et d'informations d'identification pour Confluence Cloud. Ce champ se remplit automatiquement.
      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 Abonnement Confluence Cloud.
    3. Dans l’onglet Télécharger le flux secondaire d’abonnement , vérifiez que le champ Flux secondaire est défini sur Flux secondaire d’abonnements de téléchargement Confluence Cloud.
    4. Dans l’onglet Calculer le flux secondaire de l’activité , vérifiez que le champ Flux secondaire est défini sur Mettre à jour le flux secondaire de l’activité de l’utilisateur de Confluence Cloud.
      Vous pouvez également sélectionner la date et l’heure à partir desquelles vous souhaitez analyser l’activité de l’utilisateur dans le champ Analyser l’activité de l’utilisateur à partir de. 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 logiciels. Pour plus d'informations, consultez Réviser une règle de réclamation logicielle.
    5. Dans l’onglet Récupérer le flux secondaire d’abonnement , vérifiez que le champ Flux secondaire est défini sur Flux secondaire d’abonnement de récupération Confluence Cloud.
    6. Cliquez sur Enregistrer.
      Votre ServiceNow instance crée une ébauche de profil d’intégration. Le profil d’intégration utilise les flux secondaires Télécharger les abonnements, Confluence Cloud Mettre à jour l’activité Confluence Cloud de l’utilisateur et Confluence Cloud Récupérer l’abonnement pour récupérer les données utilisateur dans l’applicationConfluence Cloud.
    7. Ouvrez l’enregistrement des alias de connexion et d’informations d’identification en cliquant sur l’icône d’aperçu ( icône Aperçu.)en regard du champ Connexion et informations d’identification , puis en cliquant sur Ouvrir l’enregistrement dans l’aperçu de l’enregistrement.
    8. Sur le formulaire Alias de connexion et d’informations d’identification, cliquez sur le lien connexe Créer une nouvelle connexion et informations d’identification .
    9. Renseignez les champs de la boîte de dialogue.
      Tableau 2. Boîte de dialogue Créer une connexion et des informations d’identification
      Champ Description
      Nom Nom de la connexion.
      URL du site
      Remarque :
      Ce champ s’affiche uniquement si vous avez demandé et installé Gestion des actifs logiciels : Gestion des licences SaaS Intégrations version 6.0.0 ou antérieure.
      		 URL de votre Confluence Cloud site.
      URL de connexion
      Remarque :
      Ce champ s’affiche uniquement si vous avez demandé et installé Gestion des actifs logiciels : Gestion des licences SaaS Intégrations version 7.0.0 ou ultérieure.
      		 URL d’API pour Confluence Cloud. Ce champ est automatiquement https://api.atlassian.com.
      ID client OAuth ID client affecté à votre Confluence Cloud application OAuth 2.0 (3LO).
      Secret client OAuth Clé secrète du client affectée à votre Confluence Cloud application OAuth 2.0 (3LO).
      URL de redirection OAuth URL du fournisseur OAuth vers lequel les utilisateurs sont redirigés après authentification. Ce champ se remplit automatiquement en fonction de l’URL de rappel que vous avez spécifiée dans Créer une Confluence Cloud application OAuth 2.0 (3LO).
    10. Cliquez sur Créer et obtenir un jeton OAuth.
      La boîte de dialogue se ferme et vous revenez automatiquement au formulaire Alias de connexion et d’informations d’identification.
    11. Spécifiez les groupes qui ont accès aux produits Confluence.
      En spécifiant ces groupes sur votre ServiceNow instance, vous pouvez récupérer des données et gérer les licences uniquement pour les utilisateurs au sein de ces groupes.
      1. Dans un nouvel onglet, ouvrez le portail d’administration Atlassian.
      2. Connectez-vous à votre compte administrateur de site.
      3. Accédez à la PARAMÈTRES DU SITE > Accès au produit.
      4. Dans la section Confluence, affichez la liste des groupes ayant accès aux produits Confluence.
        Prenez note de ces informations pour une utilisation ultérieure.
      5. Retournez à votre ServiceNow instance et accédez à Confluence Cloud > Groupes Confluence.
      6. Sur le formulaire Groupes Confluence, cliquez sur le lien connexe Ajouter des groupes .
        La boîte de dialogue Ajouter des groupes Confluence s’ouvre.
      7. Dans la liste Disponible, sélectionnez les groupes qui ont accès aux produits Confluence.
        Conseil :
        La liste Disponible comprend tous les groupes associés à votre Atlassian compte. Sélectionnez uniquement les groupes qui ont accès aux produits Confluence.
      8. Cliquez sur la flèche vers la droite pour déplacer les groupes de la liste Disponible vers la liste Sélectionné.
      9. Cliquez sur OK.
    12. Revenez à votre profil d’intégration en accédant à Licence SaaS > Administration > Profils d'intégration directe , puis en sélectionnant le profil dans la liste Profils d’intégration.
    13. Cliquez sur Publier.
      La boîte de dialogue Publier la confirmation s’ouvre.
    14. Dans la boîte de dialogue, cliquez sur OK.

    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 utilisateur, qui sont actualisés quotidiennement.

    Passez en revue toutes les règles de réclamation générées automatiquement pour récupérer les abonnements des utilisateurs. Pour plus d'informations, consultez Réviser une règle de réclamation logicielle.

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