# Atlassian Admin

> Verbind je Atlassian-organisatie met Tidal Control via een API key, zodat compliance tests instellingen en gebruikersbeheer uitlezen op organisatieniveau.

Source: https://tidalcontrol.com/nl/docs/integrations/atlassian-admin

De Atlassian Admin integratie stelt Tidal Control in staat om automatisch compliance tests uit te voeren op je Atlassian organisatie via een API key configuratie. 

Atlassian Admin wordt gebruikt voor centraal beheer van Atlassian-producten, waardoor beheerders gebruikers, groepen, beveiligingsbeleid en compliance-instellingen kunnen beheren.

## Vereisten

- Super User rol in Tidal Control
- Atlassian Admin account met organisatie beheer rechten
- Toegang tot Atlassian Admin portal
- API key creation permissions

## Configuratie stappenplan

We maken een **Atlassian Admin API key met scopes** in jouw Atlassian organisatie die Tidal toestaat om compliance data op te halen. Een scoped API key is een Atlassian mechanisme waarmee externe applicaties (Tidal) veilig toegang krijgen tot specifieke organisatie resources met beperkte rechten.

**Configuratie stappen:**

1. **API key met scopes aanmaken**
2. **Integratie voltooien**

## Stap 1: API key met scopes aanmaken

- Ga naar **Atlassian Admin portal** op http://admin.atlassian.com
- **Selecteer je organisatie** uit beschikbare organisaties
- Klik **"Settings"** in bovenste navigatiebalk
- Selecteer **"API Keys"** in linker menu
- Klik **"Create API Key"** rechtsboven

**API key type selecteren:**
- Selecteer **"API key with scopes"**
- Klik **"Next"**

**API key configuratie:**
- **Beschrijvende naam:** `Tidal Control Integration`
- **Vervaldatum:** Selecteer gewenste geldigheidsperiode (max. 1 jaar)
- Klik **"Next"**

**Scopes toewijzen:**
Selecteer in de **"Read"** sectie de volgende bereiken:
- `Classification levels`
- `Domains`
- `Policies`
- Klik **"Next"**

**API key voltooien:**
- Controleer API key details
- Klik **"Create API Key"**
- **Kopieer API key waarde** onmiddellijk (niet meer zichtbaar na sluiten)
- Klik **"Done"**

> **info:**

**API key geldigheid:** Atlassian Admin API keys hebben een maximale geldigheidsperiode van één jaar. Wanneer je API key verloopt, kan Tidal Control geen gegevens meer ophalen uit je Atlassian Admin omgeving.

## Stap 2: Integratie voltooien

- Ga naar **Instellingen → Integraties** in Tidal Control
- Klik op het **plus-icoon** naast Atlassian Admin
- Vul configuratie in:
  - **Name:** `Atlassian Admin Production`
  - **API Key:** Gekopieerde API key waarde (uit stap 1)
- Klik **"Maken"** om integratie op te slaan

## Setup voor meerdere organisaties

Als je meerdere Atlassian organisaties moet verbinden met Tidal Control:

1. **Herhaal API key aanmaak** voor elke Atlassian organisatie
2. **Configureer aparte integratie** in Tidal per organisatie
3. **Gebruik beschrijvende namen** om organisaties te onderscheiden (bijv. "Atlassian Admin EU", "Atlassian Admin US")

## Verificatie

Na succesvolle configuratie toont Instellingen → Integraties Atlassian Admin onder **Geconfigureerde integraties**, zijn Atlassian-specifieke tests beschikbaar in de Tests sectie, en leveren test refreshes resultaten op zonder authentication errors.

> **warning:**

**API key bewaren:** Noteer de API key veilig - deze is niet meer zichtbaar na aanmaak en uniek nodig voor troubleshooting

## Troubleshooting

Maakt de integratie geen verbinding, controleer dan het volgende:

- Verifieer dat API key correct gekopieerd is (geen extra spaties)
- Check API key vervaldatum nog niet bereikt
- Bevestig juiste rechten geselecteerd (Classification levels, Domains, Policies)
- Verifieer dat Atlassian Admin account organisatie beheer rechten heeft

**Voor meer informatie over Atlassian Admin 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.