Integration mit Confluence Cloud

Integration von Software Asset ManagementAnwendung mit Confluence CloudMit 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 CloudAnwendung	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	Zusammenfassungen von Inhalten und Platzbereichen durchsuchen (Suche:Confluence)
Abonnement zurückfordern	Site-Administrator	Anwendergruppen lesen (read:Confluence-Groups) Anwendergruppen erstellen, entfernen und aktualisieren (write:Confluence-groups)

Erstellen Sie ein Confluence CloudOAuth 2,0-Anwendung (3LO)

Erstellen Sie ein Confluence CloudOAuth 2,0-Anwendung (3LO), um den Zugriff auf zu ermöglichen Confluence CloudAPI.

Vorbereitungen

AtlassianErforderliche Rolle: Siehe Minimale Anwenderberechtigungen Tabelle.

Prozedur

1. Öffnen Sie in einem Webbrowser Atlassian-Entwicklerportal .
2. Melden Sie sich bei Ihrem Site-Administrator-Account an.
3. Wählen Sie im Seitenheader des Portals Ihr Profilsymbol aus, und wählen Sie dann aus Entwicklerkonsole .
   Die Seite „meine Apps“ von AtlassianEntwicklerkonsole 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 aus Autorisierung .
   2. Wählen Sie Aus Konfigurieren Für den Autorisierungstyp OAuth 2,0 (3LO).
      Die Seite „OAuth 2,0-Autorisierungscode gewährt“ (3LO) für Apps wird geöffnet.
   3. In Rückruf-URL Geben Sie die URL des OAuth-Providers ein, an den Anwender nach der Authentifizierung weitergeleitet werden.
      Eingabetaste https:// Instanz .service-now.com/oauth_redirect.do , Wobei < Instanz > ist der Name von ServiceNowInstanz.
   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 AtlassianAPIs.
   1. Wählen Sie im linken Navigationsbereich aus Berechtigungen .
   2. Suchen Sie in der Liste der verfügbaren APIs die Konfluenz-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 Umfänge für die Confluence-API hinzu:
      • Durchsuchen Sie Zusammenfassungen von Inhalten und Platzbereichen
      • Anwendergruppen lesen
      • Erstellen, entfernen und aktualisieren Sie Anwendergruppen
      • Anwender lesen
9. Rufen Sie die Client-ID und den geheimen Client-Schlüssel ab, die Ihrer Anwendung zugewiesen sind.
   1. Wählen Sie im linken Navigationsbereich aus Einstellungen .
   2. Kopieren Sie im Abschnitt „Authentifizierungsdetails“ die Werte in Client-ID Und Geheimnis Felder.
      Speichern Sie sie an einem sicheren Ort für die spätere Verwendung.

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

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

Vorbereitungen

Confluence Cloud Erforderliche Rolle: administrator

Prozedur

1. Melden Sie sich bei an Atlassische Verwaltung .
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 Zeile Confluence-Produkt.

   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.

Erstellen Sie ein Confluence CloudIntegrationsprofil

Erstellen Sie ein Confluence CloudIntegrationsprofil, um Softwareabonnements nachzuverfolgen und die Lizenzierung für zu optimieren Confluence CloudAnwendungen.

Vorbereitungen

Zum Erstellen von Confluence CloudIntegrationsprofil, fordern Sie an Software Asset Management– SaaS-LizenzmanagementPlugin (sn_sam_saas_int) von ServiceNow-Speicher .

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 Application ManagerSeite. 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 CloudIntegrationsprofil in Core-UIIst 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. Integrationsprofilformular

   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	Typ des Integrationsprofils. 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 SaaSLizenzen.
   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 – Abonnements Herunterladen .
      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 – Anwenderaktivität Aktualisieren .
      Hinweis:

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

      In Analysieren Sie die Anwenderaktivität 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 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 „Schwellenwert für letzte Aktivität“ 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 – Abonnement Zurückfordern .
      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.
   Ihr ServiceNowInstanz erstellt einen Entwurf für ein Integrationsprofil.

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

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

   Tabelle : 3. Dialogfeld „Verbindung und Anmeldeinformationen erstellen“

   Feld	Beschreibung
   Name	Name der Verbindung.
   Verbindungs-URL	API-URL für Confluence Cloud.Dieses Feld wird automatisch auf festgelegt https://api.atlassian.com . Für Software Asset Management– SaaS-LizenzmanagementVersion 15.0.9 und höher: Geben Sie die URL von an Confluence CloudInstanz 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 CloudInstanz.
   OAuth-Client-ID	Client-ID, die Ihrem zugewiesen ist Confluence CloudOAuth 2,0-Anwendung (3LO).
   OAuth-Client-Geheimnis	Geheimer Clientschlüssel, der Ihrem zugewiesen ist Confluence CloudOAuth 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 ein Confluence CloudOAuth 2,0-Anwendung (3LO).

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

   Informationen zur Rolle, die zur Ausführung dieses Schritts erforderlich ist, finden Sie unter Minimale Anwenderberechtigungen Tabelle.
9. Wenn das Dialogfeld angezeigt wird, gewähren Sie die Berechtigung für Confluence CloudAnwendung.
   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 ServiceNowInstanz können Sie Daten abrufen und Lizenzen nur für die Anwender innerhalb dieser Gruppen verwalten.
    1. Öffnen Sie auf einer neuen Registerkarte Atlassian-Verwaltungsportal .
    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 Zeile Confluence-Produkt.
    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 ServiceNowInstanz und navigieren Sie zu Confluence-Cloud > Konfluenzgruppenan.
    8. Wählen Sie im Formular „Konfluenzgruppen“ die aus Fügen Sie Gruppen Hinzu Zugehöriger Link.
       Das Dialogfeld „Konfluenzgruppen 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 AtlassianAccount. Wählen Sie nur die Gruppen aus, die Zugriff auf Confluence-Produkte haben.
    11. Wählen Sie die Pfeilschaltfläche nach rechts aus, um die Gruppen aus der Liste verfügbar in die Liste ausgewählt zu verschieben.
    12. Wählen Sie OK aus.
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 ServiceNowDie Instanz erstellt 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 Software-Reklamationsregel.

Erstellen Sie Softwareberechtigungen für die automatisch generierten Softwaremodelle, um verwendete Software mit eigener Software zu verfolgen.

• Weitere Informationen zum Erstellen von Softwareberechtigungen finden Sie in Software Asset ManagementCore-UI, siehe Erstellen Sie Berechtigungen in Software Asset ManagementKlassisch.
• 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 ManagementPlaybook, siehe Erstellen Sie Berechtigungen mithilfe der geführten Walk-Through.

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

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