Brak zgodności z YubiKey

Brak zgodności z YubiKey wskazuje na aplikację niewspierającą standardu FIDO2/U2F wykorzystywanego przez ten sprzętowy klucz bezpieczeństwa — wymaga aktualizacji oprogramowania klienckiego.

Czym jest brak zgodności z YubiKey

Brak zgodności z YubiKey oznacza, że komputer, przeglądarka internetowa, aplikacja albo usługa nie potrafi prawidłowo wykorzystać sprzętowego klucza bezpieczeństwa do logowania lub potwierdzania tożsamości. YubiKey może działać między innymi jako urządzenie wykorzystujące standardy FIDO2, WebAuthn lub starszy U2F, a także jako nośnik jednorazowych kodów, certyfikatów albo innych mechanizmów uwierzytelniania. Samo podłączenie klucza do portu USB nie gwarantuje więc poprawnego działania. Wymagana jest zgodność całego łańcucha: systemu operacyjnego, sterownika, przeglądarki, aplikacji, ustawień konta oraz używanego modelu klucza.

Problem może objawiać się brakiem reakcji po włożeniu YubiKey, niewidocznym przyciskiem logowania za pomocą klucza, komunikatem o nieobsługiwanym urządzeniu albo zatrzymaniem procesu podczas dotknięcia przycisku na kluczu. W niektórych przypadkach urządzenie jest wykrywane przez system, lecz dana usługa nie rozpoznaje go jako dozwolonego sposobu uwierzytelniania. Nie musi to oznaczać uszkodzenia sprzętu. Częstą przyczyną jest nieaktualna aplikacja kliencka, nieobsługiwana przeglądarka lub wyłączona funkcja bezpieczeństwa.

Kontekst techniczny i porównanie sposobów uwierzytelniania - Brak zgodności z YubiKey

YubiKey różni się od zwykłego hasła tym, że potwierdzenie logowania wymaga fizycznego dostępu do zarejestrowanego urządzenia. Przy rozwiązaniach opartych na FIDO2 i WebAuthn klucz współpracuje z usługą internetową oraz przeglądarką, tworząc podpis powiązany z konkretną domeną. Dzięki temu przechwycenie samego hasła nie wystarcza do odtworzenia pełnego procesu logowania. U2F jest starszym mechanizmem o podobnym przeznaczeniu, spotykanym przede wszystkim w starszych wdrożeniach.

W porównaniu z kodem przesyłanym wiadomością tekstową klucz sprzętowy nie jest zależny od zasięgu sieci komórkowej ani od dostępności skrzynki odbiorczej. Z drugiej strony musi być obsługiwany przez używany program i prawidłowo przypisany do konta. Nowszy model YubiKey może oferować funkcje, których nie rozpoznaje starsza aplikacja, natomiast starszy klucz nie zawsze obsłuży wymagany przez usługę sposób uwierzytelniania. Znaczenie może mieć także typ złącza, tryb komunikacji oraz to, czy klucz jest podłączony bezpośrednio, czy przez przejściówkę lub koncentrator.

Warto rozdzielić trzy sytuacje: brak wykrycia urządzenia przez system, wykrycie urządzenia bez obsługi w konkretnej aplikacji oraz odrzucenie klucza przez usługę po jego rozpoznaniu. Każda z nich wymaga innej diagnostyki. W pierwszym przypadku sprawdzane są porty, sterowniki i komunikacja USB. W drugim analizowana jest wersja programu, przeglądarka i dostępne mechanizmy logowania. W trzecim weryfikuje się konfigurację konta, zarejestrowane dane uwierzytelniające i reguły bezpieczeństwa obowiązujące w danej usłudze.

Typowe problemy i błędy powodujące niezgodność

Jednym z częstszych błędów jest korzystanie z programu, który nie obsługuje FIDO2, WebAuthn albo U2F w wymaganym zakresie. Podobny skutek może powodować przestarzała przeglądarka, wyłączona obsługa kluczy bezpieczeństwa, ograniczenia trybu prywatnego lub rozszerzenie blokujące element odpowiedzialny za logowanie. W środowisku, w którym używa się kilku przeglądarek, problem może występować tylko w jednej z nich, co utrudnia rozpoznanie źródła usterki.

Znaczenie mają również ustawienia systemu. Nieprawidłowo działający sterownik USB, błędy usług systemowych, ograniczenia uprawnień albo uszkodzenia w konfiguracji urządzeń mogą sprawić, że klucz nie zostanie przekazany aplikacji. Czasami YubiKey jest widoczny jako urządzenie USB, lecz nie reaguje na dotknięcie, ponieważ aplikacja oczekuje innego interfejsu. Problem może też pojawić się po aktualizacji systemu, przeglądarki lub programu do zarządzania kontem.

Nie należy pomijać kwestii konfiguracji po stronie konta. Klucz mógł zostać zarejestrowany wcześniej w innym profilu użytkownika, usunięty z listy dozwolonych metod albo przypisany do usługi, która wymaga określonego wariantu uwierzytelniania. Odrzucenie klucza może także wynikać z błędnego adresu strony logowania, niezgodności domeny lub próby użycia urządzenia w aplikacji, która obsługuje wyłącznie kody jednorazowe. Zanim zostanie uznany za uszkodzony, powinno się sprawdzić go w innym zgodnym miejscu oraz zweryfikować, czy nie jest aktywna blokada konta.

Ryzykowne jest pochopne resetowanie klucza lub usuwanie zapisanych metod logowania. Taka operacja może pozbawić dostępu do konta, jeżeli nie przygotowano wcześniej alternatywnej metody uwierzytelniania. Przed zmianami warto zachować kody odzyskiwania, sprawdzić dostęp do konta administracyjnego i ustalić, czy problem dotyczy jednego użytkownika, jednego komputera, czy wszystkich urządzeń.

Kiedy warto poprosić o ocenę stanu sprzętu - Brak zgodności z YubiKey

Zgłoszenie do serwisu jest uzasadnione, gdy YubiKey przestał być wykrywany po zmianie systemu, aktualizacji programu lub podłączeniu do innego portu, a podstawowe sprawdzenie połączenia nie przyniosło rezultatu. Wsparcie może być potrzebne także wtedy, gdy klucz działa w jednej usłudze, lecz nie działa w konkretnej aplikacji, pojawiają się powtarzające komunikaty o braku zgodności albo nie wiadomo, czy źródłem problemu jest sprzęt, system czy konfiguracja konta.

Podczas diagnostyki analizuje się wykrywanie urządzenia, działanie portów USB, stan sterowników, wersję systemu, zgodność przeglądarki i aplikacji oraz ustawienia mechanizmu logowania. Sprawdzane jest również, czy problem można odtworzyć na innym koncie lub w innym zgodnym środowisku. Takie rozdzielenie przyczyn pozwala uniknąć niepotrzebnej wymiany klucza i ogranicza ryzyko utraty dostępu do ważnych kont.

W Warszawie pomoc w takich przypadkach może zostać zgłoszona do serwisu „Warszawskie Pogotowie Komputerowe 24/7”, gdzie przy przyjmowaniu urządzenia można opisać model YubiKey, używany system, nazwę aplikacji oraz moment pojawienia się błędu. Przy problemach dotyczących laptopa dostępna jest darmowa diagnoza LAPTOPA, co pozwala najpierw ustalić, czy niezgodność wynika z konfiguracji komputera, czy z ograniczeń konkretnej usługi.

Do zgłoszenia warto dołączyć treść komunikatu błędu, informację o tym, czy klucz jest widoczny w systemie, oraz opis ostatnich zmian wykonanych przed wystąpieniem problemu. Nie powinno się przekazywać osobom postronnym haseł, kodów odzyskiwania ani danych potrzebnych do logowania. Sama diagnostyka powinna koncentrować się na działaniu urządzenia i oprogramowania, a czynności na koncie powinny być wykonywane wyłącznie przez uprawnionego użytkownika.