Dieser Artikel beantwortet die häufigsten Fragen dazu, wie unsere Integration für Jira-Karten aufgebaut ist.
Wie funktioniert die Jira-Miro-Authentifizierung?
Siehe die Hilfecenter-Artikel zu
- Jira Server (On-Premise)
- Jira Data Center (On-Premise)
-
Jira Cloud
Wähle dies auf der Einstellungsseite der Jira-Karten aus.- OAuth 2.0 (3LO)
Werden Daten bei der Übertragung zwischen Jira und Miro gesichert?
Wir verwenden das TLS-Sicherheitsprotokoll. Es verschlüsselt HTTP-Nachrichten vor der Übertragung und entschlüsselt Nachrichten bei Eintreffen. Wir unterstützen außerdem gegenseitiges TLS für Enterprise-Preisplan.
Wird gegenseitiges TLS unterstützt?
Bewahrt Miro die Daten der Kundinnen und Kunden von Jira auf?
Ja, Miro bewahrt die Daten der Karte auf, die dem Board hinzugefügt werden.
Wie lange ist die Aufbewahrungsfrist und wie werden die Daten gesichert?
Für OAuth 1.0. (Jira-Server oder -Datencenter) werden die Daten ebenfalls aktualisiert, wenn die Webhooks während der Einrichtung des Jira-Karten-Plug-ins konfiguriert werden. Die Aufbewahrungsfrist ist unbegrenzt. Es werden nur die allgemeinen Sicherheitsprotokolle von Miro angewendet.
Kann man die Informationen einschränken, die von Miro abgerufen werden können?
Wir konnten in der Dokumentation von Atlassian keinen Hinweis finden, wie die Informationen auf nur wenige Felder beschränkt werden können.
Gibt es ein Diagramm, das den Datenfluss zwischen Jira und Miro zeigt?
Detaillierte Informationen findest du in diesem Artikel der Jira-Entwickler. Wir implementieren unsere Integration gemäß der Atlassian-Dokumentation.
Wie wird das Token gehandhabt?
OAuth 1.0: Es wird nur das Zugriffstoken verwendet. Das Zugriffstoken bleibt 5 Jahre aktiv, es sei denn widerrufen (keine Option zur Anpassung, da diese Richtlinie auf der Atlassian-Seite definiert ist. Du kannst das Token auf der Jira-Seite über die Web-UI widerrufen). Bedenke, dass jedes neue Token die Integration stoppt und eine erneute Verknüpfung erfordert.
OAuth 2.0: Das Zugriffstoken ist 1 Stunde gültig. Das Aktualisierungs-Token ist 90 Tage lang gültig (wenn du die Integration 90 Tage nicht verwendest, musst du dich erneut authentifizieren).
Gilt ein einzelnes Zugriffstoken für den gesamten Jira-Zugriff der Kundschaft?
Jeder Miro-Nutzer, der Jira-Karten importieren, erstellen oder bearbeiten möchte, muss seine individuellen Jira-Anmeldeinformationen verknüpfen. Alle oben genannten Aktionen können nur im Auftrag individueller Jira-Anmeldeinformationen ausgeführt werden.
Wie werden Anfragetoken, Zugriffstoken, private Schlüssel und andere OAuth-Geheimnisse/Anmeldeinformationen gesichert?
Während der Integration werden nur Zugriffstoken verwendet. Sie sind sicher in der Datenbank gespeichert und werden nur serverseitig verwendet.
Für OAuth 1.0. (Jira Server und Data Center) wird das authToken nur für den Webhook verwendet. Es ist nicht das eigentliche Authentifizierungstoken von OAuth. Anfragen werden über eine verschlüsselte Verbindung gesendet. Der geheime Schlüssel wird automatisch generiert und dem jeweiligen Team zugeordnet.
Welche Endpunkte nutzt die Integration?
POST /rest/api/2/issue - neuen Vorgang erstellen
PUT /rest/api/2/issue/id - Vorgang aktualisieren
GET /rest/api/2/user/picker?query=xx
GET /rest/api/2/myself
GET /rest/api/2/filter/favourite
GET /rest/api/2/issue/picker
GET /rest/api/2/serverInfo
GET /rest/api/2/issue/$key
GET /rest/api/2/issue/createmeta
GET /rest/api/2/issue/$key/editmeta
GET /rest/api/2/priority
GET /rest/api/2/issuetype
GET /rest/api/2/mypermissions
Für OAuth 1.0. (Jira-Server und -Datencenter) verwenden wir zusätzlich:
POST /rest/webhooks/1.0/webhook
Funktionieren die Karten mit dem Jira Datacenter?
Ja. Wir wurden von Atlassian zugelassen und haben bereits viele Kunden, die Jira-Karten erfolgreich mit dem Datacenter verwenden. Der Installationsprozess ist identisch.
Welche IPs verwendet ihr, um mit dem Jira-System zu kommunizieren?
Die Liste unserer statischen IP-Adressen findest du hier.
Beachte, dass diese Adressen nur zur Kommunikation mit dem Jira-System verwendet werden. Die IPs der Miro-App sind dynamisch und um sicherzustellen, dass alle Funktionalitäten auf den Miro-Boards (einschließlich einiger, die zu den Jira-Karten gehören) einwandfrei funktionieren, bitten wir dich, unsere Domains in deine Zulassungsliste aufzunehmen.
Können wir Jira in Miro integrieren, aber Jira-Vorgänge mit der Sicherheitsstufe „Privat“ blockieren?
Nein, das ist nicht möglich. Die Sicherheitsstufen in Jira korrelieren nicht mit Miro.
Können wir Miro mit einem Jira-Server verbinden?
Miro ist ein Online-Tool. D. h., du kannst die Integration nur einrichten, wenn dein Jira für das öffentliche Internet geöffnet ist.
Können wir mehrere Jira-Instanzen gleichzeitig verbinden?
Ja. Beachte jedoch, dass das Verbinden einer Jira-Instanz die anfängliche Verknüpfung herstellt, während eine aktive Verbindung die aktuell verwendete verknüpfte Instanz bezeichnet. Eine aktive Verbindung legt fest, von welcher Instanz Jira-Karten importiert werden, wenn Nutzer die Jira-Karten-App öffnen, und für welche Instanz sie autorisiert sind. Für einen bestimmten Nutzer kann es jeweils nur eine (1) aktive Verbindung geben. Mit OAuth 2.0 kann ein Nutzer jede Jira-Karte bearbeiten, die mit einer verknüpften Instanz verbunden ist, bei der er sich bereits authentifiziert hat. Bei allen anderen Authentifizierungsprotokollen teilt sich ein gesamtes Team eine aktive Instanz und kann nur Karten aus dieser Instanz importieren und mit ihnen interagieren. Du kannst mehrere organisationweite Einstellungen festlegen und auf Team-Ebene zwischen aktiven Verbindungen wechseln.
Wie sieht der Migrationsprozess vom Server in die Cloud aus?
Da sich deine Jira-Basis-URL während der Migration in die Cloud zwangsläufig ändert, wird die Integration ohne Änderungen auf unserer Seite nicht funktionieren. Bitte wende dich an den Miro-Support, wenn du Unterstützung benötigst.
Erstellt Miro einen Webhook pro Team, pro Projekt oder pro Miro-Instanz?
Wenn du in deinen Miro-Einstellungen den automatischen Webhook aktivierst, werden Webhooks automatisch erstellt. Wenn du eine Autorisierung auf Team-Ebene für Jira verwendest, erstellt Miro Webhooks pro Team. Bei einer Autorisierung auf Organisationsebene erstellt Miro Webhooks pro Organisation.
Unterstützt das Jira-Karten-Plugin Next-Gen-Projekte?
Ja.
Bitte beachte, dass es derzeit kein Epic Link/Feld gibt, wenn du für ein Next-Gen-Projekt auf Miro eine Jira-Karte erstellst.
Werden benutzerdefinierte Jira-Felder unterstützt?
Ja, wir unterstützen fast alle benutzerdefinierten Felder der Basistypen. Wenn du ein komplexes Datentypfeld hast, wird es möglicherweise nicht unterstützt und verursacht unerwartetes Verhalten bei der Aktualisierung oder Erstellung von Jira-Karten auf dem Board.
Was passiert mit bestehenden Jira-Karten, wenn wir auf eine andere Jira-Instanz wechseln?
Wenn du Jira-Vorgänge in Jira von einem Projekt zu einem anderen verschiebst, werden sie in Miro nicht mehr aktualisiert.
Als Lösung empfehlen wir dir, die URL des Jira-Vorgangs zu kopieren (Strg/Befehl+C) und sie in das Miro-Board einzufügen (Strg/Befehl+V). Somit zeigt die Jira-Karte neue Werte und wird automatisch aktualisiert.
Was passiert mit den Jira-Karten auf dem Board, wenn ein Board in ein anderes Miro-Team verschoben wird?
Die Jira-Karten bleiben auf dem Board, aber niemand wird sie noch ändern können (selbst wenn die gleiche Jira-Instanz für das Zielteam konfiguriert ist).
Wenn du auf eine Karte klickst, siehst du die Meldung: "Jira-Karte wurde von einem anderen Konto importiert". Wenn du die Karten bearbeiten möchtest, importiere sie bitte erneut in das Board.
Gibt es zusätzliche Kosten für die Integration der Jira-Karten?
Jira-Karten sind für alle kostenpflichtigen Preispläne und den Education-Preisplan ohne zusätzliche Kosten verfügbar (Starter-, Business-, Education- und Enterprise-Preispläne).
Kann ein Nutzer auf alle Jira-Karten auf dem Board zugreifen?
Die Berechtigungen für die Integration der Jira-Karten stellen sicher, dass Nutzer nur Karten in Jira-Projekten erstellen und bearbeiten können, auf die sie Zugriff haben.
Da alle Widgets auf einem Miro-Board für alle zugriffsberechtigten Personen sichtbar sind, können Personen ohne Jira-Anmeldeinformationen oder mit falschen Anmeldeinformationen die zusammengeklappte Jira-Karte auf dem Board sehen (mit Titel und einigen anderen Feldern), sie jedoch nicht aufklappen, um sie vollständig anzusehen oder zu bearbeiten.
Hat Atlassian den Support für Jira Server eingestellt?
Ja, Atlassian hat den Support für Jira Server im Februar 2024 eingestellt.
Unterstützen Miro Planer/Jira-Karten die Jira-Custom-Felder: benutzerdefinierte Vorgangstypen und benutzerdefinierte Abhängigkeiten?
Ja, beide werden unterstützt. Wenn die Felder Benutzerdefinierte Vorgangstypen und Benutzerdefinierte Abhängigkeiten in Jira eingerichtet sind, und der Miro Planer für diese Jira-Instanz authentifiziert ist, stehen diese benutzerdefinierten Felder im Planer zur Verfügung.
Unterstützt Miro OAuth 2.0 für das Jira Data Center?
Ja. Siehe Über OAuth 2.0 mit dem Jira Data Center verbinden.
Wie kann ich Jira-Vorgänge in Tabellen und Zeitachse importieren?
Du kannst eine oder mehrere Jira-Karten direkt in eine Tabelle oder auf die Zeitachse ziehen und ablegen. Das ist derzeit die einzige Möglichkeit.
Welche Felder in der Tabelle sind mit Jira verknüpft?
System-Jira-Felder:
- Titel
- Beschreibung
- Enddatum (Fälligkeitsdatum in Jira)
- Bearbeitende Person
- Status
Benutzerdefinierte Jira-Felder: - Jedes benutzerdefinierte Feld, das du über Jira-Felder hinzufügen hinzufügst, sowie die folgenden automatisch zugeordneten Felder: Startdatum, Schätzung. Um benutzerdefinierte Felder zu einer Tabelle hinzuzufügen, klicke auf die Plus-Schaltfläche (+) oben in der Tabelle und wähle Jira-Felder hinzufügen. Wähle dann die benutzerdefinierten Felder, die du synchronisieren möchtest.
Welche Felder in der Tabelle werden nicht mit Jira synchronisiert?
Klicke auf eine Zelle, um zu sehen, welche Felder mit Jira synchronisiert werden. Jedes Feld, das synchronisiert wird, zeigt ein Jira-Logo an. Alle anderen Felder werden nur in Miro gespeichert und nicht mit Jira synchronisiert.
Warum kannst du ein Feld in der Tabelle oder auf der Zeitachse aus den oben genannten fünf unterstützten Jira-Feldern nicht bearbeiten?
Das Feld ist möglicherweise nicht im Bearbeitungsbildschirm in Jira vorhanden.
Eine einfache Überprüfung, um festzustellen, ob das Feld im Bearbeitungsbildschirm vorhanden ist:
Öffne in Miro das seitliche Feld für die Jira-Karte. Prüfe, ob das Feld im seitlichen Feld vorhanden ist. Falls das Feld nicht vorhanden ist, musst du das Feld zum Bearbeitungsbildschirm in Jira hinzufügen.
In seltenen Fällen sind die Felder zwar in Jira bearbeitbar, aber nicht im Bearbeitungsbildschirm von Jira vorhanden. In diesem Fall können diese Felder in Miro nicht bearbeitet werden.
Ist das Feld, das du nicht bearbeiten kannst, Start date oder Estimate? Wenn ja:
Das Feld ist möglicherweise in Jira nicht vorhanden oder fehlt im Bearbeitungsbildschirm (siehe vorherigen Punkt)
Für Startdatum oder Schätzung kann ein Abbildungsproblem vorliegen, da es sich um benutzerdefinierte Jira-Felder handelt.
Wir ordnen diese Felder nach folgender Logik zu:
- Startdatum: Wir suchen nach Feldern mit den Namen: Start Date, StartDate, Target Start
- Schätzung: Wir suchen nach Feldern mit den Namen: Story Points, Story point estimate, Story Point, StoryPoints, StoryPoint
- Wenn das Startdatum- oder Schätzfeld nicht einen der oben genannten Namen hat, kann das erklären, warum das Bearbeiten nicht funktioniert.
Warum funktioniert das Bearbeiten des Startdatums oder der Schätzung in der Miro-Tabelle oder auf der Zeitachse entweder nicht oder aktualisiert in Jira das falsche Feld?
Derzeit verlassen wir uns auf eine automatische Abbildung der Felder Start Date und Estimate in Jira. Da es sich dabei um benutzerdefinierte Felder in Jira handelt, kann es vorkommen, dass mehrere Felder in deiner Jira-Konfiguration die oben genannten Kriterien erfüllen.
Wir wählen das erste passende Feld in der Reihenfolge der oben genannten Feldnamen aus:
Beispielsweise, wenn ein Jira-Vorgang sowohl die Felder Story Points als auch Story point estimate hat, wählen wir gemäß der obigen Liste das erste davon aus, also Story Points. Änderungen am Feld Estimate in der Tabelle aktualisieren daher das Feld Story Points in Jira und nicht Story point estimate.
Im Moment gibt es dafür keine Lösung. Wenn du dieses Problem hast, gib bitte deinem Support-Team Bescheid, damit wir deine Bedürfnisse besser verstehen können, während wir erweiterte Funktionen zur Feldabbildung entwickeln.
Warum kann ich keine Jira-Karten aus zwei verschiedenen Instanzen in eine Tabelle oder Zeitachse importieren?
Derzeit unterstützen wir nur eine Jira‑Instanz pro Tabelle/Zeitachse. Sobald eine Jira-Karte in eine Tabelle/Zeitachse importiert wurde, ist diese Tabelle/Zeitachse mit genau dieser Jira‑Instanz verknüpft.
Selbst wenn alle Jira‑Datensätze gelöscht werden, bleibt die Verknüpfung zur ursprünglichen Jira‑Instanz bestehen. Um Karten aus einer anderen Jira‑Instanz zu importieren, musst du eine neue Tabelle/Zeitachse erstellen.
Warum kann ich die Felder Status und Bearbeiter für meine Jira‑Datensätze in einer Tabelle oder Zeitachse nicht sehen oder bearbeiten?
Derzeit werden die Jira‑Felder Status und Bearbeiter in Tabellen und Zeitachsen nicht unterstützt. Wir haben uns entschieden, diese Felder in Tabellen und Zeitachsen zu deaktivieren, um Erwartungen zu steuern, Verwirrung zu vermeiden und potenziellen Datenverlust zu verhindern. Die Jira‑Felder Status und Bearbeiter und deren Inhalte existieren zwar weiterhin, erscheinen aber nicht in Tabellen oder Zeitachsen.
Du kannst diese Felder weiterhin direkt in der Jira-Karte im seitlichen Feld bearbeiten. Zieh einfach die Zeile aus der Tabelle oder Zeitachse auf das Canvas, damit deine Jira‑Karte wieder erscheint.
Weitere Informationen: