Richten Sie die Spoke Jira für Jira Cloud ein

Freigeben Version: Washingtondc

Aktualisiert 1. Februar 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 Spoke Jira für Ihre Cloud-Instanz Jira mit Basic Authentication oder OAuth-Authentifizierung gemäß Ihren Anforderungen einrichten.

Option 1: Basic Authentication verwenden

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

Vorbereitungen

Erforderliche Rolle: admin.

Warum und wann dieser Vorgang ausgeführt wird

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.

Generieren Sie ein API-Token für das Atlassian-Konto

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

Vorbereitungen

Vergewissern Sie sich, dass Sie ein Atlassian -Konto haben.

Erforderliche Rolle: Atlassian Administratoranmeldeinformationen

Warum und wann dieser Vorgang ausgeführt wird

Führen Sie diese Schritte von Ihrem Atlassian -Konto aus. In der Dokumentation zum Atlassian Developer Portal finden Sie Anweisungen zum Generieren Ihres API-Tokens.

Hinweis:

Dieses Verfahren ist nur anwendbar, wenn [] Siedas Jira-Abonnement Cloud verwenden .

Prozedur

Melden Sie sich bei an Atlassian Start als Administrator.
Wechseln Sie zu Ihrem Account-Profilfoto, und wählen Sie Account-Einstellungenaus.
Wechseln Sie zu Sicherheit.
Wählen Sie im Abschnitt API-Token die Option API-Token erstellen und verwaltenaus.
Wählen Sie API-Token aus.
Geben Sie im Formular einen Integrationsnamen für das Feld Bezeichnung an.
Wählen Sie Erstellen aus.

Das API-Token wird generiert.
Wählen Sie Kopieren aus, und notieren Sie den Wert des API-Tokens zur späteren Verwendung.

Nächste Maßnahme

Verwenden Sie Ihr API-Token, um die Cloud-Verbindung 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

Navigieren zu Prozessautomatisierung > Flow Designer.
Klicken Sie auf die Registerkarte Verbindungen.
Suchen Sie den Jira- Verbindungsalias, und klicken Sie auf Details anzeigen.
- Um den standardmäßigen Aliasdatensatz für Verbindungen und Anmeldeinformationen zu konfigurieren, der im Lieferumfang der Jira-Spoke enthalten ist, klicken Sie auf Details anzeigen.
- 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ützung mehrerer Verbindungen.
Wenn Sie die Spoke zum ersten Mal konfigurieren, klicken Sie auf Konfigurieren. Klicken Sie andernfalls auf Bearbeiten.

Füllen Sie die Felder des Formulars „ Verbindung “ aus.


Feld	Beschreibung
Verbindungsname	Name zur eindeutigen Identifizierung der Verbindung. Zum Beispiel `Jira Spoke Cloud Basic Conn`.
Verbindungs-URL	URL Ihrer Jira-Instanz in folgendem Format: `https://`<provider-domain-name> .atlassian.net .
Servertyp	Wählen Sie cloudaus.
Benutzername	Geben Sie die E-Mail-Adresse des Benutzers 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.

Klicken Sie auf Verbindung erstellen.

Option 2: OAuth-Authentifizierung verwenden

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

Vorbereitungen

Erforderliche Rolle: admin.

Erstellen Sie eine OAuth 2.0-Integration im Konto Jira .

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

Vorbereitungen

Erforderliche Rolle: admin

Prozedur

Melden Sie sich bei an Atlassian Entwicklerkonsole als Administrator.
Klicken Sie unter Meine Appsauf Erstellen, und wählen Sie OAuth 2.0-Integrationaus.
Geben Sie im Formular den Namen der Integration ein, und klicken Sie auf Erstellen.

Die Integration wird erstellt, und der Wert der App-ID wird angezeigt.
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.
Klicken Sie auf Einstellungen.

Kopieren Sie unter „Authentifizierungsdetails“die Werte für „Client-ID“ und „Client-Secret“.
Klicken Sie auf Berechtigungen.
1. Stellen Sie in klassischen Bereichensicher, dass Sie diese Bereiche auswählen.
  - verwalten:jira-configuration
  - verwalten: jira-project
  - verwalten: jira-webhook
  - read:jira-work
  - read:jira-user
  - write:jira-work
2. Stellen Sie in Granulare Bereichesicher, dass Sie diese Bereiche auswählen.
  - löschen:sprint:jira-software
  - read:issue-details:jira
  - read:jql:jira
  - read:sprint:jira-software
  - write:sprint:jira-software
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

Melden Sie sich bei an Atlassian Administration als Administrator.
Klicken Sie für die erforderliche Organisation auf Auswählen.
Klicken Sie im Jira-Softwareprodukt auf Produktzugriff verwalten.
Ein neues Fenster wird geöffnet, und die URL liegt in diesem Format vor: https://admin.atlassian.com/s/<Cloud-ID> /apps .
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 werden, um einen Anwendungsregistrierungsdatensatz in Ihrer ServiceNow -Instanz zu erstellen.

Vorbereitungen

Erforderliche Rolle: admin

Prozedur

Navigieren zu Alle > System-OAuth > Applikationsregistrierung.
Klicken Sie auf Neu.
Die Meldung Welche Art von OAuth-Anwendung?wird angezeigt. .
Wählen Sie Verbindung zu einem fremden OAuth-Provider herstellen aus.

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 Atlassian Entwicklerkonsole generiert wurde.
Geheimer Clientschlüssel	Geheimer Clientschlüssel, der beim Erstellen der OAuth 2.0-Integration in der Atlassian Entwicklerkonsole generiert wird.
Standardgewährungstyp	Zum Erstellen des Tokens verwendeter Gewährungstyp. Wählen Sie Autorisierungscode aus.
Autorisierungs-URL	OAuth-Autorisierungscode-Endpunkt. Geben Sie ein: `https://auth.atlassian.com/authorize`.
Token-URL	OAuth-Servertoken-Endpunkt. Geben Sie 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 ein: `https://auth.atlassian.com/oauth/token`. Hinweis: Dieses Feld ist im Formularlayout ausgeblendet. Konfigurieren Sie das Formularlayout so, dass dieses Feld angezeigt wird.

Erstellen Sie auf der Registerkarte OAuth-Entitätsumfänge diese Entitätsumfänge-Datensätze.


Name	OAuth-Anwendungsbereich
`löschen:sprint:jira-software`	`löschen:sprint:jira-software`
`verwalten:jira-configuration`	`verwalten:jira-configuration`
`verwalten: jira-project`	`verwalten: jira-project`
`verwalten: jira-webhook`	`verwalten: jira-webhook`
`offline_access`	`offline_access`
`read:issue-details:jira`	`read:issue-details:jira`
`read:jira-user`	`read:jira-user`
`read:jira-work`	`read:jira-work`
`read:jql:jira`	`read:jql:jira`
`read:sprint:jira-software`	`read:sprint:jira-software`
`write:jira-work`	`write:jira-work`
`write:sprint:jira-software`	`write:sprint:jira-software`

Klicken Sie mit der rechten Maustaste in den Header des Formulars und wählen Sie Speichern aus.
Klicken Sie auf die Registerkarte OAuth-Entitätsprofile, und öffnen Sie den Standarddatensatz.
Beispiel: Jira-OAuth-Profil.
Stellen Sie in OAuth-Entitätsprofilbereichesicher, dass dieselben Entitätsbereiche bereitgestellt werden.
Fügen Sie andernfalls neue Zeilen ein, und wählen Sie dieselben Entitätsumfänge aus, die Sie zuvor auf der Registerkarte OAuth-Entitätsumfänge angegeben haben.
Klicken Sie mit der rechten Maustaste in den Header des Formulars und wählen Sie Speichern aus.

Erstellen Sie einen Anmeldeinformationsdatensatz für die Spoke 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

Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Berechtigungen.
Klicken Sie auf Neu.
Das System zeigt die Meldung Welche Art von Anmeldeinformationen möchten Sie erstellen? an.
Wählen Sie OAuth 2.0-Anmeldeinformationen aus.

Füllen Sie diese Werte im Formular aus.


Feld	Beschreibung
Name	Name zur Identifizierung des Anmeldeinformationsdatensatzes für die Spoke Jira. Beispiel: `Jira Cloud OAuth-Anmeldeinformationen`.
OAuth-Einheitenprofil	Standardmäßiger OAuth-Entitätsprofildatensatz, der bei der Konfiguration des Anwendungsregistrierungsdatensatzes erstellt wird.

Klicken Sie auf Absenden.

Erstellen Sie einen Verbindungsdatensatz für die Spoke 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

Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Aliasse für Verbindungen und Anmeldeinformationen.
Öffnen Sie den Aliasdatensatz für Jira, der im Lieferumfang der Spoke enthalten ist.
Klicken Sie auf der Registerkarte Verbindungen auf Neu.
Das System zeigt ein leeres HTTP(s)-Verbindungsformular an.

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-Verbindung`ein.
Anmeldeinformation	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 folgendem 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.

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 den Wert cloud für server_type ein.
Klicken Sie auf Absenden.
Navigieren zu Alle > Verbindungen und Anmeldeinformationen > Berechtigungen.
Öffnen Sie den Anmeldeinformationsdatensatz, den Sie für die Spoke Jira erstellt haben.
Beispiel: Jira-OAuth-Anmeldeinformationen.
Klicken Sie auf den zugehörigen Link OAuth-Token abrufen.
In einem neuen Fenster fordert das System Zugriff auf Ihren Atlassian -Account an.
Klicken Sie auf Akzeptieren.
Der Zugriff auf das Konto Atlassian wird gewährt, und in Ihrer Instanz ServiceNow ] wird eine Bestätigungsmeldung angezeigt, dass das Aktualisierungstoken verfügbar ist.