KSeF uwierzytelnianie certyfikatami: Różnice pomiędzy wersjami

Z wiki.groszek.pl
Przejdź do nawigacji Przejdź do wyszukiwania
← poprzednia edycjanastępna edycja →
Nie podano opisu zmian
Linia 1: Linia 1:
== Cel dokumentu ==
== Cel dokumentu ==
Celem dokumentu jest przedstawienie zasad uwierzytelniania w systemie KSeF 2.0 z wykorzystaniem certyfikatów KSeF.   
Celem niniejszej instrukcji jest wyjaśnienie zasad korzystania z '''certyfikatów KSeF''' w nowej wersji systemu '''KSeF 2.0'''.   
Opis przeznaczony jest dla jednostek samorządu terytorialnego (JST) integrujących aplikacje INFO-SYSTEM z API KSeF 2.0.
Dokument przeznaczony jest dla jednostek samorządu terytorialnego (JST) korzystających z oprogramowania, które będzie współpracować z KSeF 2.0.


== Nowy model uwierzytelniania ==
== Czym jest KSeF 2.0 ==
KSeF 2.0 wprowadza nowy, certyfikatowy model uwierzytelniania użytkowników i systemów.   
KSeF (Krajowy System e-Faktur) to system Ministerstwa Finansów służący do wystawiania, odbierania i przechowywania faktur elektronicznych.   
Każdy podmiot komunikujący się z API KSeF musi posiadać '''ważny certyfikat KSeF''', wydany w ramach '''Modułu Certyfikatów i Uprawnień (MCU)'''.
W wersji '''2.0''', która zacznie obowiązywać od '''1 lutego 2026 r.''', wprowadzony zostanie nowy sposób potwierdzania tożsamości użytkowników – za pomocą '''certyfikatów KSeF'''.


Uwierzytelnianie certyfikatowe całkowicie zastępuje dotychczasowe mechanizmy i będzie jedynym dopuszczalnym sposobem logowania do KSeF od 2026 r.
== Co to jest certyfikat KSeF ==
Certyfikat KSeF to elektroniczny „dowód tożsamości” jednostki lub osoby uprawnionej do korzystania z systemu. 
Dzięki niemu system KSeF wie, kto wystawia lub odbiera faktury w imieniu danej jednostki. 
Certyfikat zapewnia bezpieczeństwo i zgodność z przepisami oraz umożliwia działanie systemu także w sytuacjach awaryjnych (np. brak Internetu).


== Typy certyfikatów ==
== Rodzaje certyfikatów ==
W systemie funkcjonują dwa typy certyfikatów, różniące się zastosowaniem:
W KSeF 2.0 występują dwa rodzaje certyfikatów – każdy ma inne zastosowanie:


{| class="wikitable"
{| class="wikitable"
! Typ certyfikatu !! Nazwa (CN) !! Przeznaczenie
! Typ certyfikatu !! Nazwa (CN) !! Do czego służy
|-
|-
| Typ 1 – „uwierzytelnianie” || CN=...uwierzytelnianie || Do logowania i pracy w sesjach interaktywnych lub wsadowych (API / GUI)
| Typ 1 – „uwierzytelnianie” || CN=...uwierzytelnianie || Do codziennej pracy w KSeF, logowania i przesyłania faktur z programu.
|-
|-
| Typ 2 – „offline” || CN=...offline || Do wystawiania faktur w trybie OFFLINE (brak łączności z KSeF)
| Typ 2 – „offline” || CN=...offline || Do wystawiania faktur w trybie awaryjnym, gdy KSeF jest niedostępny (np. awaria systemu lub brak Internetu).
|}
|}


Każdy certyfikat wydawany jest osobno – nie można połączyć typów 1 i 2 w jednym pliku.
Każdy z tych certyfikatów wydawany jest osobno. 
Nie można połączyć obu typów w jednym pliku.


== Uzyskanie certyfikatu ==
== Jak uzyskać certyfikat ==
Od 1 listopada 2025 r. certyfikaty KSeF można uzyskać w '''Moduł Certyfikatów i Uprawnień (MCU)''' dostępnym w domenie KSeF.
Od '''1 listopada 2025 r.''' certyfikaty KSeF będzie można uzyskać poprzez specjalny system Ministerstwa Finansów – 
'''Moduł Certyfikatów i Uprawnień (MCU)''' dostępny na stronie KSeF.


=== Procedura wydania certyfikatu ===
=== Krok po kroku ===
# Wejdź do '''MCU''' w domenie KSeF.   
# Wejdź na stronę KSeF i uruchom '''Moduł Certyfikatów i Uprawnień (MCU)'''.   
# Zaloguj się przy pomocy podpisu kwalifikowanego, podpisu zaufanego lub pieczęci kwalifikowanej.   
# Zaloguj się np. za pomocą podpisu kwalifikowanego, podpisu zaufanego lub pieczęci kwalifikowanej.   
# Wybierz typ certyfikatu (1 lub 2).   
# Wybierz rodzaj certyfikatu (Typ 1 lub Typ 2).   
# Złóż wniosek o wydanie certyfikatu.   
# Złóż wniosek o jego wydanie.   
# Po zatwierdzeniu pobierz i zainstaluj certyfikat w środowisku produkcyjnym.
# Po zatwierdzeniu wniosku pobierz certyfikat i przekaż go osobie lub działowi odpowiedzialnemu za obsługę programu finansowo-księgowego.


Funkcjonalność MCU dostępna jest wyłącznie z poziomu przeglądarki (brak interfejsu API).
Dostęp do MCU odbywa się wyłącznie przez przeglądarkę internetową (nie przez program księgowy).


== Integracja z API KSeF 2.0 ==
== Jak certyfikaty działają w programie ==
Nowe API KSeF 2.0 wymaga uwierzytelniania przy użyciu certyfikatów '''Typ 1 (uwierzytelnianie)'''.
Po pobraniu i zainstalowaniu certyfikatu, nasz system automatycznie wykorzystuje go do:
* logowania się do KSeF,
* przesyłania faktur sprzedaży,
* odbierania faktur zakupowych,
* oraz weryfikowania poprawności danych w KSeF.


=== Kluczowe założenia integracyjne ===
Certyfikat jest ważny przez określony czas – po jego wygaśnięciu trzeba wystąpić o nowy.   
* Certyfikat służy wyłącznie do uwierzytelnienia – '''nie przenosi uprawnień'''. 
System poinformuje użytkownika o zbliżającym się terminie wygaśnięcia.
* Uprawnienia użytkownika weryfikowane są po stronie KSeF na podstawie ról i powiązań w MCU. 
* Certyfikat ma określony '''okres ważności'''; system integrujący powinien cyklicznie weryfikować jego stan i umożliwiać rotację.   
* Każda jednostka (np. urząd, szkoła, MOPS) może posiadać własny certyfikat przypisany do NIP jednostki nadrzędnej. 
* W przypadku pracy awaryjnej (offline) należy użyć odrębnego certyfikatu Typ 2 do oznaczania faktur kodem offline.


== Dobre praktyki dla JST ==
== Dobre praktyki ==
* Stosuj odrębne certyfikaty dla poszczególnych jednostek organizacyjnych.   
* '''Nie udostępniaj certyfikatu innym osobom.''' Każdy użytkownik powinien mieć własny plik lub dostęp przypisany do swojej jednostki. 
* Ogranicz dostęp do certyfikatów wyłącznie do osób uprawnionych.   
* '''Przechowuj certyfikat w bezpiecznym miejscu''', np. w zaszyfrowanym folderze lub na dedykowanym nośniku. 
* Przechowuj certyfikaty w bezpiecznym repozytorium kluczy.   
* '''Wydziel certyfikaty dla różnych jednostek organizacyjnych''' (np. urząd, szkoła, MOPS).   
* Planuj rotację certyfikatów przed upływem ich ważności.   
* '''Zachowaj kopię zapasową''' certyfikatu w bezpiecznym miejscu.   
* W systemach FK zapewniona będzie obsługę certyfikatów Typ 1 i Typ 2 oraz możliwość ich konfiguracji dla wielu jednostek.
* '''Unieważnij certyfikat''' w przypadku utraty dostępu, zmiany pracownika lub podejrzenia naruszenia bezpieczeństwa.
 
== Podsumowanie ==
Certyfikaty KSeF to nowy, bezpieczny sposób potwierdzania tożsamości w systemie KSeF 2.0.   
Od 2026 roku będą one niezbędne do pracy z fakturami w nowym systemie.   
Nasze oprogramowanie jest w pełni przygotowane do obsługi certyfikatów Typ 1 (uwierzytelnianie) oraz Typ 2 (offline).




Wersja z 12:46, 13 paź 2025

Cel dokumentu

Celem niniejszej instrukcji jest wyjaśnienie zasad korzystania z certyfikatów KSeF w nowej wersji systemu KSeF 2.0. Dokument przeznaczony jest dla jednostek samorządu terytorialnego (JST) korzystających z oprogramowania, które będzie współpracować z KSeF 2.0.

Czym jest KSeF 2.0

KSeF (Krajowy System e-Faktur) to system Ministerstwa Finansów służący do wystawiania, odbierania i przechowywania faktur elektronicznych. W wersji 2.0, która zacznie obowiązywać od 1 lutego 2026 r., wprowadzony zostanie nowy sposób potwierdzania tożsamości użytkowników – za pomocą certyfikatów KSeF.

Co to jest certyfikat KSeF

Certyfikat KSeF to elektroniczny „dowód tożsamości” jednostki lub osoby uprawnionej do korzystania z systemu. Dzięki niemu system KSeF wie, kto wystawia lub odbiera faktury w imieniu danej jednostki. Certyfikat zapewnia bezpieczeństwo i zgodność z przepisami oraz umożliwia działanie systemu także w sytuacjach awaryjnych (np. brak Internetu).

Rodzaje certyfikatów

W KSeF 2.0 występują dwa rodzaje certyfikatów – każdy ma inne zastosowanie:

Typ certyfikatu Nazwa (CN) Do czego służy
Typ 1 – „uwierzytelnianie” CN=...uwierzytelnianie Do codziennej pracy w KSeF, logowania i przesyłania faktur z programu.
Typ 2 – „offline” CN=...offline Do wystawiania faktur w trybie awaryjnym, gdy KSeF jest niedostępny (np. awaria systemu lub brak Internetu).

Każdy z tych certyfikatów wydawany jest osobno. Nie można połączyć obu typów w jednym pliku.

Jak uzyskać certyfikat

Od 1 listopada 2025 r. certyfikaty KSeF będzie można uzyskać poprzez specjalny system Ministerstwa Finansów – Moduł Certyfikatów i Uprawnień (MCU) dostępny na stronie KSeF.

Krok po kroku

  1. Wejdź na stronę KSeF i uruchom Moduł Certyfikatów i Uprawnień (MCU).
  2. Zaloguj się np. za pomocą podpisu kwalifikowanego, podpisu zaufanego lub pieczęci kwalifikowanej.
  3. Wybierz rodzaj certyfikatu (Typ 1 lub Typ 2).
  4. Złóż wniosek o jego wydanie.
  5. Po zatwierdzeniu wniosku pobierz certyfikat i przekaż go osobie lub działowi odpowiedzialnemu za obsługę programu finansowo-księgowego.

Dostęp do MCU odbywa się wyłącznie przez przeglądarkę internetową (nie przez program księgowy).

Jak certyfikaty działają w programie

Po pobraniu i zainstalowaniu certyfikatu, nasz system automatycznie wykorzystuje go do:

  • logowania się do KSeF,
  • przesyłania faktur sprzedaży,
  • odbierania faktur zakupowych,
  • oraz weryfikowania poprawności danych w KSeF.

Certyfikat jest ważny przez określony czas – po jego wygaśnięciu trzeba wystąpić o nowy. System poinformuje użytkownika o zbliżającym się terminie wygaśnięcia.

Dobre praktyki

  • Nie udostępniaj certyfikatu innym osobom. Każdy użytkownik powinien mieć własny plik lub dostęp przypisany do swojej jednostki.
  • Przechowuj certyfikat w bezpiecznym miejscu, np. w zaszyfrowanym folderze lub na dedykowanym nośniku.
  • Wydziel certyfikaty dla różnych jednostek organizacyjnych (np. urząd, szkoła, MOPS).
  • Zachowaj kopię zapasową certyfikatu w bezpiecznym miejscu.
  • Unieważnij certyfikat w przypadku utraty dostępu, zmiany pracownika lub podejrzenia naruszenia bezpieczeństwa.

Podsumowanie

Certyfikaty KSeF to nowy, bezpieczny sposób potwierdzania tożsamości w systemie KSeF 2.0. Od 2026 roku będą one niezbędne do pracy z fakturami w nowym systemie. Nasze oprogramowanie jest w pełni przygotowane do obsługi certyfikatów Typ 1 (uwierzytelnianie) oraz Typ 2 (offline).


Opracowano na podstawie: „Podręcznik KSeF 2.0 – Część I: Rozpoczęcie korzystania z KSeF”, MF, 2025.

Źródło: „https://wiki.groszek.pl/index.php?title=KSeF_uwierzytelnianie_certyfikatami&oldid=16196”