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 für
- Jira Server On-Premise
- Jira-Datencenter vor Ort
-
Jira Cloud
Wähle von 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 auch gegenseitiges TLS für den Enterprise-Preisplan.
Wird gegenseitiges TLS unterstützt?
Bewahrt Miro irgendwelche Jira-Daten des 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?
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.
Können wir die Informationen einschränken, die von Miro abgerufen werden?
Wir konnten in der Dokumentation von Atlassian keinen Hinweis finden, wie die Informationen auf nur wenige Felder beschränkt werden können.
Können wir ein Diagramm haben, das den Datenfluss zwischen Jira und Miro zeigt?
Detaillierte Informationen finden Sie in diesem Artikel für 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 gültig, es sei denn, es wird widerrufen (keine Möglichkeit zur Anpassung, da diese Richtlinie von Atlassian festgelegt wird. Du kannst das Token auf der Jira-Seite über die Web-UI widerrufen). Bedenke dabei, 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 Aktualisierungstoken ist 90 Tage lang gültig (wenn du die Integration 90 Tage nicht verwendest, musst du dich erneut authentifizieren).
Wird ein einzelnes Zugriffstoken für den gesamten Jira-Zugriff eines Kunden verwendet?
Jeder Miro-Nutzende, der Jira-Karten importieren, erstellen oder bearbeiten möchte, muss die individuellen Jira-Anmeldeinformationen verknüpfen. Alle oben genannten Aktionen können nur im Auftrag der individuellen Jira-Anmeldeinformationen durchgeführt werden.
Wie werden die Anfragetoken, Zugriffstoken, privaten Schlüssel und anderen 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 -Datencenter) 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 Ihre 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 Kundinnen und 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 finden Sie 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 mit Miro integrieren, jedoch in Miro die Jira-Vorgänge mit der Sicherheitsstufe „Privat“ blockieren?
Nein, das ist nicht möglich. Die Sicherheitsstufen von Jira korrelieren nicht mit denen von Miro.
Können wir Miro mit einem Jira-Server verbinden?
Miro ist ein Online-Tool, daher kannst du nur eine Verbindung zu Jira herstellen, wenn deine Instanz für das öffentliche Internet zugänglich ist.
Können wir mehrere Jira-Instanzen gleichzeitig verbinden?
Ja. Es ist jedoch wichtig zu beachten, dass das Verbinden einer Jira-Instanz das initiale Herstellen der Verbindung bedeutet, während eine aktive Verbindung sich auf die derzeit genutzte verlinkte Instanz bezieht. Eine aktive Verbindung definiert, woher die Jira-Karten importiert werden, wenn du die Jira Cards-App öffnest und für welche Instanz Nutzer berechtigt sind. Für einen gegebenen Nutzer kann es zu jeder Zeit nur eine (1) aktive Verbindung geben. Mit OAuth 2.0 kann ein Nutzer jede Jira-Karte bearbeiten, die mit einer beliebigen verlinkten Instanz verbunden ist, für die sie bereits authentifiziert sind. Für jedes andere Authentifizierungsprotokoll teilt ein gesamtes Team eine aktive Instanz und kann nur Karten von dieser Instanz importieren und damit interagieren. Du kannst mehrere Einstellungen auf Organisationsebene definieren und zwischen aktiven Verbindungen auf Teamebene 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 kontaktiere den Miro Support für Unterstützung.
Erstellt Miro einen Webhook pro Team, pro Projekt oder pro Miro-Instanz?
Wenn du in deinen Miro-Einstellungen den automatischen Webhook aktivierst, erfolgt die Erstellung von Webhooks automatisch. Bei Autorisierung auf Teamebene erstellt Miro Webhooks pro Team. Bei Autorisierung auf Organisationsebene erstellt Miro Webhooks pro Organisation.
Unterstützt das Jira-Karten-Plugin Next-Gen-Projekte?
Ja, das tut es.
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?
Derzeit, wenn du Jira-Vorgänge in Jira von einem Projekt zu einem anderen verschiebst, werden sie auf Miro-Seite 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 ändern können (selbst wenn die gleiche Jira-Instanz für das Team konfiguriert ist).
Wenn du auf eine Karte klickst, siehst du die Nachricht: „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 in allen kostenpflichtigen Preisplänen und im Education-Preisplan ohne zusätzliche Kosten verfügbar (Starter-, Business-, Education- und Enterprise-Preispläne).
Können Benutzer auf dem Board auf alle Jira-Karten 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 nicht angemessene Anmeldeinformationen die minimierte Jira-Karte auf einem Miro-Board (mit Titel und einigen anderen Feldern) ansehen, aber nicht maximieren, um sie vollständig zu überprüfen oder zu ändern.
Hat Atlassian den Support für Jira Server eingestellt?
Ja, Atlassian hat den Support für Jira Server ab Februar 2024 eingestellt.
Unterstützt Miro Planer/Jira-Karten die Jira benutzerdefinierten 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 Miro Planer für diese Jira-Instanz authentifiziert ist, dann sind diese benutzerdefinierten Felder im Planer verfügbar.
Unterstützt Miro OAuth 2.0 für Jira Data Center?
Wie kann ich Jira-Vorgänge in Tabellen und Zeitachse importieren?
Du kannst eine oder mehrere Jira-Karten direkt in eine Tabelle oder Zeitachse ziehen und ablegen. Dies ist derzeit der einzige Weg, dies zu tun.
Welche Felder in der Tabelle sind mit Jira verlinkt?
System-Jira-Felder:
- Titel
- Beschreibung
- Enddatum (Fälligkeitsdatum in Jira)
- Bearbeitende Person
- Status
Benutzerdefinierte Jira-Felder:
- Startdatum
- Schätzung
Klicke auf eine Zelle, um zu sehen, welche Felder mit Jira synchronisiert werden. Alle Felder, die synchronisiert werden, sind mit einem Jira-Logo versehen. Alle anderen Felder werden nur in Miro gespeichert und nicht mit Jira synchronisiert.
Warum kann ich ein Feld in der Tabelle oder Zeitachse von den oben genannten fünf unterstützten Jira-Feldern nicht bearbeiten?
Das Feld ist möglicherweise nicht im Bearbeitungsbildschirm auf Jira vorhanden.
Ein einfacher Check, um zu wissen, ob das Feld im Bearbeitungsbildschirm vorhanden ist oder nicht:
Öffne auf Miro das seitliche Feld für die Jira-Karte. Überprüfe, ob das Feld im seitlichen Feld vorhanden ist. Wenn das Feld nicht vorhanden ist, musst du es zum Bearbeitungsbildschirm auf Jira hinzufügen.
In einigen seltenen Fällen sind die Felder in Jira zwar bearbeitbar, aber nicht im Bearbeitungsbildschirm von Jira vorhanden. Diese Felder können dann nicht in Miro bearbeitet werden.
Ist das Feld, das du nicht bearbeiten kannst, das Startdatum oder das Schätzung? Wenn ja:
Das Feld ist möglicherweise nicht in Jira vorhanden oder fehlt im Bearbeitungsbildschirm (siehe vorheriger Punkt).
Es könnte ein Abbildungsproblem für Startdatum oder Schätzung geben, da dies benutzerdefinierte Jira-Felder sind.
Wir mappen diese Felder nach folgender Logik:
- Startdatum: Wir suchen nach Feldern, die benannt sind als: Start Date, StartDate, Target Start
- Schätzung: Wir suchen nach Feldern, die benannt sind als: Story Points, Story point estimate, Story Point, StoryPoints, StoryPoint
- Wenn das Startdatum- oder das Schätzungsfeld nicht unter einem der oben genannten Namen geführt wird, könnte dies erklären, warum die Bearbeitung nicht funktioniert.
Warum funktioniert die Bearbeitung des Startdatums oder der Schätzung in Miro Tabelle oder Zeitachse nicht oder aktualisiert das falsche Feld in Jira?
Wir verlassen uns derzeit auf die automatisierte Zuordnung der Felder Startdatum und Schätzung in Jira. Da diese in Jira benutzerdefiniert sind, kann es vorkommen, dass in Ihrer Jira-Konfiguration mehrere Felder den oben genannten Kriterien entsprechen.
Wir wählen das erste übereinstimmende Feld gemäß der oben erwähnten Reihenfolge der Feldnamen:
Zum Beispiel, wenn ein Jira-Ticket sowohl Story Points als auch Schätzung der Story Points Felder hat, stimmen wir das erste gemäß der obigen Liste überein, das sind die Story Points. Daher werden alle Änderungen am Schätzfeld in der Tabelle das Story Points-Feld in Jira aktualisieren, nicht die Schätzung der Story Points.
Im Moment gibt es hierfür keine Umgehung. Wenn Sie dieses Problem haben, senden Sie bitte Feedback an Ihr Support-Team, damit wir Ihre Bedürfnisse besser verstehen können, während wir fortschrittlichere Abbildungsfunktionen entwickeln.
Warum kann ich keine Jira-Karten aus 2 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 wird, wird diese mit der spezifischen Jira-Instanz verknüpft.
Selbst wenn alle Jira-Datensätze gelöscht werden, bleibt die Verbindung 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 Zuständiger für meine Jira-Datensätze in einer Tabelle oder Zeitachse nicht sehen oder bearbeiten?
Derzeit werden Jira-Status- und Zuständigkeitsfelder in Tabellen und Zeitachsen nicht unterstützt. Wir haben uns entschieden, diese Felder in Tabellen und Zeitachsen zu deaktivieren, um Missverständnisse, Verwirrungen und potenziellen Datenverlust zu vermeiden. Die Felder Jira-Status und Zuständiger und deren Inhalte existieren, erscheinen jedoch nicht in Tabellen oder Zeitachsen.
Du kannst diese Felder direkt in den Jira-Karten über das seitliche Feld bearbeiten. Ziehe einfach die Zeile aus der Tabelle oder der Zeitachse auf die Canvas, um deine Jira-Karte wieder erscheinen zu lassen.
Weitere Informationen: