Richten Sie die Jira -Spoke für die Jira Cloud ein

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 6 Minuten Lesedauer

    • Integrieren Sie Ihre ServiceNow -Instanz mit der Jira -Cloud-Instanz, um die Anforderungen von ServiceNow] zu authentifizieren.

    Vorbereitungen

    • Fordern Sie ein IntegrationHub -Abonnement an
    • Jira-Spoke aktivieren
    • Erforderliche Rolle: admin

    Warum und wann dieser Vorgang ausgeführt wird

    Sie können die Jira -Spoke für Ihre Jira -Cloud-Instanz mit Standardauthentifizierung oder OAuth-Authentifizierung je nach Ihren Anforderungen einrichten.

    Option 1: Standardauthentifizierung verwenden

    Integrieren Sie die Instanz JiraServiceNow und die Cloud-Instanz [] mithilfe eines API-Schlüssels zur Authentifizierung von ServiceNow -Anforderungen.

    Vorbereitungen

    Erforderliche Rolle: admin.

    Warum und wann dieser Vorgang ausgeführt wird

    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.

    Generieren Sie ein API-Token für den Atlassian-Account

    Generieren Sie ein API-Token für den Account Atlassian, um Anforderungen für Spokes zu authentifizieren, die einem Account Atlassian zugeordnet sind.

    Vorbereitungen

    Vergewissern Sie sich, dass Sie über einen Atlassian -Account verfügen.

    Erforderliche Rolle: Atlassian Administrator-Anmeldeinformationen

    Warum und wann dieser Vorgang ausgeführt wird

    Führen Sie diese Schritte in Ihrem Konto Atlassian aus. Anweisungen zum Generieren Ihres API-Tokens finden Sie in der Dokumentation zum Atlassian-Entwicklerportal.
    Hinweis:
    Dieses Verfahren gilt nur, wenn Sie're das Jira Cloud-Abonnement verwenden.

    Prozedur

    1. Melden Sie sich bei an Atlassian Start als Administrator.
    2. Wechseln Sie zu Ihrem Account-Profilfoto, und wählen Sie Account-Einstellungenaus.
      Startseite von Atlassian mit dem Dropdown-Menü des ausgewählten Profilbilds. Option „Account-Einstellungen“ hervorgehoben.
    3. Navigieren Sie zu Sicherheit.
    4. Wählen Sie im Abschnitt API-Token die Option API-Token erstellen und verwaltenaus.
    5. Wählen Sie das API-Token aus.
    6. Geben Sie im Formular einen Integrationsnamen für das Feld Bezeichnung an.
    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 Kopieren aus, und notieren Sie den Wert des API-Tokens zur späteren Verwendung.
      Dialogfeld „Bestätigung“ Ihres neuen API-Tokens mit hervorgehobener Schaltfläche „Kopieren“.

    Nächste Maßnahme

    Verwenden Sie Ihr API-Token, um die Cloudverbindung für eine Jira- oder Jira Service Management-Spoke zu konfigurieren.

    Konfigurieren Sie eine Verbindung für die Jira-Spoke

    Fügen Sie eine Jira-Verbindung hinzu, und konfigurieren Sie sie, um ServiceNow -Anforderungen in der Jira-Spoke zu authentifizieren.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Navigieren zu Prozessautomatisierung > Flow Designer.
    2. Klicken Sie auf die Registerkarte Verbindungen.
    3. Suchen Sie den Jira- Verbindungsalias, und klicken Sie auf Details anzeigen.
      • Klicken Sie auf Detailsanzeigen, um den standardmäßigen Alias-Datensatz für Verbindungen und Anmeldeinformationen zu konfigurieren, der zusammen mit der Jira-Spoke bereitgestellt wird.
      • Um mehr als einen Jira-Spoke-Verbindungsdatensatz zu verwalten, sollten Sie einen neuen untergeordneten Aliasdatensatz erstellen, indem Sie auf Verbindung hinzufügenklicken. 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. Füllen Sie die Felder im Formular „ Verbindung “ aus.
      Feld Beschreibung
      Verbindungsname Name zur eindeutigen Identifizierung der Verbindung. Beispiel: Jira-Spoke Cloud Basic Conn.
      Verbindungs-URL URL Ihrer Jira-Instanz in diesem Format: https://<provider-domain-name> .atlassian.net .
      Servertyp Wählen Sie Cloudaus.
      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: Verwenden der OAuth-Authentifizierung

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

    Vorbereitungen

    Erforderliche Rolle: admin.

    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

    Erforderliche Rolle: admin

    Prozedur

    1. Melden Sie sich bei an Atlassian Developer Console als Administrator.
    2. Klicken Sie unter „ My Apps“ (Meine Apps) auf Erstellen, und wählen Sie OAuth 2.0-Integrationaus.
      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 der App-ID wird angezeigt.
    4. Klicken Sie auf Autorisierung.
      1. Klicken Sie unter Aktion auf Hinzufügen.
        Autorisierung für den Zugriff auf APIs.
      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
        Rückruf-URL hinzufügen.
      3. Klicken Sie auf Änderungen speichern.
    5. Klicken Sie auf Einstellungen.

      Kopieren Sie unter Authentifizierungsdetailsdie Werte für Client-ID und Geheimer Clientschlüssel.

      Kopieren Sie die Werte für Client-ID und Geheimer Clientschlüssel.
    6. Klicken Sie auf Berechtigungen.
      1. Achten Sie in Klassische Umfängedarauf, diese Umfänge auszuwählen.
        • manage:jira-configuration
        • verwalten: jira-project
        • verwalten:jira-webhook
        • Lesen Sie:jira-work
        • Lesen Sie:jira-user
        • write:jira-work
      2. Achten Sie unter Granulare Umfängedarauf, dass Sie diese Umfänge auswählen.
        • delete:sprint:jira-software
        • lesen:issue-details:jira
        • lesen:jql:jira
        • read:sprint:jira-software
        • Schreiben Sie: Sprint: Jira-Software
        • Lesen Sie:board-scope:jira-software
        • Lesen:Projekt: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 Jira Cloud-Instanz ab. Dieser Wert ist während der Konfiguration des Verbindungsdatensatzes in Ihrer Instanz ServiceNow erforderlich.

    Vorbereitungen

    Erforderliche Rolle: admin

    Prozedur

    1. Melden Sie sich bei an Atlassian Administration als Administrator.
    2. Klicken Sie für die gewünschte Organisation auf Auswählen.
    3. Klicken Sie in Jira Software auf Produktzugriff verwalten.
      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 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. Klicken Sie auf Neu.
      Das System zeigt die Meldung 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.
      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 der Entwicklerkonsole Atlassian generiert wird.
      Geheimer Clientschlüssel Geheimer Clientschlüssel, der 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 Folgendes ein: https://auth.atlassian.com/authorize.
      Token-URL OAuth-Servertoken-Endpunkt. Geben Sie Folgendes ein: 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. Geben Sie Folgendes ein: https://auth.atlassian.com/oauth/token.
      Hinweis:
      Dieses Feld wird im Formularlayout ausgeblendet. Konfigurieren Sie das Formularlayout für die Anzeige dieses Felds.
    5. Erstellen Sie auf der Registerkarte OAuth- Einheitenbereiche diese Datensätze für den Entitätsbereich.
      Name OAuth-Anwendungsbereich
      delete:sprint:jira-software delete:sprint:jira-software
      manage:jira-configuration manage:jira-configuration
      verwalten: jira-project verwalten: jira-project
      verwalten:jira-webhook verwalten:jira-webhook
      offline_access offline_access
      lesen:issue-details:jira lesen:issue-details:jira
      Lesen Sie:jira-user Lesen Sie:jira-user
      Lesen Sie:jira-work Lesen Sie:jira-work
      lesen:jql:jira lesen:jql:jira
      read:sprint:jira-software read:sprint:jira-software
      write:jira-work write:jira-work
      Schreiben Sie: Sprint: Jira-Software Schreiben Sie: Sprint: Jira-Software
      Lesen Sie:board-scope:jira-software Lesen Sie: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 die Registerkarte OAuth -Einheitenprofile, und öffnen Sie den Standarddatensatz.
      Beispiel: Jira-OAuth-Profil.
    8. Stellen Sie in OAuth-Entitätsprofilbereichensicher, dass dieselben Entitätsumfänge angegeben werden.
      Fügen Sie andernfalls neue Zeilen ein, und wählen Sie dieselben Entitätsbereiche aus, die Sie zuvor auf der Registerkarte OAuth-Entitätsbereiche angegeben hatten.
    9. Klicken Sie mit der rechten Maustaste in den Header Kopfzeile des Formulars, und wählen Sie Speichern aus.

    Erstellen Sie einen Anmeldeinformationsdatensatz für die Spoke 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. Klicken Sie auf Neu.
      Das System zeigt die Meldung Welche Art von Anmeldeinformationen möchten Sie erstellen? an.
    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 die Jira -Spoke. Beispiel: OAuth-Anmeldeinformation für Jira-Cloud.
      OAuth-Einheitenprofil Standard-OAuth-Entitätsprofildatensatz, der erstellt wird, wenn der Anwendungsregistrierungsdatensatz konfiguriert wird.
    5. Klicken Sie auf Absenden.

    Erstellen Sie einen Verbindungsdatensatz für die Spoke 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 wurde.
    3. Klicken Sie auf der Registerkarte Verbindungen auf Neu.
      Das System zeigt ein leeres HTTP(s)-Verbindungsformular an.
    4. Geben Sie diese Werte ein, und klicken Sie auf Absenden.
      Feld Wert erforderlich
      Name Geben Sie einen eindeutigen Namen ein, um den Verbindungsdatensatz zu identifizieren. Geben Sie beispielsweise Jira-Cloud-OAuth-Verbindungein.
      Anmeldeinformationen Wählen Sie den für Jira erstellten Anmeldeinformationsdatensatz aus. Wählen Sie beispielsweise Jira-Cloud-OAuth-Anmeldeinformationenaus.
      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 2 für api_version ein.
      2. Geben Sie die Wertewolke für server_type ein.
      Attributwerte.
    6. Klicken Sie auf 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. Klicken Sie auf den zugehörigen Link OAuth-Token abrufen.
      In einem neuen Fenster fordert das System Zugriff auf Ihren Account Atlassian an.
    10. Klicken Sie auf Akzeptieren.
      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.