Logowanie i uprawnienia

Hasło, klucz prywatny i plik certyfikatu KSeF – skąd je wziąć i co z nimi zrobić

W skrócie

Hasło do certyfikatu KSeF wymyślasz sam w pierwszym kroku wniosku w Aplikacji Podatnika – chroni ono plik klucza prywatnego .key, który aplikacja zapisuje na twoim urządzeniu. KSeF nie przechowuje ani klucza, ani hasła, więc po ich utracie unieważniasz certyfikat i zamawiasz nowy. Do programu wgrywasz zwykle plik .crt, plik .key i hasło.

Spis treści
  1. Jakie pliki dostajesz przy generowaniu certyfikatu KSeF?
  2. Jak wygenerować klucz prywatny KSeF?
  3. Jak pobrać klucz do certyfikatu KSeF?
  4. Co zrobić, gdy zgubisz hasło albo klucz prywatny?
  5. Jak wgrać certyfikat do programu do fakturowania?
  6. Jak bezpiecznie przechowywać klucz prywatny i hasło?
  7. Czym klucz certyfikatu KSeF różni się od podpisu kwalifikowanego?

Hasło do certyfikatu KSeF ustawiasz sam w pierwszym kroku wniosku w Aplikacji Podatnika. Chroni ono plik z kluczem prywatnym (.key), który aplikacja zapisuje na twoim urządzeniu, a którego KSeF nie przechowuje – dlatego zgubionego hasła ani klucza nie odzyskasz, tylko unieważnisz certyfikat i zamówisz nowy.

Sam wniosek krok po kroku opisujemy w tekście certyfikat KSeF i token. Tu wyjaśniamy, co dzieje się z plikami i hasłem.

Jakie pliki dostajesz przy generowaniu certyfikatu KSeF?

Element Skąd się bierze Postać Pobierzesz ponownie z KSeF?
klucz prywatny tworzy go Aplikacja Podatnika w 1. kroku wniosku plik .key nazwany jak certyfikat, np. moj_certyfikat.key, chroniony hasłem nie
hasło do klucza wymyślasz je sam 15–32 znaki nie – nikt poza tobą go nie zna
certyfikat wydaje go KSeF po rozpatrzeniu wniosku plik .crt w formacie PEM tak, z listy certyfikatów, dopóki ma status „Aktywny”
kilka certyfikatów naraz lista certyfikatów, od 1 do 10 w jednej operacji archiwum ZIP Certyfikaty_KSeF_RRRRMMDD tak

Klucz publiczny trafia do KSeF razem z wnioskiem i jest zapisany w certyfikacie. Klucz prywatny zostaje wyłącznie u ciebie (podręcznik Aplikacji Podatnika, pkt 5.7.1 i 5.7.2.1).

Jak wygenerować klucz prywatny KSeF?

W Aplikacji Podatnika (Certyfikaty → Wnioskuj o certyfikat) pierwszy ekran nosi nazwę „Generowanie klucza i wniosku o wydanie certyfikatu”:

  1. Nazwa certyfikatu – od 5 do 100 znaków: litery, także polskie, cyfry, spacje, - i _. Pod tą nazwą zapiszą się oba pliki, więc wpisz coś, co rozpoznasz za rok, np. „Jan Kowalski logowanie 2026”.
  2. Hasło – od 15 do 32 znaków; musi mieć co najmniej jedną wielką i jedną małą literę (bez polskich znaków), cyfrę oraz jeden ze znaków !@#$%^&*()-_=+. Wpisujesz je dwa razy.
  3. Generuj – aplikacja tworzy parę kluczy i od razu zapisuje plik .key na twoim urządzeniu. Naszym zdaniem trafia on tam, gdzie przeglądarka zapisuje pobrane pliki – sprawdź to od razu.
  4. W drugim kroku wybierasz przeznaczenie i datę początku ważności, a potem wysyłasz wniosek. Czym różnią się oba typy, wyjaśniamy w artykule o certyfikacie offline.

Każdy wniosek tworzy nową parę kluczy. Certyfikat do logowania i certyfikat offline mają więc osobne pliki .key – i osobne hasła, jeśli takie ustawisz.

Są też dwie inne drogi:

  • Program przez API. Sam tworzy klucz – RSA 2048 bitów albo EC na krzywej P-256, przy czym MF zaleca EC – i wysyła do KSeF żądanie certyfikacyjne (CSR) z danymi odczytanymi z KSeF. Klucz może wtedy w ogóle nie opuszczać programu. Wniosku nie złożysz jednak w sesji otwartej tokenem.
  • Aplikacja Mobilna KSeF. Certyfikat trybu offline zapisuje się na telefonie, a wniosek zatwierdzasz PIN-em, wzorem lub biometrią. Podręcznik aplikacji nie wspomina przy tym o pliku ani haśle do klucza.

Jak pobrać klucz do certyfikatu KSeF?

Z KSeF – nie da się. To najczęstsze nieporozumienie. Z listy certyfikatów pobierzesz tylko plik .crt z kluczem publicznym, a klucz prywatny powstaje na twoim urządzeniu w chwili kliknięcia Generuj i istnieje tylko tam. Jeśli go nie widzisz:

  • przeszukaj folder pobranych plików i cały dysk po nazwie certyfikatu z rozszerzeniem .key,
  • sprawdź, czy przeglądarka nie zablokowała zapisu pliku,
  • jeśli pliku nie ma, unieważnij certyfikat i złóż nowy wniosek.

MF ostrzega, że ponowne pobranie certyfikatu po utracie klucza nie przywróci możliwości logowania ani podpisywania kodów QR (pkt 5.7.2.1 podręcznika).

Co zrobić, gdy zgubisz hasło albo klucz prywatny?

  1. Zaloguj się do Aplikacji Podatnika środkiem z tym samym identyfikatorem, na który wydano certyfikat. Przy powiązanych NIP i PESEL tej samej osoby zadziała każdy z nich.
  2. Wejdź w Certyfikaty → Lista certyfikatów, zaznacz certyfikat i kliknij Unieważnij. Certyfikaty unieważniasz pojedynczo.
  3. Wybierz powód. Gdy plik zginął razem z laptopem lub pendrive’em albo mógł go zobaczyć ktoś obcy, wskaż „Bezpieczeństwo klucza prywatnego związane z certyfikatem zostało naruszone”. Gdy tylko zapomniałeś hasła, wystarczy powód nieokreślony – to nasza sugestia.
  4. Złóż wniosek o nowy certyfikat i wgraj nowe pliki do programu.

Po unieważnieniu certyfikat ma status „Unieważniony” albo, przejściowo, „Zablokowany”. Unieważnienie certyfikatu typu 1, którym program jest właśnie zalogowany, przerywa sesję (cz. I pkt 2.5.8). Uważaj na limit: 12 wniosków w ciągu 30 dni na PESEL, 300 na NIP, a unieważnione certyfikaty też się liczą.

Jak wgrać certyfikat do programu do fakturowania?

MF opisuje dwa pliki: certyfikat .crt w formacie PEM i klucz .key chroniony hasłem. Programy zwykle proszą o wskazanie obu plików i wpisanie hasła – szczegóły znajdziesz w instrukcji dostawcy.

Jeśli program przyjmuje tylko jeden plik .pfx lub .p12, MF nie opisuje konwersji. Taki plik to kontener na certyfikat i klucz, chroniony własnym hasłem. Najpierw zapytaj dostawcę, czy ma do tego narzędzie. Jeśli plik .key otwarty w Notatniku zaczyna się od -----BEGIN, połączysz oba pliki np. bezpłatnym OpenSSL. To nasza wskazówka, nie procedura MF:

openssl pkcs12 -export -in moj_certyfikat.crt -inkey moj_certyfikat.key -out moj_certyfikat.pfx

OpenSSL zapyta o hasło do klucza i o nowe hasło do pliku .pfx. Rób to na swoim komputerze, nigdy w konwerterach online.

Jak bezpiecznie przechowywać klucz prywatny i hasło?

  • Nie wysyłaj pliku .key ani hasła mailem czy komunikatorem. Konsultant i serwisant ich nie potrzebują.
  • Przenieś klucz z domyślnego miejsca zapisu do znanego ci, bezpiecznego folderu – tak radziło MF w szkoleniu „Środy z KSeF” (moduł IV) – i zrób kopię na nośniku poza komputerem.
  • Certyfikat wydany na osobę (na jej PESEL lub NIP) służy tylko tej osobie. MF nie pozwala go udostępniać nikomu innemu, także księgowej (cz. I pkt 2.5.5; FAQ „Certyfikaty KSeF”, pyt. 8).
  • Certyfikat wydany na spółkę (po logowaniu pieczęcią) firma może przekazać pracownikom, ale odpowiada za to, kto go używa. MF oczekuje rozliczalności pobierania, przekazywania, użycia i unieważniania takich certyfikatów. Naszym zdaniem wystarczy prosty rejestr: nazwa i numer seryjny certyfikatu, kto ma klucz, data ważności. Gdy pracownik odchodzi, unieważnij certyfikaty, którymi się posługiwał. Więcej o organizacji dostępu: KSeF dla spółki.

Czym klucz certyfikatu KSeF różni się od podpisu kwalifikowanego?

Cecha Certyfikat KSeF Podpis lub pieczęć kwalifikowana
Kto wydaje Centrum Certyfikacji MF, bezpłatnie kwalifikowany dostawca usług zaufania, odpłatnie
Czy jest kwalifikowany nie – KSeF go honoruje, ale to certyfikat wewnętrzny systemu tak
Gdzie jest klucz prywatny w pliku .key na twoim dysku albo w programie na karcie lub w usłudze dostawcy podpisu
Gdzie działa tylko w KSeF, w programach łączących się przez API logowanie do Aplikacji Podatnika i API, a także podpisywanie dokumentów poza KSeF
Ważność najwyżej 2 lata według certyfikatu wydanego przez dostawcę
Utrata hasła unieważnienie i nowy wniosek procedura dostawcy podpisu

Podpis lub pieczęć kwalifikowana przydają się też przy samym zamawianiu certyfikatu: certyfikat na NIP spółki dostaniesz tylko po zalogowaniu pieczęcią firmy. Kiedy warto ją mieć, wyjaśniamy w tekście o pieczęci kwalifikowanej w KSeF. Jeśli szukasz dawnego modułu, w którym generowano certyfikaty przed lutym 2026 r., przeczytaj, co stało się z MCU.

Najczęstsze pytania

Gdzie znajdę hasło do certyfikatu KSeF?

Nigdzie w systemie. To hasło wymyślasz sam przy generowaniu klucza prywatnego w Aplikacji Podatnika. KSeF go nie przechowuje i nie da się go zresetować.

Jak pobrać klucz prywatny do certyfikatu KSeF?

Z KSeF go nie pobierzesz. Aplikacja Podatnika zapisuje plik .key na twoim urządzeniu w chwili generowania kluczy. Z listy certyfikatów pobierzesz ponownie tylko plik .crt z kluczem publicznym.

Co zrobić po utracie hasła albo pliku .key?

Unieważnij certyfikat na liście certyfikatów w Aplikacji Podatnika i złóż wniosek o nowy. Pamiętaj o limicie 12 wniosków w ciągu 30 dni na PESEL i 300 na NIP – unieważnione certyfikaty też się liczą.

W jakim formacie jest certyfikat KSeF?

Aplikacja Podatnika zapisuje certyfikat jako plik .crt w formacie PEM, a klucz prywatny jako plik .key chroniony hasłem. Jeśli program wymaga jednego pliku .pfx lub .p12, zapytaj dostawcę, jak połączyć oba pliki.

Czy mogę dać klucz i hasło do certyfikatu księgowej?

Nie, jeśli certyfikat wydano na ciebie jako osobę – takiego certyfikatu nie wolno udostępniać innym. Księgowa powinna dostać uprawnienia w KSeF i wygenerować własny certyfikat. Certyfikat wydany na spółkę firma może przekazać pracownikom na własną odpowiedzialność.

Źródła

  1. Podręcznik użytkownika Aplikacji Podatnika KSeF 2.0 (wersja 2.6, sierpień 2026), pkt 5.7.1 (generowanie kluczy, hasło), 5.7.2.1 (pobieranie .crt) i 5.7.2.2 (unieważnienie)
  2. Podręcznik KSeF 2.0 cz. I (MF, 06.08.2026), pkt 2.5.5 (bezpieczeństwo), 2.5.6 (limity) i 2.5.8 (unieważnianie)
  3. CIRFMF/ksef-api, „Certyfikaty KSeF” – pkt 2–3 (dane do wniosku, CSR, klucze RSA i EC)
  4. MF, „Środy z KSeF” – moduł IV, slajdy 127–136 (generowanie klucza i zapis plików)
  5. Podręcznik użytkownika Aplikacji Mobilnej KSeF, wersja 2.4.0 (29.10.2026), pkt 6.11
  6. FAQ KSeF 2.0 (MF) – sekcja „Certyfikaty KSeF”, pyt. 8–9 (udostępnianie certyfikatu)

Artykuł ma charakter informacyjny i nie stanowi porady podatkowej. W konkretnej sprawie skonsultuj się z księgowym lub doradcą podatkowym.

Przeczytaj też