Integration mit JiraSoftware-Cloud

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 8 Minuten Lesedauer
  • Integration von Software Asset ManagementAnwendung mit Atlassian JiraMit der Software Cloud können Sie Ihre Softwareabonnements nachverfolgen und nicht verwendete Lizenzen zurückfordern.

    Hinweis:
    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 JiraSoftware-Cloud-Anwendung Authentifizierungsbereiche
    Abonnements herunterladen Zugriffsberechtigung Jira
    • Lesen:Application-role:jira
    • Lesen:Gruppe:jira
    • Lesen:Anwender:jira
    • Lesen:Avatar:jira
    Anwenderaktivität abrufen
    • Verwalten JiraGlobale Berechtigung
    • Berechtigung „Projekte durchsuchen“ für das Projekt, das das Problem enthält.

      Wenn Sicherheit auf Problemebene konfiguriert ist, Sicherheitsberechtigung auf Problemebene zum Anzeigen des Problems.

    • Lesen:Anwender:jira
    • Lesen:Problem-Details:jira
    • Lesen:Audit-log:jira
    • Lesen:Avatar:jira
    • Lesen:field-Configuration:jira
    • Lesen:issue-Meta:jira
    Abonnement zurückfordern Site-Administration, d. h. Mitglied der Site-Administratorgruppe
    • Lesen:Gruppe:jira
    • Schreiben:Gruppe:jira

    Standardauthentifizierung wird verwendet

    Integrieren Sie Software Asset ManagementAnwendung und JiraVerwenden eines API-Schlüssels zur Authentifizierung ServiceNowAnforderungen.

    Sie können integrieren ServiceNowInstanz mit mehreren JiraInstanzen. Erstellen Sie für diese Integration einen Alias-Datensatz für Verbindungen und Anmeldeinformationen sowie einen Verbindungsdatensatz für jeden JiraInstanz.

    Erstellen Sie einen JiraAccount-API-Token

    Erstellen Sie ein API-Token in JiraZum Authentifizieren von Anforderungen.

    Vorbereitungen

    JiraErforderliche Rolle: Siehe Minimale Anwenderberechtigungen Tabelle.

    Prozedur

    1. Navigieren Sie zu Atlassische API-Token .
    2. Wählen Sie Aus Erstellen Sie ein API-Token .
    3. Geben Sie einen Namen für Ihr API-Token ein, und wählen Sie dann aus Erstellen .
    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 Standard-Alias-Datensatz für Verbindungen und Anmeldeinformationen, um die Anforderungen von zu authentifizieren ServiceNow.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationenan.
    2. Öffnen Sie den Aliasdatensatz für JiraDas mit der Spoke geliefert wird.
    3. Wählen Sie aus Erstellen Sie Eine Neue Verbindung Und Anmeldeinformationen Zugehöriger Link.
    4. Füllen Sie im Formular die Felder aus.
      Tabelle : 2. Verbindung und Anmeldeinformationen erstellen
      Feld Beschreibung
      Verbindungs-URL URL von JiraInstanz in https://<provider-domain-name>.atlassian.net Format.
      Anwendername Geben Sie die E-Mail-Adresse des Anwenders ein.
      API-Schlüssel Geben Sie das API-Token ein, für das Sie generiert haben Jira.
    5. Wählen Sie Erstellen aus.

    OAuth-Authentifizierung wird verwendet

    Integrieren Sie Software Asset ManagementAnwendung mit JiraAccount, der OAuth zur Authentifizierung verwendet ServiceNowAnforderungen.

    Erstellen Sie eine OAuth 2,0-Integration in JiraAccount

    Erstellen Sie eine OAuth 2,0-Integration in AtlassianEntwicklerkonsole zum Authentifizieren der Anforderungen.

    Vorbereitungen

    JiraErforderliche Rolle: Siehe Minimale Anwenderberechtigungen Tabelle.

    Prozedur

    1. Melden Sie sich bei an Atlassian-Entwicklerkonsole .
    2. Unter Meine Apps , Auswählen Erstellen Und wählen Sie aus OAuth 2,0-Integration .
    3. Geben Sie im Formular einen Namen für die Integration an, und wählen Sie aus Erstellen .

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

    4. Wählen Sie Aus Autorisierung .
      1. Wählen Sie Aus Hinzufügen Unter Aktion .
      2. In Rückruf-URL , Geben Sie die URL von an ServiceNowInstanz in diesem Format: https://<ServiceNow-Instance-Name>.service-now.com/oauth_redirect.do .
        Beispiel: https://example.service-now.com/oauth_redirect.do .
      3. Wählen Sie Änderungen speichern.
    5. Wählen Sie Aus Einstellungen .
    6. Unter Authentifizierungsdetails , Kopieren Sie die Werte der Client-ID und des geheimen Clientschlüssels.
    7. Auswählen Berechtigungen > Jira-API > Konfigurierenan.
    8. Wählen Sie aus Granulare Umfänge Registerkarte.
    9. Wählen Sie Aus Bearbeiten Sie Umfänge So fügen Sie die folgenden Bereiche hinzu:
      • Lesen:Application-role:jira
      • Lesen:Gruppe:jira
      • Lesen:Anwender:jira
      • Lesen:Avatar:jira
      • Lesen:Audit-log:jira
      • Lesen:Problem-Details:jira
      • Lesen:field-Configuration:jira
      • Lesen:issue-Meta:jira
      • Schreiben:Gruppe:jira
      Sie können andere Umfänge entsprechend Ihren Anforderungen konfigurieren.

    Rufen Sie den Cloud-ID-Wert von ab JiraInstanz

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

    Vorbereitungen

    Jira 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 Auf JiraProduktzeile.

      Die URL hat das folgende Format in einem neuen Fenster: 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 JiraSoftware-Cloud-Integrationsprofil

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

    Vorbereitungen

    Zum Erstellen von JiraIntegrationsprofil, fordern Sie an Software Asset ManagementSaaS-LizenzmanagementPlugin (sn_sam_saas_int) von ServiceNow-Speicher .

    Damit das Integrationsprofil Anwenderaktivitäten über abrufen und aktualisieren kann JiraAktualisieren Sie den Subflow „Anwenderaktivität“, legen Sie fest com.glide.transform.json.max-partial-lengthSystemeigenschaft Wert Bis 32768 .

    Atlassian Erforderliche Rolle: Site-Administrator

    ServiceNow Erforderliche Rolle: administrator oder sam_integrator

    Wichtig:
    Sie müssen auswählen Jira-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 JiraIntegrationsprofil in Core-UIIst inaktiv.

    Prozedur

    1. Navigieren Sie zum Integrationsprofil.
      SchnittstelleAktion
      Core-UI
      1. Navigieren zu Alle > Software Asset > SaaS-Lizenz > Profile für direkte Integrationan.
      2. Wählen Sie Neu.
      3. Wählen Sie Aus Jira-Integrationsprofil .
      Software-Asset-Arbeitsbereich
      1. Navigieren zu Lizenzvorgänge > Anwenderabonnements > Direkte Integrationsprofilean.
      2. Wählen Sie Neu.
      3. Wählen Sie Aus Jira Aus der Dropdown-Liste.
      4. Wählen Sie Fortsetzen.
    2. Füllen Sie im Formular die Felder aus.
      Tabelle : 3. Integrationsprofilformular
      Feld Wert
      Anzeigename Name Ihrer Wahl. Beispiel: JiraIntegration.
      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 Jira Abonnement. Dieses Feld wird automatisch gefüllt.
    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 Jira – 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 Jira – 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 Jira – 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.
      Ein Entwurfsintegrationsprofil wird erstellt.

      Die Verbindung Und Anmeldeinformationen Feld wird angezeigt und wird automatisch auf festgelegt sn_jira_Spoke.Jira .

    5. Geben Sie die Gruppen an, die Zugriff auf haben JiraProdukte.
      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 bei Ihrem Site-Administrator-Account 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 Auf JiraProduktzeile.
      6. Zeigen Sie die Liste der Gruppen an, die Zugriff auf haben JiraSoftware.
        Beachten Sie diese Informationen zur späteren Verwendung.
      7. Kehren Sie zu zurück ServiceNowInstanz und navigieren Sie zu Jira > Jira-Gruppenan.
      8. Auf JiraGruppenformular, wählen Sie aus Fügen Sie Gruppen Hinzu Zugehöriger Link.
        Das Hinzufügen JiraDas Dialogfeld „Gruppen“ wird geöffnet.
      9. Wählen Sie in der Liste verfügbar die Gruppen aus, die Zugriff auf haben JiraProdukte.
        Tipp:
        Die Liste „verfügbar“ enthält alle Gruppen, die Ihrem zugeordnet sind AtlassianAccount. Wählen Sie nur die Gruppen aus, die Zugriff auf haben JiraProdukte.
      10. Wählen Sie die Pfeilschaltfläche nach rechts aus, um die Gruppen aus der Liste verfügbar in die Liste ausgewählt zu verschieben.
      11. Wählen Sie OK aus.
    6. 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“.

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