Certificati client dei metodi di autenticazione
Usa la risorsa OIDC delle chiavi client per gestire fino a due certificati client per un metodo di autenticazione OpenID Connect esistente. Il certificato primario viene utilizzato per l’autenticazione client con private key JWT. Un certificato secondario consente di preparare una sostituzione prima di renderlo primario.
Segui le indicazioni su autenticazione e accesso alla Control API. Il contratto Swagger definisce le operazioni, i campi delle richieste e le risposte attuali.
Importare e sostituire certificati
Importa un file PKCS#12 (.p12 o .pfx) contenente il certificato e la sua chiave privata. Fornisci la password se necessaria. File non validi, password errate e chiavi private mancanti vengono rifiutati prima del salvataggio.
Per impostazione predefinita, le importazioni riguardano la posizione primaria. Imposta isPrimary su false per aggiungere o sostituire il certificato secondario; deve già esistere un certificato primario. La sostituzione di un certificato conserva l’altro.
La lettura o l’importazione tramite la risorsa delle chiavi client restituisce informazioni pubbliche su entrambi i certificati, inclusi i nomi esterni. Le chiavi private non vengono restituite. Puoi usare le funzioni di lettura dei certificati per esaminare un file prima dell’importazione.
Ruotare un certificato client
- Importa il certificato sostitutivo come certificato secondario.
- Registra il suo certificato pubblico presso il provider di identità esterno.
- Seleziona il nome esterno della chiave secondaria come primaria tramite l’operazione di aggiornamento. Il precedente certificato primario diventa secondario. Selezionando nuovamente la chiave primaria attuale, l’ordine rimane invariato.
- Rimuovi il vecchio certificato secondario quando non è più necessario.
Eliminando il certificato primario, il secondario rimanente diventa primario. Eliminando l’unico certificato, il metodo di autenticazione rimane senza certificato client per private key JWT.