Integration mit Confluence Cloud

Integration von Software Asset Management Anwendung mit Confluence Cloud Mit der Anwendung können Sie Ihre Softwareabonnements nachverfolgen und nicht verwendete Lizenzen zurückfordern.

Derzeit unterstützt diese Integration nur eine Site-Integration 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 Anwenderberechtigungen

Prozess	Erforderliche Anwenderrolle in Confluence Cloud Anwendung	Authentifizierungsbereiche
Abonnements herunterladen	Anwenderrolle für Confluence-Produkt	Anwendergruppen lesen (read:Confluence-groups) Anwender lesen (read:Confluence-user)
Anwenderaktivität abrufen	Anwenderrolle für Confluence-Produkt	Confluence-Inhalt und -Bereichszusammenfassungen durchsuchen (Suche:Confluence)
Abonnement zurückfordern	Site-Administrator	Anwendergruppen lesen (read:Confluence-groups) Anwendergruppen erstellen, entfernen und aktualisieren (write:Confluence-groups)

Erstellen Sie einen Confluence Cloud OAuth 2,0-Anwendung (3LO)

Erstellen Sie einen Confluence Cloud OAuth 2,0-Anwendung (3LO), um den Zugriff auf zu ermöglichen Confluence Cloud API.

Vorbereitungen

Atlassian Erforderliche Rolle: Weitere Informationen finden Sie im Minimale Anwenderberechtigungen Tabelle.

Prozedur

1. Öffnen Sie in einem Webbrowser Atlassian-Entwicklerportal .
2. Melden Sie sich bei Ihrem Site-Administratorkonto an.
3. Wählen Sie im Seitenheader des Portals Ihr Profilsymbol und dann aus Entwicklerkonsole .
   Die Seite „meine Apps“ von Atlassian Entwicklerkonsole wird geöffnet.
4. Wählen Sie aus Erstellen Sie eine App Menü und dann auswählen OAuth 2,0-Integration (3LO) .
   Die Integrationsseite Neues OAuth 2,0 (3LO) erstellen wird geöffnet.
5. Geben Sie einen Namen für die Anwendung OAuth 2,0 (3LO) in ein Name Feld.
6. Wählen Sie aus Ich stimme zu, an die Entwicklerbedingungen von Atlassian gebunden zu sein Aktivieren Sie das Kontrollkästchen, und wählen Sie dann aus Erstellen .
7. Konfigurieren Sie die Autorisierungseinstellungen für Ihre Anwendung.
   1. Wählen Sie im linken Navigationsbereich die Option aus Autorisierung .
   2. Wählen Sie Aus Konfigurieren Für den Autorisierungstyp OAuth 2,0 (3LO).
      Die Seite „OAuth 2,0-Autorisierungscode Grants (3LO) für Apps“ wird geöffnet.
   3. In Rückruf-URL Geben Sie die URL des OAuth-Providers ein, zu dem Anwender nach der Authentifizierung weitergeleitet werden.
      Geben Sie Ein https:// Instanz .service-now.com/oauth_redirect.do , Wobei < Instanz > ist der Name von ServiceNow Instanz.
   4. Wählen Sie Änderungen speichern.
8. Konfigurieren Sie API-Umfänge für Ihre Anwendung.
   API-Umfänge geben die Zugriffsebene an, die die Anwendung auf hat Atlassian APIs.
   1. Wählen Sie im linken Navigationsbereich die Option aus Berechtigungen .
   2. Suchen Sie in der Liste der verfügbaren APIs die Confluence-API, und wählen Sie dann aus Hinzufügen .
      Die Hinzufügen Die Aktionsschaltfläche ändert sich automatisch in Konfigurieren Aktionsschaltfläche.
   3. Wählen Sie Konfigurieren.
      Die Confluence-API-Seite wird geöffnet.
   4. Fügen Sie die folgenden Bereiche für die Confluence-API hinzu:
      • Confluence-Suchinhalte und Bereichszusammenfassungen
      • Anwendergruppen mit Lesezugriff
      • Erstellen, entfernen und aktualisieren Sie Anwendergruppen
      • 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 die Option aus Einstellungen .
   2. Kopieren Sie im Abschnitt „Authentifizierungsdetails“ die Werte in Client-ID Und Geheimnis Felder.
      Speichern Sie sie an einem sicheren Ort, um sie später zu verwenden.

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

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

Vorbereitungen

Confluence Cloud Erforderliche Rolle: administrator

Prozedur

1. Melden Sie sich bei an Atlassian-Administration .
2. Wählen Sie aus Wählen Sie Aus Schaltfläche für die erforderliche Organisation.
3. Wählen Sie aus Produkte Registerkarte.
4. Wählen Sie auf der Seite „Produkte“ die Option aus Produkt verwalten In der Confluence-Produktzeile.

   Die URL hat das folgende Format in einem neuen Fenster: 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 einen Confluence Cloud Integrationsprofil, um Softwareabonnements nachzuverfolgen und die Lizenzierung für zu optimieren Confluence Cloud Anwendungen.

Vorbereitungen

Zum Erstellen von Confluence Cloud Integrationsprofil, fordern Sie an Software Asset Management– SaaS-Lizenzmanagement Plugin (sn_sam_saas_int) aus dem ServiceNow Store .

Atlassian Erforderliche Rolle: Site-Administrator

ServiceNow Erforderliche Rolle: sam_Integrator, sn_confluence_Spoke.confluence_Cloud_admin

Wichtig:

Sie müssen auswählen Confluence Cloud-Spoke Kontrollkästchen für diese Integration beim Installieren optionaler Funktionen auf dem Application Manager Seite. Weitere Informationen zur Auswahl der erforderlichen SaaS-Anwendungen finden Sie unter SaaS-Lizenzmanagement anfordern.

Warum und wann dieser Vorgang ausgeführt wird

Wenn Sie verwenden Software-Asset-Arbeitsbereich, Die Option zum Erstellen von Confluence Cloud Integrationsprofil in Core-UI Ist inaktiv.

Prozedur

1. Navigieren Sie zum Integrationsprofil.

   Schnittstelle	Aktion
   Core-UI	Navigieren zu Alle > Software Asset > SaaS-Lizenz > Profile für direkte Integrationan. Wählen Sie Neu. Wählen Sie Aus Confluence Cloud-Integrationsprofil .
   Software-Asset-Arbeitsbereich	Navigieren zu Lizenzvorgänge > Anwenderabonnements > Direkte Integrationsprofilean. Wählen Sie Neu. Wählen Sie Aus Confluence-Cloud Aus der Dropdown-Liste. Wählen Sie Fortsetzen.

2. Füllen Sie im Formular die Felder 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 festgelegt Entwurf . Wenn Sie das Integrationsprofil bereits veröffentlicht haben, wird dieses Feld automatisch auf festgelegt Veröffentlicht .
   Profiltyp	Integrationsprofiltyp. Dieses Feld wird automatisch auf festgelegt Confluence Cloud-Abonnement .

3. Überprüfen Sie die erforderlichen Anwenderrollen oder API-Berechtigungen, die in angegeben sind Lieferantenkonfiguration Feld für jeden Prozess, um Sicherheitsrisiken zu minimieren und zu optimieren SaaS Lizenzen.
   Hinweis:

   Weitere Informationen finden Sie unter Minimale Anwenderberechtigungen Tabelle.
   1. Überprüfen Sie im Abschnitt Abonnement-Subflow herunterladen, ob die Subflow Feld ist auf festgelegt Confluence Cloud-Download-Abonnements .
      Hinweis:

      Die Abonnements herunterladen Das Kontrollkästchen ist standardmäßig aktiviert, und Sie können es nicht deaktivieren.
   2. Überprüfen Sie im Abschnitt Aktivitäts-Subflow berechnen, ob Subflow Feld ist auf festgelegt Confluence Cloud-Update-Anwenderaktivität .
      Hinweis:

      Die Aktivität Herunterladen Das Kontrollkästchen ist standardmäßig aktiviert. Wenn Sie sie löschen, wird die geplante Aufgabe der Aktivität angezeigt SAM - Refresh <displayname> ActivityWurde nicht erstellt.

      In Analysieren Sie die Anwenderaktivität Feld können Sie auch das Datum und die Uhrzeit auswählen, ab der Sie die Anwenderaktivität analysieren möchten. Standardmäßig können Sie Anwenderaktivitäten bis zu 60 Tage vor dem aktuellen Datum analysieren und Ereignisse anzeigen, die von einzelnen Anwendern ab dem Zeitpunkt der Erstellung dieses Profils ausgeführt wurden.

      Hinweis:

      Software Asset Management Ruft die Ereignisse ab dem Zeitpunkt ab, zu dem Sie mit der Analyse der Anwenderaktivität beginnen, unabhängig vom Erstellungsdatum des Profils.

      Sie können diesen Wert im Feld letzter Aktivitätsschwellenwert Ihrer Software-Reklamationsregeln ändern. Weitere Informationen finden Sie unter Überprüfen Sie eine Software-Reklamationsregel.
   3. Überprüfen Sie im Abschnitt Subflow „Abonnement zurückfordern“, ob Subflow Feld ist auf festgelegt Confluence Cloud-Reklamationsabonnement .
      Hinweis:

      Die Abonnements zurückfordern Das Kontrollkästchen ist standardmäßig aktiviert. Wenn Sie keine Abonnements zurückfordern möchten, können Sie dieses Kontrollkästchen deaktivieren. Wenn Sie dies löschen, werden die Entfernungskandidaten erstellt, der Subflow „Abonnement zurückfordern“ wird jedoch nicht ausgelöst, oder der Reklamationsprozess wird nicht initiiert.
4. Wählen Sie Speichern.
   Ein Entwurfsintegrationsprofil wird erstellt.

   Die Verbindung Und Anmeldeinformationen Feld wird angezeigt und automatisch auf festgelegt sn_conflunce_Spoke.confluence_Subscription_activity_reclaim Wenn alle Prozesse ausgewählt sind.

   Hinweis:

   Der automatisch ausgefüllte Wert in Verbindung und Anmeldeinformationen Feldänderungen basierend auf der Auswahl in Aktivität herunterladen Und Abonnements zurückfordern Kontrollkästchen.

   Tabelle : 3. Automatisch ausgefüllte Verbindungs- und Anmeldeinformationswerte basierend auf der Auswahl

   Auswahl	Wert für Verbindung und Anmeldeinformationen
   Beides Aktivität herunterladen Und Abonnements zurückfordern Sind ausgewählt.	sn_conflunce_Spoke.confluence_Subscription_activity_reclaim
   Nur Aktivität herunterladen Ist ausgewählt.	sn_conflunce_Spoke.Confluence_Subscription_activity
   Nur Abonnements zurückfordern Ist ausgewählt.	sn_conflunce_Spoke.confluence_Subscription_reclaim
   Beides Aktivität herunterladen Und Abonnements zurückfordern Sind nicht ausgewählt.	sn_conflunce_Spoke.Confluence_Subscription

5. Öffnen Sie den Datensatz für Aliasse für Verbindungen und Anmeldeinformationen, indem Sie das Vorschausymbol ( ) Neben Verbindung Und Anmeldeinformationen Feld und dann auswählen Öffnen Sie Den Datensatz In der Datensatzvorschau.
6. Wählen Sie im Formular Aliasse für Verbindungen und Anmeldeinformationen die aus Neue Verbindung Und Anmeldeinformationen Erstellen Zugehöriger Link.
7. Füllen Sie die Felder im Dialogfeld aus.

   Tabelle : 4. Dialogfeld „Verbindung und Anmeldeinformationen erstellen“

   Feld	Beschreibung
   Name	Name der Verbindung
   Verbindungs-URL	Geben Sie die URL von an Confluence Cloud Instanz in https://api.atlassian.com/ex/confluence/<Cloud-ID Format. Weitere Informationen zum Abrufen des Werts der Cloud-ID finden Sie unter Rufen Sie den Cloud-ID-Wert von ab Confluence Cloud Instanz.
   OAuth-Client-ID	Client-ID, die Ihrem zugewiesen ist Confluence Cloud OAuth 2,0-Anwendung (3LO).
   OAuth-Client-Geheimnis	Geheimer Clientschlüssel, der Ihrem zugewiesen ist Confluence Cloud OAuth 2,0-Anwendung (3LO).
   OAuth-Umleitungs-URL	URL des OAuth-Providers, zu dem Anwender nach der Authentifizierung weitergeleitet werden. Dieses Feld wird automatisch basierend auf der Rückruf-URL ausgefüllt, die Sie in angegeben haben Erstellen Sie einen Confluence Cloud OAuth 2,0-Anwendung (3LO).

8. Wählen Sie OAuth-Token erstellen und abrufen aus.
   Hinweis:

   Informationen zur Rolle, die für diesen Schritt erforderlich ist, finden Sie unter Minimale Anwenderberechtigungen Tabelle.
9. Wenn das Dialogfeld angezeigt wird, gewähren Sie dem die Berechtigung Confluence Cloud Anwendung.
   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.
    Indem Sie diese Gruppen auf Ihrem angeben ServiceNow Instanz können Sie Daten abrufen und Lizenzen nur für die Anwender innerhalb dieser Gruppen verwalten.
    1. Öffnen Sie auf einer neuen Registerkarte Atlassian-Administrationsportal .
    2. Melden Sie sich mit der Rolle „Site_admin“ beim Administratoraccount an.
    3. Wählen Sie aus Wählen Sie Aus Schaltfläche für die erforderliche Organisation.
    4. Wählen Sie aus Produkte Registerkarte.
    5. Wählen Sie auf der Seite „Produkte“ die Option aus Produkt verwalten In der Confluence-Produktzeile.
    6. Zeigen Sie die Liste der Gruppen an, die Zugriff auf Confluence-Produkte haben.
       Beachten Sie diese Informationen zur späteren Verwendung.
    7. Kehren Sie zu zurück ServiceNow Instanz und navigieren Sie zu Confluence-Cloud > Vereinigungsgruppenan.
    8. Wählen Sie im Formular Confluence-Gruppen die aus Fügen Sie Gruppen Hinzu Zugehöriger Link.
       Das Dialogfeld Confluence-Gruppen 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 zugeordnet sind Atlassian Account. Wählen Sie nur die Gruppen aus, die Zugriff auf Confluence-Produkte haben.
    11. Wählen Sie die Pfeilschaltfläche nach rechts, 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“ die Option aus Validieren Sie Die Verbindung Dient zum Überprüfen der Verbindungs- und Anmeldeinformationsdetails dieser Integration.

    Durch die Validierung der Verbindung werden die APIs „Abonnements herunterladen“ und „Aktivität berechnen“ überprüft, aber nicht die APIs „Abonnements zurückfordern“.

13. Nachdem die Verbindung verifiziert wurde, wählen Sie aus Veröffentlichen .
14. Wählen Sie im Dialogfeld „Bestätigung veröffentlichen“ die Option aus OK .
    Hinweis:

    Wenn Sie löschen Aktivität Herunterladen Kontrollkästchen nach der Veröffentlichung des Integrationsprofils müssen Sie die Verbindungen erneut validieren und dann das Integrationsprofil erneut veröffentlichen, da die folgenden Ereignisse auftreten:

    • Die Status Das Feld im Integrationsprofilformular ändert sich in Entwurf .
    • Die Validieren Sie die Verbindung Schaltfläche wird im Formular angezeigt.
    • Die aktuelle SAM - Refresh <displayname> ActivityAuftrag wird gelöscht.

Nächste Maßnahme

Nachdem die Integration eine Verbindung hergestellt hat, ist Ihr ServiceNow Die Instanz erstellt automatisch Softwaremodelle, Reklamationsregeln und Softwareabonnements, die täglich aktualisiert werden.

Zeigen Sie nach dem Erstellen eines Integrationsprofils Informationen zum Profil in an Software-Asset-Arbeitsbereich Indem Sie zu navigieren Lizenzvorgänge > Anwenderabonnement > Direkte Integrationsprofilean. Sie können ein Integrationsprofil auswählen, um die folgenden zugehörigen Listen anzuzeigen. Wenn nicht alle der folgenden zugehörigen Listen für ein Integrationsprofil in der Standardansicht sichtbar sind, können Sie die anwenderdefinierte Integrationsansicht auf der Registerkarte Details auswählen:

• Softwaremodelle
• Nicht erkannte Abonnementbezeichner
• Geplante Aufgaben
• Ergebnisse der geplanten Aufgabe
• Software-Abonnements
• Ausschlussregel für Abonnementbezeichner
• Ausschlussregel für Abonnementanwender

Nach dem Erstellen eines Integrationsprofils können Sie Abonnementausschlussregeln definieren, um bestimmte Abonnements von den Berechnungen der Lizenzkosten zu befreien. Weitere Informationen finden Sie unter Abonnementausschlüsse für SaaS Und SSO-Anwendungen.

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

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

Erstellen Sie Softwareberechtigungen für die automatisch generierten Softwaremodelle, um verwendete Software im Vergleich zu eigener Software nachzuverfolgen.

• Weitere Informationen zum Erstellen von Softwareberechtigungen in finden Sie in Software Asset Management Core-UI, siehe Erstellen Sie Berechtigungen in Software Asset Management Klassisch.
• Weitere Informationen zum Erstellen von Softwareberechtigungen im Software Asset-Arbeitsbereich finden Sie unter Erstellen Sie Berechtigungen im Arbeitsbereich.
• Weitere Informationen zum Erstellen von Softwareberechtigungen mit Software Asset Management Playbook, siehe Erstellen Sie Berechtigungen mit der geführten Führung.

Der Abgleich wird auch für Ihre Abonnements als geplante Aufgabe oder bei Bedarf ausgeführt. Sie können Ihre Abgleichergebnisse in anzeigen Lizenz-Workbench ( Software Asset Management Klassische Anwendung) oder Lizenznutzungsansicht (Software-Asset-Arbeitsbereich). Verwenden Sie diese Ergebnisse, um Ihre Lizenz-Compliance-Position zu bestimmen und Verstöße zu beheben.

• Weitere Informationen zum Ausführen des Abgleichs in finden Sie Software Asset Management Klassische Anwendung, siehe Führen Sie den Softwareabgleich in aus Software Asset Management Klassisch.
• Weitere Informationen zum Ausführen des Abgleichs im Software Asset-Arbeitsbereich finden Sie unter Führen Sie den Softwareabgleich im Arbeitsbereich aus.