Intégration à Confluence Cloud

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 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 Confluence Cloud	Périmètres d’authentification
Télécharger les abonnements	Rôle d’utilisateur pour le produit Confluence	Lire des groupes d’utilisateurs (lire :confluence-groups) Utilisateur de lecture (lecture : confluence-user)
Pull user activity (Transférer 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 des groupes d’utilisateurs (lire :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 activer l’accès à l’API Confluence Cloud .

Avant de commencer

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

Procédure

1. Depuis 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, sélectionnez votre icône de profil, puis sélectionnez Developer Console.
   La page Mes applications de la Atlassian console développeur s’ouvre.
4. Sélectionnez le menu Créer une application, puis l’intégrationOAuth 2.0 (3LO).
   La page Créer une intégration OAuth 2.0 (3LO) s’ouvre.
5. Saisissez un nom pour l’application OAuth 2.0 (3LO) dans le champ Nom .
6. Cochez la case J’accepte d’être lié par les termes du développeur Atlassian , 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 du code d’autorisation 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.
      Entrez 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 de l’API pour votre application.
   Les champs d’application de l’API spécifient le niveau d’accès que l’application a 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 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.

Obtenir la valeur de l’ID dans le cloud de l’instance Confluence Cloud

Obtenez la valeur de l’ID dans le cloud de l’instance dans le Confluence Cloud cloud. Cette valeur est requise lors de la configuration de l’enregistrement de connexion dans votre ServiceNow instance.

Avant de commencer

Confluence Cloud Rôle requis : admin

Procédure

1. Connectez-vous à l’administration Atlassian.
2. Sélectionnez le bouton Sélectionner en regard de l’organisation requise.
3. Sélectionnez l’onglet Produits .
4. Sur la page Produits, sélectionnez Gérer le produit sur la ligne du produit Confluence.

   L’URL se trouve au format suivant dans une nouvelle fenêtre : https://admin.atlassian.com/o/<orgID>/products/conf/<Cloud-Id>.

5. Copiez la valeur de l’ID dans le cloud 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, demandez le module d’extension Confluence CloudGestion des actifs logiciels - Gestion des licences SaaS (sn_sam_saas_int) auprès de ServiceNow Store.

Atlassian Rôle requis : administrateur de site

ServiceNow Rôle requis : sam_integrator, sn_confluence_spoke.confluence_cloud_admin

Important :

Vous devez cocher la case Spoke Confluence Cloud 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 Confluence Cloud dans Interface utilisateur principale est inactive.

Procédure

1. Accédez au profil d’intégration.

   Interface	Action
   Interface utilisateur principale	Accédez à la Tous > Actifs Logiciels > Licence SaaS > Profils d'intégration directe. Sélectionnez Nouveau. Sélectionnez le profil d’intégration Confluence Cloud.
   Espace de travail actifs logiciels	Accédez à la Opérations de licence > Abonnements de l'utilisateur > Profils d'intégration directe. Sélectionnez Nouveau. Sélectionnez Confluence Cloud dans la liste déroulante. Sélectionnez Continuer.

2. Remplissez les champs du formulaire.

   Tableau 2. Formulaire Profil d’intégration

   Champ	Valeur
   Nom d'affichage	Nom du profil d’intégration. Par exemple, Intégration de Confluence Cloud.
   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. 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 Flux secondaire de téléchargement d’abonnement, vérifiez que le champ Flux secondaire est défini sur Abonnements de téléchargement à Confluence Cloud.
      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 de l’activité, vérifiez que le champ Flux secondaire est défini sur Confluence Cloud 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 Récupérer l’abonnement à Confluence Cloud.
      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.
   Une ébauche de profil d’intégration est créée.

   Le champ Connexion et informations d’identification apparaît et est automatiquement défini sur sn_conflunce_spoke.confluence_subscription_activity_reclaim lorsque tous les processus sont sélectionnés.

   Remarque :

   La valeur renseignée automatiquement dans le champ Connexion et informations d’identification change en fonction de la sélection dans les cases à cocher Activité de téléchargement et Récupérer les abonnements .

   Tableau 3. Valeurs de connexion et d’informations d’identification renseignées automatiquement en fonction de la sélection

   Sélection	Valeur de connexion et d’informations d’identification
   Les abonnements Télécharger l’activité et Récupérer sont sélectionnés.	sn_conflunce_spoke.confluence_subscription_activity_reclaim
   Seule l’activité Télécharger est sélectionnée.	sn_conflunce_spoke.confluence_subscription_activity
   Seuls les abonnements de récupération sont sélectionnés.	sn_conflunce_spoke.confluence_subscription_reclaim
   Les abonnements Activité de téléchargement et Récupération ne sont pas sélectionnés.	sn_conflunce_spoke.abonnement_confluence

5. Ouvrez l’enregistrement des alias de connexion et d’informations d’identification en sélectionnant l’icône d’aperçu (icône 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.
   URL de connexion	Fournissez l’URL de votre Confluence Cloud instance au format https://api.atlassian.com/ex/confluence/<Cloud-ID . Pour plus d’informations sur l’obtention de la valeur de l’ID dans le cloud, reportez-vous à la section Obtenir la valeur de l’ID dans le cloud de l’instance Confluence Cloud.
   ID client OAuth	ID client qui est affecté à votre Confluence Cloud application OAuth 2.0 (3LO).
   Secret client OAuth	Clé secrète du client qui est 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 est renseigné 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).

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 .
9. Lorsque la boîte de dialogue s’affiche, accordez l’autorisation à l’application Confluence Cloud .
   La boîte de dialogue se ferme et vous revenez automatiquement au formulaire Alias de connexion et d’informations d’identification.
10. 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 au compte administrateur avec un rôle site_admin.
    3. Sélectionnez le bouton Sélectionner en regard de l’organisation requise.
    4. Sélectionnez l’onglet Produits .
    5. Sur la page Produits, sélectionnez Gérer le produit sur la ligne du produit Confluence.
    6. Consultez la liste des groupes ayant accès aux produits Confluence.
       Prenez note de ces informations pour une utilisation ultérieure.
    7. Retournez à votre ServiceNow instance et accédez à Confluence Cloud > Groupes Confluence.
    8. Dans le formulaire Groupes Confluence, sélectionnez le lien connexe Ajouter des groupes .
       La boîte de dialogue Ajouter des groupes Confluence s’ouvre.
    9. Sélectionnez la connexion et les informations d’identification définies sur le profil d’intégration.
    10. Dans la liste Disponible, 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.
    11. Sélectionnez le bouton flèche vers la droite pour déplacer les groupes de la liste Disponible vers la liste Sélectionné.
    12. Sélectionnez OK.
11. Revenez à votre profil d’intégration, puis sélectionnez le profil d’intégration.
12. 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.

13. Une fois la connexion vérifiée, sélectionnez Publier.
14. 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.

Après avoir créé un profil d’intégration, affichez les informations relatives au profil dans le Software Asset Workspace en accédant à Opérations de licence > Abonnement de l'utilisateur > Profils d'intégration directe. Vous pouvez sélectionner un profil d’intégration pour afficher les listes connexes suivantes. Si toutes les listes connexes suivantes ne sont pas visibles pour un profil d’intégration dans la vue par défaut, vous pouvez sélectionner la vue d’intégration personnalisée dans l’onglet Détails :

• Modèles logiciels
• Identificateurs d'abonnement non reconnus
• Travaux planifiés
• Résultats de la tâche planifiée
• Abonnements logiciels
• Règle d'exclusion de l'identificateur d'abonnement
• Règle d'exclusion de l'utilisateur de l'abonnement

Après avoir créé un profil d’intégration, vous pouvez définir des règles d’exclusion des abonnements afin d’exclure certains abonnements du calcul des coûts de licence. Pour plus d'informations, consultez Exclusions d’abonnements pour SaaS les applications SSO et.

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 Confluence Cloud 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.

• Pour plus d’informations sur la création d’autorisations logicielles dans l’interface Gestion des actifs logiciels utilisateur principale, reportez-vous à la section Créer des autorisations au format Gestion des actifs logiciels classique.
• Pour plus d’informations sur la création d’autorisations logicielles dans Software Asset Workspace, reportez-vous à la section Créer des autorisations dans l’espace de travail.
• Pour plus d’informations sur la création d’autorisations logicielles à l’aide du Gestion des actifs logiciels playbook, reportez-vous à la section Créer des autorisations à l’aide de la visite guidée.

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é.

• Pour plus d’informations sur l’exécution du rapprochement dans l’application Gestion des actifs logiciels classique, reportez-vous à la section Exécuter le rapprochement de logiciel au format Gestion des actifs logiciels classique.
• Pour plus d’informations sur l’exécution du rapprochement dans Software Asset Workspace, reportez-vous à la section Exécuter le rapprochement de logiciel dans l’espace de travail.