Verfügbar für: Jira Cloud, Jira-Server (On-Premise) und Datacenter (auch LDAP-geschützt)
Eingerichtet von: Team-Admin bei Miro & System-Admin bei Jira mit administrativen Projektberechtigungen
⚠️ Sollten technische Probleme auftreten, lies bitte unseren Artikel über Mögliche Probleme und wie du sie beheben kannst.
💡 In den Artikeln FAQ zu Jira-Karten und Wie richte ich webHook für Jira-Karten ein erfährst du mehr über Jira-Karten.
Konfiguration von Miro in Jira
✏️ Bitte beachte, dass die Menüs von Jira je nach Jira-Version unterschiedlich sein können. Der allgemeine Ablauf sollte jedoch derselbe sein. Die folgenden Anweisungen findest du auch im Atlassian-Support.
Schritt 1: Anwendungslink
Erstelle zunächst einen Anwendungslink und konfiguriere ihn.
- Geh zu Jira-Einstellungen > Produkte > Integrationen > Anwendungslinks > Link erstellen:
Bitte beachte, dass die Benutzeroberfläche von Jira je nach verwendeter Version anders aussehen kann
- Wähle Direkter Anwendungslink und gib https://miro.com/ im Feld Anwendungs-URL ein.
Wichtig: Du musst die URL genau in diesem Format eingeben. Klicke auf Weiter.
Den Link erstellen
- Klicke im nächsten Menü einfach erneut auf Weiter.
- Überprüfe im Menü Link überprüfen, ob die URL immer noch genau https://miro.com/ ist, und gib den Anwendungsnamen deiner Wahl ein. Scrolle nach unten und aktiviere unten das Kontrollkästchen Eingehenden Link erstellen. Überspringe die übrigen Felder und klicke auf Weiter.
- Hier siehst du die Felder für die Miro-Werte. Um die Werte zu erhalten, melde dich bei Miro an und geh zu Teameinstellungen > Apps & Integrationen > Jira-Karten.
Wenn du keine Jira-Karten in deiner Apps-Liste hast, scrolle zum oberen Abschnitt, klicke auf Apps installieren und fahre mit der Installation der App über den Miro Marketplace fort. Wenn du die Jira-Karten in der Liste siehst, klicke darauf, um sie zu öffnen.
Die Plugin-Registerkarte wird geöffnet und du siehst Schritt 1 zum Erhalt der erforderlichen Werte:Werte für Jira-Karten
Kopiere die Werte und füge sie zum Menü Link überprüfen auf Atlassian hinzu. - Du siehst einen Moment lang die Verarbeitungsmeldung:
Der letzte Schritt der Link-Erstellung
Damit sind alle Schritte, die auf der Seite von Atlassian durchgeführt werden müssen, abgeschlossen. Der Link erscheint in der Liste deiner Anwendungslinks.
Schritt 2: Verbindung
Gehe zurück zu deinen Jira-Karteneinstellungen in Miro und wähle eine der folgenden Optionen aus: „Einen Webhook manuell erstellen“ oder „Einen Webhook automatisch erstellen“. Wenn du „manuell“ auswählst, deaktiviere die Option. Weitere Informationen findest du in diesem Artikel. Wir empfehlen dringend, den WebHook zu verwenden, damit du ihn bei großen Updates des Plugins nicht zurücksetzen musst.
Zum Schluss gibst du deine Jira-URL ein und klickst auf Verbinden:
Jira-Karten verknüpfen
Um die Jira-URL zu erhalten, kopiere die Base-URL deiner Jira-Instanz. Wir akzeptieren folgende Formate:
https://name.domain/
https://name.domain:port/
https://IPaddress/
https://IPaddress:port/
Falls deine Jira-URL nicht akzeptiert wird, lies bitte diesen Artikel. Bitte stelle außerdem sicher, dass Miro ausreichend Zugriff auf dein Jira-Konto hat, um die Verbindung herstellen zu können.
Jetzt hast du deine Jira-Instanz mit deinem Miro-Team verbunden.
⚠️ Bitte beachte, dass der Jira-Server im Februar 2024 eingestellt wird. Die folgenden Schritte funktionieren jedoch in ähnlicher Weise wie die des Jira-Datencenters.
- Gehe zu https://your-jira-server/plugins/servlet/applinks/listApplicationLinks. Wenn „Anwendunglinks“ nicht ausgewählt ist, klicke es bitte an.
Anwendungslinks des Jira-Servers
- Klicke auf Link erstellen. Wähle „Atlassian-Produkt“ aus und gib die Anwendungs-URL „https://miro.com“ ein. Klicke auf Weiter.
Konfiguration der Anwendungs-URL
- Du wirst zum Dialogfeld „Link-Anwendungen“ weitergeleitet. Gib einen Anwendungsnamen ein (z. B. Jira-Karte für Miro) und wähle als Anwendungstyp „Generische Anwendung“ aus.
Unter „Du erstellst einen Link von:“ solltest du nun die URL der Jira-Anwendung sehen und unter „Zu dieser Anwendung:“ sollte https://miro.com angezeigt werden. Klicke auf Weiter.Informationen zu Link-Anwendungen konfigurieren
- Die Link-Konfiguration wird verarbeitet. Wenn der Prozess abgeschlossen ist, findest du deinen neuen Link auf dem Jira-Server, unter „Anwendungslinks“.
Deine konfigurierte Anwendung auf dem Jira-Server
- Nun musst du noch die Informationen zu deiner Anwendung festlegen. Klicke zum Bearbeiten der Anwendungsinformationen auf das Bleistiftsymbol deiner Anwendung.
- Klicke im Dialogfeld „Konfigurieren“ auf die Option Eingehende Authentifizierung . Gib den API-Schlüssel, den API-Namen, den Public Key und optional eine Beschreibung ein. Diese Informationen findest du bei Miro in deinen Teameinstellungen unter Apps und Integrationen.
Konfiguration der im Jira-Server eingehenden Authentifizierungsinformationen
Informationen zu den Links der in Miro verwendeten Jira-Anwendung
- Scrolle bis zum Ende der Optionen für die „Eingehende Authentifizierung“ und klicke auf Speichern. Dein Verifizierungsstatus sollte nun bestätigt sein, und dieser Jira-Server kann ab sofort innerhalb von Miro für die Verwendung mit Jira-Karten genutzt werden. Bitte achte darauf, dass auf der Miro-Seite „Jira-Server“ und „OAuth 1.0“ ausgewählt ist.
Autorisierung von Personen
Nachdem die Integration verbunden wurde, muss jede Person ihr persönliches Jira-Profil verbinden, um die richtigen Berechtigungen einzurichten. Dadurch wird sichergestellt, dass jeder Zugriff auf der Miro-Seite genau der gleiche ist wie bei deiner Jira-Instanz. Wenn Personen zum ersten Mal versuchen, eine Jira-Karte zu importieren oder zu bearbeiten, werden sie aufgefordert, sich mit ihren individuellen Zugangsdaten bei Jira anzumelden.
Danach können sie Aufgaben als Karten auf dem Whiteboard hinzufügen. Alle Änderungen, die in Jira vorgenommen wurden, werden auch in den Jira-Karten auf dem Board angezeigt.
✏️ Wenn eine Person keine Jira-Anmeldeinformationen, aber Zugriff auf das Board hat, auf dem die Karte hinzugefügt wurde, sieht sie den Namen der Karte, die Art des Problems, die Priorität, die zugewiesene Person und alle Attribute, die auf der Jira-Karte angezeigt werden. Allerdings können sie die Karte nicht erweitern, um weitere Attribute zu sehen und sie zu bearbeiten, es sei denn, dies wurde autorisiert. Wenn die Person ihre Jira-Anmeldeinformationen nicht verbindet, wird der Avatar der zugewiesenen Person nicht angezeigt und die Karte sieht ganz allgemein anders aus.
Verwenden einer Jira-Instanz für mehrere Miro-Teams (optional)
Beachte, dass die Karten auf Teamebene installiert sind. Wenn du also unseren Enterprise-Preisplan verwendest und mehrere Teams hast, musst du Schritt 2 für jedes der Teams wiederholen, die du verbunden haben möchtest. Der bestehende Anwendungslink wird für alle verwendet.
Nachdem du dein Team mit einer Jira-Instanz verbunden hast, wird in deinen Jira-Webhooks ein neuer Webhook erstellt – für das Miro-Team, mit dem du eine Verbindung hergestellt hast. Ein Webhook wird erstellt, um den Kanal für die Update-Anfragen einzurichten.
⚠️ Wenn du mehrere Teams verbinden möchtest, empfehlen wir dringend, zur Seite mit deinen Jira-Webhooks zu gehen und jedem neu erstellten Webhook einen eindeutigen Namen zu geben, damit es keine Verwirrung gibt.
Die Verbindung mehrerer Jira-Instanzen mit einem Miro-Team wird nicht unterstützt.
Deinstallation des Plugins
Gehe in deine Teameinstellungen > Apps & Integrationen > Jira-Karten und deaktiviere deine Jira-URL unter Schritt 2. Klicke dann auf Deinstallieren für das Team.
Jira-Karten deinstallieren
💡 Vergiss nicht, einen Blick auf den Hauptartikel zur Verwendung von Jira-Karten zu werfen!