Integration mit Jira Software Cloud

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 10 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
    • Durchsuchen Sie die globalen Berechtigungen für Anwender und Gruppen
    • 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
    • Durchsuchen Sie die globalen Berechtigungen für Anwender und Gruppen
    • 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: admin

    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“ .
      Benutzername Geben Sie die E-Mail-Adresse des Anwenders ein.
      API Key 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 Autorisierung aus.
      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 Einstellungen aus.
    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 Wert der Cloud-ID 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 Auswählen für die gewünschte Organisation aus.
    3. Wählen Sie im Softwareprodukt Jira die Option Produkt verwaltenaus.

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

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

    Erstellen Sie eine Anwendungsregistrierung in der Instanz ServiceNow .

    Verwenden Sie die Informationen, die beim Erstellen der OAuth 2.0-Integration generiert wurden, um einen Anwendungsregistrierungsdatensatz in Ihrer Instanz ServiceNow zu erstellen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > System-OAuth > Applikationsregistrierung.
    2. Wählen Sie Neu.
      Das System zeigt die Meldung Welche Art von OAuth-Anwendung? an..
    3. Wählen Sie Verbindung zu einem fremden OAuth-Provider herstellen aus.
    4. Füllen Sie diese Werte im Formular aus.
      Tabelle : 3. Anwendungsregistrierungen
      Feld Beschreibung
      Name Name zur Identifizierung des Anwendungsregistrierungsdatensatzes.
      Client-ID Client-ID, die beim Erstellen der OAuth 2.0-Integration in der Entwicklerkonsole Atlassian generiert wird.
      Client-Secret Clientgeheimnis, das beim Erstellen der OAuth 2.0-Integration in der Entwicklerkonsole Atlassian generiert wurde.
      Standardgewährungstyp Zum Erstellen des Tokens verwendeter Gewährungstyp. Wählen Sie Autorisierungscode.
      Autorisierungs-URL OAuth-Autorisierungscode-Endpunkt. Geben Sie https://auth.atlassian.com/authorize ein.
      Token-URL OAuth-Servertoken-Endpunkt. Geben Sie https://auth.atlassian.com/oauth/token ein.
      Umleitungs-URL OAuth-Callback-Endpunkt. Das System generiert die URL beim Speichern der Anwendungsregistrierung.
      URL zur Token-Aktualisierung URL zum Aktualisieren eines Tokens. Geben Sie https://auth.atlassian.com/oauth/token ein.
      Hinweis:
      Dieses Feld wird im Formularlayout ausgeblendet. Konfigurieren Sie das Formularlayout für die Anzeige dieses Felds.
    5. Drücken und halten Sie den Formularheader (oder klicken Sie mit der rechten Maustaste darauf), und wählen Sie Speichern.
      Auf der Registerkarte „OAuth- Entitätsprofile “ wird ein Standard-OAuth-Entitätsprofil-Datensatz erstellt.
    6. Erstellen Sie in den OAuth-Entitätsbereichen die folgenden Entitätsumfangsdatensätze.
      Name OAuth-Bereich
      read:application-role:jira read:application-role:jira
      Lesen:Gruppe:Jira Lesen:Gruppe:Jira
      lesen:user:jira lesen:user:jira
      lesen:avatar:jira lesen:avatar:jira
      read:audit-log:jira read:audit-log:jira
      lesen:issue-details:jira lesen:issue-details:jira
      read:field-configuration:jira read:field-configuration:jira
      read:issue-meta:jira read:issue-meta:jira
      Schreiben:Gruppe:Jira Schreiben:Gruppe:Jira
      offline_access offline_access

    Ergebnisse

    In Ihrer Instanz ServiceNow wird ein Anwendungsregistrierungsdatensatz erstellt.

    Erstellen Sie einen Anmeldeinformationsdatensatz für Jira

    Erstellen Sie einen Anmeldeinformationsdatensatz für den Account Jira. Der Alias für Verbindungen und Anmeldeinformationen der Jira -Spoke verwendet diese Anmeldeinformationen zum Autorisieren von Aktionen.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Akadem. Grade.
    2. Wählen Sie Neu.
      Das System zeigt eine Meldung an: Welche Art von Anmeldeinformationen möchten Sie erstellen?.
    3. Wählen Sie OAuth 2.0-Anmeldeinformationen aus.
    4. Füllen Sie diese Werte im Formular aus.
      Tabelle : 4. OAuth 2.0-Anmeldeinformationen
      Feld Beschreibung
      Name Name zur Identifizierung des Anmeldeinformationsdatensatzes für die Jira -Spoke. Beispiel: Jira OAuth-Anmeldeinformation.
      OAuth-Einheitenprofil Standard-OAuth-Entitätsprofildatensatz, der erstellt wird, wenn der Anwendungsregistrierungsdatensatz konfiguriert wird.
    5. Wählen Sie Absenden.

    Erstellen Sie einen Verbindungsdatensatz für Jira

    Erstellen Sie einen Verbindungsdatensatz für den Account Jira. Der Alias für Verbindungen und Anmeldeinformationen verwendet diese Verbindung, um Aktionen in Jiraauszuführen.

    Vorbereitungen

    Erforderliche Rolle: admin

    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 auf der Registerkarte Verbindungen die Option Neuaus.
    4. Füllen Sie diese Felder im Formular „HTTP(s)-Verbindung“ aus.
      Tabelle : 5. HTTP(s)-Verbindung
      Feld Beschreibung
      Name Geben Sie einen beliebigen eindeutigen Namen ein, um den Verbindungsdatensatz zu identifizieren. Geben Sie beispielsweise Jira OAuth-Verbindung ein.
      Anmeldeinformationen Wählen Sie den für Jira erstellten Anmeldeinformationsdatensatz aus. Wählen Sie beispielsweise Jira OAuth-Anmeldeinformationen aus.
      Verbindungsalias Suchen Sie nach dem Alias sn_jira_spoke.Jira, und wählen Sie ihn aus.
      Verbindungs-URL Geben Sie die URL Ihrer Instanz Jira unter https://api.atlassian.com/ex/jira/ ein.<Cloud-ID> -Format.

      Informationen zum Abrufen des Werts der Cloud-ID finden Sie unter Rufen Sie den Wert der Cloud-ID ab.
    5. Geben Sie in der zugehörigen Liste „Attribute“ diese Werte an.
      1. Geben Sie den Wert 2 für api_version ein.
      2. Geben Sie die Wertewolke für server_type ein.
    6. Wählen Sie Absenden.
    7. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Akadem. Grade.
    8. Öffnen Sie den Anmeldeinformationsdatensatz, den Sie für die Spoke Jira erstellt haben.
      Beispiel: Jira OAuth-Anmeldeinformation.
    9. Wählen Sie den zugehörigen Link OAuth-Token abrufen aus.
      In einem neuen Fenster fragt das System nach Zugriffsrechten für den Account Atlassian.
      Hinweis:
      Informationen zur Rolle, die zum Ausführen dieses Schritts erforderlich ist, finden Sie in der Tabelle der minimalen Anwenderberechtigungen.
    10. Wählen Sie Akzeptieren aus.
      Der Zugriff auf den Account Atlassian wird gewährt, und in Ihrer Instanz ServiceNow ] wird eine Bestätigungsmeldung angezeigt, dass das Aktualisierungstoken verfügbar ist.

    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 (com.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:
    • Ab Version 5.0.1 von Software Asset Management - SaaS-Lizenzmanagement und Version 3.0.4 der Jira -Spoke ist eine der folgenden ServiceNow -Rollen erforderlich:
      • sam_integrator und sn_jira_spoke.jira_admin
      • Administrator

    • Vor Version 5.0.1 von Software Asset Management - SaaS-Lizenzmanagement und Version 3.0.4 der Jira -Spoke ist die Rolle sam_integrator oder admin ServiceNow erforderlich.

    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-Integrationsprofil aus.
      Software-Asset-Arbeitsbereich
      1. Navigieren zu Lizenzvorgänge > Anwenderabonnements > Profile für direkte Integration.
      2. Wählen Sie Neu.
      3. Wählen Sie Jira aus der Dropdown-Liste aus.
      4. Wählen Sie Fortsetzen aus.
    2. Füllen Sie die Felder des Formulars aus.
      Tabelle : 6. Formular „Integrationsprofil“.
      Feld Wert
      Anzeigename Name Ihrer Wahl. Beispiel: Jira integration.
      Verbindung und Anmeldeinformationen sn_jira_spoke.Jira Dieses Feld wird automatisch ausgefüllt.
      Status Status des Integrationsprofils. Die Optionen sind Entwurf und Veröffentlicht. Dieses Feld wird automatisch ausgefüllt.
      Profiltyp Jira Abonnement Dieses Feld wird automatisch ausgefüllt.
    3. Wählen Sie im Formularabschnitt „ Aktivitäts-Subflow berechnen“ einen Wert für das Feld Anwenderaktivität analysieren von aus.
      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.
      Hinweis:
      Nachdem Sie das Integrationsprofil gespeichert haben, ist das Feld Anwenderaktivität analysieren von schreibgeschützt.
    4. Wählen Sie Speichern.
      Ein Integrationsprofilentwurf wird erstellt. Das -Integrationsprofil verwendet die Subflows [ Jira Abonnements herunterladen, Jira Benutzeraktivität aktualisieren und Jira Abonnement zurückfordern, um Benutzerdaten aus der Softwareanwendung Jira ] abzurufen.
    5. Geben Sie die Gruppen an, die Zugriff auf die -Produkte Jira haben.
      Wichtig:
      Dieser Schritt gilt erst ab Version 5.0.1 von Software Asset Management - SaaS-Lizenzmanagement Integrations und Version 3.0.4 der Jira -Spoke.
      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 Jira die Liste der Gruppen an, die Zugriff auf Jira Software haben.
        Notieren Sie sich diese Informationen zur späteren Verwendung.
      5. Kehren Sie zu Ihrer Instanz ServiceNow zurück, und navigieren Sie zu Jira > Jira-Gruppen.
      6. Wählen Sie im Formular Jira Gruppen den zugehörigen Link Gruppen hinzufügen.
        Das Dialogfeld „ Jira Gruppen hinzufügen“ wird geöffnet.
      7. 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.
      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.
    6. 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.
    7. Wählen Sie Veröffentlichen aus.
    8. 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.