Vercel

Vercel integratie configureren

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

Wat gaan we doen: 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

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 Settings → Integrations 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 "Create" om de integratie op te slaan

Configuratie velden uitgelegd

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

Controleer integratie status:

• Settings → Integrations toont "Connected" status voor Vercel
• 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 wij nemen zo snel mogelijk contact op.