> For the complete documentation index, see [llms.txt](https://docs.keeper.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.keeper.io/user-guides/pl/troubleshooting/hardware-security-keys-on-mobile.md).

# Sprzętowe klucze bezpieczeństwa na urządzeniach mobilnych

Obsługa kluczy bezpieczeństwa FIDO2 w aplikacji Keeper na urządzeniach mobilnych.

Ten przewodnik zawiera wszystko, co musisz wiedzieć o używaniu sprzętowego klucza bezpieczeństwa z aplikacją Keeper w systemach iOS i Android: instrukcję konfiguracji, zachowanie kodu PIN, zgodność urządzeń i sposoby rozwiązywania typowych problemów.

{% hint style="warning" %}
Przed skonfigurowaniem sprzętowego klucza bezpieczeństwa zainstaluj najnowszą wersję aplikacji Keeper. Starsze wersje mogą nie obsługiwać wszystkich rodzajów kluczy ani wersji oprogramowania sprzętowego.
{% endhint %}

### Obsługiwane klucze sprzętowe

#### iOS

W systemie iOS aplikacja Keeper współpracuje z każdym certyfikowanym kluczem bezpieczeństwa FIDO®. Pełną listę certyfikowanych kluczy znajdziesz w witrynie [FIDO® Certified Showcase](https://fidoalliance.org/fido-certified-showcase/) (po angielsku).

Zanim zaczniesz, warto wiedzieć o kilku sprawach:

* **Klucze NFC** są obsługiwane w większości modeli iPhone. Tablety iPad nie obsługują sprzętowych kluczy NFC. Na iPadzie działają tylko klucze podłączane bezpośrednio (przez złącze Lightning lub USB-C).
* **Klucze NFC nie działają w rozszerzeniu KeeperFill**, czyli w funkcji autouzupełniania w systemie iOS. Obejście problemu opisujemy w sekcji [Klucze NFC i KeeperFill w systemie iOS](#nfc-keys-and-keeperfill-on-ios).
* Klucze USB-C wymagają aplikacji Keeper **w wersji 16.12.0 lub nowszej**.

**Zgodność z wersjami systemu iOS**

| **Wersja systemu iOS** | **Aplikacja Keeper (główna)** | **Autouzupełnianie** |
| :--------------------: | ----------------------------- | -------------------- |
| **iOS 16 lub starsza** | ✅ Obsługiwana                 | ❌ Nieobsługiwane     |
|       **iOS 17**       | ✅ Obsługiwana                 | ✅ Obsługiwane        |
|       **iOS 18**       | ✅ Obsługiwana                 | ✅ Obsługiwane        |
|   **iOS 26 i nowsze**  | ✅ Obsługiwana                 | ✅ Obsługiwane        |

#### Android

Aplikacja Keeper obsługuje w systemie Android każdy sprzętowy klucz z certyfikatem FIDO2. Zgodność może zależeć od producenta klucza i biblioteki FIDO firmy Google. Pełną listę certyfikowanych kluczy znajdziesz w witrynie [FIDO® Certified Showcase](https://fidoalliance.org/fido-certified-showcase/) (po angielsku).

Zanim zaczniesz, warto wiedzieć o kilku sprawach:

* Większość kluczy FIDO2 z obsługą NFC działa w systemie Android przez NFC.
* Jeśli wystąpią problemy z określonym kluczem, zarejestruj go przez USB zamiast NFC albo dodaj go w sejfie internetowym Keeper, a zostanie zsynchronizowany z urządzeniem mobilnym.

***

### Konfigurowanie klucza bezpieczeństwa

Przed dodaniem klucza bezpieczeństwa w systemie iOS lub Android na koncie musi być już aktywna co najmniej jedna inna metoda uwierzytelniania dwuskładnikowego. Posłuży jako kopia zapasowa na wypadek, gdyby klucz był niedostępny.

{% hint style="info" %}
Na koncie można zarejestrować maksymalnie 5 kluczy bezpieczeństwa. Do logowania wystarczy dowolny z nich.
{% endhint %}

#### W systemie iOS

1. Otwórz aplikację Keeper i przejdź do **Ustawienia > Uwierzytelnianie dwuskładnikowe**.
2. Dotknij **Dodaj** obok pozycji „Klucze bezpieczeństwa”, a następnie dotknij **+ dodaj klucz**.
3. Nadaj kluczowi nazwę i dotknij **Zarejestruj się**.
4. Postępuj zgodnie z monitem na ekranie: podłącz klucz albo przyłóż go do tyłu telefonu iPhone.
5. Jeśli klucz ma kod PIN, zostanie wyświetlony monit o jego wpisanie.
6. Po zakończeniu rejestracji dotknij **OK** na ekranie potwierdzenia.

#### W systemie Android

1. Otwórz aplikację Keeper i przejdź do **Ustawienia > Uwierzytelnianie dwuskładnikowe**.
2. Dotknij **Dodaj** obok pozycji „Klucze bezpieczeństwa”, a następnie dotknij **+ dodaj klucz**.
3. Wpisz nazwę klucza i dotknij **Zarejestruj się**.
4. Z listy opcji wybierz **NFC Security key** lub **USB Security key**.
5. Przyłóż klucz płasko do tylnej części urządzenia (w przypadku NFC) albo włóż go do portu USB-C.
6. Przytrzymaj klucz w tym miejscu, aż aplikacja potwierdzi rejestrację na ekranie.

{% hint style="warning" %}
**Masz klucz YubiKey z oprogramowaniem sprzętowym w wersji 5.7 lub nowszej?** Te klucze są fabrycznie dostarczane z wyłączoną funkcją NFC. Aby NFC zaczęło działać, podłącz klucz do portu USB na około 3 sekundy. Wystarczy zrobić to raz. Szczegóły znajdziesz w sekcji [Znane problemy](#known-issues).
{% endhint %}

***

### Częstotliwość logowania

Jak często aplikacja prosi o użycie klucza bezpieczeństwa, zależy od ustawienia częstotliwości uwierzytelniania dwuskładnikowego.

* **Przy każdym logowaniu:** klucz jest wymagany za każdym razem, gdy otwierasz aplikację Keeper i logujesz się.
* **Co 12 godzin:** klucz jest wymagany raz na 12 godzin.
* **Co 24 godz.:** klucz jest wymagany raz na 24 godziny.
* **Co 30 dni:** klucz jest wymagany raz na 30 dni.
* **Nie pytaj ponownie na tym urządzeniu:** klucz jest wymagany tylko raz na każdym urządzeniu.

To ustawienie można zmienić w dowolnym momencie w obszarze **Ustawienia > Uwierzytelnianie dwuskładnikowe > Częstotliwość 2FA**.

{% hint style="info" %}
Gdy na koncie jest włączone uwierzytelnianie dwuskładnikowe, dostęp do sejfu w trybie offline jest domyślnie wyłączony. Jeśli dostęp offline był włączony i dodasz klucz bezpieczeństwa lub inną metodę 2FA, zobaczysz komunikat, że podczas logowania w trybie offline uwierzytelnianie dwuskładnikowe zostanie pominięte.
{% endhint %}

***

### Kody PIN i sprzętowe klucze bezpieczeństwa

Kod PIN klucza sprzętowego można ustawić za pomocą oprogramowania producenta, na przykład aplikacji [Yubico Authenticator](https://www.yubico.com/products/yubico-authenticator/) (po angielsku). PIN jest opcjonalny, ale dodatkowo chroni klucz na wypadek jego zgubienia lub kradzieży.

**W systemie iOS:** jeśli klucz ma ustawiony PIN, system iOS prosi o jego wpisanie przy każdym użyciu klucza. Monitu o PIN nie można pominąć, ponieważ wymusza to sam system iOS.

**W systemie Android:** działanie kodu PIN może zależeć od producenta urządzenia. Jeśli podczas konfiguracji lub logowania występują problemy, najpierw spróbuj zarejestrować klucz bez PIN-u, aby wykluczyć problemy ze zgodnością z nim związane.

{% hint style="warning" %}
Jeśli sześć razy z rzędu wpiszesz nieprawidłowy PIN, klucz zostanie zablokowany. Aby znowu móc go używać, musisz go zresetować za pomocą oprogramowania producenta (na przykład aplikacji Yubico Authenticator).
{% endhint %}

***

### Tablety iPad i sprzętowe klucze bezpieczeństwa

Sprzętowe klucze bezpieczeństwa działają na iPadzie, ale z jednym istotnym ograniczeniem: żaden model iPada nie obsługuje NFC. Działają tylko klucze podłączane fizycznie do urządzenia:

* klucze ze złączem Lightning w starszych modelach iPada,
* klucze USB-C w nowszych modelach iPada (wymagają aplikacji Keeper w wersji **16.12.0** lub nowszej).

Klucze obsługujące zarówno NFC, jak i bezpośrednie podłączenie (na przykład YubiKey 5C NFC) są zgodne z iPadem tylko przez bezpośrednie podłączenie.

***

### Znane problemy <a href="#known-issues" id="known-issues"></a>

#### NFC nie działa w nowych kluczach YubiKey (oprogramowanie sprzętowe 5.7 lub nowsze)

**Dotyczy:** kluczy YubiKey z oprogramowaniem sprzętowym w wersji 5.7.0 lub nowszej, w systemach iOS i Android

Od wersji 5.7 oprogramowania sprzętowego wszystkie nowe klucze YubiKey z obsługą NFC są dostarczane z celowo wyłączoną funkcją NFC. To mechanizm bezpieczeństwa firmy Yubico o nazwie Restricted NFC, który zapobiega manipulacjom, gdy klucz jest jeszcze w opakowaniu.

Przy pierwszym przyłożeniu takiego klucza do telefonu w przeglądarce może otworzyć się strona konfiguracji Yubico (yubico.com/getting-started) zamiast ukończenia rejestracji. Oznacza to, że NFC nie zostało jeszcze aktywowane.

**Aby aktywować NFC w kluczu YubiKey z oprogramowaniem 5.7 lub nowszym:**

Podłącz klucz do dowolnego portu USB (w komputerze, ładowarce lub koncentratorze USB) i pozostaw go na około 3 sekundy. Wystarczy zrobić to raz, a od tej pory NFC będzie działać normalnie.

{% hint style="info" %}
Nie wiesz, jaka wersja oprogramowania sprzętowego jest w kluczu YubiKey? Pobierz aplikację [Yubico Authenticator](https://www.yubico.com/products/yubico-authenticator/) (po angielsku), podłącz klucz, a wersja pojawi się na ekranie głównym.
{% endhint %}

***

#### Rejestracja klucza YubiKey przez NFC nie powiodła się w systemie Android (kod błędu 28)

**Dotyczy:** systemu Android i wyłącznie kluczy YubiKey z oprogramowaniem sprzętowym 5.7.1

Niektórzy użytkownicy klucza YubiKey z oprogramowaniem sprzętowym w wersji 5.7.1 widzą następujący błąd podczas rejestracji klucza przez NFC w systemie Android:

> „Coś poszło nie tak przy użyciu klucza bezpieczeństwa, spróbuj ponownie. (Kod błędu 28)”

Błąd pojawia się zwykle na samym końcu rejestracji, czasem zaraz po ekranie informującym o jej powodzeniu. Klucze z oprogramowaniem 5.4.3 i 5.7.4 rejestrują się bez problemu, więc problem dotyczy najprawdopodobniej wyłącznie wersji 5.7.1.

**Sposoby obejścia problemu:**

1. **Zarejestruj klucz przez USB.** Podłącz klucz YubiKey do urządzenia z systemem Android przez USB-C i podczas rejestracji wybierz opcję **USB Security key**. Po zarejestrowaniu klucza przez USB można go zwykle używać do logowania także przez NFC.
2. **Zarejestruj klucz w sejfie internetowym.** Zaloguj się do sejfu w przeglądarce na komputerze (Chrome lub Edge) i dodaj klucz stamtąd. Po dodaniu do konta klucz będzie dostępny na urządzeniu mobilnym.
3. **Najpierw zarejestruj inny klucz.** Jeśli masz drugi klucz YubiKey z oprogramowaniem 5.4.3, 5.7.4 lub nowszym, zarejestruj go najpierw przez NFC, a potem spróbuj ponownie zarejestrować klucz z wersją 5.7.1. U niektórych użytkowników to rozwiązało problem.

***

#### Klucze NFC i KeeperFill w systemie iOS <a href="#nfc-keys-and-keeperfill-on-ios" id="nfc-keys-and-keeperfill-on-ios"></a>

**Dotyczy:** systemu iOS i sprzętowych kluczy NFC

Sprzętowe klucze NFC nie działają z rozszerzeniem autouzupełniania KeeperFill w systemie iOS. To ograniczenie na poziomie systemu: iOS nie pozwala rozszerzeniom innych firm inicjować interakcji z kluczami NFC.

**Obejście:** włącz opcję **Nie wylogowuj** w ustawieniach aplikacji Keeper. Dzięki temu sesja pozostaje aktywna, a KeeperFill może wypełniać dane logowania bez każdorazowego uwierzytelniania kluczem sprzętowym.

***

#### Autouzupełnianie długim dotknięciem i sprzętowe klucze bezpieczeństwa w systemie iOS <a href="#long-tap-autofill-and-hardware-security-keys-on-ios" id="long-tap-autofill-and-hardware-security-keys-on-ios"></a>

**Dotyczy:** systemu iOS 18 i nowszych

W systemie iOS 18 pojawiła się funkcja autouzupełniania długim dotknięciem, która umożliwia wypełnianie zapisanych danych logowania w aplikacjach i witrynach bezpośrednio z menedżera haseł. Gdy konto Keeper jest chronione sprzętowym kluczem bezpieczeństwa, ten proces nie zakończy się prawidłowo. System musi współdziałać z kluczem sprzętowym, a to nie jest zgodne z działaniem autouzupełniania długim dotknięciem.

**Obejście:**

1. Włącz opcję **Nie wylogowuj** w ustawieniach aplikacji Keeper.
2. Najpierw zaloguj się do głównej aplikacji Keeper na urządzeniu.
3. Potem możesz normalnie korzystać z autouzupełniania długim dotknięciem.

***

#### Pętla kodu PIN klucza YubiKey FIDO w systemie iOS <a href="#yubikey-fido-pin-loop-on-ios" id="yubikey-fido-pin-loop-on-ios"></a>

**Dotyczy:** systemów iOS 18.1 i iPadOS 18.1, problem rozwiązano w systemie iOS 18.2

Użytkownicy systemu iOS lub iPadOS 18.1 z kluczem YubiKey z oprogramowaniem sprzętowym 5.7 mogli utknąć w pętli kodu PIN. Klucz przyjmował PIN, a zaraz potem znowu o niego prosił, co uniemożliwiało zakończenie logowania.

Firma Apple rozwiązała ten problem w systemach iOS 18.2 i iPadOS 18.2. Zaktualizuj urządzenie w obszarze **Settings > General > Software Update**.

Jeśli po aktualizacji problemy nadal występują, usuń klucz bezpieczeństwa z konta i zarejestruj go ponownie. Dodatkowe informacje znajdziesz na [stronie pomocy technicznej Yubico](https://support.yubico.com/hc/en-us/articles/16726447752732) (po angielsku).

***

### Przydatne odnośniki

* Sprawdzanie wersji oprogramowania sprzętowego klucza YubiKey: [Yubico Authenticator](https://www.yubico.com/products/yubico-authenticator/) (po angielsku)
* Pełna lista kluczy z certyfikatem FIDO: [FIDO® Certified Showcase](https://fidoalliance.org/fido-certified-showcase/) (po angielsku)
* Kontakt z pomocą techniczną Keeper: [keepersecurity.com/support.html](https://www.keepersecurity.com/support.html)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.keeper.io/user-guides/pl/troubleshooting/hardware-security-keys-on-mobile.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
