Intégration à Confluence Cloud

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

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

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

    Important :
    Minimisez les risques de sécurité et protégez les informations en n’accordant l’accès qu’aux utilisateurs ou aux autorisations d’API nécessaires.
    Tableau 1. Autorisations utilisateur minimales
    Processus Rôle d’utilisateur requis dans l’application Confluence Cloud Périmètres d’authentification
    Télécharger les abonnements Rôle d’utilisateur pour le produit Confluence
    • Lire les groupes d’utilisateurs (read :confluence-groups)
    • Utilisateur en lecture (read :confluence-user)
    Extraire l’activité utilisateur Rôle d’utilisateur pour le produit Confluence Rechercher des résumés de contenu et d’espace Confluence (search :confluence)
    Récupérer l’abonnement Administrateur du site
    • Lire les groupes d’utilisateurs (read :confluence-groups)
    • Créer, supprimer et mettre à jour des groupes d’utilisateurs (write :confluence-groups)

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

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

    Avant de commencer

    Atlassian Rôle requis : reportez-vous au tableau Autorisations minimales de l’utilisateur .

    Procédure

    1. À partir d’un navigateur Web, ouvrez le portail Atlassian Developer.
    2. Connectez-vous à votre compte administrateur du site.
    3. Dans l’en-tête de la page du portail, sélectionnez l’icône de votre profil, puis sélectionnez Console développeur.
      La page Mes applications de la Atlassian Developer Console s’ouvre.
    4. Sélectionnez le menu Créer une application, puis l’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 d’Atlassian pour les développeurs , puis sélectionnez Créer.
    7. Configurez les paramètres d’autorisation de votre application.
      1. Dans le volet de navigation de gauche, sélectionnez Autorisation.
      2. Sélectionnez 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 , entrez l’URL du fournisseur OAuth vers lequel les utilisateurs sont redirigés après authentification.
        Saisissez https:// instance.service-now.com/oauth_redirect.do, où <instance> est le nom de votre ServiceNow instance.
      4. Sélectionnez Enregistrer les modifications.
    8. Configurez les périmètres d’API pour votre application.
      Les périmètres des 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 sélectionnez Ajouter.
        Le bouton Ajouter une action se transforme automatiquement en bouton Configurer l’action.
      3. Sélectionnez Configurer.
        La page de l’API Confluence s’ouvre.
      4. Ajoutez les champs d’application suivants pour l’API Confluence :
        • Rechercher des résumés de contenu et d'espace Confluence
        • Lire des groupes d'utilisateurs
        • Créer, supprimer et mettre à jour des groupes d’utilisateurs
        • Lire un utilisateur
    9. Récupérez l’ID client et le secret client qui sont 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) auprès du ServiceNow Store.

    Atlassian Rôle requis : site admin

    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 Confluence Cloud 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 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 2. 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 d’activité , vérifiez que le champ Flux secondaire est défini sur Flux secondaire d’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 de logiciel.
    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. Sélectionnez 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 Confluence Cloud abonnements, Confluence Cloud Mettre à jour l’activité utilisateur et Confluence Cloud Récupérer l’abonnement pour récupérer les données utilisateur à partir de l’application Confluence Cloud .
    7. Ouvrez l’enregistrement des alias de connexion et d’informations d’identification en sélectionnant l’icône d’aperçu ( icône 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.
    8. 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 .
    9. Renseignez les champs de la boîte de dialogue.
      Tableau 3. Boîte de dialogue Créer une connexion et des informations d’identification
      Champ Description
      Nom Nom de la connexion.
      Site URL URL de votre Confluence Cloud site.
      URL de connexion URL d’API pour Confluence Cloud.

      Ce champ est automatiquement défini sur 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. 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 .
      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 des utilisateurs au sein de ces groupes.
      1. Dans un nouvel onglet, ouvrez le portail d’administration Atlassian.
      2. Connectez-vous à votre compte administrateur du site.
      3. Accédez à la PARAMÈTRES DU SITE > Accès au produit.
      4. Dans la section Confluence, consultez la liste des groupes ayant accès aux produits Confluence.
        Prenez note de ces informations pour une utilisation ultérieure.
      5. Revenez à votre ServiceNow instance et accédez à Confluence Cloud > Groupes Confluence.
      6. Sur le formulaire Groupes Confluence, sélectionnez le lien connexe Ajouter des groupes .
        La boîte de dialogue Ajouter des groupes Confluence s’ouvre.
      7. Dans la liste Disponibles, sélectionnez les groupes qui ont accès aux produits Confluence.
        Conseil :
        La liste Disponible inclut tous les groupes associés à votre Atlassian compte. Sélectionnez uniquement les groupes qui ont accès aux produits Confluence.
      8. Sélectionnez le bouton flèche vers la droite pour déplacer les groupes de la liste Disponible vers la liste Sélectionné.
      9. Sélectionnez OK.
    12. Revenez à votre profil d’intégration en naviguant vers Licence SaaS > Administration > Profils d'intégration directe puis en sélectionnant le profil dans la liste Profils d’intégration.
    13. Sélectionnez Publier.
    14. Dans la boîte de dialogue Publier la confirmation, sélectionnez 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 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 les résultats de votre 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 de conformité de licence et pour remédier à toute non-conformité.