Richten Sie ein JiraSpoke Für Jira Cloud

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 6 Minuten Lesedauer
  • Integrieren Sie Ihre ServiceNowInstanz Mit JiraCloud-Instanz Um die Anforderungen von zu authentifizieren ServiceNow.

    Vorbereitungen

    • Fordern Sie an IntegrationHubAbonnement.
    • Jira-Spoke aktivieren
    • Erforderliche Rolle: admin.

    Warum und wann dieser Vorgang ausgeführt wird

    Sie können einrichten JiraSpoke für Ihr JiraCloud-Instanz mit Standardauthentifizierung oder OAuth-Authentifizierung gemäß Ihren Anforderungen.

    Option 1: Standardauthentifizierung wird verwendet

    Integrieren Sie ServiceNowInstanz und JiraCloud-Instanz, die einen API-Schlüssel zur Authentifizierung verwendet ServiceNowAnforderungen.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Warum und wann dieser Vorgang ausgeführt wird

    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.

    Generieren Sie ein API-Token für einen atlassischen Account

    Generieren Sie einen AtlassianAccount-API-Token zum Authentifizieren von Anforderungen für Spokes, die einem zugeordnet sind AtlassianAccount.

    Vorbereitungen

    Stellen Sie sicher, dass Sie einen haben AtlassianAccount.

    Erforderliche Rolle: AtlassianAdministrator-Anmeldeinformationen

    Warum und wann dieser Vorgang ausgeführt wird

    Führen Sie diese Schritte über aus AtlassianAccount. Siehe Atlassischer Entwickler Portaldokumentation mit Anweisungen zum Generieren Ihres API-Tokens.
    Hinweis:
    Dieses Verfahren gilt nur für Sie 'Re Mit der Jira Cloud Abonnement.

    Prozedur

    1. Melden Sie sich bei an Atlassian Starten Als Administrator.
    2. Wechseln Sie zu Ihrem Accountprofilfoto, und wählen Sie aus Account-Einstellungen .
      Atlassische Startseite mit dem Dropdown-Menü des ausgewählten Profilbilds. Option „Account-Einstellungen“ hervorgehoben.
    3. Wechseln Sie zu Sicherheit .
    4. Wählen Sie im Abschnitt API-Token die Option aus Erstellen und verwalten Sie API-Token .
    5. Wählen Sie Aus API-Token .
    6. Geben Sie im Formular einen Integrationsnamen für an Bezeichnung Feld.
    7. Wählen Sie Erstellen aus.
      Das Modal „API-Token erstellen“ mit hervorgehobener Schaltfläche „Erstellen“.
      Das API-Token wird generiert.
    8. Wählen Sie Aus Kopieren Und notieren Sie den Wert des API-Tokens zur späteren Verwendung.
      Bestätigungsmodal Ihres neuen API-Tokens mit hervorgehobener Schaltfläche „Kopieren“.

    Nächste Maßnahme

    Verwenden Sie Ihr API-Token, um die Cloud-Verbindung für eine Jira- oder Jira-Servicemanagement-Spoke zu konfigurieren.

    Konfigurieren Sie eine Verbindung für Jira-Spoke

    Fügen Sie eine Jira-Verbindung zur Authentifizierung hinzu, und konfigurieren Sie sie ServiceNowAnforderungen in Jira-Spoke.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Prozessautomatisierung > Flow Designeran.
    2. Klicken Sie auf Verbindungen Registerkarte.
    3. Suchen Sie Jira Verbindungsalias, und klicken Sie auf Details Anzeigen .
      • Klicken Sie zum Konfigurieren des Standarddatensatzes für Alias für Verbindungen und Anmeldeinformationen, der zusammen mit der Jira-Spoke geliefert wird, auf Details Anzeigen .
      • Um mehr als einen Jira-Spoke-Verbindungsdatensatz zu verwalten, sollten Sie einen neuen untergeordneten Alias-Datensatz erstellen, indem Sie auf klicken Verbindung Hinzufügen . Weitere Informationen zur Verwendung mehrerer Verbindungen finden Sie unter Unterstützt mehrere Verbindungen.
      Wenn Sie die Spoke zum ersten Mal konfigurieren, klicken Sie auf Konfigurieren . Klicken Sie andernfalls auf Bearbeiten .
    4. Auf Verbindung Füllen Sie die Felder aus.
      Feld Beschreibung
      Verbindungsname Name zur eindeutigen Identifizierung der Verbindung. Beispiel: Jira-Spoke-Cloud-Basisverbindung .
      Verbindungs-URL URL Ihrer Jira-Instanz in diesem Format: https://<provider-domain-name>.atlassian.net .
      Servertyp Wählen Sie Aus Cloud .
      Anwendername Geben Sie die E-Mail-Adresse des Anwenders ein.
      API-Schlüssel Geben Sie das API-Token ein, das Sie für Ihre Jira Cloud-Instanz generiert haben.

      Verbindungskonfiguration für Jira Cloud.

    5. Klicken Sie Auf Verbindung Erstellen .

    Option 2: OAuth-Authentifizierung wird verwendet

    Integrieren Sie ServiceNowInstanz mit Ihrem JiraAccount, der OAuth zur Authentifizierung verwendet ServiceNowAnforderungen.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Erstellen Sie eine OAuth 2,0-Integration in JiraAccount

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

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Melden Sie sich bei an Atlassian Entwicklerkonsole Als Administrator.
    2. Unter Meine Apps , Klicken Sie auf Erstellen Und wählen Sie aus OAuth 2,0-Integration .
      Erstellen Sie eine OAuth 2,0-Integration.
    3. Geben Sie im Formular den Namen der Integration an, und klicken Sie auf Erstellen .
      Geben Sie den Integrationsnamen an.
      Die Integration wird erstellt und der Wert von App-ID Wird angezeigt.
    4. Klicken Sie Auf Autorisierung .
      1. Klicken Sie Auf Hinzufügen Unter Aktion .
        Autorisierung für den Zugriff auf APIs.
      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
        Rückruf-URL hinzufügen.
      3. Klicken Sie Auf Speichern Sie Die Änderungen .
    5. Klicken Sie Auf Einstellungen .

      Unter Authentifizierungsdetails , Kopieren Sie die Werte von Client-ID Und Geheimer Client .

      Kopieren Sie die Werte von Client-ID Und Geheimer Client .
    6. Klicken Sie Auf Berechtigungen .
      1. In Klassische Umfänge , Stellen Sie sicher, dass Sie diese Bereiche auswählen.
        • Verwalten:jira-Configuration
        • Verwalten:jira-Projekt
        • Verwalten:jira-Webhook
        • Lesen:jira-work
        • Lesen:jira-user
        • Schreiben:jira-work
      2. In Granulare Umfänge , Stellen Sie sicher, dass Sie diese Bereiche auswählen.
        • Löschen:Sprint:jira-Software
        • Lesen:Problem-Details:jira
        • Lesen:jql:jira
        • Lesen:Sprint:jira-Software
        • Write:Sprint:jira-Software
        • Lesen:Board-scope:jira-Software
        • Lesen:Projekt:jira
      Sie können andere Umfänge entsprechend Ihren Anforderungen konfigurieren.

    Rufen Sie den Wert der Cloud-ID ab

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

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Melden Sie sich bei an Atlassian Administration Als Administrator.
    2. Klicken Sie Auf Wählen Sie Aus Für die erforderliche Organisation.
    3. Von Jira-Software Produkt, klicken Sie auf Verwalten Sie den Produktzugriff .
      Ein neues Fenster wird geöffnet, und die URL hat dieses Format: 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 ServiceNowInstanz

    Verwenden Sie die Informationen, die beim Erstellen der OAuth 2,0-Integration generiert werden, um einen Anwendungsregistrierungsdatensatz in zu erstellen ServiceNowInstanz.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > System-OAuth > Applikationsregistrierungan.
    2. Klicken Sie auf Neu.
      Das System zeigt die Nachricht an Welche Art von OAuth-Anwendung? .
    3. Wählen Sie Aus Stellen Sie eine Verbindung zu einem externen OAuth-Anbieter her .
    4. Füllen Sie diese Werte im Formular aus.
      Feld Beschreibung
      Name Name zur Identifizierung des Anwendungsregistrierungsdatensatzes. Beispiel: Jira Cloud-OAuth-App-Registrierung .
      Client-ID Client-ID, die beim Erstellen der OAuth 2,0-Integration in generiert wurde AtlassianEntwicklerkonsole.
      Geheimer Clientschlüssel Geheimer Clientschlüssel, der generiert wurde, als die OAuth 2,0-Integration in erstellt wurde AtlassianEntwicklerkonsole.
      Standardgewährungstyp Zum Erstellen des Tokens verwendeter Gewährungstyp. Wählen Sie Autorisierungscode.
      Autorisierungs-URL OAuth-Autorisierungscode-Endpunkt. Eingabetaste: https://auth.atlassian.com/authorize .
      Token-URL OAuth-Servertoken-Endpunkt. Eingabetaste: https://auth.atlassian.com/oauth/token .
      Umleitungs-URL OAuth-Callback-Endpunkt. Das System generiert die URL beim Speichern der Anwendungsregistrierung.
      URL zur Token-Aktualisierung URL zum Aktualisieren eines Tokens. Eingabetaste: https://auth.atlassian.com/oauth/token .
      Hinweis:
      Dieses Feld ist im Formularlayout ausgeblendet. Konfigurieren Sie das Formularlayout, um dieses Feld anzuzeigen.
    5. In OAuth-Entitätsbereiche Erstellen Sie diese Entitätsbereichsdatensätze.
      Name OAuth-Anwendungsbereich
      Löschen:Sprint:jira-Software Löschen:Sprint:jira-Software
      Verwalten:jira-Configuration Verwalten:jira-Configuration
      Verwalten:jira-Projekt Verwalten:jira-Projekt
      Verwalten:jira-Webhook Verwalten:jira-Webhook
      Offline_Access Offline_Access
      Lesen:Problem-Details:jira Lesen:Problem-Details:jira
      Lesen:jira-user Lesen:jira-user
      Lesen:jira-work Lesen:jira-work
      Lesen:jql:jira Lesen:jql:jira
      Lesen:Sprint:jira-Software Lesen:Sprint:jira-Software
      Schreiben:jira-work Schreiben:jira-work
      Write:Sprint:jira-Software Write:Sprint:jira-Software
      Lesen:Board-scope:jira-Software Lesen:Board-scope:jira-Software
      Lesen:Projekt:jira Lesen:Projekt:jira
    6. Klicken Sie mit der rechten Maustaste in den Header Kopfzeile des Formulars, und wählen Sie Speichern aus.
    7. Klicken Sie auf OAuth-Entitätsprofile Registerkarte und öffnen Sie den Standarddatensatz.
      Beispiel: Jira-OAuth-Profil .
    8. In Bereiche des OAuth-Entitätsprofils , Stellen Sie sicher, dass dieselben Entitätsbereiche angegeben sind.
      Andernfalls fügen Sie neue Zeilen ein, und wählen Sie dieselben Entitätsbereiche aus, die Sie zuvor in angegeben hatten OAuth-Entitätsbereiche Registerkarte.
    9. Klicken Sie mit der rechten Maustaste in den Header Kopfzeile des Formulars, und wählen Sie Speichern aus.

    Anmeldeinformationsdatensatz für erstellen JiraSpoke

    Erstellen Sie einen Anmeldeinformationsdatensatz für JiraAccount. Die JiraDer Spoke-Alias für Verbindungen und Anmeldeinformationen verwendet diese Anmeldeinformationen, um Aktionen zu autorisieren.

    Vorbereitungen

    Erforderliche Rolle: Administrator

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Anmeldeinformationenan.
    2. Klicken Sie auf Neu.
      Das System zeigt die Nachricht 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.
      Feld Beschreibung
      Name Name zur Identifizierung des Anmeldeinformationsdatensatzes für JiraSpoke. Beispiel: Jira Cloud-OAuth-Anmeldeinformationen .
      OAuth-Einheitenprofil Standard-OAuth-Entitätsprofildatensatz, der erstellt wird, wenn der Anwendungsregistrierungsdatensatz konfiguriert ist.
    5. Klicken Sie auf Absenden.

    Erstellen Sie einen Verbindungsdatensatz für JiraSpoke

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

    Vorbereitungen

    Erforderliche Rolle: admin.

    Prozedur

    1. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationenan.
    2. Öffnen Sie den Aliasdatensatz für Jira Das mit der Spoke geliefert wurde.
    3. Auf Verbindungen Klicken Sie auf die Registerkarte Neu .
      Das System zeigt ein leeres HTTP(s)-Verbindungsformular an.
    4. Geben Sie diese Werte ein, und klicken Sie auf Übermitteln .
      Feld Wert erforderlich
      Name Geben Sie einen beliebigen Namen ein, um den Verbindungsdatensatz eindeutig zu identifizieren. Geben Sie beispielsweise ein Jira-Cloud-OAuth-Verbindung .
      Anmeldeinformationen Wählen Sie den für Jira erstellten Anmeldeinformationsdatensatz aus. Wählen Sie beispielsweise aus Jira Cloud-OAuth-Anmeldeinformationen .
      Verbindungs-URL Geben Sie die URL Ihrer Jira-Instanz in diesem Format ein: https://api.atlassian.com/ex/jira/<Cloud-ID> .

      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 ein 2 Für api_Version .
      2. Geben Sie den Wert ein Cloud Für Server_type .
      Attributwerte.
    6. Klicken Sie auf Absenden.
    7. Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Anmeldeinformationenan.
    8. Öffnen Sie den Anmeldeinformationsdatensatz, den Sie für erstellt haben JiraSpoke.
      Beispiel: Jira-OAuth-Anmeldeinformationen .
    9. Klicken Sie auf den zugehörigen Link „OAuth-Token abrufen“.
      In einem neuen Fenster fordert das System Zugriff auf an AtlassianAccount.
    10. Klicken Sie Auf Akzeptieren .
      Zugriff wird gewährt AtlassianAccount und eine Bestätigungsnachricht werden in angezeigt ServiceNowInstanz, in der das Aktualisierungstoken verfügbar ist.