Direct naar de inhoud

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

TestSlaagt wanneer
Actieve Clerk-gebruikers hebben MFA, een passkey of SSOelke gebruiker die niet geblokkeerd is een tweede factor, een passkey of een enterprise SSO-account heeft
Organisatiebeheerders in Clerk hebben MFA, een passkey of SSOhetzelfde geldt voor elke gebruiker met de rol org:admin
Geen Clerk-gebruikers zijn langer dan een jaar inactiefelke 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 beheerderClerk geen organisatie meldt zonder lid dat haar kan beheren
Geen geblokkeerde Clerk-gebruikers hebben een beheerdersrol in een organisatiegeen geblokkeerde of gedeprovisioneerde gebruiker de rol org:admin heeft
SAML IdP-certificaten in Clerk verlopen niet binnen 30 dagenelke 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
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 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.

Volgende
Cloudflare