Klientsertifikater for autentiseringsmetoder

Bruk OIDC-ressursen for klientnøkler til å administrere opptil to klientsertifikater for en eksisterende OpenID Connect autentiseringsmetode. Det primære sertifikatet brukes til klientautentisering med private key JWT. Et sekundært sertifikat lar deg forberede en utskifting før det gjøres primært.

Følg veiledningen om autentisering og tilgang til Control API. Swagger-kontrakten definerer gjeldende operasjoner, forespørselsfelter og svar.

Importer og erstatt sertifikater

Importer en PKCS#12-fil (.p12 eller .pfx) som inneholder sertifikatet og den private nøkkelen. Oppgi passordet hvis det kreves. Ugyldige filer, feil passord og manglende private nøkler avvises før lagring.

Import gjelder som standard den primære posisjonen. Sett isPrimary til false for å legge til eller erstatte det sekundære sertifikatet; et primært sertifikat må allerede finnes. Hvis ett sertifikat erstattes, beholdes det andre.

Lesing eller import via ressursen for klientnøkler returnerer offentlig informasjon om begge sertifikatene, inkludert deres eksterne navn. Private nøkler returneres ikke. Du kan bruke hjelpefunksjonene for sertifikatlesing til å undersøke en fil før import.

Roter et klientsertifikat

1. Importer erstatningssertifikatet som det sekundære sertifikatet.
2. Registrer det offentlige sertifikatet hos den eksterne identitetsleverandøren.
3. Velg den sekundære nøkkelens eksterne navn som primær med oppdateringsoperasjonen. Det tidligere primære sertifikatet blir sekundært. Hvis den gjeldende primære nøkkelen velges igjen, forblir rekkefølgen uendret.
4. Fjern det gamle sekundære sertifikatet når det ikke lenger trengs.

Hvis det primære sertifikatet slettes, blir det gjenværende sekundære sertifikatet primært. Hvis det eneste sertifikatet slettes, står autentiseringsmetoden uten klientsertifikat for private key JWT.