Personen: Jira-Systemadministratoren
Preispläne: Alle Miro-Preispläne (für die Integration von Jira Server/Data Center über OAuth 1.0)
Plattformen: Browser, Desktop-App (für Einrichtungsverfahren)
Damit deine Jira-Karten auf einem Miro-Board aktuell bleiben, muss Miro Nachrichten von Jira empfangen, wenn Datenänderungen auftreten. Diese Jira-Ereignisse werden über ein Webhook an Miro übertragen.
Diese Anleitung bietet zwei Möglichkeiten, Webhooks für Jira Server und Jira Data Center mit OAuth 1.0 und OAuth2.0 zu erstellen.
Webhook automatisch erstellen
Wenn du deine Jira-Karten-Integration einrichtest und eine Verbindung zu Jira Server oder Jira Data Center herstellst, kannst du die Option Webhook automatisch erstellen aktiviert lassen. Dies ist die empfohlene Methode.
✏️ Für die automatische Webhook-Erstellung musst du bei Jira als Admin angemeldet sein.
Jira-Karteneinstellungen, Schritt 2: „Webhook automatisch erstellen“ ist aktiviert
Nachdem der Webhook automatisch erstellt wurde, ist es eine gute Praxis, auf deine Jira-WebHooks-Seite zu gehen und den Webhook zu bearbeiten, um ihm einen eindeutigen Namen zu geben. Dies ist besonders wichtig, wenn du planst, mehrere Miro-Teams mit deiner Jira-Instanz zu verbinden.
✏️ Bei OAuth2.0-Verbindungen wird die Miro-seitige Verbindung auf Unternehmensebene eingerichtet. Ein Webhook wird für alle Miro-Teams erstellt.
✏️ Bei OAuth 1.0-Verbindungen auf Miro-Teamebene wird pro Team ein Webhook erstellt. Auf Unternehmensebene von Miro wird ein Webhook für alle Teams erstellt.
Webhook manuell erstellen
Wenn du den Webhook lieber manuell erstellen möchtest oder musst, gehe wie folgt vor.
Webhook-URL von Miro erhalten
- Deaktiviere in den Einstellungen für Jira-Karten in Miro (Schritt 2, bei der Verbindung mit Jira Server/Data Center) die Option Webhook automatisch erstellen.
- Kopiere & füge die Jira-URL deiner Organisation ein und klicke auf Verbinden und Einstellungen speichern.
Einstellungen für Jira-Karten, Schritt 2: "Webhook automatisch erstellen" ist deaktiviert - Erlaube die Verbindung der Integration in Jira, wenn du dazu aufgefordert wirst.
- Nach diesen Schritten wird Miro dir die Webhook-URL bereitstellen:
Webhook-URL von Miro bereitgestellt
✏️ Falls du kein Jira-Systemadmin bist, kopiere bitte die von Miro bereitgestellte Webhook-URL und sende sie deinem Jira-Systemadmin, damit dieser den Webhook auf der Jira-Seite gemäß den unten stehenden Anweisungen erstellen kann.
Webhook in Jira erstellen
Nachfolgend sind die Schritte aufgeführt, um einen Webhook in Jira zu erstellen, wobei die von Miro erhaltene URL verwendet wird. Du kannst auch die offizielle Atlassian-Dokumentation für Jira Server und Jira Cloud konsultieren (obwohl sich dieser Artikel auf Server/Data Center konzentriert).
- Um zur Seite WebHooks in Jira zu gelangen, navigiere zu Jira-Verwaltung > System > Erweitert > WebHooks (der genaue Pfad kann je nach Jira-Version leicht abweichen). Alternativ kannst du oft einen Direktlink verwenden, indem du
/plugins/servlet/webhooksan die URL deiner Jira-Instanz anhängst (z.B.https://YourJiraInstanceName/plugins/servlet/webhooks). - Klicke oben rechts auf der WebHooks-Seite auf Webhook erstellen.
- Gib einen aussagekräftigen Namen für den Webhook ein (z.B. "Miro Integration Webhook").
- Setze den Webhook-Status auf Aktiviert.
- Füge die Webhook-URL aus den Miro-Einstellungen in das URL-Feld ein.
System-Webhooks-Konfiguration in Jira - Wähle im Events-Abschnitt unter Issue die Ereignisse aktualisiert und gelöscht aus.
- Klicke auf Erstellen, um den Webhook zu speichern.
Jira-WebHook-Einstellungen - Nachdem das Webhook in Jira erstellt wurde, kehre zu Schritt 2 in den Jira-Karten-Einstellungen in Miro zurück, stelle sicher, dass deine Jira-URL korrekt ausgefüllt ist, und klicke auf Verbinden.
Nun ist das Webhook erstellt und konfiguriert. Jira-Karten auf deinen Miro-Boards werden automatisch aktualisiert, wenn Änderungen in Jira vorgenommen werden.
Organisationsebene-Webhooks
HINWEIS: Wenn deine team-spezifischen Webhooks mit JQL-Filtern (zum Beispiel für bestimmte Projekte) eingeschränkt waren, muss der organisationale Webhook entweder alle diese JQL-Filter widerspiegeln oder gar keinen Filter haben. Überprüfe deine JQL-Anforderungen, bevor du zu Organisationseinstellungen wechselst.
In den Organisationseinstellungen findest du nach dem Einrichten der Verbindung die Webhook-URL unter Verbundene Instanzen. Kopiere den manuellen Webhook und füge ihn in deine Jira-Umgebung ein.