Voor beheerders: Lucid kaarten voor Jira configureren

Stel je Jira Cloud-instantie in voor livesynchronisatie

Je hebt zowel Jira- als Lucidspark-beheerdersrechten nodig om de volgende stappen te voltooien. We vereisen dat de beheerder die deze integratie instelt een Lucidspark-licentie heeft. We raden ook aan een Jira-serviceaccount of Jira-beheerdersaccount te gebruiken.

Om de Jira Cloud-instantie in te stellen voor livesynchronisatie met Lucid, kan een accountbeheerder de volgende stappen uitvoeren in Lucid: 

1. Klik op de Lucid startpagina op Beheerder linksonder in het navigatiemenu.
2. Klik op App-integratie in het linkermenu. 
3. Selecteer in de vervolgkeuzelijst Lucidspark.
4. Zoek de tegel Lucid kaarten voor Jira Cloud en klik op Instellingen.
5. Selecteer Nieuwe instantie toevoegen.
   

Hiermee wordt de pagina met Jira Cloud-instellingen geopend, waarop je deze stappen moet volgen:

1. Selecteer in het vervolgkeuzemenu “Authorize for” je Jira-instantie voor Lucidspark.
2. Klik op Accepteren.
   
3. Klik op Verbinden om te verifiëren met de inloggegevens van je Jira-instantie.
4. Selecteer Verzenden.

De integratie is nu ingesteld voor livesynchronisatie. 

Jira Data Center-instantie inschakelen

Volg de onderstaande stappen om een Jira Data Center-instantie in te stellen. We raden aan om OAuth 2.0 te gebruiken voor nieuwe integraties. Als je account eerder was verbonden via Application Links (OAuth 1.0), hoef je niet over te stappen; je bestaande verbinding blijft werken. Als je ondersteuning nodig hebt voor OAuth 1.0, raadpleeg dan dit communitybericht.

Hoewel de Jira-menu's die in dit gedeelte worden weergegeven kunnen verschillen afhankelijk van je versie van Jira Data Center, is het algemene instellingsproces hetzelfde.

Zorg dat je Jira-instantie toegankelijk is voor de servers van Lucid

Zorg dat je een openbare DNS hebt en sta inkomende verzoeken van de onderstaande statische IP-adressen toe.

Als je je in de FedRAMP-omgeving bevindt, zorg er dan voor dat je de inkomende en uitgaande verzoeken van de onderstaande statische IP-adressen toestaat.

Verbind Lucidspark met Jira Data Center via OAuth 2.0

Je hebt zowel Jira- als Lucidspark-beheerdersrechten nodig, naast een Lucidspark-licentie, om de volgende stappen te voltooien.

Stap 1: Maak een OAuth 2.0-applicatie aan in Jira Data Center

Maak in je Jira Data Center-instantie een inkomende OAuth 2.0-applicatielink aan:

1. Ga in Jira naar Jira-instellingen.
2. Ga naar Applicaties.
3. Kies Applicatielinks.
4. Selecteer Link aanmaken.
5. Kies Externe applicatie met de richting “Inkomend”.
6. Selecteer Doorgaan.
7. Stel de applicatienaam in.
   • De naam die je kiest, moet iets zijn dat de functionaliteit van Lucid kaarten voor Jira vertegenwoordigt; zoals “Lucidspark”.
   • Stel de omleidings-URL in op “https://lucid.app/jiradatacenter/oauth2/callback”.
8. Stel applicatietoestemmingen in op inclusief BEHEERDER.
9. Sla de gegenereerde Client-ID en het Clientgeheim op en kopieer ze.

Stap 2: de verbinding in Lucid configureren

1. Selecteer in Lucid Beheerder in het menu linksonder op de startpagina.
2. Selecteer App-integratie in het menu aan de linkerkant.
3. Klik in het vervolgkeuzemenu op Lucidspark.
4. Zoek de tegel "Lucid kaarten voor Jira Data Center".
5. Klik op Instellingen op de tegel (of Installeren als je de integratie nog niet eerder hebt ingesteld).
6. Selecteer Nieuwe instantie toevoegen (of Beginnen met instellen als je de integratie nog niet eerder hebt ingesteld).
7. Controleer of de omleidings-URL overeenkomt met wat je in Jira hebt geconfigureerd op de applicatielink.
8. Voer de Client-ID en Client Secret van Jira in.
9. Voer de URL van je Jira Data Center-instantie in.
   • Dit kan er bijvoorbeeld ongeveer zo uitzien als “https://jira.yourcompany.com”.
   • Als er een reverse proxy is geconfigureerd om inkomend verkeer te onderscheppen voordat het je instantie bereikt, kun je de URL van die reverse proxy opgeven. Die reverse proxy moet inkomend verkeer toestaan vanaf onze IP-adressen die hier staan vermeld.

Stap 3: Autoriseer de verbinding

1. Klik op Inschakelen om de OAuth 2.0-autorisatiestroom te starten.

Je wordt omgeleid naar je Jira Data Center-instantie om toegang goed te keuren. Na goedkeuring word je teruggeleid naar Lucid. De integratie is nu ingesteld voor livesynchronisatie.

Zodra de beheerdersconfiguratie is voltooid, kunnen eindgebruikers zich verifiëren met hun eigen Jira-inloggegevens om Jira-issues in Lucidspark te importeren en aan te maken. Elke gebruiker wordt tijdens de eerste verbinding doorgestuurd naar het toestemmingsscherm van Jira Data Center.

Voor accounts die SSO-verificatie met Jira gebruiken

De servers van Lucid moeten je Jira Data Center-instantie kunnen bereiken. Als je Jira Data Center-instantie wordt beschermd door een SSO-provider, kan dit problemen veroorzaken, aangezien SSO is ontworpen om gebruikers in een browser te authenticeren en vaak niet kan worden voltooid door een back-endservice die API-aanroepen doet.

De oplossing voor dit probleem hangt af van je specifieke SSO en netwerkconfiguratie. Je moet je SSO of netwerkinfrastructuur zo configureren dat het server-naar-serververkeer van Lucid de SSO-interceptie omzeilt. Veelvoorkomende benaderingen zijn onder meer uitsluiting op basis van paden in de SSO-laag of het verkeer van Lucid volledig om SSO heen leiden. 

OAuth 1.0 gebruiken met SSO

Voor OAuth 1.0-applicatielinks raadpleeg je de tijdelijke oplossing van Atlassian in dit communitybericht.

Stel je Atlassian Government Cloud-instantie in voor livesynchronisatie

Je hebt zowel Jira- als Lucidspark-beheerdersrechten nodig om de volgende stappen te voltooien. We vereisen dat de beheerder die deze integratie instelt, een Lucidspark-licentie heeft. We raden ook aan om een Jira-beheerdersaccount te gebruiken.

Om de Atlassian Government Cloud-instantie in te stellen voor livesynchronisatie met Lucid, kan een accountbeheerder de volgende stappen uitvoeren in Lucid: 

1. Klik op de Lucid startpagina op Beheerder linksonder in het navigatiemenu.
2. Klik op App-integratie in het linkermenu. 
3. Selecteer Lucidspark in de vervolgkeuzelijst.
4. Klik op Nieuwe Atlassian Government Cloud-instantie toevoegen.
5. Lees de toestemmingen door en klik op Accepteren.

De integratie is nu ingesteld voor livesynchronisatie. 

Veelgestelde vragen

Waarom zou ik als beheerder de Jira Cloud- of Atlassian Government Cloud-integratie inschakelen als dat niet verplicht is?
Vanaf januari 2023 gebruikt Lucidspark webhooks om gegevens van Jira te synchroniseren. Dankzij deze update kunnen whiteboards in realtime updates van Jira ontvangen. Lucidspark maakt en beheert pas webhooks na een eenmalige authenticatie via de configuratiestappen voor de integratie in dit artikel. Als de integratie individueel door een gebruiker wordt geïnstalleerd voordat deze stappen zijn voltooid, werkt de integratie wel, maar worden kaarten ongeveer elke 2 minuten bijgewerkt vanuit Jira in plaats van in realtime.

Wat moet ik doen als ik een foutmelding krijg wanneer ik de Lucid kaarten-integratie in Jira Data Center probeer in te stellen?
Als je bij het instellen van de Jira Data Center-integratie tegen een applicatiefout aanloopt, raadpleeg dan dit communitybericht Tips voor het oplossen van veelvoorkomende fouten bij het configureren van Lucid kaarten voor Jira Data Center.

Hoe werkt deze integratie en welke toestemmingen heb ik nodig?
Raadpleeg onze technische veelgestelde vragen over Lucid kaarten voor Jira voor een uitgebreide uitleg over hoe deze integratie werkt en welke toestemmingen je hebt op basis van het feit of je Jira-gebruikers- of beheerdersgegevens hebt. Deze bron bevat een diepgaande toelichting op hoe beheerdersgegevens worden gebruikt, webhooks en de voordelen ervan, en hoe Jira-gegevens worden beschermd.

Waarom word ik omgeleid naar lucid.app wanneer ik de Lucid kaarten voor Jira-integratie met mijn Atlassian Government Cloud-instantie probeer in te stellen?
Om te voorkomen dat je wordt omgeleid naar lucid.app, moet je SSO gebruiken om in te loggen op je Atlassian Government Cloud-instantie voordat je de Lucid kaarten voor Jira-integratie instelt.

Bronnen

Bekijk de aanvullende bronnen hieronder voor verdere ondersteuning bij het succesvol gebruiken van deze integratie. Deze bronnen zijn alleen beschikbaar in het Engels.

Community-berichten

Jira-probleemoplossing: Kan een veld in Lucid niet bewerken - foutmelding “Bewerken niet ondersteund”
Jira-probleemoplossing: Verschillende talen worden als kolommen toegevoegd aan Dynamic Table

Feedback geven over dit artikel