Dieser Artikel beantwortet die häufigsten Fragen dazu, wie unsere Integration für Jira-Karten aufgebaut ist.
Wie funktioniert die Jira-Miro-Authentifizierung?
Sieh dir die Hilfecenter-Artikel zu
- Jira-Server (On-Prem)
- Jira-Datencenter (On-Prem)
-
Jira Cloud
Wähle es 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 Jira-Daten von Kunden auf?
Ja, Miro bewahrt die Daten der Karte auf, die dem Board hinzugefügt werden.
Wie lange ist die Aufbewahrungsfrist und wie sind die Daten gesichert?
Bei OAuth 1.0 (Jira Server oder Data Center) 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 sich die Informationen auf nur wenige Felder beschränken lassen.
Gibt es ein Diagramm, das den Datenfluss zwischen Jira und Miro zeigt?
Detaillierte Informationen dazu 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 lang aktiv, es sei denn, es wird widerrufen (keine Option zur Anpassung, da diese Richtlinie auf der Atlassian-Seite definiert ist. Du kannst das Token in Jira über die Web-UI widerrufen). Bedenke, dass jedes neue Token die Integration stoppt und eine erneute Verknüpfung erforderlich macht.
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?
Alle Miro-Nutzer, die Jira-Karten importieren, erstellen oder bearbeiten möchten, müssen ihre individuellen Jira-Anmeldeinformationen verknüpfen. Alle oben genannten Aktionen können nur mit individuellen Jira-Anmeldeinformationen durchgeführt werden.
Wie werden die 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 ausschließlich 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 - create new issue
PUT /rest/api/2/issue/id - update issue
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 Jira-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. Um sicherzustellen, dass alle Funktionalitäten auf den Miro-Boards (einschließlich einiger, die zu den Jira-Karten gehören) erfolgreich ausgeführt werden, bitten wir, unsere Domains in die Zulassungsliste aufzunehmen.
Können wir Jira in Miro integrieren, aber in Miro diese 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 Jira verbinden, wenn wir einen Jira Server verwenden?
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 das Herstellen der anfänglichen Verknüpfung bedeutet, während eine aktive Verbindung die derzeit genutzte, verknüpfte Instanz bezeichnet. Eine aktive Verbindung legt fest, von welcher Instanz Jira-Karten importiert werden, wenn du die Jira-Cards-App öffnest, und für welche Instanz du autorisiert bist. Für dich kann jeweils nur eine (1) aktive Verbindung bestehen. Mit OAuth 2.0 kannst du jede Jira-Karte bearbeiten, die mit einer verknüpften Instanz verbunden ist, bei der du bereits authentifiziert bist. Bei allen anderen Authentifizierungsprotokollen teilt 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 Automatic Webhook aktivierst, werden Webhooks automatisch erstellt. Wenn du die teambezogene Autorisierung mit Jira verwendest, erstellt Miro Webhooks pro Team. Wenn du die organisationsweite Autorisierung verwendest, 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 kann sie ändern (selbst wenn dieselbe 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 bearbeitbar machen möchtest, importiere sie bitte neu 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, die keine Jira-Anmeldeinformationen haben oder nicht die richtigen Anmeldeinformationen besitzen, die eingeklappte Jira-Karte auf dem Miro-Board (mit Titel und einigen anderen Feldern) zwar ansehen, sie aber nicht aufklappen, um sie vollständig zu prüfen 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 und Jira-Karten die Jira-Custom-Felder: Custom issue types und Custom dependencies?
Ja, beide werden unterstützt. Wenn die Felder Custom issue types und Custom dependencies in Jira eingerichtet sind, und der Miro-Planer für diese Jira-Instanz authentifiziert ist, sind diese benutzerdefinierten Felder im Planer verfügbar.
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 die Zeitachse importieren?
Du kannst eine oder mehrere Jira-Karten direkt in eine Tabelle, in eine Zeitachse, in ein Kanban-Board oder in eine Journey ziehen und ablegen. Das ist derzeit der einzige Weg.
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 ergänzt, sowie die folgenden automatisch zugeordneten Felder: Startdatum, Schätzung. Um benutzerdefinierte Felder zu einer Tabelle hinzuzufügen, klicke oben in der Tabelle auf die Plus-Schaltfläche (+) und wähle Jira-Felder hinzufügen. Wähle dann ein beliebiges benutzerdefiniertes Feld, das du synchronisieren möchtest.
Welche Felder in der Tabelle werden nicht mit Jira synchronisiert?
Klicke eine Zelle, um zu sehen, welche Felder mit Jira synchronisiert werden. Jedes Feld, das synchronisiert wird, ist mit einem Jira-Logo gekennzeichnet. Alle anderen Felder werden nur in Miro gespeichert und nicht mit Jira synchronisiert.
Warum kann ich 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 Prüfung, um festzustellen, ob das Feld im Bearbeitungsbildschirm vorhanden ist oder nicht:
Öffne in Miro das seitliche Feld für die Jira-Karte. Prüfe, ob das Feld im seitlichen Feld vorhanden ist. Wenn das Feld nicht vorhanden ist, musst du es im Bearbeitungsbildschirm in Jira hinzufügen.
In seltenen Fällen sind die Felder in Jira zwar bearbeitbar, aber nicht im Bearbeitungsbildschirm sichtbar. 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)
Es kann ein Abbildungsproblem für Startdatum oder Schätzung geben, da es sich dabei um benutzerdefinierte Jira-Felder handelt.
Wir ordnen diese Felder nach folgender Logik zu:
- Startdatum: Wir prüfen Felder mit den Namen: Start Date , StartDate, Target Start
- Schätzung: Wir prüfen Felder mit den Namen: Story Points, Story point estimate, Story Point, StoryPoints, StoryPoint
- Wenn das Startdatum- oder Schätzfeld nicht einen der oben aufgeführten Namen trägt, 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 automatisierte Abbildung der Felder Start Date und Estimate in Jira. Da es sich in Jira um benutzerdefinierte Felder handelt, kann es vorkommen, dass mehrere Felder in deiner Jira-Konfiguration den oben genannten Kriterien entsprechen.
Wir wählen die erste Übereinstimmung in der Reihenfolge der oben genannten Feldnamen aus:
Wenn ein Jira-Vorgang zum Beispiel sowohl die Felder Story Points als auch Story point estimate hat, wählen wir gemäß obiger Liste das erste Feld aus – in diesem Fall Story Points. Änderungen am Estimate-Feld in der Tabelle aktualisieren daher das Story-Points-Feld in Jira, nicht das Feld Story point estimate.
Im Moment gibt es dafür keine Umgehungslösung. Wenn du dieses Problem beobachtest, sende bitte Rückmeldung an dein Support-Team, damit wir deine Bedürfnisse besser verstehen, während wir fortschrittlichere Funktionen zur Feldabbildung entwickeln.
Warum kann ich Jira-Karten nicht aus zwei verschiedenen Instanzen in eine Tabelle oder Zeitachse importieren?
Derzeit unterstützen wir pro Tabelle/Zeitachse nur eine Jira-Instanz. Sobald eine Jira-Karte in eine Tabelle/Zeitachse importiert wurde, ist die Tabelle/Zeitachse mit dieser bestimmten Jira-Instanz verknüpft.
Selbst wenn alle Jira-Einträge 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 Status- und Bearbeiterfelder meiner Jira-Einträge in einer Tabelle oder auf der Zeitachse nicht sehen oder bearbeiten?
Derzeit werden die Jira-Status- und Bearbeiterfelder in Tabellen und auf der Zeitachse nicht unterstützt. Wir haben beschlossen, diese Felder in Tabellen und auf der Zeitachse zu deaktivieren, um Erwartungen zu steuern, Verwirrung zu vermeiden und möglichen Datenverlust zu verhindern. Die Jira-Status- und Bearbeiterfelder sowie deren Inhalte existieren zwar weiterhin, werden aber in Tabellen oder auf der Zeitachse nicht angezeigt.
Du kannst diese Felder weiterhin direkt in den Jira-Karten über das seitliche Feld bearbeiten. Zieh einfach die Zeile aus der Tabelle oder von der Zeitachse auf das Canvas, damit die Jira-Karte wieder sichtbar wird.
Weitere Informationen: