Clientcertificaten voor authenticatiemethoden
Gebruik de OIDC-resource voor clientsleutels om maximaal twee clientcertificaten te beheren voor een bestaande OpenID Connect authenticatiemethode. Het primaire certificaat wordt gebruikt voor clientauthenticatie met private key JWT. Met een secundair certificaat kunt u een vervanging voorbereiden voordat u dit primair maakt.
Volg de richtlijnen voor authenticatie en toegang tot de Control API. Het Swagger-contract definieert de huidige bewerkingen, aanvraagvelden en antwoorden.
Certificaten importeren en vervangen
Importeer een PKCS#12-bestand (.p12 of .pfx) met het certificaat en de privésleutel. Geef indien nodig het wachtwoord op. Ongeldige bestanden, onjuiste wachtwoorden en ontbrekende privésleutels worden geweigerd voordat ze worden opgeslagen.
Imports richten zich standaard op de primaire positie. Stel isPrimary in op false om het secundaire certificaat toe te voegen of te vervangen; er moet al een primair certificaat bestaan. Bij vervanging van een certificaat blijft het andere behouden.
Lezen of importeren via de resource voor clientsleutels retourneert openbare informatie over beide certificaten, inclusief hun externe namen. Privésleutels worden niet geretourneerd. U kunt de hulpfuncties voor het lezen van certificaten gebruiken om een bestand vóór het importeren te bekijken.
Een clientcertificaat roteren
- Importeer het vervangende certificaat als secundair certificaat.
- Registreer het openbare certificaat bij de externe identiteitsprovider.
- Selecteer met de updatebewerking de externe naam van de secundaire sleutel als primair. Het vorige primaire certificaat wordt secundair. Als u de huidige primaire sleutel opnieuw selecteert, blijft de volgorde ongewijzigd.
- Verwijder het oude secundaire certificaat wanneer het niet meer nodig is.
Als het primaire certificaat wordt verwijderd, wordt het resterende secundaire certificaat primair. Als het enige certificaat wordt verwijderd, heeft de authenticatiemethode geen clientcertificaat meer voor private key JWT.