Integraties
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
| Test | Slaagt wanneer |
|---|---|
| Actieve Clerk-gebruikers hebben MFA, een passkey of SSO | elke gebruiker die niet geblokkeerd is een tweede factor, een passkey of een enterprise SSO-account heeft |
| Organisatiebeheerders in Clerk hebben MFA, een passkey of SSO | hetzelfde geldt voor elke gebruiker met de rol org:admin |
| Geen Clerk-gebruikers zijn langer dan een jaar inactief | 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 |
| Elke Clerk-organisatie heeft een beheerder | Clerk geen organisatie meldt zonder lid dat haar kan beheren |
| Geen geblokkeerde Clerk-gebruikers hebben een beheerdersrol in een organisatie | geen geblokkeerde of gedeprovisioneerde gebruiker de rol org:admin heeft |
| SAML IdP-certificaten in Clerk verlopen niet binnen 30 dagen | elke actieve SAML-verbinding een certificaat heeft dat langer dan 30 dagen geldig is |
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
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:
- Maak een secret key aan
- Configureer de integratie in Tidal Control
Stap 1: Maak een secret key aan
- Log in op het Clerk Dashboard 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
- Naam: Een beschrijvende naam, bijvoorbeeld
- 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 metpk_ - 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.
Verzamel supportinformatie: Noteer welke browser je gebruikt, de exacte foutmeldingen en welke stappen je al hebt geprobeerd. Dat versnelt de oplossing aanzienlijk.
- Vorige
- Claude Enterprise
- Volgende
- Cloudflare