Jira-Integration einrichten – Help Center (DE)

Es gibt einige wichtige Schritte, um die Workpath-Jira-Integration vollständig einzurichten:

Stellen Sie sicher, dass Ihre Jira-Instanz von außen erreichbar ist
Installation der Integration
Eingabe Ihrer Jira-Zugangsdaten in Workpath
Vergabe der Jira-Berechtigung für die Integration
Verknüpfen von Workpath-Teams mit Jira-Projekten

Schritt 1: Erreichbarkeit Ihrer Jira-Instanz sicherstellen

Hinweis: Dieser Schritt ist für Jira Cloud nicht erforderlich.

Firewall
Wenn Sie Jira Server oder Data Center verwenden, muss Workpath die Jira-API erreichen können. Gegebenenfalls müssen Sie die IP 3.122.149.234 in Ihrer Firewall whitelisten.
Rate Limiting
Wenn Sie in Ihrer Jira Data Center-Instanz Rate Limiting eingerichtet haben, schließen Sie Workpath davon aus. Workpath verarbeitet Rate-Limit-Fehler durch erneute Anfragen, doch lange Wartezeiten verschlechtern das Nutzererlebnis.

Schritt 2: Integration aus dem Atlassian Marketplace installieren

Melden Sie sich als Jira-Administrator in der Instanz an, in der Sie die Integration installieren möchten.
Navigieren Sie zu Verwalten von Apps.
Klicken Sie auf Neue Apps suchen und suchen Sie nach Workpath.
Wählen Sie je nach Produkt „Workpath OKRs for Jira Cloud“ oder „Workpath OKRs for Jira Server“ und klicken Sie auf Installieren.

Schritt 3: Jira‐Zugangsdaten in Workpath hinterlegen

In Workpath als Admin zu Settings → Integrations → Jira navigieren.
Add a new connection anklicken.
Ihren Jira-Produkttyp wählen: Cloud oder Server/Data Center.

Für Jira Server/Data Center – Möglichkeit 1: Basic Auth

Jira-URL (z. B. https://your-jira-url.com, API unter /rest/api/2)
Benutzername und Passwort eines Jira-Nutzers mit mindestens Leseberechtigung
Public Key und Secret Key (finden Sie nach Installation unter Manage Apps → Manage tokens)

Für Jira Server/Data Center – Möglichkeit 2: OAuth 2.0

Jira-URL (API unter /rest/api/2)
Client ID & Client Secret aus dem Application Link in Jira:
1. Jira Settings → Applications → Application links
2. Create link → External application → Incoming
3. Name frei wählbar
4. Redirect URL:
```
https://connect.workpath.com/jira/v1/server/oauth/callback
```
5. Permission: Write
6. Speichern und Client-ID/Secret kopieren
Public Key & Secret Key wie oben unter Manage tokens

Für Jira Cloud

Jira-URL (z. B. https://your-company.atlassian.net/)
E-Mail-Adresse und API-Token eines Jira-Nutzers mit mindestens Leseberechtigung (API-Token hier erstellen)

Nach Eingabe testet Workpath die Verbindung automatisch. Erscheint die Fehlermeldung
„We could not access any Jira Projects with these credentials.“, überprüfen Sie bitte Ihre Zugangsdaten.

Schritt 4: Jira-Berechtigung für die Integration vergeben

Nach Installation gibt es in Jira die neue Berechtigung „View and Link Workpath Goals“. Standardmäßig ist diese nur für Jira-Admins aktiv.

Als Jira-Admin zu Settings → System → Global permissions gehen.
Unter Grant Permission die Berechtigung „View and Link Workpath Goals“ auswählen und einer Benutzergruppe zuweisen.

Wichtig: Wird ein Jira-Projekt in Schritt 5 nicht mit einem Workpath-Team verknüpft, sehen Nutzer die Workpath-Sektion in den Jira-Issues nicht, auch wenn sie die Berechtigung haben.

Schritt 5: Workpath-Teams mit Jira-Projekten verknüpfen

In Workpath zu Teams & Check-ins → [Ihr Team] → Settings navigieren.
Unter Jira Projects die gewünschten Jira-Projekte auswählen, die dieses Team nutzt.

✅ Fertig!
Sie können die Integration nun nutzen. Bei Fragen stehen wir jederzeit zur Verfügung.

FAQ

Mehrere Jira-Instanzen?
Ja, Sie können beliebig viele Jira-Instanzen parallel integrieren.

Dasselbe Jira in mehreren Workpath-Accounts?
Auch das ist möglich – ein und dasselbe Jira-Projekt kann von mehreren Workpath-Konten aus verknüpft werden.

Automations-Limits bei Atlassian?
Workpath-Synchronisationen sind von Atlassians Automations-Limits nicht betroffen. Für Details kontaktieren Sie uns bitte.

Welche Daten werden synchronisiert?
– Issue-Titel
– Aktueller Status
– Direkter URL-Link zum Jira-Issue
– Beschreibung
– Issue-Typ (Story, Bug etc.)

Seit wann gibt es die Integration?
Die Jira-Integration ist seit 2020 in Betrieb.

Datensicherheit & Speicherung?
Alle Daten werden in Deutschland gehostet – ebenso wie sämtliche anderen Workpath-Daten.