Certificados de cliente de métodos de autenticación
Utiliza el recurso OIDC de claves de cliente para gestionar hasta dos certificados de cliente de un método de autenticación OpenID Connect existente. El certificado primario se utiliza para la autenticación de cliente con private key JWT. Un certificado secundario permite preparar una sustitución antes de convertirlo en primario.
Sigue las indicaciones de autenticación y acceso a Control API. El contrato de Swagger define las operaciones, los campos de solicitud y las respuestas actuales.
Importar y sustituir certificados
Importa un archivo PKCS#12 (.p12 o .pfx) que contenga el certificado y su clave privada. Proporciona su contraseña si es necesario. Los archivos no válidos, las contraseñas incorrectas y las claves privadas ausentes se rechazan antes de guardar.
Las importaciones se dirigen de forma predeterminada a la posición primaria. Establece isPrimary en false para añadir o sustituir el certificado secundario; ya debe existir un certificado primario. Al sustituir cualquiera de los certificados se conserva el otro.
La lectura o importación mediante el recurso de claves de cliente devuelve información pública de ambos certificados, incluidos sus nombres externos. No se devuelven claves privadas. Puedes utilizar las funciones auxiliares de lectura de certificados para examinar un archivo antes de importarlo.
Rotar un certificado de cliente
- Importa el certificado de sustitución como certificado secundario.
- Registra su certificado público en el proveedor de identidad externo.
- Selecciona el nombre externo de la clave secundaria como primaria mediante la operación de actualización. El anterior certificado primario pasa a ser secundario. Volver a seleccionar la clave primaria actual no cambia el orden.
- Elimina el antiguo certificado secundario cuando ya no sea necesario.
Al eliminar el certificado primario, el secundario restante pasa a ser primario. Al eliminar el único certificado, el método de autenticación queda sin certificado de cliente para private key JWT.