Certyfikaty klienta metod uwierzytelniania

Użyj zasobu kluczy klienta OIDC, aby zarządzać maksymalnie dwoma certyfikatami klienta dla istniejącej metody uwierzytelniania OpenID Connect. Certyfikat podstawowy służy do uwierzytelniania klienta za pomocą private key JWT. Certyfikat dodatkowy pozwala przygotować wymianę, zanim zostanie ustawiony jako podstawowy.

Postępuj zgodnie ze wskazówkami dotyczącymi uwierzytelniania i dostępu do Control API. Kontrakt Swagger określa bieżące operacje, pola żądań i odpowiedzi.

Importowanie i zastępowanie certyfikatów

Zaimportuj plik PKCS#12 (.p12 lub .pfx) zawierający certyfikat i jego klucz prywatny. W razie potrzeby podaj hasło. Nieprawidłowe pliki, błędne hasła i brak kluczy prywatnych są odrzucane przed zapisem.

Import domyślnie dotyczy pozycji podstawowej. Ustaw isPrimary na false, aby dodać lub zastąpić certyfikat dodatkowy; certyfikat podstawowy musi już istnieć. Zastąpienie jednego certyfikatu zachowuje drugi.

Odczyt lub import za pośrednictwem zasobu kluczy klienta zwraca publiczne informacje o obu certyfikatach, w tym ich nazwy zewnętrzne. Klucze prywatne nie są zwracane. Możesz użyć funkcji pomocniczych odczytu certyfikatów, aby sprawdzić plik przed importem.

Rotacja certyfikatu klienta

1. Zaimportuj nowy certyfikat jako certyfikat dodatkowy.
2. Zarejestruj jego certyfikat publiczny u zewnętrznego dostawcy tożsamości.
3. Wybierz nazwę zewnętrzną klucza dodatkowego jako podstawowego za pomocą operacji aktualizacji. Dotychczasowy certyfikat podstawowy stanie się dodatkowym. Ponowny wybór bieżącego klucza podstawowego nie zmienia kolejności.
4. Usuń stary certyfikat dodatkowy, gdy nie jest już potrzebny.

Usunięcie certyfikatu podstawowego sprawia, że pozostały certyfikat dodatkowy staje się podstawowym. Usunięcie jedynego certyfikatu pozostawia metodę uwierzytelniania bez certyfikatu klienta dla private key JWT.