Integration mit Confluence Cloud

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 6 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.do ein, 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.

    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 (com.sn_sam_saas_int) im ServiceNow Storean.

    Atlassian Erforderliche Rolle: Site-Administrator

    ServiceNow Erforderliche Rolle: sam_integrator, sn_confluence_spoke.confluence_cloud_admin

    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 Profile aus.
      Software-Asset-Arbeitsbereich
      1. Navigieren zu Lizenzvorgänge > Anwenderabonnements > Profile für direkte Integration.
      2. Wählen Sie Neu.
      3. Wählen Sie in der Dropdown-Liste Confluence Cloud aus.
      4. Wählen Sie Fortsetzen aus.
    2. Füllen Sie die Felder des Formulars aus.
      Tabelle : 2. Formular „Integrationsprofil“.
      Feld Wert
      Name Name des Integrationsprofils. Beispiel: Confluence Cloud Integration.
      Verbindung und Anmeldeinformationen Verbindungs- und Anmeldealias für Confluence Cloud. Dieses Feld wird automatisch ausgefüllt.
      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. Stellen Sie auf der Registerkarte Subflow zum Herunterladen von Abonnements sicher, dass das Feld Subflow auf Confluence Cloud-Download-Abonnements-Subflow festgelegtist.
    4. Stellen Sie auf der Registerkarte Aktivitäts-Subflow berechnen sicher, dass das Feld Subflow auf Confluence Cloud Update User Activity Subflow festgelegtist.
      Sie können auch das Datum und die Uhrzeit, ab der Sie die Anwenderaktivität analysieren möchten, im Feld Anwenderaktivität analysieren von auswählen. 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.
    5. Stellen Sie auf der Registerkarte Subflow zum Zurückfordern des Abonnements sicher, dass das Feld Subflow auf Confluence Cloud Subflowzum Zurückfordern des Abonnements festgelegt ist.
    6. Wählen Sie Speichern.
      Ihre Instanz ServiceNow erstellt einen Integrationsprofilentwurf. Das -Integrationsprofil verwendet die Subflows [ Confluence Cloud Abonnements herunterladen, Confluence Cloud Benutzeraktivität aktualisieren und Confluence Cloud Abonnement zurückfordern, um Benutzerdaten aus der Anwendung Confluence Cloud abzurufen.
    7. Ö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.
    8. Wählen Sie im Formular „ Aliasse für Verbindungen und Anmeldeinformationen“ den zugehörigen Link Neue Verbindung und Anmeldeinformationen erstellen aus.
    9. Füllen Sie die Felder im Dialogfeld aus.
      Tabelle : 3. Dialogfeld „Verbindungen und Anmeldeinformationen erstellen“.
      Feld Beschreibung
      Name Name der Verbindung
      Website-URL URL Ihrer Website Confluence Cloud
      Verbindungs-URL API-URL für Confluence Cloud.

      Dieses Feld wird automatisch auf https://api.atlassian.comfestgelegt.
      OAuth-Client-ID Client-ID, die Ihrer Anwendung Confluence Cloud OAuth 2.0 (3LO) zugewiesen ist.
      Geheimer OAuth-Schlüssel 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.
    10. 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.
      Das Dialogfeld wird geschlossen, und Sie kehren automatisch zum Formular „Aliasse für Verbindungen und Anmeldeinformationen“ zurück.
    11. 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 bei Ihrem Site-Administratorkonto an.
      3. Navigieren zu STANDORTEINSTELLUNGEN > Produktzugriff.
      4. Zeigen Sie im Abschnitt Confluence die Liste der Gruppen an, die Zugriff auf Confluence-Produkte haben.
        Notieren Sie sich diese Informationen zur späteren Verwendung.
      5. Kehren Sie zu Ihrer Instanz ServiceNow zurück, und navigieren Sie zu Confluence-Cloud > Vereinigungsgruppen.
      6. Wählen Sie im Formular „Confluence-Gruppen“ den zugehörigen Link Gruppen hinzufügen.
        Das Dialogfeld „Zusammenführungsgruppen hinzufügen“ wird geöffnet.
      7. 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.
      8. Wählen Sie die Nach-rechts-Taste, um die Gruppen aus der Liste Verfügbar in die Liste Ausgewählt zu verschieben.
      9. Wählen Sie OK.
    12. Kehren Sie zu Ihrem Integrationsprofil zurück, indem Sie zu navigieren SaaS-Lizenz > Administration > Profile für direkte Integration und wählen Sie dann das Profil aus der Liste der Integrationsprofile aus.
    13. Wählen Sie Veröffentlichen aus.
    14. Wählen Sie im Dialogfeld „Bestätigung veröffentlichen“ die Option OKaus.

    Nächste Maßnahme

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

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