Ga naar hoofdinhoud
Versie: Versie 22

import SelfguideEmbed from '@site/src/components/selfguide/SelfguideEmbed';

Jira-applicatiekoppeling

Introductie​

Wat is de Jira-applicatiekoppeling? De Jira-applicatiekoppeling vormt de basis van de Jira-connectiviteitsintegratie in Fortes Change Cloud. Deze koppeling zorgt voor een beveiligde verbinding tussen een FCC-omgeving en een Jira-omgeving, en maakt tweerichtingsgegevensuitwisseling mogelijk: FCC stuurt Portfolio-items of programma-/project-items naar Jira, en Jira geeft continu de (bijgewerkte) status van die items terug.

Wie gebruikt het?

  • Beheerders en integratiespecialisten die de Jira-integratie inrichten en onderhouden.
  • Portfolio- en programmamanagers die profiteren van gesynchroniseerde teamgegevens tussen Jira en FCC.

Welke waarde levert het op?

  • Een live tweerichtingsverbinding waardoor werk-items en statussen tussen FCC en Jira op elkaar afgestemd blijven.
  • Gecontroleerde authenticatie via OAuth 2.0.
  • De voorwaarde voor alle verdere Jira-connectiviteitsconfiguratie, zoals teamconfiguraties en veldmappings.

Tweerichtingssynchronisatie: Items die vanuit FCC in Jira worden aangemaakt, houden hun veldmappings in beide richtingen gesynchroniseerd. Wanneer informatie in FCC wordt bijgewerkt, wordt dit doorgegeven aan Jira, en updates in Jira worden teruggekoppeld naar FCC. De koppeling is dus continu, niet eenmalig.

Een nieuwe applicatiekoppeling aanmaken​

Het maken van de koppeling is een tweezijdig proces: je registreert Fortes Change Cloud als app in Jira en plakt vervolgens de resulterende gegevens terug in FCC. De exacte stappen zijn afhankelijk van of je Jira Cloud of Jira Data Center gebruikt. FCC toont de waarden die je nodig hebt (zoals de callback-URL) op de pagina van de applicatiekoppeling zelf, met kopieerknoppen.

Belangrijk: De Jira-gebruiker waarmee je bent ingelogd tijdens het maken van de koppeling, is de gebruiker namens wie FCC zal handelen. Zorg dat je bent ingelogd in Jira als de beoogde API-gebruiker voordat je begint.

Jira Cloud (OAuth 2.0)​

Stap 1: FCC registreren in Jira

  1. Ga naar de Atlassian developer console: https://developer.atlassian.com/console/myapps/.
  2. Klik op Create en voeg een nieuwe OAuth 2.0 integration toe.
  3. Gebruik de waarden die FCC toont op de pagina van de applicatiekoppeling:
    • App name
    • OAuth 2.0 authorization callback URL
    • API scopes

Stap 2: Jira-gegevens terugkopiëren naar FCC

Plak de applicatiegegevens van de Jira-pagina in de bijbehorende FCC-velden:

  • Client ID
  • Client secret

Zorg dat de gebruiker die op dat moment is ingelogd in Jira, de gebruiker is die FCC moet gebruiken (de API-gebruiker).

Jira Data Center​

Voor Jira Data Center wordt de koppeling aangemaakt als een application link in Jira, en heb je ADMIN-rechten nodig om dit te doen.

Stap 1: FCC registreren in Jira

Registreer Fortes Change Cloud als een nieuwe applicatiekoppeling met de onderstaande waarden. De gebruiker waarmee je je aanmeldt in Jira, maakt ook de applicatiekoppeling aan.

  • Name: Fortes Change Cloud
  • Redirect URL: de callback-URL die FCC toont (bijv. https://<your-environment>/jira/oauth2/callback)
  • Permission: ADMIN

Stap 2: Jira-gegevens terugkopiëren naar FCC

Plak de applicatiekoppelingsgegevens van de Jira-pagina in de bijbehorende FCC-velden:

  • Client ID
  • Client secret
  • Jira URL: de link van de Jira-omgeving.

Best practices​

  • Gebruik een specifieke API-gebruiker in Jira met de juiste rechten, in plaats van een persoonlijk account, zodat de koppeling niet verbreekt wanneer iemand uit dienst treedt.
  • Log in als die API-gebruiker voordat je de koppeling aanmaakt. FCC handelt namens wie op dat moment is ingelogd in Jira.
  • Behandel de Client secret als een inloggegeven: bewaar deze veilig en vervang deze als hij mogelijk is blootgesteld.
  • Maak de koppeling eenmalig aan en hergebruik deze in elke teamconfiguratie; je hebt geen aparte koppeling per team nodig.

Veelgestelde vragen​

Wat is het verschil tussen de Jira Cloud- en Jira Data Center-installatie? Jira Cloud gebruikt een OAuth 2.0-integratie die is geregistreerd in de Atlassian developer console; Jira Data Center gebruikt een applicatiekoppeling die in Jira zelf wordt aangemaakt, waarvoor ADMIN-rechten nodig zijn en waarbij ook de Jira-URL wordt vastgelegd.

Als welke gebruiker handelt FCC? De Jira-gebruiker die was ingelogd toen de koppeling werd aangemaakt. Gebruik de beoogde API-gebruiker.

Is de synchronisatie eenrichtings- of tweerichtingsverkeer? Tweerichtingsverkeer. FCC stuurt items en updates naar Jira, en Jira geeft statusupdates terug aan FCC.

Heb ik per team een aparte koppeling nodig? Nee. Eén applicatiekoppeling kan worden hergebruikt voor meerdere teamconfiguraties.

Meer hulp nodig?​

Neem voor stapsgewijze instructies of hulp bij problemen contact op met je Fortes Change Cloud-beheerder of raadpleeg de in-app help.