Für Administrator*innen: Konfigurieren Sie Lucid-Karten für Jira

Richten Sie Ihre Jira Cloud-Instanz für die Live-Synchronisierung ein

Sie benötigen sowohl Jira- als auch Lucidspark-Admin-Berechtigungen, um die folgenden Schritte auszuführen. Wir setzen voraus, dass der Admin, der diese Integration einrichtet, über eine Lucidspark-Lizenz verfügt. Wir empfehlen außerdem die Verwendung eines Jira-Servicekontos oder Jira-Admin-Kontos.

Um die Jira Cloud-Instanz für die Live-Synchronisierung mit Lucid einzurichten, können Kontoadmins die folgenden Schritte in Lucid ausführen: 

1. Klicken Sie auf der Lucid Homepage unten links im Navigationsmenü auf Admin.
2. Klicken Sie auf App-Integration im linken Menü. 
3. Wählen Sie im Dropdown-Menü Lucidspark aus.
4. Suchen Sie die Kachel „Lucid-Karten für Jira Cloud“ und klicken Sie auf Einstellungen.
5. Wählen Sie Neue Instanz hinzufügen.
   

Dadurch wird die Seite „Jira Cloud-Einstellungen“ geöffnet, auf der Sie die folgenden Schritte ausführen müssen:

1. Wählen Sie im Dropdown-Menü „Autorisieren für“ Ihre Jira-Instanz für Lucidspark aus.
2. Klicken Sie auf Akzeptieren.
   
3. Klicken Sie auf Verbinden, um sich mit den Anmeldedaten Ihrer Jira-Instanz zu authentifizieren.
4. Wählen Sie Senden.

Die Integration ist jetzt für die Live-Synchronisierung eingerichtet. 

Jira Data Center-Instanz aktivieren

Befolgen Sie die folgenden Schritte, um eine Jira Data Center-Instanz einzurichten. Wir empfehlen die Verwendung von OAuth 2.0 für neue Integrationen. Wenn Ihr Konto zuvor über Anwendungslinks (OAuth 1.0) verbunden war, müssen Sie nicht wechseln. Ihre bestehende Verbindung funktioniert weiterhin. Wenn Sie Support für OAuth 1.0 benötigen, lesen Sie bitte diesen Community-Beitrag.

Auch wenn sich die in diesem Abschnitt gezeigten Jira-Menüs je nach Ihrer Version von Jira Data Center unterscheiden können, ist der allgemeine Einrichtungsprozess derselbe.

Stellen Sie sicher, dass Ihre Jira-Instanz für die Server von Lucid erreichbar ist

Stellen Sie sicher, dass Sie über ein öffentlich zugängliches DNS verfügen und eingehende Anfragen von den unten aufgeführten statischen IP-Adressen zulassen.

Wenn Sie sich in der FedRAMP-Umgebung befinden, stellen Sie sicher, dass Sie die unten aufgeführten eingehenden und ausgehenden Anfragen von statischen IP-Adressen zulassen.

Lucidspark über OAuth 2.0 mit Jira Data Center verbinden

Sie benötigen sowohl Jira- als auch Lucidspark-Admin-Berechtigungen sowie eine Lucidspark-Lizenz, um die folgenden Schritte auszuführen.

Schritt 1: Erstellen Sie eine OAuth 2.0-Anwendung in Jira Data Center

Erstellen Sie in Ihrer Jira Data Center-Instanz einen eingehenden OAuth 2.0-Anwendungslink:

1. Navigieren Sie in Jira zu Jira-Einstellungen.
2. Gehen Sie zu Anwendungen.
3. Wählen Sie Anwendungslinks.
4. Wählen Sie Link erstellen.
5. Wählen Sie Externe Anwendung mit der Richtung „Eingehend“.
6. Wählen Sie Weiter.
7. Legen Sie den Anwendungsnamen fest.
   • Der von Ihnen gewählte Name sollte die Funktionalität von Lucid-Karten für Jira repräsentieren, zum Beispiel „Lucidspark“.
   • Setzen Sie die Weiterleitungs-URL auf „https://lucid.app/jiradatacenter/oauth2/callback“.
8. Stellen Sie die Anwendungsberechtigungen so ein, dass ADMIN enthalten ist.
9. Speichern Sie die generierte Client-ID und das Client-Secret und kopieren Sie sie.

Schritt 2: Verbindung in Lucid konfigurieren

1. Wählen Sie in Lucid im Menü unten links auf der Startseite Admin aus.
2. Wählen Sie im Menü links App-Integration aus.
3. Klicken Sie im Dropdown-Menü auf Lucidspark.
4. Suchen Sie die Kachel „Lucid-Karten für Jira Data Center“.
5. Klicken Sie auf der Kachel auf Einstellungen (oder auf Installieren, wenn Sie die Integration zuvor noch nicht eingerichtet haben).
6. Wählen Sie Neue Instanz hinzufügen (oder Einrichtung beginnen, wenn Sie die Integration zuvor noch nicht eingerichtet haben).
7. Überprüfen Sie, ob die Weiterleitungs-URL damit übereinstimmt, was Sie in Jira für den Anwendungslink konfiguriert haben.
8. Geben Sie die Client-ID und das Client-Geheimnis von Jira ein.
9. Geben Sie die URL Ihrer Jira Data Center-Instanz ein.
   • Dies könnte beispielsweise etwa so aussehen: „https://jira.yourcompany.com“.
   • Wenn ein Reverse-Proxy so konfiguriert ist, dass er eingehenden Datenverkehr abfängt, bevor er Ihre Instanz erreicht, können Sie die URL dieses Reverse-Proxys angeben. Dieser Reverse-Proxy muss eingehenden Datenverkehr von unseren hier aufgelisteten IP-Adressen zulassen.

Schritt 3: Autorisieren Sie die Verbindung

1. Klicken Sie auf „Aktivieren“, um den OAuth 2.0-Autorisierungsablauf zu starten.

Sie werden zu Ihrer Jira Data Center-Instanz weitergeleitet, um den Zugriff zu genehmigen. Nach der Genehmigung werden Sie zurück zu Lucid geleitet. Die Integration ist jetzt für die Live-Synchronisierung eingerichtet.

Sobald die Admin-Einrichtung abgeschlossen ist, können sich Endnutzende mit ihren eigenen Jira-Anmeldedaten authentifizieren, um Jira-Tickets in Lucidspark zu importieren und zu erstellen. Alle Nutzenden werden bei ihrer ersten Verbindung zum Jira Data Center-Zustimmungsbildschirm weitergeleitet.

Für Konten, die SSO-Authentifizierung mit Jira verwenden

Die Server von Lucid müssen Ihre Jira Data Center-Instanz erreichen können. Wenn Ihre Jira Data Center-Instanz durch einen SSO-Anbieter geschützt ist, kann dies zu Problemen führen, da SSO dafür ausgelegt ist, Nutzende in einem Browser zu authentifizieren, und häufig nicht von einem Backend-Dienst abgeschlossen werden kann, der API-Aufrufe ausführt.

Die Behebung dieses Problems hängt von Ihrer spezifischen SSO- und Netzwerkkonfiguration ab. Sie müssen Ihre SSO- oder Netzwerkinfrastruktur so konfigurieren, dass der Server-zu-Server-Datenverkehr von Lucid das Abfangen durch SSO umgeht. Zu den gängigen Ansätzen gehören ein pfadbasierter Ausschluss auf SSO-Layer oder das vollständige Umleiten des Lucid-Datenverkehrs um SSO herum. 

Verwendung von OAuth 1.0 mit SSO

Informationen zu OAuth 1.0-Anwendungslinks finden Sie im Atlassian-Workaround in diesem Community-Beitrag.

Richten Sie Ihre Atlassian Government Cloud-Instanz für die Live-Synchronisierung ein

Sie benötigen sowohl Jira- als auch Lucidspark-Administratorberechtigungen, um die folgenden Schritte durchzuführen. Wir setzen voraus, dass der Administrator, der diese Integration einrichtet, über eine Lucidspark-Lizenz verfügt. Wir empfehlen außerdem, ein Jira-Admin-Konto zu verwenden.

Um die Atlassian Government Cloud-Instanz für die Live-Synchronisierung mit Lucid einzurichten, können Kontoadmins die folgenden Schritte in Lucid ausführen: 

1. Klicken Sie auf der Lucid Homepage unten links im Navigationsmenü auf Admin.
2. Klicken Sie im linken Menü auf App-Integration. 
3. Wählen Sie im Dropdown-Menü Lucidspark aus.
4. Klicken Sie auf Neue Atlassian Government Cloud-Instanz hinzufügen.
5. Lesen Sie die Berechtigungen durch und klicken Sie auf Akzeptieren.

Die Integration ist jetzt für die Live-Synchronisierung eingerichtet. 

FAQ

Warum sollte ich als Admin die Jira Cloud- oder Atlassian Government Cloud-Integration aktivieren, wenn dies nicht erforderlich ist?
Seit Januar 2023 verwendet Lucidspark Webhooks, um Daten aus Jira zu synchronisieren. Dieses Update ermöglicht es Boards, Aktualisierungen von Jira in Echtzeit zu erhalten. Lucidspark erstellt und verwaltet Webhooks erst nach einer einmaligen Authentifizierung über die Schritte zur Einrichtung der Integration in diesem Artikel. Wenn die Integration von Nutzenden einzeln installiert wird, bevor diese Schritte abgeschlossen sind, funktioniert die Integration zwar, aber Karten synchronisieren Aktualisierungen von Jira etwa alle 2 Minuten anstatt in Echtzeit.

Was kann ich tun, wenn ich beim Einrichten der Integration von Lucid-Karten im Jira Data Center eine Fehlermeldung erhalte?
Wenn beim Einrichten der Jira Data Center-Integration ein Anwendungsfehler auftritt, lesen Sie diesen Community-Beitrag: Tipps zur Behebung häufiger Fehler beim Konfigurieren von Lucid-Karten für Jira Data Center.

Wie funktioniert diese Integration und welche Berechtigungen benötige ich?
Eine ausführliche Erklärung dazu, wie diese Integration funktioniert und welche Berechtigungen Sie haben, je nachdem, ob Sie über Jira-Anmeldedaten für Nutzende oder Admins verfügen, finden Sie in unserer Ressource Lucid-Karten für Jira – Technische FAQs. Diese Ressource bietet ausführliche Einblicke dazu, wie Admin-Anmeldedaten verwendet werden, über Webhooks und deren Vorteile sowie darüber, wie Jira-Daten geschützt werden.

Warum werde ich zu lucid.app weitergeleitet, wenn ich versuche, die Integration von Lucid-Karten für Jira mit meiner Atlassian Government Cloud-Instanz einzurichten?
Um eine Weiterleitung zu lucid.app zu verhindern, müssen Sie sich per SSO bei Ihrer Atlassian Government Cloud-Instanz anmelden, bevor Sie die Integration von Lucid-Karten für Jira einrichten.

Ressourcen

Weitere Unterstützung bei der erfolgreichen Nutzung dieser Integration finden Sie in den zusätzlichen Ressourcen unten. Diese Ressourcen sind nur auf Englisch verfügbar.

Community-Beiträge

Jira-Fehlerbehebung: Ein Feld in Lucid kann nicht bearbeitet werden – Fehlermeldung „Bearbeitung nicht unterstützt“
Jira-Fehlerbehebung: Verschiedene Sprachen werden als Spalten zur dynamischen Tabelle hinzugefügt

Geben Sie Feedback zu diesem Artikel