Klientcertifikat för autentiseringsmetoder

Använd OIDC-resursen för klientnycklar för att hantera upp till två klientcertifikat för en befintlig OpenID Connect autentiseringsmetod. Det primära certifikatet används för klientautentisering med private key JWT. Ett sekundärt certifikat låter dig förbereda ett byte innan det görs primärt.

Följ vägledningen om autentisering och åtkomst till Control API. Swagger-kontraktet definierar aktuella operationer, begäransfält och svar.

Importera och ersätt certifikat

Importera en PKCS#12-fil (.p12 eller .pfx) som innehåller certifikatet och dess privata nyckel. Ange lösenordet om det behövs. Ogiltiga filer, felaktiga lösenord och saknade privata nycklar avvisas innan de sparas.

Import riktas som standard mot den primära positionen. Sätt isPrimary till false för att lägga till eller ersätta det sekundära certifikatet; ett primärt certifikat måste redan finnas. Om ett certifikat ersätts bevaras det andra.

Läsning eller import via resursen för klientnycklar returnerar publika uppgifter om båda certifikaten, inklusive deras externa namn. Privata nycklar returneras inte. Du kan använda hjälpfunktionerna för certifikatläsning för att granska en fil före import.

Rotera ett klientcertifikat

1. Importera ersättningscertifikatet som sekundärt certifikat.
2. Registrera dess publika certifikat hos den externa identitetsleverantören.
3. Välj den sekundära nyckelns externa namn som primär med uppdateringsoperationen. Det tidigare primära certifikatet blir sekundärt. Om den aktuella primära nyckeln väljs igen förblir ordningen oförändrad.
4. Ta bort det gamla sekundära certifikatet när det inte längre behövs.

Om det primära certifikatet tas bort blir det återstående sekundära certifikatet primärt. Om det enda certifikatet tas bort lämnas autentiseringsmetoden utan klientcertifikat för private key JWT.