Jira mit einem API-Token verbinden

Mit einem API-Token kann Planning Poker Web Jira-Vorgänge lesen und bestätigte Schätzungen zurückschreiben, ohne dass du dich dafür in Jira anmelden musst. Hier erfährst du, wie du ein Token erstellst, welche Berechtigungen es hat und was du bei Problemen prüfen solltest. Die Anleitung gilt für Jira Cloud (eine Adresse wie your-team.atlassian.net). Jira Data Center wird nicht unterstützt.

Bevor du beginnst

Du benötigst in deiner Organisation die Berechtigung, Planning Poker zu verwalten. Inhaber haben sie standardmäßig.
Das Jira-Konto des Tokens benötigt in jedem verwendeten Projekt die Berechtigung, das Projekt anzuzeigen (für den Import) und Vorgänge zu bearbeiten (zum Zurückschreiben der Schätzung). Wenn du nur importierst und keine Schätzungen zurücksendest, reicht die Anzeigeberechtigung.
Verwende möglichst ein dafür eingerichtetes gemeinsames Konto, zum Beispiel [email protected], statt des persönlichen Kontos einer Person. Die Schätzung erscheint im Vorgangsverlauf unter diesem Kontonamen; ein persönliches Token funktioniert nicht mehr, sobald die betreffende Person das Unternehmen verlässt oder den Zugriff verliert.

Schritt 1: Token in Atlassian erstellen

Melde dich mit dem gewählten Konto bei Atlassian an und öffne id.atlassian.com → Sicherheit → API-Tokens.
Wähle API-Token erstellen. Verwende das einfache Token, nicht „API-Token mit Bereichen erstellen“: Ein Token mit Bereichen funktioniert mit dieser Verbindung nicht.
Vergib einen wiedererkennbaren Namen, zum Beispiel „Planning Poker Web“, und wähle die Gültigkeitsdauer.
Kopiere das Token sofort. Atlassian zeigt es nur ein einziges Mal an. Wenn du es verlierst, musst du ein neues erstellen.

Wenn die Option nicht angezeigt wird, hat deine Atlassian-Administration möglicherweise eingeschränkt, wer Tokens erstellen darf. Bitte darum, dies für das gewählte Konto zu erlauben.

Schritt 2: In Planning Poker Web verbinden

Öffne Einstellungen → Integrationen, wähle Jira, dann Verbinden und anschließend die Option API-Token.
Fülle die drei Felder aus:
- Jira-Website: die Adresse deiner Jira-Instanz, zum Beispiel https://your-team.atlassian.net. Zulässig sind nur Adressen im Format https://….atlassian.net.
- Konto-E-Mail: die E-Mail-Adresse des Atlassian-Kontos, das das Token erstellt hat.
- API-Token: das kopierte Token.
Wähle Testen. Bei erfolgreicher Verbindung wird der Name des Jira-Kontos angezeigt. Dein Token wird verschlüsselt gespeichert und nie wieder angezeigt.
Lege im Schritt Konfigurieren fest, ob die bestätigte Schätzung an Jira zurückgesendet werden soll und in welches Feld. Siehe Schätzungen zurücksenden.

So funktioniert es

Jede Anfrage wird von unseren Servern an Jira gesendet und mit deiner E-Mail-Adresse und deinem Token signiert. Das Token hat genau dieselben Berechtigungen wie das Konto, das es erstellt hat – nicht mehr und nicht weniger. Planning Poker Web tut nur Folgendes:

Liest deine Projekte und für ein Projekt Status, Vorgangstypen, Epics und Sprints aus, damit der Importdialog passende Filter anbieten kann.
Liest Vorgänge aus: Schlüssel, Titel und Beschreibung, um sie in einen Raum zu übernehmen.
Schreibt eine Zahl in einen einzelnen Vorgang: die bestätigte Schätzung in das von dir gewählte Feld.

Es werden niemals Vorgänge erstellt oder gelöscht, Status geändert oder Kommentare hinzugefügt. Sprints werden nur gelesen, wenn das Konto das Projektboard in Jira Software öffnen darf. Andernfalls bleibt der Sprintfilter einfach leer.

Wenn es nicht funktioniert

„Jira hat die Anmeldedaten abgelehnt“: E-Mail-Adresse oder Token sind falsch, das Token wurde widerrufen oder ist abgelaufen. Erstelle ein neues Token und wähle Erneut verbinden.
„Jira hat den Zugriff verweigert (403)“: Jira hat den Schlüssel erkannt, die Anfrage aber abgelehnt. Prüfe nacheinander: ob das Konto Zugriff auf Jira auf dieser Website hat (melde dich damit dort an), ob es das Projekt anzeigen darf (und Vorgänge bearbeiten darf, wenn es um Schätzungen geht), ob die Atlassian-Administration den API-Zugriff auf bestimmte Netzwerke beschränkt hat und ob du ein einfaches Token statt eines „Tokens mit Bereichen“ verwendest. Eine Erklärung von Jira steht gegebenenfalls nach dem Doppelpunkt.
Dein Projekt ist nicht in der Liste: Das Konto darf es nicht anzeigen. Füge das Konto zum Projekt hinzu oder verwende ein bereits berechtigtes Konto.
Die Schätzung wurde nicht gesendet, weil das Feld nicht auf dem Bildschirm ist: Das Feld muss im Projekt auf dem Bearbeitungsbildschirm des Vorgangs verfügbar sein. Jira hat zwei ähnlich benannte Felder, Story points und Story point estimate; wähle das Feld, das dein Board anzeigt.
„Verwende deine Jira-Cloud-Adresse“: Das Website-Feld muss etwa https://your-team.atlassian.net enthalten, ohne zusätzlichen Pfad.

Wenn das Token abläuft oder du die Verbindung beenden möchtest

Atlassian-Tokens sind nicht unbegrenzt gültig. Erstelle nach Ablauf ein neues und wähle Erneut verbinden; deine Schätzungseinstellungen bleiben erhalten. Zum Beenden der Verbindung wählst du in Planning Poker Web Trennen und widerrufst das Token bei Bedarf unter id.atlassian.com → Sicherheit → API-Tokens. Danach kann nichts mehr auf deine Jira-Instanz zugreifen.

Zurück Verbinden und Aufgaben importieren Weiter Schätzungen zurücksenden