Integraties

Jira Cloud


title: Jira Cloud description: Jira Cloud integratie configureren voor automatische compliance monitoring in Tidal Control sidebar_position: 7

Jira Cloud

Jira Cloud integratie configureren

De Jira Cloud integratie stelt Tidal Control in staat om automatisch compliance tests uit te voeren op je Jira omgeving via een API token configuratie.

Jira Cloud is een krachtige tool voor het bijhouden van issues en projectbeheer die teams helpt bij het plannen, toewijzen, volgen, rapporteren en beheren van werk binnen verschillende projecten.

Vereisten:

  • Super User rol in Tidal Control
  • Jira Cloud account met project toegang
  • Atlassian account management rechten
  • Toegang tot Jira Cloud instance

Configuratie stappenplan

Wat gaan we doen: We maken een Jira API token met scopes in jouw Atlassian account die Tidal toestaat om compliance data op te halen. Een scoped API token is een Atlassian mechanisme waarmee externe applicaties (Tidal) veilig toegang krijgen tot specifieke Jira resources met beperkte rechten.

Configuratie stappen:

  1. API token aanmaken
  2. Integratie voltooien

Stap 1: API token aanmaken

  • Ga naar Atlassian Account API Tokens op https://id.atlassian.com/manage-profile/security/api-tokens

  • Log in met je Jira Cloud account

  • Klik Create API token with scopes rechtsboven

  • Token configuratie:

    • Label: Tidal Control Integration
    • Vervaldatum: Selecteer gewenste geldigheidsperiode (max. 1 jaar)
    • Klik Next
    • Selecteer Jira als de app voor het API token
    • Klik Next
    • Selecteer de volgende scopes:
      • read:jira-user
      • read:jira-work
    • Klik Next
  • Token voltooien:

    • Controleer API token details
    • Klik Create token
    • Kopieer token waarde onmiddellijk (niet meer zichtbaar na sluiten)
    • Klik Close
Info

Token geldigheid: Jira Cloud API tokens hebben een maximale geldigheidsperiode van één jaar. Wanneer je API token verloopt, kan Tidal Control geen gegevens meer ophalen uit je Jira Cloud omgeving.

Stap 2: Integratie voltooien

  • Ga naar Settings → Integrations in Tidal Control
  • Klik op het plus-icoon naast Jira Cloud
  • Vul configuratie in:
    • Name: Jira Production
    • Username: Het email adres dat je gebruikt om in Jira in te loggen (en dat gebruikt is om het API token aan te maken)
    • API url: Je Jira instance URL (format: https://yourcompany.atlassian.net)
    • API token: Gekopieerde token waarde (uit stap 1)
  • Klik "Create" om integratie op te slaan
Tip

API URL format: Gebruik altijd volledige URL inclusief https:// (bijv. https://company.atlassian.net)

Setup voor meerdere sites

Als je meerdere Jira-sites moet verbinden met Tidal Control:

  • Herhaal token aanmaak voor elke Jira site
  • Configureer aparte integratie in Tidal per site
  • Gebruik beschrijvende namen om sites te onderscheiden (bijv. "Jira Development", "Jira Operations")

Verificatie

Na succesvolle configuratie toont Settings → Integrations een "Connected" status voor Jira Cloud, zijn Jira-specifieke tests beschikbaar in de Tests sectie, en leveren test refreshes resultaten op zonder authentication errors.

Warning

API token bewaren: Noteer het API token veilig - het is niet meer zichtbaar na aanmaak en uniek nodig voor troubleshooting

Troubleshooting

Troubleshooting bij problemen:

  • Verifieer of API token correct gekopieerd is (geen extra spaties)
  • Check API URL format inclusief https:// en correct domein
  • Bevestig of username overeen komt met het email adres van degene die het token heeft aangemaakt
  • Check dat token vervaldatum nog niet bereikt is
  • Bevestig dat de API token de juiste rechten heeft (read:jira-user, read:jira-work)

Voor meer informatie over Jira Cloud API management: Zie officiële Atlassian documentatie

Kom je er nog niet uit?

Stuur een e-mail naar support@tidalcontrol.com, en wij nemen zo snel mogelijk contact op.

Info

Support info verzamelen: Noteer welke browser je gebruikt, exacte foutmeldingen, welke stappen je al geprobeerd hebt, en screenshots van het probleem. Dit versnelt de oplossing aanzienlijk.

Vorige
GitLab