# Jira Cloud

> Verbind Jira Cloud met Tidal Control via een API token, zodat compliance tests je Jira-omgeving uitlezen en taken werkitems kunnen worden in je project.

Source: https://tidalcontrol.com/nl/docs/integrations/jira-cloud

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.

Omdat Jira Cloud ook een issue tracker is, werkt de integratie in **twee richtingen**: Tidal voert compliance tests uit op je Jira omgeving (Jira → Tidal), en je kunt werkitems in Jira aanmaken, koppelen en synchroniseren vanuit Tidal taken en issues (Tidal → Jira). Zie [Externe issues](/docs/integrations/external-issues) voor die werkwijze.

## Vereisten

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

## Configuratie stappenplan

We maken een **Jira API token** in jouw Atlassian account die Tidal toestaat om compliance data op te halen. Een API token is een Atlassian mechanisme waarmee externe applicaties (Tidal) veilig toegang krijgen tot jouw Jira resources.

**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`** rechtsboven
- **Token configuratie:**
  - **Label:** `Tidal Control Integration`
  - Klik **`Create`**
  - **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 **Instellingen → Integraties** 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 **"Maken"** 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")

## Taken en issues doorzetten naar Jira (Tidal Control → Jira)

Vanuit elke Tidal taak of issue kun je een Jira werkitem aanmaken (of een bestaand werkitem koppelen), en Tidal houdt de status synchroon in het taakoverzicht. Selecteer bij het toevoegen van een externe issue je Jira verbinding, het **project** en het **issue type**; de rest van de werkwijze is voor elke issue tracker gelijk.

Zie **[Externe issues](/docs/integrations/external-issues)** voor de volledige aanmaken- / koppelen- / synchroniseren-werkwijze en de statuskolom in het taakoverzicht.

## Verificatie

Na succesvolle configuratie is er een link-icoon aanwezig in Tidal Taken en Issues, 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

Maakt de integratie geen verbinding, controleer dan het volgende:

- 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

**Voor meer informatie over Jira Cloud API management:** [Zie officiële Atlassian documentatie](https://support.atlassian.com/organization-administration/docs/manage-an-organization-with-the-admin-apis/)

### Kom je er nog niet uit?

Stuur een e-mail naar support@tidalcontrol.com, en we nemen zo snel mogelijk contact met je 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.