Integration mit Confluence Cloud

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 6 Minuten Lesedauer

    • Sie können Ihre Instanz ServiceNow mit der Anwendung Confluence Cloud integrieren, um Ihre Softwareabonnements nachzuverfolgen und nicht verwendete Lizenzen zurückzufordern.

    Hinweis:
    Derzeit unterstützt diese Integration nur eine Site-Integration pro Profil.

    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 ermöglichen.

    Vorbereitungen

    Atlassian Erforderliche Rolle: Site-Administrator

    Prozedur

    1. Öffnen Sie in einem Webbrowser das Atlassian Developer Portal.
    2. Melden Sie sich bei Ihrem Site-Administratorkonto an.
    3. Klicken Sie im Seiten-Header des Portals auf Ihr Profilsymbol, und wählen Sie dann Entwicklerkonsoleaus.
      Die Seite „Meine Apps“ der Entwicklerkonsole Atlassian wird geöffnet.
    4. Klicken Sie auf das Menü App erstellen, und wählen Sie 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 einen Namen für die OAuth 2.0 (3LO)-Anwendung in das Feld Name ein.
    6. Aktivieren Sie das Kontrollkästchen Ich stimme zu, an die Entwicklerbedingungen von Atlassian gebunden zu sein, und klicken Sie dann auf Erstellen.
      Die Übersicht und die Einstellungen für Ihre neu erstellte App werden geöffnet.
    7. Konfigurieren Sie Autorisierungseinstellungen für Ihre Anwendung.
      1. Wählen Sie im linken Navigationsbereich Autorisierungaus.
      2. Klicken Sie für den Autorisierungstyp OAuth 2.0 (3LO) auf Konfigurieren.
        Die Seite OAuth 2.0-Autorisierungscode (3LO) für -Apps wird geöffnet.
      3. Geben Sie im Feld Callback URL (Rückruf-URL) die URL des OAuth-Providers ein, zu dem Benutzer nach der Authentifizierung weitergeleitet werden.
        Geben Sie https://instance.service-now.com/oauth_redirect.do ein, wobei <instance> der Name Ihrer Instanz ServiceNow ist.
      4. Klicken Sie auf Ä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 die Confluence-API, und klicken Sie dann auf Hinzufügen.
        Die Aktionsschaltfläche Hinzufügen ändert sich automatisch in die Aktionsschaltfläche Konfigurieren.
      3. Klicken Sie auf Konfigurieren.
        Die Seite „Confluence API“ wird geöffnet.
      4. Fügen Sie die folgenden Bereiche für die Confluence-API hinzu:
        • Durchsuchen Sie Confluence-Inhalte und Platzzusammenfassungen
        • Lesen Sie Benutzergruppen
        • Erstellen, entfernen und aktualisieren Sie Benutzergruppen
        • Anwender lesen
    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 Geheimer Schlüssel.
        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

    Um ein Confluence Cloud -Integrationsprofil zu erstellen, fordern Sie das Plugin Software Asset Management - SaaS-Lizenzmanagement (com.sn_sam_saas_int) aus dem 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 Workspace verwenden, ist die Option zum Erstellen des Integrationsprofils Confluence Cloud in der 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-Integrationsprofil aus.
      Software-Asset-Arbeitsbereich
      1. Navigieren zu Lizenzvorgänge > Benutzerabonnements > Profile für direkte Integration.
      2. Wählen Sie Neu.
      3. Wählen Sie Confluence Cloud aus der Dropdown-Liste aus.
      4. Wählen Sie Fortsetzen aus.
    2. Füllen Sie die Felder des Formulars aus.
      Tabelle : 1. 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 Entwurfgesetzt. 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. Vergewissern Sie sich, dass auf der Registerkarte Abonnement-Subflow herunterladen das Feld Subflow auf Confluence Cloud Download Subflow Abonnements festgelegt ist.
    4. Vergewissern Sie sich, dass auf der Registerkarte „Aktivitäts-Subflow berechnen“ das Feld Subflow auf Confluence Cloud Update User Activity Subflow(Subflow der Benutzeraktivität) festgelegt ist.
      Sie können auch das Datum und die Uhrzeit, aus denen Sie die Benutzeraktivität analysieren möchten, im Feld Benutzeraktivität analysieren von auswählen. Standardmäßig können Sie die Benutzeraktivität bis zu 60 Tage vor dem aktuellen Datum analysieren und Events anzeigen, die von einzelnen Benutzern ab dem Zeitpunkt der Erstellung dieses Profils durchgeführt wurden.
      Hinweis:
      Software Asset Management ruft die Events ab dem Zeitpunkt ab, zu dem Sie mit der Analyse der Benutzeraktivität beginnen, unabhängig vom Datum der Profilerstellung.
      Sie können diesen Wert im Feld Letzter Aktivitätsschwellenwert Ihrer Softwarerückforderungsregeln ändern. Weitere Informationen finden Sie unter Überprüfen Sie eine Software-Rückforderungsregel.
    5. Stellen Sie auf der Registerkarte Abonnement-Subflow zurückfordern sicher, dass das Feld Subflow auf Confluence Cloud Abonnement-Subflow zurückfordern festgelegtist.
    6. Klicken Sie auf Speichern.
      Ihre Instanz ServiceNow erstellt ein Entwurfs-Integrationsprofil. 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 für Aliasse für Verbindungen und Anmeldeinformationen, indem Sie auf das Vorschausymbol ( Vorschausymbol) neben dem Feld Verbindung und Anmeldeinformationen klicken und dann in der Datensatzvorschau auf Datensatz öffnen klicken.
    8. Klicken Sie im Formular für Aliasse für Verbindungen und Anmeldeinformationen auf den zugehörigen Link Neue Verbindung und Anmeldeinformationen erstellen.
    9. Füllen Sie im Dialogfeld die Felder aus.
      Tabelle : 2. Dialogfeld „Verbindung und Anmeldeinformationen erstellen“
      Feld Beschreibung
      Name Name der Verbindung
      Website-URL
      Hinweis:
      Dieses Feld wird nur angezeigt, wenn Sie Software Asset Management - SaaS-Lizenzmanagement Integrations Version 6.0.0 oder früher angefordert und installiert haben.
      		 URL Ihrer Confluence Cloud -Website.
      Verbindungs-URL
      Hinweis:
      Dieses Feld wird nur angezeigt, wenn Sie Software Asset Management - SaaS-Lizenzmanagement Integrations Version 7.0.0 oder höher angefordert und installiert haben.
      		 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-Providers, zu dem Benutzer nach der Authentifizierung weitergeleitet werden. Dieses Feld wird basierend auf der Rückruf-URL, die Sie in Erstellen Sie eine Confluence Cloud OAuth 2.0 (3LO)-Anwendungangegeben haben, automatisch ausgefüllt.
    10. Klicken Sie auf OAuth-Token erstellen und abrufen.
      Das Dialogfeld wird geschlossen, und Sie kehren automatisch zum Formular für 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 Daten abrufen und Lizenzen nur für die Benutzer innerhalb dieser Gruppen verwalten.
      1. Öffnen Sie auf einer neuen Registerkarte das Atlassian-Verwaltungsportal.
      2. Melden Sie sich bei Ihrem Site-Administratorkonto an.
      3. Navigieren zu SITE-EINSTELLUNGEN > 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. Klicken Sie im Formular „Confluence-Gruppen“ auf den zugehörigen Link Gruppen hinzufügen.
        Das Dialogfeld „Confluence-Gruppen 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 Konto Atlassian zugeordnet sind. Wählen Sie nur die Gruppen aus, die Zugriff auf Confluence-Produkte haben.
      8. Klicken Sie auf den Rechtspfeil, um die Gruppen aus der Liste Verfügbar in die Liste Ausgewählt zu verschieben.
      9. Klicken Sie auf OK.
    12. Kehren Sie zu Ihrem Integrationsprofil zurück, indem Sie zu navigieren SaaS-Lizenz > Administration > Profile für direkte Integration und dann das Profil aus der Liste „Integrationsprofile“ auswählen.
    13. Klicken Sie auf Veröffentlichen.
      Das Dialogfeld „Bestätigung veröffentlichen“ wird geöffnet.
    14. Klicken Sie im Dialogfeld auf OK.

    Nächste Maßnahme

    Nachdem die Integration eine Verbindung hergestellt hat, erstellt Ihre ServiceNow -Instanz automatisch Softwaremodelle, Rückforderungsregeln und Benutzerabonnements, die täglich aktualisiert werden.

    Überprüfen Sie alle automatisch generierten Rückforderungsregeln, um Benutzerabonnements zurückzufordern. Weitere Informationen finden Sie unter Überprüfen Sie eine Software-Rückforderungsregel.

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