# Clerk

> Verbind je Clerk-instance met Tidal Control via een secret key, zodat compliancetests MFA, inactieve gebruikers, beheerders en SAML-certificaten controleren.

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

De Clerk-integratie van Tidal Control leest de authenticatie-inrichting van één Clerk-instance uit voor compliancedoeleinden. De verbinding authenticeert met een secret key tegen de Clerk Backend API (`https://api.clerk.com/v1`) en verstuurt alleen leesverzoeken.

Clerk is meestal de inloglaag binnen je eigen product. De gebruikers die deze integratie leest zijn dus de eindgebruikers van je applicatie, niet je medewerkers. Hun MFA-gebruik, inactieve accounts en beheerdersrollen zijn precies waar een auditor naar vraagt als je product klantgegevens bevat.

## Wat deze integratie monitort

- **Gebruikers:** Tweede factoren, passkeys, enterprise SSO-accounts, geblokkeerde en vergrendelde accounts, en de laatste activiteit
- **Organisaties:** Of elke organisatie een beheerder heeft, wie de beheerdersrol heeft, en geblokkeerde gebruikers die die rol nog hebben
- **Enterprise SSO:** Actieve SAML- en OIDC-verbindingen, en wanneer het certificaat van elke SAML-identiteitsprovider verloopt

## Tests

<table>
<thead>
<tr><th>Test</th><th>Slaagt wanneer</th></tr>
</thead>
<tbody>
<tr><td>Actieve Clerk-gebruikers hebben MFA, een passkey of SSO</td><td>elke gebruiker die niet geblokkeerd is een tweede factor, een passkey of een enterprise SSO-account heeft</td></tr>
<tr><td>Organisatiebeheerders in Clerk hebben MFA, een passkey of SSO</td><td>hetzelfde geldt voor elke gebruiker met de rol <code>org:admin</code></td></tr>
<tr><td>Geen Clerk-gebruikers zijn langer dan een jaar inactief</td><td>elke gebruiker die niet geblokkeerd is in het afgelopen jaar actief was; een gebruiker die nooit heeft ingelogd wordt beoordeeld op de aanmaakdatum van het account</td></tr>
<tr><td>Elke Clerk-organisatie heeft een beheerder</td><td>Clerk geen organisatie meldt zonder lid dat haar kan beheren</td></tr>
<tr><td>Geen geblokkeerde Clerk-gebruikers hebben een beheerdersrol in een organisatie</td><td>geen geblokkeerde of gedeprovisioneerde gebruiker de rol <code>org:admin</code> heeft</td></tr>
<tr><td>SAML IdP-certificaten in Clerk verlopen niet binnen 30 dagen</td><td>elke actieve SAML-verbinding een certificaat heeft dat langer dan 30 dagen geldig is</td></tr>
</tbody>
</table>

Gebruikers die inloggen via enterprise SSO slagen voor de MFA-tests, omdat hun identiteitsprovider MFA afdwingt en niet Clerk.

## Vereisten

- De rol Super User in Tidal Control
- Toegang tot de pagina **API keys** van je Clerk-productie-instance

> **warning:**

**Een secret key van Clerk kan niet tot leesrechten worden beperkt.** Elke secret key kan alles in zijn instance lezen en wijzigen, inclusief het verwijderen van gebruikers. Tidal Control verstuurt alleen leesverzoeken, maar maak er een aparte sleutel voor aan, zodat je die kunt intrekken zonder de sleutels van je applicatie te raken.

## Stappenplan voor de configuratie

We maken in Clerk een aparte secret key aan en voegen daarna de verbinding toe in Tidal Control.

**Configuratiestappen:**

1. **Maak een secret key aan**
2. **Configureer de integratie in Tidal Control**

## Stap 1: Maak een secret key aan

- Log in op het [Clerk Dashboard](https://dashboard.clerk.com) en open je applicatie
- Ga naar je **productie**-instance. Een development-instance bevat testgegevens, en de resultaten zouden dan niets over je product zeggen
- Open **API keys** en voeg een nieuwe secret key toe met de naam `Tidal Control`
- Kopieer de sleutel. Die begint met `sk_live_`

De publishable key op dezelfde pagina begint met `pk_` en is bedoeld voor je frontend. Daarmee bereik je de Backend API niet, dus die werkt hier niet.

## Stap 2: Configureer de integratie in Tidal Control

- Ga in Tidal Control naar **Instellingen → Integraties**
- Klik op het **plusicoon** naast **Clerk**
- Vul de configuratie in:
  - **Naam:** Een beschrijvende naam, bijvoorbeeld `Clerk`
  - **Geheime sleutel:** De sleutel uit stap 1, zonder aanhalingstekens of spaties eromheen
- Klik op **"Aanmaken"** om de integratie op te slaan

## Uitleg van de configuratievelden

**Naam:**
- Een beschrijvende naam voor deze verbinding
- Bijvoorbeeld: `Clerk`, `Clerk productie`

**Geheime sleutel:**
- Een secret key van Clerk die begint met `sk_live_`
- Verplicht, en opgeslagen als geheim
- Een development-sleutel die begint met `sk_test_` wordt geaccepteerd om de integratie uit te proberen

## Verificatie

De integratie werkt als het volgende klopt:

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

## Veelgestelde vragen

**Welke gebruikers leest Tidal Control?**
De gebruikers van de Clerk-instance waar de sleutel bij hoort, en dat zijn normaal gesproken de eindgebruikers van je applicatie. Leden van het Clerk Dashboard, de mensen die Clerk zelf beheren, zijn niet beschikbaar via de Backend API.

**Kan Tidal Control controleren of MFA voor iedereen verplicht is?**
Nee. De Backend API van Clerk geeft geen instance-instellingen vrij, zoals verplichte MFA, het wachtwoordbeleid of de sessieduur. De tests lezen in plaats daarvan de werkelijke situatie van elke gebruiker.

**Waarom tonen de organisatietests geen resultaten?**
Organisaties zijn een functie van Clerk die je per instance aanzet. Staat die uit, dan zijn er geen organisaties of beheerdersrollen om te controleren, en slagen die tests zonder resultaten.

**Waarom toont de test voor SAML-certificaten geen resultaten?**
Enterprise SSO vereist een betaald abonnement bij Clerk, en OIDC-verbindingen hebben geen certificaat. Zonder actieve SAML-verbinding is er niets te controleren.

## Veelvoorkomende problemen

**Tests geven een authenticatiefout**
- Controleer of je een secret key hebt gekopieerd die begint met `sk_live_`, en niet de publishable key die begint met `pk_`
- Is de sleutel ingetrokken in het Clerk Dashboard, maak dan een nieuwe aan en werk de verbinding bij voordat je de tests ververst

**De resultaten beschrijven testgebruikers**
- De verbinding gebruikt een development-sleutel (`sk_test_`). Bewerk de verbinding en plak een sleutel uit je productie-instance

### Kom je er niet uit?

Stuur een e-mail naar support@tidalcontrol.com, dan nemen we zo snel mogelijk contact met je op.

> **info:**

**Verzamel supportinformatie:** Noteer welke browser je gebruikt, de exacte foutmeldingen en welke stappen je al hebt geprobeerd. Dat versnelt de oplossing aanzienlijk.
