Verfügbar für: Oauth 1.0.: Jira-Server und Datencenter ((On-Premise), (LDAP-geschützt))
Einrichtung durch: System-Admin bei Jira.
Zur Aktualisierung von Jira-Karten im Board muss Miro Nachrichten von Jira mit den Datenänderungsereignissen erhalten. Diese Jira-Ereignisse werden in Miro über ein Webhook übertragen. Es gibt in Miro zwei Möglichkeiten, einen Webhook zu erstellen.
Option 1 (empfohlen): Webhook automatisch erstellen
Wähle beim Einrichten deines Jira-Karten-Plugins „Jira-Server“ oder „Jira-Datencenter“ aus und lass die Option Einen Webhook automatisch erstellen aktiviert.
✏️ Die automatische Erstellung eines Webhooks erfordert, dass du als Admin bei Jira angemeldet bist.
Jira-Karteneinstellungen, Schritt 2: „Webhook automatisch erstellen“ ist aktiviert
Geh nach der Erstellung des Webhooks zu deiner Jira-Webhooks-Seite und gib ihm dort einen einzigartigen Namen, falls du mehrere Miro-Teams mit deiner Jira-Instanz verbinden möchtet.
⚠️ Für die Verbindung jedes Teams wird ein weiterer Webhook erstellt. Deshalb ist es wichtig, dass die Benennung eindeutig ist. Wenn du die Verknüpfung von Teams trennst, werden die zugehörigen Webhooks nicht entfernt.
Option 2: Webhook manuell erstellen
So erhalte ich den Webhook
- Deaktiviere die Option zum automatischen Erstellen eines Webhooks
- Kopiere die Jira-URL deiner Organisation und füge sie ein und klicke auf Verbinden und speichern.Einstellungen für Jira-Karten, Schritt 2: „Webhook automatisch erstellen“ ist deaktiviert
- Erlaube der Integration, in Jira eine Verknüpfung herzustellen.
- Du hast jetzt die WebHook-URL in
Miro:Webhook-URL
✏️ Wenn du kein Jira-System-Admin bist, sende bitte die Webhook-URL an deinen Jira-Admin, um einen Webhook auf der Jira-Seite zu erstellen.
So wendest du den WebHook an
Nachfolgend findest du die Schritte zum Erstellen eines Webhook. Du kannst auch die Atlassian-Dokumentation verwenden: für Jira-Server und für Jira-Cloud.
- Zur Webhooks-Seite in Jira gelangst du über Administration > System > Erweitert > Webhooks. Alternativ kannst du den folgenden Link verwenden, um den eindeutigen Namen deiner Jira-Instanz hinzuzufügen (der Link funktioniert sowohl für Server als auch für die Cloud, obwohl wir den Erfolg nicht für jede Version garantieren können): https://JiraInstanceName/plugins/servlet/webhooks
-
Klicke auf Webhook erstellen – die Schaltfläche befindet sich in der oberen rechten Ecke:Schaltfläche Webhook erstellen
- Gib den Webhook-Namen ein, setze den Webhook-Status auf Aktiviert und füge die Webhook-URL aus Miro
kopiert:System Webhooks in Jira ein. - Wähle die aktualisierten und gelöschten Ereignisse im Abschnitt Problem aus und klicke auf Erstellen:Jira-Webhook-Einstellungen
- Kehre zu Schritt 2 in den Miro-Einstellungen zurück, füge deine Jira-URL ein und klicke auf Verbinden.
Jetzt ist der Webhook erstellt. Die Jira-Karten sind aktiviert und können automatisch aktualisiert werden. Alle Änderungen, die in Jira vorgenommen wurden, werden auch in den Jira-Karten auf dem Board angezeigt.