Integration mit Jira Software Cloud

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

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

    Hinweis:
    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 Jira Software Cloud Authentifizierungsbereiche
    Abonnements herunterladen Berechtigung zum Zugriff auf Jira
    • read:application-role:jira
    • Lesen:Gruppe:Jira
    • lesen:user:jira
    • lesen:avatar:jira
    Anwenderaktivität abrufen
    • Globale Berechtigung Jira verwalten
    • Durchsuchen Sie die Projektberechtigung für das Projekt, das das Problem enthält.

      Wenn Sicherheit auf Problemebene konfiguriert ist, Sicherheitsberechtigung auf Problemebene zum Anzeigen des Problems.
    • lesen:user:jira
    • lesen:issue-details:jira
    • read:audit-log:jira
    • lesen:avatar:jira
    • read:field-configuration:jira
    • read:issue-meta:jira
    Abonnement zurückfordern Site-Administration, also Mitglied der Gruppe „site-admin“.
    • Lesen:Gruppe:Jira
    • Schreiben:Gruppe:Jira

    Standardauthentifizierung wird verwendet

    Integrieren Sie die Anwendung Software Asset Management und Jira mithilfe eines API-Schlüssels, um ServiceNow -Anforderungen zu authentifizieren.

    Sie können eine Instanz ServiceNow mit mehreren Instanzen Jira integrieren. Erstellen Sie für diese Integration einen Aliasdatensatz für Verbindungen und Anmeldeinformationen sowie einen Verbindungsdatensatz für jede Jira -Instanz.

    Erstellen Sie ein Jira -Account-API-Token

    Erstellen Sie in Jira ein API-Token, um Anforderungen zu authentifizieren.

    Vorbereitungen

    Jira Erforderliche Rolle: Verweisen Sie auf die Tabelle der minimalen Benutzerberechtigungen.

    Prozedur

    1. Navigieren Sie zu Atlassian API Tokens.
    2. Wählen Sie API-Token erstellen aus.
    3. Geben Sie einen Namen für Ihr API-Token ein, und wählen Sie Erstellenaus.
    4. Kopieren Sie das API-Token, und speichern Sie es.
      Sie werden das Token später verwenden.

    Konfigurieren Sie den Verbindungs- und Anmeldeinformationsdatensatz

    Konfigurieren Sie den Standardalias-Datensatz für Verbindungen und Anmeldeinformationen, um die Anforderungen von ServiceNowzu authentifizieren.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationen.
    2. Öffnen Sie den Aliasdatensatz für Jira, der mit der Spoke geliefert wird.
    3. Wählen Sie den zugehörigen Link Neue Verbindung und Anmeldeinformationen erstellen aus.
    4. Füllen Sie die Felder des Formulars aus.
      Tabelle : 2. Verbindung und Anmeldeinformationen erstellen
      Feld Beschreibung
      Verbindungs-URL URL Ihrer Instanz Jira in https:// <provider-domain-name> Format „.atlassian.net“ .
      Anwendername Geben Sie die E-Mail-Adresse des Anwenders ein.
      API-Schlüssel Geben Sie das API-Token ein, das Sie für Jirageneriert haben.
    5. Wählen Sie Erstellen aus.

    Mithilfe von OAuth-Authentifizierung

    Integrieren Sie die Anwendung Software Asset Management mit Ihrem Konto Jira mithilfe von OAuth, um ServiceNow -Anforderungen zu authentifizieren.

    Erstellen Sie eine OAuth 2.0-Integration im Account Jira

    Erstellen Sie eine OAuth 2.0-Integration in der Entwicklerkonsole Atlassian, um die -Anforderungen zu authentifizieren.

    Vorbereitungen

    Jira Erforderliche Rolle: Verweisen Sie auf die Tabelle der minimalen Benutzerberechtigungen.

    Prozedur

    1. Melden Sie sich bei der Atlassian-Entwicklerkonsolean.
    2. Wählen Sie unter Meine Appsdie Option Erstellen und dann OAuth 2.0-Integrationaus.
    3. Geben Sie im Formular einen Namen für die Integration ein, und wählen Sie Erstellenaus.

      Die Integration wird erstellt, und der Wert der App-ID wird angezeigt.

    4. Wählen Sie Autorisierungaus.
      1. Wählen Sie Hinzufügen unter Aktionaus.
      2. Geben Sie unter Rückruf-URLdie URL Ihrer Instanz ServiceNow in diesem Format an: https://<ServiceNow-Instance-Name> .service-now.com/oauth_redirect.do
        Beispiel: https://beispiel.service-now.com/oauth_redirect.do.
      3. Wählen Sie Änderungen speichern.
    5. Wählen Sie Einstellungenaus.
    6. Kopieren Sie unter Authentifizierungsdetailsdie Werte für „Client-ID“ und „Geheimer Clientschlüssel“.
    7. Auswahlvorgang Berechtigungen > Jira-API > Konfigurieren.
    8. Wählen Sie die Registerkarte Granulare Bereiche.
    9. Wählen Sie Bereiche bearbeiten aus, um die folgenden Bereiche hinzuzufügen:
      • read:application-role:jira
      • Lesen:Gruppe:Jira
      • lesen:user:jira
      • lesen:avatar:jira
      • read:audit-log:jira
      • lesen:issue-details:jira
      • read:field-configuration:jira
      • read:issue-meta:jira
      • Schreiben:Gruppe:Jira
      Sie können andere Bereiche entsprechend Ihren Anforderungen konfigurieren.

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

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

    Vorbereitungen

    Jira 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 Produktzeile Jiradie Option Produkt verwalten aus.

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

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

    Erstellen Sie ein Jira Software Cloud-Integrationsprofil

    Erstellen Sie ein Integrationsprofil, um -Softwareabonnements nachzuverfolgen und die Lizenzierung für Atlassian Jira Software Cloud zu optimieren.

    Vorbereitungen

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

    Damit das Integrationsprofil die Anwenderaktivität über den Subflow Jira „ Anwenderaktivität aktualisieren abrufen und aktualisieren kann, legen Sie die Systemeigenschaft Wertcom.glide.transform.json.max-partial-length auf den Wert 32768fest.

    Atlassian Erforderliche Rolle: Site-Administrator

    ServiceNow Erforderliche Rolle: admin oder sam_integrator

    Wichtig:
    Sie müssen das Kontrollkästchen Jira-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 Jira 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 Jira-Integrationsprofilaus.
      Software-Asset-Arbeitsbereich
      1. Navigieren zu Lizenzvorgänge > Anwenderabonnements > Direkte Integrationsprofile.
      2. Wählen Sie Neu.
      3. Wählen Sie Jira aus der Dropdown-Liste aus.
      4. Wählen Sie Fortsetzen.
    2. Füllen Sie die Felder des Formulars aus.
      Tabelle : 3. Formular „Integrationsprofil“.
      Feld Wert
      Anzeigename Name Ihrer Wahl. Beispiel: Jira 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 Jira Abonnement Dieses Feld wird automatisch gefüllt.
    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 des Abonnements“ sicher, dass das Feld „Subflow“ auf Jira-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 Jira Update User Activity (Benutzeraktivität aktualisieren)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 Jira - 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.
      Ein Integrationsprofilentwurf wird erstellt.

      Das Feld Verbindung und Anmeldeinformationen wird angezeigt und automatisch auf sn_jira_spoke.Jirafestgelegt.

    5. Geben Sie die Gruppen an, die Zugriff auf die -Produkte Jira 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. 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 Produktzeile Jiradie Option Produkt verwalten aus.
      6. Zeigen Sie die Liste der Gruppen an, die Zugriff auf Jira Software haben.
        Notieren Sie sich diese Informationen zur späteren Verwendung.
      7. Kehren Sie zu Ihrer Instanz ServiceNow zurück, und navigieren Sie zu Jira > Jira-Gruppen.
      8. Wählen Sie im Formular Jira Gruppen den zugehörigen Link Gruppen hinzufügen.
        Das Dialogfeld Jira „ Gruppen hinzufügen“ wird geöffnet.
      9. Wählen Sie in der Liste Verfügbar die Gruppen aus, die Zugriff auf die Produkte Jira 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 die Produkte Jira haben.
      10. Wählen Sie die Nach-rechts-Taste, um die Gruppen aus der Liste Verfügbar in die Liste Ausgewählt zu verschieben.
      11. Wählen Sie OK.
    6. 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.

    7. Nachdem die Verbindung verifiziert wurde, wählen Sie Veröffentlichenaus.
    8. 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.