# Vercel

> Verbind Vercel met Tidal Control zodat compliance tests de beveiligingsconfiguratie van je deployment platform uitlezen, van teamtoegang tot projecten.

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

Tidal Control's Vercel integratie monitort de beveiligingsconfiguratie van je deployment platform voor compliance doeleinden.

## Wat deze integratie monitort

- **Teams:** SAML-handhaving
- **Team members:** Bevestigingsstatus en herkomst van inrichting
- **Project members:** Configuratie van admin-rechten
- **Projects:** Instellingen voor deployment-beveiliging
- **Environment variables:** Versleuteling (geen plain text secrets)
- **Deployments:** Productie-deployments uitsluitend vanuit Git
- **Firewall:** Status van de Web Application Firewall
- **Domains:** Verificatiestatus en automatische verlengingsconfiguratie
- **Certificates:** Configuratie van automatische verlenging

## Vereisten

- Super User rol in Tidal Control
- Vercel account met toegang tot account- of team-instellingen

## Configuratie stappenplan

We maken een **Vercel access token** aan en voegen de verbinding toe in Tidal Control. Als je Vercel account teams gebruikt, geef je ook het team-ID op om de monitoring te beperken tot een specifiek team.

**Configuratie stappen:**

1. **Access token aanmaken**
2. **Team-ID opzoeken (indien van toepassing)**
3. **Integratie configureren in Tidal Control**

## Stap 1: Access token aanmaken

- Log in op je Vercel account
- Klik op je **profielfoto** rechtsboven in het scherm
- Selecteer **Account Settings** (of navigeer via **Settings** vanuit het dashboard)
- Navigeer naar **Tokens** in de linker zijbalk
- Klik op **Create**
- Voer een naam in (bijv. `Tidal Control`)
- Kies een scope: selecteer **Full Account** of het specifieke team dat je wilt monitoren
- Stel een vervaldatum in (optioneel maar aanbevolen)
- Klik op **Create Token**
- **Kopieer de tokenwaarde**: deze wordt slechts één keer getoond

> **warning:**

**Sla het token direct op.** Vercel toont de volledige tokenwaarde slechts één keer bij aanmaken. Als je het dialoogvenster sluit zonder te kopiëren, moet je een nieuw token aanmaken.

## Stap 2: Team-ID opzoeken (indien van toepassing)

Als je Vercel account teams gebruikt en je de integratie wilt beperken tot een specifiek team:

- Navigeer naar de **Settings** van het team in Vercel
- Ga naar **General**
- Kopieer het **Team ID** dat op deze pagina wordt getoond (begint met `team_`)

Als je het token hebt aangemaakt met een volledige accountscope, kun je het team-ID leeg laten om alle teams te monitoren.

## Stap 3: Integratie configureren in Tidal Control

- Ga naar **Instellingen → Integraties** in Tidal Control
- Klik op het **plus-icoon** naast **Vercel**
- Vul de configuratie in:
  - **Name:** Een beschrijvende naam, bijv. `Vercel`
  - **Access Token:** Het access token uit stap 1
  - **Team ID (optioneel):** Het team-ID uit stap 2, als je de monitoring wilt beperken tot een specifiek team
- 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: `Vercel`, `Vercel Productie`

**Access Token:**
- Je persoonlijke Vercel access token
- Aangemaakt in stap 1
- Houd deze waarde veilig

**Team ID (optioneel):**
- Beperkt de integratie tot een specifiek Vercel-team
- Laat leeg om alle teams te monitoren die toegankelijk zijn voor het access token
- Begint met `team_`

## Verificatie

De integratie werkt wanneer het volgende allemaal klopt:

- Instellingen → Integraties toont Vercel onder **Geconfigureerde integraties**
- Vercel tests zijn beschikbaar in de Tests sectie
- Test refresh levert resultaten zonder authenticatiefouten

## Veelgestelde vragen

**Kan ik hetzelfde access token gebruiken voor meerdere Tidal Control omgevingen?**
Ja, hetzelfde access token kan worden gebruikt voor verschillende Tidal Control instanties.

**Wat is het verschil tussen een team-ID gebruiken en niet gebruiken?**
Zonder team-ID monitort de integratie alle resources die toegankelijk zijn voor het access token. Met een team-ID wordt de monitoring beperkt tot dat specifieke team.

**Heb ik een Vercel Pro of Enterprise abonnement nodig?**
Sommige functies (zoals SAML-handhaving en geavanceerde deployment-beveiliging) zijn alleen beschikbaar op Pro of Enterprise abonnementen. De integratie werkt ook op het Hobby-abonnement, maar die tests leveren dan mogelijk geen resultaten op.

## Veelvoorkomende problemen

**"Access Token is required"**
- Zorg dat je de tokenwaarde hebt ingevoerd en niet de tokennaam

**Tests tonen authenticatiefouten na verbinding**
- Controleer of het access token nog geldig is. Tokens kunnen verlopen of worden ingetrokken in de Vercel token-instellingen
- Controleer of de tokenscope het team omvat dat je wilt monitoren

**Test "VERCEL_TEAMS_SAML_ENFORCED" mislukt voor alle teams**
- SAML is een Enterprise-functie in Vercel. Deze test mislukt als je abonnement dit niet ondersteunt
- Als je Enterprise hebt, schakel SAML-handhaving in via de Security-instellingen van het team

**Er worden geen tests voor environment variables uitgevoerd**
- Environment variables worden alleen gecontroleerd voor handmatig aangemaakte variabelen, niet voor door het systeem gegenereerde variabelen
- Zorg dat je projecten handmatig geconfigureerde environment variables hebben

### 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, en welke stappen je al geprobeerd hebt. Dit versnelt de oplossing aanzienlijk.