Integration mit Jira Software Cloud

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

    • Sie können Ihre ServiceNow -Instanz mit Atlassian Jira Software Cloud integrieren, um Ihre Softwareabonnements nachzuverfolgen und nicht verwendete Lizenzen zurückzufordern.

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

    Standardauthentifizierung wird verwendet

    Integrieren Sie die Instanz [ ServiceNow und Jira mithilfe eines API-Schlüssels, um Anforderungen von ServiceNow zu authentifizieren.

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

    Erstellen Sie ein Jira -Konto-API-Token

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

    Vorbereitungen

    Jira Erforderliche Rolle: admin

    Prozedur

    1. Navigieren Sie zu Atlassian API-Token.
    2. Klicken Sie auf API-Token erstellen.
    3. Geben Sie einen Namen für Ihr API-Token ein, und klicken Sie dann auf Erstellen.
    4. Kopieren Sie das API-Token, und speichern Sie es.
      Sie verwenden das Token später.

    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. Klicken Sie auf den zugehörigen Link Neue Verbindung und Anmeldeinformationen erstellen.
    4. Füllen Sie die Felder des Formulars aus.
      Tabelle : 1. Verbindung und Anmeldeinformationen erstellen
      Feld Beschreibung
      Verbindungs-URL URL Ihrer Jira -Instanz in https:// <provider-domain-name> .atlassian.net -Format.
      Benutzername Geben Sie die E-Mail-Adresse des Benutzers ein.
      API Key Geben Sie das API-Token ein, das Sie für Jirageneriert haben.
    5. Klicken Sie auf Erstellen.

    Verwenden der OAuth-Authentifizierung

    Integrieren Sie die Instanz ServiceNow mit Ihrem Konto Jira mithilfe von OAuth, um Anforderungen von ServiceNow zu authentifizieren.

    Erstellen Sie eine OAuth 2.0-Integration im Konto Jira .

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

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Melden Sie sich bei der Atlassian Developer Consolean.
    2. Klicken Sie unter Meine Appsauf Erstellen, und wählen Sie OAuth 2.0-Integrationaus.
    3. Geben Sie im Formular einen Namen für die Integration ein, und klicken Sie auf Erstellen.

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

    4. Klicken Sie auf Autorisierung.
      1. Klicken Sie unter Aktion auf Hinzufügen.
      2. Geben Sie in Rückruf-URLdie URL Ihrer ServiceNow-Instanz in folgendem Format an: https://<ServiceNow-Instance-Name> .service-now.com/oauth_redirect.do .
        Beispiel: https://example.service-now.com/oauth_redirect.do.
      3. Klicken Sie auf Änderungen speichern.
    5. Klicken Sie auf Einstellungen.
    6. Kopieren Sie unter „Authentifizierungsdetails“die Werte für „Client-ID“ und „Client-Secret“.
    7. Klicken Sie auf Berechtigungen.
      1. Wählen Sie unter Granulare Bereiche die folgenden Bereiche aus.
        • read:application-role:jira
        • read:group:jira
        • read:user:jira
        • read:avatar:jira
        • read:audit-log:jira
        • read:issue-details:jira
        • read:field-configuration:jira
        • read:issue-meta:jira
        • write:group:jira
        Sie können andere Bereiche gemäß 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 ServiceNow -Instanz erforderlich.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Melden Sie sich bei der Atlassian-Administrationan.
    2. Klicken Sie für die erforderliche Organisation auf Auswählen.
    3. Klicken Sie im Softwareprodukt Jira auf Produktzugriff verwalten.

      Die URL weist in einem neuen Fenster das folgende Format auf: https://admin.atlassian.com/s/<Cloud-ID> /apps .

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

    Erstellen Sie eine Anwendungsregistrierung in der Instanz ServiceNow .

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

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > System-OAuth > Applikationsregistrierung.
    2. Klicken Sie auf Neu.
      Das System zeigt die folgende Meldung an: Welche Art von OAuth-Anwendung?.
    3. Wählen Sie Verbindung zu einem fremden OAuth-Provider herstellen aus.
    4. Füllen Sie diese Werte im Formular aus.
      Tabelle : 2. Anwendungsregistrierungen
      Feld Beschreibung
      Name Name zur Identifizierung des Anwendungsregistrierungsdatensatzes.
      Client-ID Client-ID, die beim Erstellen der OAuth 2.0-Integration in der Atlassian Developer Console generiert wurde.
      Client-Secret Geheimer Clientschlüssel, der beim Erstellen der OAuth 2.0-Integration in der Atlassian Developer Console generiert wurde.
      Standardgewährungstyp Zum Erstellen des Tokens verwendeter Gewährungstyp. Wählen Sie Autorisierungscode aus.
      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 ist im Formularlayout ausgeblendet. Konfigurieren Sie das Formularlayout so, dass dieses Feld angezeigt wird.
    5. Klicken Sie mit der rechten Maustaste in den Header Kopfzeile des Formulars, und wählen Sie Speichern aus.
      Auf der Registerkarte OAuth- Entitätsprofile wird ein standardmäßiger OAuth-Entitätsprofildatensatz erstellt.
    6. Erstellen Sie in den OAuth-Entitätsbereichen die folgenden Datensätze für Entitätsbereiche.
      Name OAuth-Bereich
      read:application-role:jira read:application-role:jira
      read:group:jira read:group:jira
      read:user:jira read:user:jira
      read:avatar:jira read:avatar:jira
      read:audit-log:jira read:audit-log:jira
      read:issue-details:jira read:issue-details:jira
      read:field-configuration:jira read:field-configuration:jira
      read:issue-meta:jira read:issue-meta:jira
      write:group:jira write:group:jira
      offline_access offline_access

    Ergebnisse

    In Ihrer ServiceNow -Instanz wird ein Anwendungsregistrierungsdatensatz erstellt.

    Erstellen Sie einen Anmeldeinformationsdatensatz für Jira

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

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Berechtigungen.
    2. Klicken Sie auf Neu.
      Das System zeigt die folgende 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 : 3. OAuth 2.0-Anmeldeinformationen
      Feld Beschreibung
      Name Name zur Identifizierung des Anmeldeinformationsdatensatzes für die Spoke Jira. Beispiel: Jira-OAuth-Anmeldeinformationen.
      OAuth-Einheitenprofil Standardmäßiger OAuth-Entitätsprofildatensatz, der bei der Konfiguration des Anwendungsregistrierungsdatensatzes erstellt wird.
    5. Klicken Sie auf Absenden.

    Erstellen Sie einen Verbindungsdatensatz für Jira

    Erstellen Sie einen Verbindungsdatensatz für das Konto 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.
      Das System zeigt ein leeres HTTP(s)-Verbindungsformular an.
    4. Füllen Sie die Felder im Formular aus.
      Tabelle : 4. 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 Jira -Instanz in 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 für api_version den Wert 2ein.
      2. Geben Sie den Wert cloud für server_type ein.
    6. Wählen Sie Absenden.
    7. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Berechtigungen.
    8. Öffnen Sie den Anmeldeinformationsdatensatz, den Sie für die Spoke Jira erstellt haben.
      Beispiel: Jira OAuth-Anmeldeinformationen.
    9. Klicken Sie auf den zugehörigen Link OAuth-Token abrufen.
      In einem neuen Fenster fordert das System Sie auf, auf Ihren Atlassian -Account zuzugreifen.
    10. Wählen Sie Akzeptieren aus.
      Dem Konto Atlassian wird Zugriff 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

    Um ein Jira -Integrationsprofil zu erstellen, fordern Sie das Plugin Software Asset Management - SaaS-Lizenzmanagement (com.sn_sam_saas_int) aus dem ServiceNow Storean.

    Um das Integrationsprofil zum Abrufen und Aktualisieren von Benutzeraktivitäten über den Subflow Jira Benutzeraktivität aktualisieren zu aktivieren, legen Sie die Systemeigenschaft Wert von com.glide.transform.json.max-partial-length auf 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 Spoke Jira ist die folgende Rolle ServiceNow erforderlich: sam_integrator und sn_jira_spoke.jira_admin oder admin.

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

    Warum und wann dieser Vorgang ausgeführt wird

    Wenn Sie Software Asset Workspace verwenden, ist die Option zum Erstellen des Integrationsprofils Jira 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 Jira-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 Jira aus der Dropdown-Liste aus.
      4. Wählen Sie Fortsetzen aus.
    2. Füllen Sie die Felder des Formulars aus.
      Tabelle : 5. Formular „Integrationsprofil“
      Feld Wert
      Anzeigename Name Ihrer Wahl. Beispiel: Integration von Jira.
      Verbindung und Anmeldeinformationen sn_jira_spoke.Jira Dieses Feld wird automatisch ausgefüllt.
      Status Status des Integrationsprofils. Die Optionen lauten 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 Benutzeraktivität analysieren aus aus.
      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.
      Hinweis:
      Nachdem Sie das Integrationsprofil gespeichert haben, wird das Feld Benutzeraktivität analysieren aus schreibgeschützt.
    4. Klicken Sie auf 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 Jira Produkte haben.
      Wichtig:
      Dieser Schritt gilt erst ab Version 5.0.1 von Software Asset Management - SaaS-Lizenzmanagement Integrations und Version 3.0.4 der Spoke Jira.
      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 Jira die Liste der Gruppen an, die Zugriff auf die Software Jira 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. Klicken Sie im Formular Jira Gruppen auf 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 von Jira 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 Jira 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.
    6. 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.
    7. Klicken Sie auf Veröffentlichen.
      Das Dialogfeld „Bestätigung veröffentlichen“ wird geöffnet.
    8. 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.