Certificats clients des méthodes d’authentification
Utilisez la ressource OIDC des clés clientes pour gérer jusqu’à deux certificats clients d’une méthode d’authentification OpenID Connect existante. Le certificat primaire sert à l’authentification client avec private key JWT. Un certificat secondaire permet de préparer un remplacement avant de le rendre primaire.
Suivez les instructions d’authentification et d’accès à la Control API. Le contrat Swagger définit les opérations, les champs de requête et les réponses actuels.
Importer et remplacer des certificats
Importez un fichier PKCS#12 (.p12 ou .pfx) contenant le certificat et sa clé privée. Fournissez son mot de passe si nécessaire. Les fichiers invalides, les mots de passe incorrects et les clés privées manquantes sont rejetés avant l’enregistrement.
Les importations ciblent par défaut la position primaire. Définissez isPrimary sur false pour ajouter ou remplacer le certificat secondaire ; un certificat primaire doit déjà exister. Le remplacement de l’un des certificats préserve l’autre.
La lecture ou l’importation via la ressource des clés clientes renvoie les informations publiques des deux certificats, y compris leurs noms externes. Les clés privées ne sont pas renvoyées. Vous pouvez utiliser les fonctions de lecture des certificats pour examiner un fichier avant de l’importer.
Renouveler un certificat client
- Importez le certificat de remplacement comme certificat secondaire.
- Enregistrez son certificat public auprès du fournisseur d’identité externe.
- Sélectionnez le nom externe de la clé secondaire comme clé primaire à l’aide de l’opération de mise à jour. L’ancien certificat primaire devient secondaire. Sélectionner à nouveau la clé primaire actuelle ne modifie pas l’ordre.
- Supprimez l’ancien certificat secondaire lorsqu’il n’est plus nécessaire.
La suppression du certificat primaire rend primaire le certificat secondaire restant. La suppression du seul certificat laisse la méthode d’authentification sans certificat client pour private key JWT.