Zum Inhalt springen

Jira-Verbindung

Einführung

Eine Jira-Verbindung, die mit dem Jira-Connector erstellt wurde, ermöglicht den Zugriff auf Jira. Sobald eine Verbindung konfiguriert ist, können Instanzen von Jira-Aktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Erstellen oder Bearbeiten einer Jira-Verbindung

Eine neue Jira-Verbindung wird mit dem Jira-Connector von einem dieser Standorte erstellt:

Eine vorhandene Jira-Verbindung kann von diesen Standorten bearbeitet werden:

Konfigurieren einer Jira-Verbindung

Jedes Benutzeroberflächenelement des Konfigurationsbildschirms für die Jira-Verbindung wird im Folgenden beschrieben.

Die in der Konfiguration der Jira-Verbindung verwendete Schnittstelle hängt von der ausgewählten Option Authentifizierungsmechanismus ab:

  • Credential-based auth: Bei dieser Option wird die Verbindung mit einem Benutzernamen und einem API-Token oder Passwort authentifiziert.

  • OAuth: Für diese Option wird die Verbindung mithilfe einer 3-beinigen OAuth 2.0 App authentifiziert. Diese Option erfordert die Verwendung der Agentenversion 10.83 / 11.21 oder höher.

Hinweis

Credential-based Auth muss zur Konfiguration eines globalen Endpunkts verwendet werden.

Credential-based auth

Wenn Credential-based Auth als Authentifizierungsmechanismus ausgewählt wird, wird die unten beschriebene Schnittstelle angezeigt.

Tipp

Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben, oder indem Sie auf das Symbol für Variablen klicken, um ein Menü mit vorhandenen Variablen anzuzeigen, aus dem Sie auswählen können.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Jira-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Jira-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

  • Authentifizierungsmechanismus: Wählen Sie Credential-based Auth, um sich mit einem Benutzernamen und einem API-Token oder Passwort (siehe unten) zu authentifizieren.

  • Instanztyp: Wählen Sie einen Instanztyp aus der Liste, entweder Jira Cloud oder Jira On-premise:

    • Jira Cloud: Verbindung zu Jira Software Cloud.

    • Jira On-premise: Verbindung zu Jira Server oder Jira Data Center.

  • Hostname: Geben Sie den Jira-Hostname ein. Der Name kann entweder mit https:// oder http:// beginnen. Wenn nicht angegeben, wird https:// angenommen.

  • Benutzername: Geben Sie den Jira-Benutzernamen ein.

  • Jira Server-Version: Wenn Jira On-premise als Instanztyp ausgewählt ist, wählen Sie die Version von Jira Server oder Jira Data Center aus, eine der 9.17.2, 9.17.1, 9.17.0, 9.12.12, 9.12.9, 9.12.8, 9.12.7, 9.4.3 oder 8.22.3 (nicht empfohlen).

  • Auth type: Wählen Sie den Authentifizierungstyp für die Jira-Instanz, entweder API-Token oder Passwort. Diese Option ist nur sichtbar, wenn Jira On-premise als Instanztyp ausgewählt ist. Wenn Jira Cloud als Instanztyp ausgewählt ist, müssen Sie ein API-Token zur Authentifizierung eingeben.

  • API token: Geben Sie das API-Token für die Jira-Instanz ein.

  • Password: Geben Sie das Passwort für die Jira-Instanz ein.

  • Use Proxy Settings (Private Agent Only): Wenn Sie einen privaten Agenten verwenden, kann diese Einstellung ausgewählt werden, um die Proxy-Einstellungen des privaten Agenten zu verwenden.

  • Optional settings: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

    • Use SSL: Wenn Sie einen privaten Agenten verwenden, wählen Sie diese Option, um die Verbindung mit Secure Sockets Layer (SSL) für den Client zu authentifizieren.

      Wichtig

      Wenn Sie diese Option verwenden, muss ein Zertifikat zum Jitterbit Java KeyStore hinzugefügt werden.

    • Enable Hostname Verifier: Wenn Sie ein selbstsigniertes Zertifikat verwenden, wählen Sie diese Option, um zu verhindern, dass die HTTP-Anfrage vom Connector blockiert wird.

    • Security Protocol: Wenn Use SSL ausgewählt ist, verwenden Sie das Menü, um das zu verwendende Sicherheitsprotokoll auszuwählen, entweder TLSv1.2 oder TLSv1.3. Weitere Informationen zu diesen Protokollen finden Sie in RFC 6347 (TLS v1.2) oder 8446 (TLS v1.3).

  • Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Organisation Richtlinie "Auto Connector Update deaktivieren".

  • Save Changes: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

  • Discard Changes: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fragt Sie, ob Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem eine vorhandene Verbindungs-Konfiguration geöffnet wurde, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.

OAuth

Wenn OAuth als Authentifizierungsmechanismus ausgewählt ist, wird die unten beschriebene Schnittstelle angezeigt.

Tipp

Felder mit einem Symbol für Variablen unterstützen die Verwendung von globalen Variablen, Projektvariablen und Jitterbit-Variablen. Beginnen Sie entweder, indem Sie eine öffnende eckige Klammer [ in das Feld eingeben oder indem Sie auf das Symbol für Variablen klicken, um ein Menü anzuzeigen, das vorhandene Variablen zur Auswahl auflistet.

  • Verbindungsname: Geben Sie einen Namen ein, um die Verbindung zu identifizieren. Der Name muss für jede Jira-Verbindung eindeutig sein und darf keine Schrägstriche / oder Doppelpunkte : enthalten. Dieser Name wird auch verwendet, um den Jira-Endpunkt zu identifizieren, der sich sowohl auf eine spezifische Verbindung als auch auf deren Aktivitäten bezieht.

  • Authentifizierungsmechanismus: Wählen Sie OAuth, um sich mit einer 3-beinigen OAuth 2.0 Anwendung zu authentifizieren. Wenn dieser Authentifizierungsmechanismus ausgewählt ist, wird das Feld OAuth-Anwendung verfügbar (siehe unten). Diese Option erfordert die Verwendung der Agenten-Version 10.83 / 11.21 oder höher.

  • Instanztyp: Wählen Sie einen Instanztyp aus der Liste, entweder Jira Cloud oder Jira On-premise:

    • Jira Cloud: Verbinden Sie sich mit Jira Software Cloud.

    • Jira On-premise: Verbinden Sie sich mit Jira Server oder Jira Data Center.

  • Hostname: Wenn Jira On-premise als Instanztyp ausgewählt ist, geben Sie den Jira-Hostname ein. Der Name kann entweder mit https:// oder http:// beginnen. Wenn nicht angegeben, wird https:// angenommen.

  • Jira Server-Version: Wenn Jira On-premise als Instanztyp ausgewählt ist, wählen Sie die Version von Jira Server oder Jira Data Center aus, eine der 9.17.2, 9.17.1, 9.17.0, 9.12.12, 9.12.9, 9.12.8, 9.12.7, 9.4.3 oder 8.22.3 (nicht empfohlen).

  • OAuth-Anwendung: Verwenden Sie das Menü, um eine OAuth 2.0-Anwendung aus einer dieser Kategorien auszuwählen:

    • Cloud-Anwendungen: Die Anwendung in dieser Kategorie (Jitterbit App) ist eine von Jitterbit bereitgestellte OAuth 2.0-Anwendung. Diese Anwendung ist nur sichtbar, wenn eine Cloud-Agent-Gruppe verwendet wird und Jira Cloud als Instanztyp ausgewählt ist.

    • Private Anwendungen: Diese Kategorie zeigt Jira-Connector-Anwendungen an, die auf der Seite App-Registrierungen im Management Console konfiguriert sind. Um eine Jira-Connector-Anwendung auf der Seite App-Registrierungen zu konfigurieren, müssen Sie zuerst eine 3-beinige OAuth 2.0 Anwendung für die Jira-Instanz konfigurieren.

  • Mit Jira anmelden: Klicken Sie, um sich mit der ausgewählten OAuth-Anwendung zu authentifizieren. Bei Verwendung einer Privaten Anwendung werden Sie zu der URL weitergeleitet, die in der konfigurierten Authentifizierungs-URL der Connector-Anwendung angegeben ist (siehe App-Registrierungen). Bei Verwendung der Jitterbit App werden Sie aufgefordert, der Jitterbit App den Zugriff auf die Jira-Instanz zu erlauben. Nach erfolgreicher Authentifizierung werden diese Felder verfügbar:

    • Benachrichtigung über Inaktivität erhalten: Wenn Aktivieren Sie die Inaktivitätsablaufzeit für das Refresh-Token im Token-Richtlinien Tab der App-Registrierung aktiviert ist (unter Erweiterte Optionen), wählen Sie aus, um eine Email-Benachrichtigung (und eine Benachrichtigung im gesamten Harmony-Portal) zu erhalten, nachdem die festgelegte Anzahl von Tagen der Benutzerinaktivität vergangen ist.

      • Tage für Inaktivitätsbenachrichtigung: Geben Sie die Anzahl der inaktiven Tage ein, um die Benachrichtigung auszulösen. Der Standardwert beträgt 30 Tage.

    • Erhalte Ablaufbenachrichtigung: Wenn Ablauf des Aktualisierungstokens aktivieren im Tab Token-Richtlinie der App-Registrierung (unter Erweiterte Optionen) aktiviert ist, wählen Sie aus, um eine Email-Benachrichtigung (und eine Benachrichtigung im gesamten Harmony-Portal) zu erhalten, sobald die festgelegte Anzahl von Tagen vor dem Ablauf der OAuth 2.0-Anwendung erreicht ist.

      • Tage für Ablaufbenachrichtigung: Geben Sie die Anzahl der Tage ein, um die Benachrichtigung auszulösen. Der Standardwert beträgt 30 Tage.

      Hinweis

      Wenn entweder die Erhalte Inaktivitätsbenachrichtigung oder die Erhalte Ablaufbenachrichtigung eingestellt ist, wird die Benachrichtigung an die Administratoren der Harmony-Organisation (Mitglieder einer Rolle mit der Berechtigung Admin und den Benutzer, der das Projekt zuletzt bereitgestellt hat) gesendet.

  • Proxy-Einstellungen verwenden (nur privater Agent): Wenn Sie einen privaten Agenten verwenden, kann diese Einstellung ausgewählt werden, um die Proxy-Einstellungen des privaten Agenten zu verwenden.

  • Optionale Einstellungen: Klicken Sie, um zusätzliche optionale Einstellungen zu erweitern:

    • SSL verwenden: Wenn Sie einen privaten Agenten verwenden, wählen Sie aus, um die Verbindung mit dem Client Secure Sockets Layer (SSL) zu authentifizieren.

      Wichtig

      Wenn Sie diese Option verwenden, muss SSL für den JMS-Client konfiguriert werden, und ein Zertifikat muss zum Jitterbit Java KeyStore hinzugefügt werden.

    • Hostname-Überprüfer aktivieren: Wenn Sie ein selbstsigniertes Zertifikat verwenden, wählen Sie aus, um zu verhindern, dass die HTTP-Anfrage vom Connector blockiert wird.

    • Sicherheitsprotokoll: Wählen Sie aus dem Menü das zu verwendende Sicherheitsprotokoll aus, entweder TLSv1.2 oder TLSv1.3. Weitere Informationen zu diesen Protokollen finden Sie in den RFCs 6347 (TLS v1.2) oder 8446 (TLS v1.3).

  • Test: Klicken Sie, um die Verbindung mit der bereitgestellten Konfiguration zu überprüfen. Wenn die Verbindung getestet wird, wird die neueste Version des Connectors von den Agenten in der Agentengruppe heruntergeladen, die mit der aktuellen Umgebung verbunden ist. Dieser Connector unterstützt das Aussetzen des Downloads der neuesten Connector-Version durch die Verwendung der Deaktivieren Sie die automatische Connector-Aktualisierung Organisationsrichtlinie.

  • Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen.

  • Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration ohne Speichern zu schließen. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

  • Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Verbindung löschen möchten.

Nächste Schritte

Nachdem eine Jira-Verbindung erstellt wurde, platzieren Sie einen Aktivitätstyp auf der Entwurfsleinwand, um Aktivitätsinstanzen zu erstellen, die entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet werden.

Menüaktionen für eine Verbindung und ihre Aktivitätstypen sind im Projektbereich und in der Palette der Entwurfskomponenten zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Diese Aktivitätstypen sind verfügbar:

  • Suche: Ruft Objektdaten aus einem Jira-Projekt ab und ist als Quelle in einem Vorgang vorgesehen.

  • Problem: Erstellt, aktualisiert oder löscht ein Problem in einem Jira-Projekt und ist als Ziel in einem Vorgang vorgesehen.

  • Erstellen: Erstellt Objektdaten in einem Jira-Projekt und ist als Ziel in einem Vorgang vorgesehen.

  • Update: Aktualisiert Objektdaten in einem Jira-Projekt und ist als Ziel in einer Operation vorgesehen.

  • Search Dashboard: Ruft Dashboard-Daten von Jira ab und ist als Quelle in einer Operation vorgesehen.

  • Delete: Löscht Objektdaten aus Jira und ist als Ziel in einer Operation vorgesehen.

  • Transition: Ruft Jira-Tickets ab oder aktualisiert sie und ist als Ziel in einer Operation vorgesehen.

  • Search Filter: Ruft Filterdaten von Jira ab und ist als Quelle in einer Operation vorgesehen.