HelixIAM door KubeDNA

HSM · Sleutelbeheer · Thales Luna · PKCS#11 · Soevereiniteit

Tokens ondertekenen met sleutels die het HSM nooit verlaten: HelixIAM getest met Thales Luna Cloud HSM

Veel Europese overheidsorganisaties en banken bewaren hun sleutels in een HSM. Wat sleutelbeheer met High assurance in HelixIAM doet, hoe we het testten met een Thales Luna Cloud HSM, de gemeten ondertekentijden en hoe de opzet werkt.

Getest met Thales Luna Cloud HSMSleutelbeheer met High assurance
Realmsleutels
ES256, RS256 en PS256, gegenereerd in het HSM
Tokens
Gecontroleerd tegen de JWKS van de realm
Levenscyclus
Rotatie, noodrotatie en herstart geslaagd
Ondertekentijd
Ongeveer 25 ms bij p50 en 45 ms bij p95
De private sleutel blijft in het HSM. HelixIAM vraagt het HSM om te ondertekenen.
Op deze pagina
  1. Waarom sleutelbeheer in een HSM telt voor overheid en gereguleerde organisaties
  2. Wat High assurance doet
  3. Getest met Thales Luna Cloud HSM
  4. De opzet, in het kort
  5. Wat bij jou blijft
  6. Hoe begin je

Elk token dat je identity provider ondertekent is maar zo betrouwbaar als de private sleutel erachter. Wie die sleutel heeft, kan een geldige login maken voor elke applicatie die de provider vertrouwt. Daarom bewaren veel Europese overheidsorganisaties en banken hun sleutels in een hardware security module (HSM), en daarom is “waar staat de ondertekeningssleutel?” een van de eerste vragen die een securityboard stelt over een identityplatform.

Dit artikel legt uit wat sleutelbeheer in een HSM betekent voor een identity provider, wat het High assurance-profiel in HelixIAM doet, en hoe we het hebben getest met een Thales Luna Cloud HSM: wat we draaiden, wat we maten en hoe de opzet eruitziet. Het hoort bij soevereine identiteit en zelf-gehoste IAM: daar gaat het om de vraag wie de sleutels beheert, hier om hoe dat in de praktijk met een HSM werkt.

Waarom sleutelbeheer in een HSM telt voor overheid en gereguleerde organisaties

Een identity provider is een klein stuk software met een heel grote impact. Hij bepaalt wie binnenkomt in het zaaksysteem, de betaaladministratie en het burgerportaal. De ondertekeningssleutel is de basis van die beslissing. Wordt de sleutel gekopieerd, dan kan niemand een vervalst token nog onderscheiden van een echt token totdat de sleutel is geroteerd, en moet elke applicatie die erop vertrouwde opnieuw worden bekeken.

Organisaties die al een HSM draaien, hebben meestal drie dingen geregeld:

  1. De sleutel wordt gemaakt in hardware die zij beheren en kan niet worden geëxporteerd.
  2. Gebruik van de sleutel wordt gelogd en beperkt door het eigen beleid van het HSM, los van de applicatie.
  3. Het beheer volgt een bestaand proces: partities, Crypto Officer-rollen, back-ups en key ceremonies die hun securityteam al in handen heeft.

Een identity provider die zijn sleutels in zijn eigen database bewaart, vraagt deze organisaties om een uitzondering. Een identity provider die via hun HSM ondertekent, past in het proces dat ze al hebben.

Wat High assurance doet

In HelixIAM kies je per realm waar de private ondertekeningssleutels staan, in drie profielen voor sleutelbeheer:

ProfielWaar de private sleutels staan
StandardGegenereerd door de server en versleuteld opgeslagen in de database.
ProtectedAlleen ingepakt in de database opgeslagen, door een key-encryption key (KEK) die in je HSM of Vault staat.
High assuranceGegenereerd in je HSM of Vault en verlaat dat nooit. Het ondertekenen gebeurt door die backend.

Met High assurance heeft HelixIAM de private sleutel nooit in handen. Bij het uitgeven van een ID-token of access token stuurt HelixIAM de te ondertekenen gegevens via PKCS#11 naar het HSM en krijgt de handtekening terug. De publieke helft staat in de JWKS van de realm, zodat je applicaties tokens precies zo controleren als voorheen. Voor hen verandert er niets.

Het profiel stel je per realm in. Een realm voor een publieke dienst kan naar High assurance terwijl een ontwikkelrealm op Standard blijft. Elke realm heeft eigen ondertekeningssleutels met veilige rotatie, en je kunt een tenant een eigen HSM-partitie geven als je wilt dat de scheiding ook in de key store standhoudt.

Getest met Thales Luna Cloud HSM

We hebben HelixIAM getest met een Thales Luna Cloud HSM-dienst op Thales Data Protection on Demand , op een partitie met FIPS-beperkingen aan, met de standaard Luna-client en de bijbehorende PKCS#11-bibliotheek. We hebben het gedraaid op Kubernetes met de Helm-chart en met Docker Compose.

Wat we draaiden, met elke realm op High assurance:

  • Ondertekeningssleutels van de realm in het HSM voor ES256, RS256 en PS256, gegenereerd in de partitie en daar gebruikt voor elke handtekening.
  • Tokens gecontroleerd tegen de JWKS. Tokens van elke realm zijn gecontroleerd tegen de gepubliceerde JWKS van die realm, voor elk algoritme en voor een tweede realm met eigen sleutels.
  • Rotatie. Normale sleutelrotatie en noodrotatie zijn allebei geslaagd.
  • Herstart. Na een herstart maakte de server opnieuw verbinding met het HSM en bleef dezelfde sleutel ondertekenen.

Wat we maten

Een handtekening op de Luna Cloud HSM kostte ongeveer 25 ms bij p50 en tot ongeveer 45 ms bij p95, voor zowel ES256 als RS256.

Zie deze getallen als de vorm van de kosten, niet als productiecijfer. Ze zijn gemeten via het openbare internet naar een cloud-HSM, en het grootste deel van die tijd is de rondgang naar het HSM. De afstand tussen je HelixIAM-pods en je HSM bepaalt je eigen getallen. Elk token dat in een High assurance-realm wordt ondertekend betaalt deze kosten één keer. Daarom is de keuze per realm, en stem je het aantal HSM-sessies af op de gelijktijdigheid die je verwacht.

Eén ding om vooraf te weten

EdDSA is niet beschikbaar in FIPS-modus op een Luna-partitie. Gebruik ES256, RS256 of PS256 voor realms in High assurance op Luna; HelixIAM weigert EdDSA op die backend met een foutmelding.

De opzet, in het kort

De volledige handleiding staat op de documentatiesite: Thales Luna HSM in de HelixIAM-documentatie (in het Engels). In grote lijnen:

  1. In Data Protection on Demand maak je een Luna Cloud HSM-dienst aan en download je het clientpakket. Initialiseer de partitie en de Crypto Officer met de Luna-tools.
  2. Behandel het clientpakket als een geheim. De configuratie bevat de inloggegevens voor de dienst, dus mount het vanuit een Kubernetes Secret, niet vanuit een ConfigMap. De pincode van de Crypto Officer gaat erin als alleen-lezen Secret-bestand, nooit als omgevingsvariabele.
  3. Sta uitgaand verkeer toe op TCP 443 van de HelixIAM-pods naar de Data Protection on Demand-endpoints voor je regio.
  4. Voeg een PKCS#11-key store toe aan de HelixIAM-configuratie: het pad naar de Luna-bibliotheek, het partitielabel, het pinbestand en timeouts die passen bij een HSM via het netwerk.
  5. Controleer of de key store gezond is via de admin-API en zet daarna een realm op High assurance op die key store. HelixIAM genereert de sleutels van de realm in het HSM, en vanaf dat moment gebeurt elke handtekening voor die realm daar.

Wat bij jou blijft

Een HSM haalt de sleutel buiten bereik van de applicatie. Het werk eromheen neemt het niet weg:

  • Het HSM beheren. Partities, Crypto Officer-gegevens, back-ups en toegangsbeleid blijven bij je securityteam, zoals nu.
  • Het profiel kiezen. High assurance voegt voor elke handtekening een aanroep naar het HSM toe. Gebruik het voor de realms die het nodig hebben.
  • Je eigen assurance. Of een bepaald HSM en een bepaalde partitie aan je beleid voldoen, beslis jij. HelixIAM gebruikt het HSM; jouw proces bepaalt hoe.

Hoe begin je

  1. Een technische demo. We laten op een draaiend systeem zien hoe een realm van Standard naar High assurance gaat, met tokens die worden gecontroleerd tegen de JWKS.
  2. Jouw use case. We vertalen je tenants, je HSM-partities en je beleid voor sleutelbeheer naar een realm-indeling.
  3. Een betaalde pilot. Past het, dan volgt een pilot op je eigen infrastructuur tegen je eigen HSM, met vooraf afgesproken succescriteria.

HelixIAM is commerciële software van KubeDNA B.V., beschikbaar onder een commerciële licentie. HelixIAM zit in early access en we nemen nu lanceringspartners aan boord. Is de eerste vraag van je securityboard “waar staat de ondertekeningssleutel?”, dan kan het antwoord zijn: in je HSM, en daar gaat hij nooit weg.

Lees ook

Soevereine identiteit en zelfgehoste enterprise-IAM

Enterprise-IAM op infrastructuur en sleutels die jij beheert: OIDC, SAML, SSO en MFA, ondertekeningssleutels in je HSM of Vault, DigiD-, eHerkenning- en eIDAS-connectoren, en de EU Digitale Identiteitswallet in early access.

Alle artikelen

Bekijk het op een draaiend systeem.

In een technische demo laten onze engineers de flows uit dit artikel zien op een echte HelixIAM en vertalen ze naar jouw landschap.