# Aikido

> Verbind Aikido Security met Tidal Control zodat compliance tests je code- en cloudbevindingen uitlezen. Alle toegang is alleen-lezen, er verandert niets.

Source: https://tidalcontrol.com/nl/docs/integrations/aikido

Tidal Control's Aikido integratie monitort je Aikido Security-omgeving voor compliance doeleinden. Alle toegang is alleen-lezen. Tidal Control maakt, wijzigt of verwijdert nooit iets in Aikido.

## Wat deze integratie monitort

- **Issues:** Openstaande security-bevindingen en hun severity
- **Repositories:** Gekoppelde code-repositories
- **Cloud accounts:** Gekoppelde cloudomgevingen
- **Containers:** Gescande container images
- **Virtual machines:** Gekoppelde VM's
- **Domains:** Gemonitorde domeinen
- **Teams & users:** Teamlidmaatschap en gebruikers

## Vereisten

- Super User rol in Tidal Control
- Een Aikido-account met rechten om API-credentials aan te maken

## Configuratie stappenplan

We maken een **Aikido OAuth2 API-client** aan (Client ID en Client Secret) en voegen daarna de verbinding toe in Tidal Control.

**Configuratie stappen:**

1. **API-client aanmaken in Aikido**
2. **Integratie configureren in Tidal Control**

## Stap 1: API-client aanmaken in Aikido

- Log in op [Aikido](https://app.aikido.dev)
- Ga naar **Integrations › API**
- Maak een nieuwe API-client aan
- **Kopieer de Client ID en Client Secret**: de secret wordt slechts één keer getoond

> **warning:**

**Sla de Client Secret direct op.** Aikido toont de secret slechts één keer bij het aanmaken. Als je het venster sluit zonder te kopiëren, moet je een nieuwe API-client aanmaken.

## Stap 2: Integratie configureren in Tidal Control

- Ga naar **Instellingen → Integraties** in Tidal Control
- Klik op het **plus-icoon** naast **Aikido**
- Vul de configuratie in:
  - **Name:** Een beschrijvende naam, bijv. `Aikido`
  - **Client ID:** De Client ID uit stap 1
  - **Client Secret:** De Client Secret uit stap 1
  - **Region (optioneel):** De Aikido-regio die je account gebruikt (standaard **EU**)
- Klik op **"Maken"** om de integratie op te slaan

## Configuratievelden uitgelegd

Het integratievenster vraagt om de volgende waarden:

**Name:**
- Een beschrijvende naam voor deze verbinding
- Bijvoorbeeld: `Aikido`, `Aikido Productie`

**Client ID:**
- De identifier van de Aikido OAuth2-client
- Aangemaakt in stap 1

**Client Secret:**
- Het geheime deel van de Aikido OAuth2-client
- Aangemaakt in stap 1
- Houd deze waarde veilig

**Region (optioneel):**
- De Aikido-dataregio die je account gebruikt
- Laat op de standaardwaarde (EU) staan, tenzij je account in een andere regio wordt gehost

<table>
<thead>
<tr><th>Regio</th><th>Endpoint</th></tr>
</thead>
<tbody>
<tr><td><code>EU</code></td><td>app.aikido.dev (standaard)</td></tr>
<tr><td><code>US</code></td><td>app.us.aikido.dev</td></tr>
<tr><td><code>ME</code></td><td>app.me.aikido.dev</td></tr>
</tbody>
</table>

## Verificatie

De integratie werkt wanneer het volgende allemaal klopt:

- Instellingen → Integraties toont Aikido onder **Geconfigureerde integraties**
- Aikido tests zijn beschikbaar in de sectie Tests
- Het verversen van tests levert resultaten op zonder authenticatiefouten

## Veelgestelde vragen

**Brengt Tidal Control wijzigingen aan in Aikido?**
Nee. De integratie is alleen-lezen en leest uitsluitend gegevens uit de publieke Aikido API.

**Welke regio moet ik kiezen?**
Gebruik de regio waar je Aikido-account wordt gehost. De meeste accounts zitten in de EU-regio (`app.aikido.dev`), wat de standaard is. Log je in op `app.us.aikido.dev` of `app.me.aikido.dev`, kies dan respectievelijk US of ME.

## Veelvoorkomende problemen

**"Aikido OAuth2 authentication failed"**
- Controleer of de Client ID en Client Secret correct zijn en niet zijn afgekapt
- De secret wordt slechts één keer getoond. Heb je deze niet gekopieerd, maak dan een nieuwe API-client aan

**Tests falen met een autorisatiefout**
- Controleer of de API-client nog bestaat in Aikido en niet is ingetrokken

**Geen of verkeerde data**
- Controleer of de gekozen **Region** overeenkomt met de regio waar je Aikido-account wordt gehost

### 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:**

**Verzamel support-informatie:** Noteer welke browser je gebruikt, de exacte foutmeldingen en welke stappen je al hebt geprobeerd. Dit versnelt de oplossing aanzienlijk.