Certificados de cliente dos métodos de autenticação
Utilize o recurso OIDC de chaves de cliente para gerir até dois certificados de cliente de um método de autenticação OpenID Connect existente. O certificado primário é utilizado para autenticação de cliente com private key JWT. Um certificado secundário permite preparar uma substituição antes de o tornar primário.
Siga as orientações de autenticação e acesso à Control API. O contrato Swagger define as operações, os campos dos pedidos e as respostas atuais.
Importar e substituir certificados
Importe um ficheiro PKCS#12 (.p12 ou .pfx) que contenha o certificado e a respetiva chave privada. Forneça a palavra-passe, se necessário. Ficheiros inválidos, palavras-passe incorretas e chaves privadas em falta são rejeitados antes de guardar.
Por predefinição, as importações destinam-se à posição primária. Defina isPrimary como false para adicionar ou substituir o certificado secundário; tem de existir previamente um certificado primário. A substituição de qualquer dos certificados preserva o outro.
A leitura ou importação através do recurso de chaves de cliente devolve informações públicas sobre ambos os certificados, incluindo os seus nomes externos. As chaves privadas não são devolvidas. Pode utilizar as funções auxiliares de leitura de certificados para examinar um ficheiro antes de o importar.
Efetuar a rotação de um certificado de cliente
- Importe o certificado de substituição como certificado secundário.
- Registe o respetivo certificado público no fornecedor de identidade externo.
- Selecione o nome externo da chave secundária como primária através da operação de atualização. O anterior certificado primário passa a secundário. Voltar a selecionar a chave primária atual mantém a ordem inalterada.
- Remova o antigo certificado secundário quando deixar de ser necessário.
Ao eliminar o certificado primário, o secundário restante passa a primário. Ao eliminar o único certificado, o método de autenticação fica sem certificado de cliente para private key JWT.