Integration mit Confluence Cloud

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 9 Minuten Lesedauer

    • Durch die Integration Ihrer Anwendung Software Asset Management in die Anwendung Confluence Cloud können Sie Ihre Softwareabonnements nachverfolgen und nicht verwendete Lizenzen zurückfordern.

    Derzeit unterstützt diese Integration nur eine Standortintegration pro Profil.

    Wichtig:
    Minimieren Sie Sicherheitsrisiken und schützen Sie Informationen, indem Sie nur den erforderlichen Anwender- oder API-Berechtigungen Zugriff gewähren.
    Tabelle : 1. Minimale Benutzerberechtigungen
    Prozess Erforderliche Anwenderrolle in der Anwendung Confluence Cloud Authentifizierungsbereiche
    Abonnements herunterladen Anwenderrolle für Confluence-Produkt
    • Anwendergruppen mit Lesezugriff (read:confluence-groups)
    • Anwender lesen (read:confluence-user)
    Anwenderaktivität abrufen Anwenderrolle für Confluence-Produkt Confluence-Inhalte und Bereichszusammenfassungen durchsuchen (Suche:Confluence)
    Abonnement zurückfordern Site-Administrator
    • Anwendergruppen mit Lesezugriff (read:confluence-groups)
    • Anwendergruppen erstellen, entfernen und aktualisieren (write:confluence-groups)

    Erstellen Sie eine Confluence Cloud OAuth 2.0 (3LO)-Anwendung

    Erstellen Sie eine Confluence Cloud OAuth 2.0 (3LO)-Anwendung, um den Zugriff auf die Confluence Cloud API zu aktivieren.

    Vorbereitungen

    Atlassian Erforderliche Rolle: Siehe Tabelle „Mindestbenutzerberechtigungen“.

    Prozedur

    1. Öffnen Sie in einem Webbrowser das Atlassian-Entwicklerportal.
    2. Melden Sie sich bei Ihrem Site-Administratorkonto an.
    3. Wählen Sie im Seiten-Header des -Portals Ihr Profilsymbol und dann Entwicklerkonsoleaus.
      Die Seite „My Apps“ (Meine Apps) der Entwicklerkonsole Atlassian wird geöffnet.
    4. Wählen Sie das Menü App erstellen und dann OAuth 2.0 (3LO) integration (OAuth 2.0 (3LO)-Integration)aus.
      Die Seite Neue OAuth 2.0 (3LO)-Integration erstellen wird geöffnet.
    5. Geben Sie im Feld Name einen Namen für die Anwendung OAuth 2.0 (3LO) ein.
    6. Aktivieren Sie das Kontrollkästchen Ich stimme zu, an die Entwicklerbedingungen von Atlassian gebunden zu sein, und wählen Sie Erstellenaus.
    7. Konfigurieren Sie die Autorisierungseinstellungen für Ihre Anwendung.
      1. Wählen Sie im linken Navigationsbereich Autorisierenaus.
      2. Wählen Sie Konfigurieren für den Autorisierungstyp OAuth 2.0 (3LO) aus.
        Die Seite „OAuth 2.0-Autorisierungscodegewährungen (3LO) für Apps“ wird geöffnet.
      3. Geben Sie im Feld Rückruf-URL die URL des OAuth-Anbieters ein, an den Anwender nach der Authentifizierung weitergeleitet werden.
        Geben Sie https://Instanz.service-now.com/oauth_redirect.doein, wobei <Instanz> der Name Ihrer Instanz ServiceNow ist.
      4. Wählen Sie Änderungen speichern.
    8. Konfigurieren Sie API-Bereiche für Ihre Anwendung.
      API-Bereiche geben die Zugriffsebene an, die die Anwendung auf die Atlassian -APIs hat.
      1. Wählen Sie im linken Navigationsbereich Berechtigungenaus.
      2. Suchen Sie in der Liste der verfügbaren APIs nach der Confluence-API, und wählen Sie Hinzufügenaus.
        Die Schaltfläche Aktion hinzufügen wird automatisch in Aktionsschaltfläche Konfigurieren geändert.
      3. Wählen Sie Konfigurieren.
        Die Seite „Confluence API“ wird geöffnet.
      4. Fügen Sie die folgenden Bereiche für die Confluence API hinzu:
        • Confluence-Suchinhalte und Bereichszusammenfassungen
        • Anwendergruppen mit Lesezugriff
        • Benutzergruppen erstellen, entfernen und aktualisieren
        • Anwender mit Lesezugriff
    9. Rufen Sie die Client-ID und den geheimen Clientschlüssel ab, die Ihrer Anwendung zugewiesen sind.
      1. Wählen Sie im linken Navigationsbereich Einstellungenaus.
      2. Kopieren Sie im Abschnitt „Authentifizierungsdetails“ die Werte in den Feldern Client-ID und Geheimnis.
        Speichern Sie sie zur späteren Verwendung an einem sicheren Ort.

    Rufen Sie den Cloud-ID-Wert der Instanz Confluence Cloud ab

    Rufen Sie den Wert der Cloud-ID der Cloud-Instanz Confluence Cloud ab. Dieser Wert ist während der Konfiguration des Verbindungsdatensatzes in Ihrer Instanz ServiceNow erforderlich.

    Vorbereitungen

    Confluence Cloud Erforderliche Rolle: admin

    Prozedur

    1. Melden Sie sich bei der Atlassian-Administrationan.
    2. Wählen Sie die Schaltfläche Auswählen für die gewünschte Organisation aus.
    3. Wählen Sie die Registerkarte Produkte.
    4. Wählen Sie auf der Seite „Produkte“ in der Zeile Confluence-Produkt die Option Produkt verwalten aus.

      Die URL wird in einem neuen Fenster im folgenden Format angezeigt: https://admin.atlassian.com/o/<orgID> /products/conf/<Cloud-Id> .

    5. Kopieren Sie den Wert der Cloud-ID zur späteren Verwendung.

    Confluence Cloud-Integrationsprofile erstellen

    Erstellen Sie ein Confluence Cloud -Integrationsprofil, um -Softwareabonnements nachzuverfolgen und die Lizenzierung für Ihre Confluence Cloud -Anwendungen zu optimieren.

    Vorbereitungen

    Zum Erstellen eines Confluence Cloud -Integrationsprofils fordern Sie das Plugin Software Asset Management - SaaS-Lizenzmanagement (sn_sam_saas_int) im ServiceNow Storean.

    Atlassian Erforderliche Rolle: Site-Administrator

    ServiceNow Erforderliche Rolle: sam_integrator, sn_confluence_spoke.confluence_cloud_admin

    Wichtig:
    Sie müssen das Kontrollkästchen Confluence Cloud-Spoke für diese Integration aktivieren, während Sie optionale Funktionen auf der Seite Application Manager installieren. Weitere Informationen zur Auswahl der erforderlichen SaaS-Anwendungen finden Sie unter SaaS-Lizenzmanagement anfordern.

    Warum und wann dieser Vorgang ausgeführt wird

    Wenn Sie Software-Asset-Arbeitsbereichverwenden, ist die Option zum Erstellen des Integrationsprofils Confluence Cloud in Core-UI inaktiv.

    Prozedur

    1. Navigieren Sie zum -Integrationsprofil.
      SchnittstelleAktion
      Core-UI
      1. Navigieren zu Alle > Software Asset > SaaS-Lizenz > Profile für direkte Integration.
      2. Wählen Sie Neu.
      3. Wählen Sie Confluence Cloud Integration Profileaus.
      Software-Asset-Arbeitsbereich
      1. Navigieren zu Lizenzvorgänge > Anwenderabonnements > Direkte Integrationsprofile.
      2. Wählen Sie Neu.
      3. Wählen Sie in der Dropdown-Liste Confluence Cloud aus.
      4. Wählen Sie Fortsetzen.
    2. Füllen Sie die Felder des Formulars aus.
      Tabelle : 2. Formular „Integrationsprofil“.
      Feld Wert
      Anzeigename Name des Integrationsprofils. Beispiel: Confluence Cloud Integration.
      Status Status des Integrationsprofils.
      • Wenn Sie das Integrationsprofil nicht veröffentlicht haben, wird dieses Feld automatisch auf Entwurffestgelegt.
      • Wenn Sie das Integrationsprofil bereits veröffentlicht haben, wird dieses Feld automatisch auf Veröffentlichtgesetzt.
      Profiltyp Integrationsprofiltyp.

      Dieses Feld wird automatisch auf Confluence Cloud Subscriptionfestgelegt.
    3. Überprüfen Sie die erforderlichen Anwenderrollen oder API-Berechtigungen, die im Feld Lieferantenkonfiguration für jeden Prozess angegeben sind, um Sicherheitsrisiken zu minimieren und SaaS -Lizenzen zu optimieren.
      Hinweis:
      Weitere Informationen finden Sie unter Tabelle der minimalen Benutzerberechtigungen.
      1. Stellen Sie im Abschnitt „Subflow zum Herunterladen von Abonnements“ sicher, dass das Feld „Subflow“ auf Confluence Cloud-Download-Abonnementsfestgelegt ist.
        Hinweis:
        Das Kontrollkästchen Abonnements herunterladen ist standardmäßig aktiviert und kann nicht deaktiviert werden.
      2. Stellen Sie im Abschnitt „Subflow für Aktivität berechnen“ sicher, dass das Feld „Subflow“ auf Confluence Cloud Update User Activity (Confluence Cloud-Aktualisierung für Benutzeraktivität)festgelegt ist.
        Hinweis:
        Das Kontrollkästchen Download-Aktivität ist standardmäßig aktiviert. Wenn Sie diese Option löschen, wird die geplante Aktivitätsaufgabe SAM - Refresh <displayname> Activity nicht erstellt.
        Im Feld Anwenderaktivität analysieren können Sie auch das Datum und die Uhrzeit auswählen, ab dem Sie die Anwenderaktivität analysieren möchten. Standardmäßig können Sie die Anwenderaktivität bis zu 60 Tage vor dem aktuellen Datum analysieren und Ereignisse anzeigen, die von einzelnen Anwendern ab dem Zeitpunkt der Erstellung dieses Profils durchgeführt wurden.
        Hinweis:
        Software Asset Management ruft die Ereignisse ab dem Zeitpunkt ab, zu dem Sie die Analyse der Anwenderaktivität starten, unabhängig vom Datum der Profilerstellung.
        Sie können diesen Wert im Feld Letzter Aktivitätsschwellenwert Ihrer Softwarereklamationsregeln ändern. Weitere Informationen finden Sie unter Überprüfen Sie eine Softwarereklamationsregel.
      3. Stellen Sie im Abschnitt „Subflow zum Zurückfordern des Abonnements“ sicher, dass das Feld „Subflow“ auf Confluence Cloud – Abonnement zurückfordernfestgelegt ist.
        Hinweis:
        Das Kontrollkästchen Abonnements zurückfordern ist standardmäßig aktiviert. Wenn Sie Abonnements nicht zurückfordern möchten, können Sie dieses Kontrollkästchen deaktivieren. Wenn Sie diese Option löschen, werden die Entfernungskandidaten erstellt, aber der Subflow zum Zurückfordern des Abonnements wird nicht ausgelöst oder der Reklamationsprozess nicht initiiert.
    4. Wählen Sie Speichern.
      Ihre Instanz ServiceNow erstellt einen Integrationsprofilentwurf.

      Das Feld Verbindung und Anmeldeinformationen wird angezeigt und automatisch auf sn_conflunce_spoke.confluence_subscription_activity_reclaim festgelegt, wenn alle Prozesse ausgewählt sind.

    5. Öffnen Sie den Datensatz „Aliasse für Verbindungen und Anmeldeinformationen“, indem Sie das Vorschausymbol ( Vorschausymbol.) neben dem Feld „Verbindung und Anmeldeinformationen“ und dann Datensatz öffnen in der Datensatzvorschau auswählen.
    6. Wählen Sie im Formular „Aliasse für Verbindungen und Anmeldeinformationen“ den zugehörigen Link Neue Verbindung und Anmeldeinformationen erstellen aus.
    7. Füllen Sie die Felder im Dialogfeld aus.
      Tabelle : 3. Dialogfeld „Verbindungen und Anmeldeinformationen erstellen“.
      Feld Beschreibung
      Name Name der Verbindung
      Verbindungs-URL

      API-URL für Confluence Cloud.Dieses Feld wird automatisch auf https://api.atlassian.comfestgelegt.

      Geben Sie für Software Asset Management - SaaS-Lizenzmanagement Version 15.0.9 und höher die URL Ihrer Instanz Confluence Cloud unter https://api.atlassian.com/ex/confluence/ an. <Cloud-ID -Format. Weitere Informationen zum Abrufen des Werts der Cloud-ID finden Sie unter Rufen Sie den Cloud-ID-Wert der Instanz Confluence Cloud ab.
      OAuth-Client-ID Client-ID, die Ihrer Anwendung Confluence Cloud OAuth 2.0 (3LO) zugewiesen ist.
      OAuth-Client-Geheimnis Geheimer Clientschlüssel, der Ihrer Anwendung Confluence Cloud OAuth 2.0 (3LO) zugewiesen ist.
      OAuth-Umleitungs-URL URL des OAuth-Anbieters, zu dem Anwender nach der Authentifizierung weitergeleitet werden.

      Dieses Feld wird automatisch basierend auf der Rückruf-URL ausgefüllt, die Sie in Erstellen Sie eine Confluence Cloud OAuth 2.0 (3LO)-Anwendungangegeben haben.
    8. Wählen Sie OAuth-Token erstellen und abrufen aus.
      Hinweis:
      Informationen zur Rolle, die zum Ausführen dieses Schritts erforderlich ist, finden Sie in der Tabelle der minimalen Anwenderberechtigungen.
    9. Wenn das Dialogfeld angezeigt wird, erteilen Sie der Anwendung Confluence Cloud die Berechtigung.
      Das Dialogfeld wird geschlossen, und Sie kehren automatisch zum Formular „Aliasse für Verbindungen und Anmeldeinformationen“ zurück.
    10. Geben Sie die Gruppen an, die Zugriff auf Confluence-Produkte haben.
      Durch Angabe dieser Gruppen in Ihrer Instanz ServiceNow können Sie nur für die Benutzer innerhalb dieser Gruppen Daten abrufen und Lizenzen verwalten.
      1. Öffnen Sie auf einer neuen Registerkarte das Atlassian-Verwaltungsportal.
      2. Melden Sie sich beim Administratorkonto mit der Rolle „site_admin“ an.
      3. Wählen Sie die Schaltfläche Auswählen für die gewünschte Organisation aus.
      4. Wählen Sie die Registerkarte Produkte.
      5. Wählen Sie auf der Seite „Produkte“ in der Zeile Confluence-Produkt die Option Produkt verwalten aus.
      6. Zeigen Sie die Liste der Gruppen an, die Zugriff auf Confluence-Produkte haben.
        Notieren Sie sich diese Informationen zur späteren Verwendung.
      7. Kehren Sie zu Ihrer Instanz ServiceNow zurück, und navigieren Sie zu Confluence-Cloud > Vereinigungsgruppen.
      8. Wählen Sie im Formular „Confluence-Gruppen“ den zugehörigen Link Gruppen hinzufügen.
        Das Dialogfeld „Zusammenführungsgruppen hinzufügen“ wird geöffnet.
      9. Wählen Sie die Verbindung und die Anmeldeinformationen aus, die im Integrationsprofil festgelegt wurden.
      10. Wählen Sie in der Liste Verfügbar die Gruppen aus, die Zugriff auf Confluence-Produkte haben.
        Tipp:
        Die Liste Verfügbar enthält alle Gruppen, die Ihrem Account Atlassian zugeordnet sind. Wählen Sie nur die Gruppen aus, die Zugriff auf Confluence-Produkte haben.
      11. Wählen Sie die Nach-rechts-Taste, um die Gruppen aus der Liste Verfügbar in die Liste Ausgewählt zu verschieben.
      12. Wählen Sie OK.
    11. Kehren Sie zu Ihrem Integrationsprofil zurück, und wählen Sie dann das Integrationsprofil aus.
    12. Wählen Sie im Formular „Integrationsprofil“ Verbindung validieren aus, um die Verbindungs- und Anmeldeinformationsdetails dieser Integration zu überprüfen.

      Durch das Validieren der Verbindung werden die APIs zum Herunterladen von Abonnements und zum Berechnen von Aktivitäten überprüft, nicht jedoch die APIs zum Zurückfordern von Abonnements.

    13. Nachdem die Verbindung verifiziert wurde, wählen Sie Veröffentlichenaus.
    14. Wählen Sie im Dialogfeld „Bestätigung veröffentlichen“ die Option OKaus.
      Hinweis:
      Wenn Sie das Kontrollkästchen Download-Aktivität deaktivieren, nachdem das Integrationsprofil veröffentlicht wurde, müssen Sie die Verbindungen erneut validieren und das Integrationsprofil anschließend erneut veröffentlichen, da die folgenden Ereignisse eintreten:
      • Das Feld Status im Formular „Integrationsprofil“ ändert sich in Entwurf.
      • Im Formular wird die Schaltfläche „Verbindung validieren“ angezeigt.
      • Der aktuelle Auftrag SAM - Refresh <displayname> Activity wird gelöscht.

    Nächste Maßnahme

    Nachdem die Integration hergestellt wurde, erstellt Ihre Instanz ServiceNow automatisch Softwaremodelle, Reklamationsregeln und Softwareabonnements, die täglich aktualisiert werden.

    Wenn Sie mehrere Integrationsprofile mit eindeutigen Verbindungen einrichten möchten, erstellen Sie untergeordnete Aliasse, um verschiedene Konfigurationen und Einstellungen für jedes Integrationsprofil zu verwalten. Weitere Informationen finden Sie unter Erstellen Sie einen untergeordneten Alias, um mehrere Integrationsprofile einzurichten.

    Überprüfen Sie alle automatisch generierten Reklamationsregeln, um Anwenderabonnements zurückzufordern. Weitere Informationen finden Sie unter Überprüfen Sie eine Softwarereklamationsregel.

    Erstellen Sie Softwareberechtigungen für die automatisch generierten Softwaremodelle, um verwendete Software im Vergleich zu eigener Software nachzuverfolgen.
    Der Abgleich wird für Ihre Abonnements auch als geplante Aufgabe oder bei Bedarf ausgeführt. Sie können Ihre Abgleichergebnisse in der Lizenz-Workbench (Software Asset Management klassische Anwendung) oder in der Ansicht Lizenznutzung (Software Asset Workspace) anzeigen. Verwenden Sie diese Ergebnisse, um Ihre Position bei der Lizenz-Compliance zu bestimmen und etwaige Nichteinhaltungen zu beheben.