Klientcertifikater til autentificeringsmetoder

Brug OIDC-ressourcen til klientnøgler til at administrere op til to klientcertifikater for en eksisterende OpenID Connect autentificeringsmetode. Det primære certifikat bruges til klientautentificering med private key JWT. Et sekundært certifikat giver mulighed for at forberede en udskiftning, før det gøres primært.

Følg vejledningen om autentificering og adgang til Control API. Swagger-kontrakten definerer de aktuelle operationer, anmodningsfelter og svar.

Importér og udskift certifikater

Importér en PKCS#12-fil (.p12 eller .pfx), der indeholder certifikatet og dets private nøgle. Angiv adgangskoden, hvis det er nødvendigt. Ugyldige filer, forkerte adgangskoder og manglende private nøgler afvises før lagring.

Import målrettes som standard den primære position. Sæt isPrimary til false for at tilføje eller udskifte det sekundære certifikat; der skal allerede være et primært certifikat. Udskiftning af det ene certifikat bevarer det andet.

Læsning eller import gennem ressourcen til klientnøgler returnerer offentlige oplysninger om begge certifikater, inklusive deres eksterne navne. Private nøgler returneres ikke. Du kan bruge hjælpefunktionerne til certifikatlæsning til at undersøge en fil før import.

Rotér et klientcertifikat

1. Importér erstatningscertifikatet som det sekundære certifikat.
2. Registrér dets offentlige certifikat hos den eksterne identitetsudbyder.
3. Vælg den sekundære nøgles eksterne navn som primær med opdateringsoperationen. Det tidligere primære certifikat bliver sekundært. Hvis den aktuelle primære nøgle vælges igen, forbliver rækkefølgen uændret.
4. Fjern det gamle sekundære certifikat, når det ikke længere er nødvendigt.

Hvis det primære certifikat slettes, bliver det tilbageværende sekundære certifikat primært. Hvis det eneste certifikat slettes, efterlades autentificeringsmetoden uden et klientcertifikat til private key JWT.