Dokument nr 3 Produkty epuap specyfikacja funkcjonalna. Wersja 1.1 (robocza), 1 luty 2010 rok

Transkrypt

1 LINIA WSPÓŁPRACY PRODUKTY EPUAP Dkument nr 3 Prdukty epuap specyfikacja funkcjnalna. Wersja 1.1 (rbcza), 1 luty 2010 rk

2 Prdukty epuap specyfikacja funkcjnalna Autr MSWiA Wersja dkumentu 1.1 Liczba strn 67 Histria zmian Wersja Data Kt Opis zmian MSWiA Wersja rbcza MSWiA Wersja rbcza przekazana 1 luteg 2010 rku KM i KWRiS d piniwania, pddana dalszej analizie i ew. zmianm. 2/67

3 Prdukty epuap specyfikacja funkcjnalna Spis treści 1 Wstęp Cel i przeznaczenie dkumentu Geneza i załŝenia dkumentu Źródła infrmacji Struktura dkumentu Zastswane skróty i pjęcia Prdukty epuap KAP SG BIP Hsting BIP KUP Centralne Repzytrium Dkumentów Repzytrium Interperacyjnści Prtal Interperacyjnści Krajwy Katalg Serwisów Publicznych Krajwa Szyna Usług Skrytki Elektrniczny Skład Dkumentów Dręczyciel e-rejestry Krdynatr Krdynatr Dradca Silnik Frmularzy ŚBA Osbisty Skład Dkumentów (OSD) Płatnści Walidatr Pdpis ZP Usługi TSL Usługi bezpieczeństwa /67

4 Prdukty epuap specyfikacja funkcjnalna 1 Wstęp 1.1 Cel i przeznaczenie dkumentu Dkument Prdukty epuap - specyfikacja funkcjnalna stanwi część dkumentu (a właściwie zestawu dkumentów) pwstających pd nazwą Linia Współpracy. Szczegółwy pdział dkumentu LW nakreślny zstał w rzdziale 2 dkumentu Linia Współpracy pdmitów publicznych administracji rządwej i samrządwej na rzecz mdernizacji funkcjnwania państwa w zakresie współdziałania centralnych i reginalnych systemów teleinfrmatycznych (zwaneg dalej dkumentem prgramwym). Dkument niniejszy stanwi element pzimu trzecieg LW (pzim pisu funkcjnalneg). Dkument ten psiada charakter kncepcyjn-techniczny i bejmuje swim zakresem prjekt epuap. Równlegle d niniejszeg dkumentu istnieje dkument Prdukty pl.id - specyfikacja funkcjnalna któreg zakres bejmuje prjekt pl.id. MŜna przyjąć, Ŝe bk wymieninych dkumentów bejmujących zakresem epuap i pl.id w kategrii tej pjawiać się będą pisy funkcjnalne dtyczące prduktów wyknanych w ramach systemów samrządwych raz systemów innych działów administracji rządwej, pd warunkiem ich przystąpienia d Inicjatywy LW. Cel dkumentu zstanie siągnięty pprzez Przeniesienie wizji architektury kreślnej w dkumencie nr 2 LW Pdstawy analityczn-techniczne architektury współdziałania infrastruktur rządwej i samrządwej (centralnej i reginalnej) na prdukty prjektu epuap. Określenie głównych funkcjnalnści prduktów. Określenie interfejsów zewnętrznych dla prduktów. Odbircami dkumentu są Interesariusze Inicjatywy Linia Współpracy będący: specjalistami z dziedziny infrmatyki i zarządzania, widącymi analitykami, architektami i prjektantami systemów teleinfrmatycznych. Wyłączenia Dkument nie kreśla szczegółwych zasad funkcjnwania systemów infrmatycznych. 4/67

5 Prdukty epuap specyfikacja funkcjnalna Dkument nie jest techniczną specyfikacją interfejsów epuap, które pisane są na strnach infrmacyjnych epuap, w szczególnści na strnie pświęcnej integracji epuap. (specyfikacje integracji znajdują się na prtalu epuap w zakładce Pmc -> Pmc dla integratrów). Dkument nie przedstawia prjektów aktów prawnych umŝliwiających funkcjnwanie epuap. Bazą d stwrzenia dkumentu jest wizja architektury kreślna w rzdziale 2 dkumentu nr 2 LW Pdstawy analityczn-techniczne architektury współdziałania infrastruktur rządwej i samrządwej (centralnej i reginalnej). 1.2 Geneza i załŝenia dkumentu Geneza i załŝenia dkumentów wchdzących w skład dkumentu LW zstały przedstawine w prgramwym pracwaniu Linia Współpracy pdmitów publicznych administracji rządwej i samrządwej na rzecz mdernizacji funkcjnwania państwa w zakresie współdziałania centralnych i reginalnych systemów teleinfrmatycznych rzdział 2. Ze względu na bjętść dkumentu i zróŝnicwanie dbirców całeg LW część kncepcyjntechniczna zstała wydzielna d niniejszeg dkumentu. 1.3 Źródła infrmacji Kncepcja Architektury epuap-wkp załącznik d SIWZ Architektura techniczna epuap p rzbudwie Studium Wyknalnści pl.id Studium Wyknalnści epuap2 Warsztaty epuap seria warsztatów rganizwanych przez MSWiA w których dyskutwane były kncepcje które są przedmitem niniejszeg dkumentu, a których celem była analiza prblemów raz nakreślenie architektury epuap2 raz stwrzenie dkumentu Linia Współpracy E-GOV Benchmark, 8th Benchmark Measurement Nvember 2009 epuap - definicja prduktów część analityczn-kncepcyjna dkumentu Linia Współpracy. 1.4 Struktura dkumentu Dkument niniejszy stanwi element grupy dkumentów LW zawartści kncepcyjnanalitycznej. Rzdział 1. Zawiera wstęp, przeznaczenie dkumentów raz dbirców, strukturę dkumentu raz definicję pdstawwych skrótów i pjęć uŝywanych w dkumencie. 5/67

6 Prdukty epuap specyfikacja funkcjnalna Rzdział 2. Zawiera pis prduktów, przy czym kaŝdy prdukt pisany jest w ddzielnym pdrzdziale. KaŜdy prdukt pisany jest pprzez 1. Przeznaczenie prduktu. 2. Cechy funkcjnalne i pzafunkcjnalne zestaw pdstawwych wyskpzimwych wymagań definiujących zakres prduktu. 3. Scenariusze współdziałania parte wizję architektury z dkumentu analitycznkncepcyjneg. 4. Interfejsy zewnętrzne dla prduktu z wejściami i wyjściami na pzimie lgicznym. 1.5 Zastswane skróty i pjęcia Pjęcia uŝywane w niniejszym dkumencie wyjaśnine zstały w słwniku skrótów i pjęć analityczn-kncepcyjneg dkumentu nr 2 Linia Współpracy ( Rzdział 1.5 Zastswane pjęcia dkumentu Pdstawy analityczn-techniczne architektury współdziałania infrastruktur rządwej i samrządwej (centralnej i reginalnej)). 6/67

7 Prdukty epuap specyfikacja funkcjnalna 2 Prdukty epuap 2.1 KAP Przeznaczenie Katalg administracji publicznej stanwi punkt dniesienia we wszystkich kntekstach, gdzie ptrzebne jest grmadzenie lub pwiązanie jakiejś infrmacji z knkretnym pdmitem publicznym Zakres prduktu Prdukt przechwuje pzyskane z GUS (jak pdzbiór REGON) infrmacje pdmitach publicznych Identyfikatrem pdmitu w KAP jest identyfikatr nadany przez GUS (numer REGON) Prdukt udstępnia API przy pmcy któreg GUS pwiadamia zmianach w zakresie dpwiednieg pdzbiru REGON Prdukt udstępnia API (pwszechnie dstępne) pzwalające na przepytywanie i pbieranie infrmacji z Katalgu Administracji Publicznej Scenariusze współdziałania Pwiadmienie aktualizacji infrmacji w GUS 1. REGON: przekazuje kmunikat z numerem (numerami) REGON ddaneg/zmienineg/usunięteg wpisu w zakresie pdzbiru dpwiadająceg pdmitm publicznym. 2. KAP: dpytuje rejestr REGON dane pdmitów zadanych numerach REGON. Zapytanie d KAP 1. System (dwlny): frmułuje zapytanie d KAP (zapytanie zawiera kryteria, wyszukania pdmitu). 2. KAP: udstępnia infrmacje dtyczące pdmitów publicznych spełniających kryteria zapytania. 7/67

8 Prdukty epuap specyfikacja funkcjnalna Interfejsy Udstępniane API zapytań d KAP System (dwlny) inicjuje kmunikację. System przesyła kmunikat z kryteriami zapytania. KAP przesyła kmunikat z danymi pdmitów publicznych spełniających kryteria. API pwiadmienia zmianie danych pdmitu publiczneg w REGON System infrmatyczny GUS inicjuje kmunikację. System infrmatyczny GUS przesyła listę numerów REGON nwzarejestrwanych/ zmieninych/ wyrejestrwanych pdmitów publicznych Wykrzystywane API rejestru REGON KAP inicjuje kmunikację. KAP przesyła d REGON kmunikat z numerem REGON pdmitu. REGON udstępnia dane pdmitu wskazanym numerze REGON. 2.2 SG BIP Przeznaczenie SG BIP stanwić ma dla klientów administracji pjedynczy punkt wejścia d wszystkich strn pdmitwych BIP raz d Katalgu Usług Publicznych Zakres prduktu Prdukt udstępnia w publicznym Internecie katalg wszystkich pdmitów publicznych wraz z infrmacjami kntaktwymi, infrmacjami lkalizacji, gdzinach urzędwania, rachunkach bankwych, itp. raz adres strny pdmitwej BIP (zgdnie z zakresem ustalnym przepisami prawa). Prdukt pzwala na przeszukiwanie i przeglądanie katalgu z wykrzystaniem pełntekstwych zapytań, zapytań wykrzystujących knkretne atrybuty raz z pmcą ustalnych klasyfikacji. Prdukt jak źródła danych identyfikacyjnych PP wykrzystuje Katalg Administracji Publicznej. Prdukt umŝliwia samdzielne wprwadzanie danych persnelwi pdmitm publicznym w zakresie bjętym zakresem SG BIP i nie bjętym zakresem KAP (REGON jak źródła KAP). 8/67

9 Prdukty epuap specyfikacja funkcjnalna Prdukt umŝliwia wprwadzanie danych d KUP przez persnel pdmitów publicznych. W zakresie uwierzytelnienia i autryzacji dstępu d funkcji wprwadzania danych przez pdmity publiczne prdukt bazuje na usługach bezpieczeństwa epuap Scenariusze współdziałania Prdukt nie współdziała z zewnętrznymi systemami Interfejsy Prdukt nie współdziała z zewnętrznymi systemami. 2.3 Hsting BIP Przeznaczenie Prdukt stanwi składnik implementacji pisany w scenariuszu wspólnej infrastruktury e-usług ( Rzdział Wspólna infrastruktura usług dkumentu Pdstawy analityczn-techniczne architektury współdziałania infrastruktur rządwej i samrządwej (centralnej i reginalnej)). Stanwi narzędzie i infrastrukturę dla pdmitów publicznych małym ptencjale, słuŝące prwadzeniu przez nie strn pdmitwych BIP Zakres prduktu Prdukt umŝliwia stwrzenie przestrzeni dla Strny Pdmitwej BIP pdmitu raz nadanie uprawnień d redagwania zwartści w tej przestrzeni. Prdukt udstępnia zawartść zdefiniwanych przestrzeni w publicznym Internecie (jak strn WWW), zapewniając kaŝdej z przestrzeni sbny URL stanwiący adres strny pdmitwej BIP. Prdukt umŝliwia persnelwi pdmitu publiczneg (właściciela przestrzeni) samdzielne zarządzanie zawartścią przestrzeni zawierającej BIP daneg pdmitu. Prdukt implementuje graniczenia rzmiaru zawartści zgrmadznej w przestrzeniach pszczególnych pdmitów Scenariusze współdziałania Prdukt nie współdziała z zewnętrznymi systemami infrmatycznymi Interfejsy Prdukt nie współdziała z zewnętrznymi systemami infrmatycznymi. 9/67

10 Prdukty epuap specyfikacja funkcjnalna 2.4 KUP Przeznaczenie Przeznaczeniem prduktu jest umŝliwienie klientm znalezienia najbardziej dpwiedniej usługi publicznej w kntekście ich prblemu/sytuacji/ptrzeby. Prdukt stanwi element implementacji scenariusza katalgwania usług publicznych, pisaneg w dkumencie analitycznkncepcyjnym ( Rzdział Wspólna infrastruktura usług dkumentu Pdstawy analityczntechniczne architektury współdziałania infrastruktur rządwej i samrządwej (centralnej i reginalnej) Zakres prduktu Prdukt grmadzi i udstępnia pisy usług publicznych dstarczane przez pdmity publiczne. Opisy usług pdzielne są na część gólną i cześć szczególną. Cześć gólna pisu usługi dla usług realizwanych bezpśredni na pdstawie prawa pwszechneg jest jedna, wspólna dla wszystkich usług realizwanych w całej Plsce (realizwanych na tej samej pdstawie). Części gólne pisów usług realizwanych na pdstawie prawa pwszechneg dstarczane są przez uprawnine pdmity publiczne (typw MSWiA lub ministerstwa dpwiedzialne za pszczególne działy administracji) wprst d KUP. Części szczególne pisów usługi raz części gólne pisu usługi realizwanych na pdstawie prawa lkalneg dstarczane są przez pdmity publiczne usługdawców pszczególnych usług pprzez SG BIP. Opisy usług dstarczane przez pdmity publiczne pprzez SG BIP dstarczane mgą być bezpśredni z wykrzystaniem dpwiednich interaktywnych frmularzy SG BIP i/lub pprzez wskazanie jedneg lub więcej systemów (URL-i) udstępniających tę infrmacje pprzez kreślne API. Struktura pisu usługi dstarczaneg przez pdmity publiczne raz wykrzystywane w niej słwniki i reprezentacje infrmacji/wiedzy są zgdne z ustanwinymi w tym zakresie standardami (udstępnianymi w repzytrium interperacyjnści). Jeden i ten sam system (URL) mŝe dstarczać infrmacje usługach róŝnych pdmitów publicznych (mŝe być wskazany jak źródł przez wiele róŝnych pdmitów), przy czym w uzyskanej z knkretneg systemu (URL-a) ignrwane są pisy usług pdmitów, które nie wskazały teg systemu jak źródła infrmacji swich usługach. Wszystkie pisy usług (części gólne i szczególne) udstępniane są pprzez publicznie dstępne API (bez autryzacji, uwierzytelnienia, pdpisów, itp.) umŝliwiające pbieranie pisów z wykrzystaniem kryteriów bazujących na atrybutach i słwnikach uŝywanych w pisach usług dstarczanych przez pdmity publiczne. 10/67

11 Prdukty epuap specyfikacja funkcjnalna Wszystkie wskazane przez pdmity publiczne systemy, pwiadamiane są zmianach w zakresie gólnych pisów usług realizwanych na pdstawie prawa pwszechneg. Prdukt umŝliwia kaŝdemu uŝytkwnikwi (bez ptrzeby uwierzytelnienia i autryzacji) przeglądanie i przeszukiwanie zgrmadznych w nim pisów usług z wykrzystaniem atrybutów i słwników wykrzystywanych przez pdmity publiczne w prcesie dstarczania infrmacji usługach. Prdukt umŝliwia przeglądanie i wyszukiwanie usług z wykrzystaniem metd, atrybutów, pjęć i słwników zrientwanych na klienta. Prdukt bejmuje mechanizmy wniskwania raz bazy wiedzy (np. reguły) umŝliwiające wywdzenie atrybutów i pjęć zrientwanych na klienta na pdstawie pisów w standardwej strukturze przekazywanej przez pdmity publiczne. Mechanizmami wniskwania i bazami wiedzy sterującymi wniskwaniem zarządza uprawniny persnel MSWiA. Prdukt bejmuje narzędzia (raprty) zestawiające zgrmadzne pisy usług z wykazem pdmitów publicznych z KAP, słuŝące mnitrwaniu wywiązywania się pdmitów z bwiązków dstarczania d SG BIP infrmacji usługach publicznych Scenariusze współdziałania Rejestracja systemu źródła infrmacji 1. Persnel pdmitu: wskazuje w SG BIP system (URL) źródł infrmacji swich usługach publicznych. 2. SG BIP: rejestruje tę infrmacje w KUP. 3. KUP: dpytuje wskazany URL pełny zbiór usług udstępnianych przez wskazany pdmit. 4. KUP: zapisuje/aktualizuje udstępnine przez system pisy usług naleŝące d pdmitów, które wskazały g jak źródł infrmacji (ignruje inne pisy usług). Pwiadmienie KUP zmianie w zakresie usług 1. System źródł infrmacji dla KUP: pwiadamia zmianie udstępnianeg zbiru usług, pwiadmienie przekazuje infrmację identyfikującą zmiany. 2. KUP: dpytuje system ( ile jest n zarejestrwany przez jakiklwiek pdmit publiczny jak źródł infrmacji) zmiany, przekazując uzyskaną w pwiadmieniu infrmację identyfikującą zmiany. 3. KUP: zapisuje/aktualizuje udstępnine przez system pisy usług naleŝące d pdmitów, które wskazały g jak źródł infrmacji (ignruje inne pisy usług). 11/67

12 Prdukty epuap specyfikacja funkcjnalna Zapytania zawartść KUP 1. System (dwlny): dpytuje API KUP pdając dwlne wspierane kryteria wyszukiwania. 2. KUP: dpwiada udstępniając dpwiednie wpisy. Pwiadmienie zmianie w zakresie gólnych pisów usług bazujących na prawie pwszechnym 1. Persnel ministerstwa: zmiana/utwrzenie/usunięcie gólneg pisu usługi w KUP. 2. KUP: wysyła pwiadmienia d wszystkich zarejestrwanych w KUP systemów (URL-i). D kaŝdeg tylk raz, niezaleŝnie d liczby pdmitów, które wskazały ten system. Pwiadmienie zawiera identyfikatry zmieninych/ddanych/usuniętych wpisów. 3. Systemy (źródła infrmacji dla KUP): pbierają (jeŝeli ptrzebują) zmienine, gólne pisy usług z KUP Interfejsy Udstępniane API zapytań d KUP Inicjuje kmunikację dwlny system/aplikacja. System/aplikacja przekazuje zapytanie (zestaw kryteriów). KUP udstępnia listę pasujących d zapytania pisów usług (w strukturze zgdnej ze standardem). API pwiadmienia zmianach System źródł infrmacji inicjuje kmunikację. System źródł infrmacji przekazuje kmunikat zawierający swój URL raz swje identyfikatry zmieninych/ddanych/usuniętych usług Wykrzystywane API pbierania danych d KUP Interakcje inicjuje KUP. KUP przekazuje zapytanie (zestaw kryteriów, w szczególnym przypadku zapytanie pełny zbiór). System (źródł infrmacji wskazane przez pdmit publiczny) dpwiada pełnym zestawem udstępnianych pisów usług (w strukturze zgdnej ze standardem). API pwiadmienia zmianach gólnych pisów usług KUP inicjuje kmunikacje. KUP przekazuje kmunikat zawierający identyfikatry zmieninych/ ddanych/ usuniętych usług. 12/67

13 Prdukty epuap specyfikacja funkcjnalna 2.5 Centralne Repzytrium Dkumentów Przeznaczenie Przeznaczeniem CRD jest dstarczanie wzrów dkumentów elektrnicznych d Ŝądająceg. Prdukt jest dedykwany dla usługdawców Zakres prduktu CRD umŝliwia publikację wzru dkumentu. CRD umŝliwia dszukanie wzru dkumentu. CRD umŝliwia pbranie wzru dkumentu. CRD dstarcza zestandaryzwane API, pzwalające zewnętrznym aplikacjm na wyknywanie wyŝej wymieninych funkcji. CRD udstępnia graficzny interfejs uŝytkwnika w śrdwisku przeglądarkwym, umŝliwiający wyknywanie wyŝej wymieninych funkcji. Graficzny interfejs uŝytkwnika CRD daje mŝliwść pbierania uŝytych we wzrze dkumentu schematów atmwych z Repzytrium Interperacyjnści.. CRD zapewnia jednznaczną identyfikację publikwanych wzrów. Wzry publikwane w CRD są identyfikwane przez unikalne adresy URL. Wzry grmadzne są zgdne ze ustalnym standardem. Wzór dkumentu składa się z trzech części: wyróŝnika dkumentu, schematu dkumentu, wzru wizualizacji dkumentu. Adresy URL przydzielane pszczególnym częścim definicji teg sameg dkumentu są twrzne według ustalnych reguł. CRD dstarcza graficzneg interfejsu uŝytkwnika umŝliwiająceg wizualizację wzru dkumentu. CRD dstarcza graficzneg interfejsu uŝytkwnika d zarządzania wzrami przez administratrów systemu. 13/67

14 Prdukty epuap specyfikacja funkcjnalna Scenariusze współdziałania Scenariusz 1: Pbranie wzru sd CRWD System zewnętrzny CRD Repzytrum Interperacyjnści lp Wyszukanie wzru dkumentu() Lista wzrów dkumentów() lp Pbranie wzru dkumentu() pt lp śądanie schematu atmweg() Rysunek 1 Scenariusz 1: Pbranie wzru System zewnętrzny przekazuje Ŝądanie wyszukania wzru dkumentu spełniająceg zadane kryteria. CRD zwraca listę URL wzrów dkumentów spełniających kryteria. System zewnętrzny pbiera wzór dkumentu. MŜe t bejmwać wielkrtne zapytania d CRD pszczególne elementy definicji dkumentu. CRD zwraca Ŝądane wzry. W przypadku, gdy wzry parte są schematy atmwe, zewnętrzny system kieruje Ŝądanie przekazania schematu atmweg d Repzytrium Interperacyjnści. Repzytrium Interperacyjnści przesyła Ŝądane schematy atmwe Interfejsy Udstępniane Wyszukanie wzru dkumentu Inicjatrem kmunikacji jest dwlny system zewnętrzny. System zewnętrzny wysyła d CRD kryteria wyszukiwania wzru dkumentu. 14/67

15 Prdukty epuap specyfikacja funkcjnalna CRD przesyła dane identyfikacyjne raz adresy URL dkumentów spełniających kryteria. Pbranie wzru dkumentu Inicjatrem kmunikacji jest dwlny system zewnętrzny. System zewnętrzny wysyła d CRD adres URL d pbrania. CRD przesyła wzór (plik XML) spd teg adresu. 2.6 Repzytrium Interperacyjnści Przeznaczenie Prdukt jest przeznaczny d utrzymywania ustalnych schematów atmwych Zakres prduktu Repzytrium Interperacyjnści umŝliwia pbieranie schematów atmwych. Repzytrium Interperacyjnści umŝliwia przeglądanie schematów atmwych. Repzytrium Interperacyjnści umŝliwia ładwanie schematów atmwych. Repzytrium Interperacyjnści udstępnia pwyŝsze funkcje pprzez usługi d wykrzystania przez aplikacje Scenariusze współpracy Pbranie wzru schematu atmweg. Scenariusz pbrania wzru schematu atmweg zstał pisany w scenariuszu Pbranie wzru dla prduktu Centralne Repzytrium Dkumentów. UŜycie schematów atmwych nie musi jednak graniczać się tylk d wzrów dstępnych w CRD. MŜliwe jest bezpśrednie wykrzystanie schematów atmwych z RI we wzrach zewnętrznych. Mechanizm udstępniania pzstaje jednak taki sam dla bu przypadków Interfejsy Udstępniane Wyszukanie schematu atmweg Inicjatrem kmunikacji jest dwlny system zewnętrzny. System zewnętrzny wysyła d RI kryteria wyszukiwania wzru dkumentu. RI przesyła dane identyfikacyjne raz adresy URL dkumentów spełniających kryteria. Pbranie schematu atmweg Inicjatrem kmunikacji jest dwlny system zewnętrzny. 15/67

16 Prdukty epuap specyfikacja funkcjnalna System zewnętrzny wysyła d RI adres URL d pbrania. RI przesyła schemat (plik XML) spd teg adresu. 2.7 Prtal Interperacyjnści Przeznaczenie Przeznaczeniem prduktu jest dstarczenie śrdwiska d wsparcia prac nad ramami interperacyjnści, dstarczania infrmacji działaniach rganizacji interperacyjnści raz sterwania jej pracami Zakres prduktu Prtal Interperacyjnści umŝliwia twrzenie i udstępnianie d wykrzystania frów dyskusyjnych róŝnym pzimie dstępu. System udstępnia mŝliwść przeszukiwania frów dyskusyjnych na Prtalu Interperacyjnści. System zapewnia mŝliwść przeglądania/czytania frów dyskusyjnych wszystkim uŝytkwnikm (równieŝ nieuwierzytelninym). Prdukt zapewnia mŝliwść przeglądania/czytania/zakładania wątków dyskusyjnych. Prdukt zapewnia mŝliwść zarządzania wątkami dyskusyjnymi w zaleŝnści d psiadanych uprawnień. Prtal Interperacyjnści umŝliwia składwanie, wersjnwanie i udstępnianie rbczych dkumentów interperacyjnści. Prtal Interperacyjnści dstarcza mechanizmów umŝliwiających definiwanie i sterwanie prcesem pracwywania i zatwierdzania dkumentów interperacyjnści. Prdukt dstarcza mechanizmu wizualnej prezentacji i edycji (twrzenia) wzrów dkumentów XML zawartych w rekmendacjach interperacyjnści. Prdukt umŝliwia kategryzację prac w ramach prtalu interperacyjnści wg pdstawy prawnej, typu sprawy i typu dkumentu. Istnieje mŝliwść rganizwania sób pracujących w ramach Prtalu Interperacyjnści w grupy rbcze. Prtal Interperacyjnści ma mŝliwść kmunikacji z innymi kmpnentami epuap z wykrzystaniem szyny usług Scenariusze współdziałania Prdukt nie współdziała z zewnętrznymi systemami. 16/67

17 Prdukty epuap specyfikacja funkcjnalna Interfejsy Prdukt nie współdziała z zewnętrznymi systemami. 2.8 Krajwy Katalg Serwisów Publicznych Przeznaczenie Przeznaczeniem prduktu jest dstarczanie wiedzy dstępnych usługach. Prdukt dedykwany jest dla dstawców usług, chcących wykrzystywać istniejące usługi administracji publicznej Zakres prduktu Krajwy Katalg Serwisów Publicznych prwadzi ewidencję definicji serwisów usług w pstaci katalgwej: umŝliwia wyszukiwanie definicji serwisów w katalgu, umŝliwia pbranie definicji wskazaneg usługi serwisu, definicja serwisu bejmuje pis danych wejściwych i wyjściwych serwisu, spsbu jeg uruchamiania wraz z właściwymi parametrami technicznymi dla kmunikacji z systemem bsługujący serwis. Krajwy Katalg Serwisów Publicznych udstępnia graficzny interfejs uŝytkwnika umŝliwiający knfigurwanie platfrm reginalnych i dziedzinwych, których katalgi serwisów publicznych będzie wykrzystywał. Definicje serwisów udstępniane są w standardzie umŝliwiającym wykrzystanie ich przy wytwarzaniu aplikacji z uŝyciem ppularnych aplikacji dewelperskich. Krajwy Katalg Serwisów Publicznych subskrybuje reginalne i dziedzinwe katalgi serwisów publicznych prwadzne przez platfrmy dziedzinwe i reginalne. Krajwy Katalg Serwisów Publicznych udstępnia mŝliwść subskrypcji katalgu. Dla zewnętrznych klientów subskrypcja jest udstępniana w pstaci kanału RSS. Krajwy Katalg Serwisów Publicznych udstępnia funkcjnalnści dla zarządzania katalgiem przez jeg administratra: typu ręczne wprwadzanie i knfigurwanie usług systemów nie wspierających standardów KSU, wykrywanie knfliktów, niejednznacznści w katalgu (np. z danych dstarczanych przez systemy wynika, Ŝe jedna instytucja ma dwie gólne skrzynki pdawcze). 17/67

18 Prdukty epuap specyfikacja funkcjnalna Scenariusze Scenariusz 1: Publikacja definicji serwisu e-usługi sd Publikacj a definicj i serw isu e-usługi Dmenwy Katalg Serwisów Publicznych Krajwy Katalg Serwisów Publicznych Platfrma dmenwa Subskrybent Aktualizacja katalgu() Rzgłszenie infrmacji usłudze() Aktualizacja katalgu() Rzgłszenie infrmacji usłudze() Aktualizacja katalgu() RSS(pwiadmienie usłudze) Rysunek 2 Scenariusz 1: Publikacja definicji serwisu e-usługi Reginalny Katalg Serwisów Publicznych przesyła kmunikat nwym serwisie lub zmianie definicji serwisu. Krajwy Katalg Serwisów Publicznych aktualizuje zawartść katalgu uwzględniając przesłane infrmacje. Krajwy Katalg Serwisów Publicznych rzsyła pwiadmienie zmianie d wszystkich zarejestrwanych platfrm reginalnych i dziedzinwych, prwadzących własne Katalgi Serwisów Publicznych. Krajwy Katalg Serwisów Publicznych rzsyła pwiadmienie zmianie przez RSS d wszystkich subskrybujących te infrmacje. 18/67

19 Prdukty epuap specyfikacja funkcjnalna Scenariusz 2: Wyszukiwanie definicji usługi sd Wyszukiwanie definicji usługi Twórca usługi zintegrwanej/złŝnej Wykrzystanie usługi publicznej() IDE Krajwy Katalg Serwisów Publicznych Wyszukaj usługę() Pbierz definicje() (frm Actrs) Rysunek 3 Scenariusz 2: Wyszukiwanie definicji usługi Twórca usługi zintegrwanej lub złŝnej włącza usługę publiczną d aplikacji realizującej swja usługę. Śrdwisk develperskie łączy się z KKSP i wyszukuje właściwa usługę, a następnie pbiera jej definicję. Scenariusz 3: Zarejestrwanie Reginalneg/Dziedzinweg Katalgu Usług Publicznych sd Rejestracja nweg Dmenweg KSP Krajwy Katalg Serwisów Publicznych Rejestracja nweg Dmenweg KSP Platfrma dmenwa Subskrybent Obsluga KUP Rejestracja nweg Reginalneg/dziedzinweg KSP() Zapytanie DKSP() Zawartść DKSP() Uzupełnienie katalgu usług() Krajwy KSP() Aktualizacja KKSP() RSS(Aktualizacja KKSP) (frm Actrs) 19/67

20 Prdukty epuap specyfikacja funkcjnalna Rysunek 4 Scenariusz 3: Zarejestrwanie Reginalneg/Dziedzinweg Katalgu Usług Publicznych Pracwnik MSWiA rejestruje w KKSP nwą platfrmę reginalną lub dziedzinwą, prwadzącą własny Katalg Serwisów Publicznych. KKSP wywłuje nwy KSP, Ŝądając przekazania zawartści. Nwy KSP przesyła wszystkie swje definicje serwisów publicznych d KKSP. KKSP uzupełnia swój katalg serwisów serwisy z nweg KSP. KKSP przesyła d nweg KSP całść własnych definicji serwisów. KKSP rzgłasza nwe usługi d wszystkich platfrm reginalnych i dziedzinwych zarejestrwanych w KKSP. KKSP rzsyła infrmacje nwych usługach przez RSS d wszystkich zaintereswanych Interfejsy Udstępniane Wyszukanie definicji serwisu Inicjatrem kmunikacji jest system IDE. IDE przesyła d KKSP parametry wyszukiwaneg serwisu. KKSP przesyła listę serwisów spełniających kryteria wyszukiwania. Pbranie definicji serwisu Inicjatrem kmunikacji jest system IDE. IDE przesyła d KKSP identyfikatr serwisu. KKSP przesyła definicję serwisu. Subskrypcja zmian w KSP Inicjatrem kmunikacji jest Reginalny/Dziedzinwy KSP. Reginalny/Dziedzinwy KSP przesyła d KKSP infrmacje ddaniu lub zmianie definicji serwisu. KKSP ptwierdza kmunikat Wykrzystywane Udstępnienie zawartści KSP Inicjatrem kmunikacji jest KKSP. KKSP przesyła d reginalneg/dziedzinweg KSP Ŝądanie przekazania całści zawartści. reginalny/dziedzinwy KSP przesyła d KKSP całść zawartści. Rzgłaszania definicji serwisów Inicjatrem kmunikacji jest KKSP. 20/67

21 Prdukty epuap specyfikacja funkcjnalna KKSP wysyła d Reginalneg/dziedzinweg KSP kmunikat z aktualizacją zawartści KKSP. reginalny/dziedzinwy KSP ptwierdza kmunikat. 2.9 Krajwa Szyna Usług Przeznaczenie Przeznaczeniem KSU jest zapewnienie jednliteg dstępu d usług agregwanych na pzimie krajwym. Jest pmstem łączącym usługi udstępniane w ramach platfrm reginalnych i aplikacje wykrzystywane przez bywateli w celu skrzystania z wych usług. Stanwi backend dla realizacji usług świadcznych za pśrednictwem infrastruktury epuap. Zapewnia jedncześnie jednlity interfejs dstępwy d usług udstępnianych w ramach Rejestrów Zakres prduktu Prdukt składa się z kilku kmpnentów: Właściwej Szyny Usług Usługi Skrytek Zwrtnych Adapterów niestandardwych Usług Publicznych Zakres Krajwej Szyny Usług KSU udstępnia jednlity i ustandaryzwany dstęp d usług publicznych dla wszystkich strn kmunikacji. KSU udstępnia usługi zdefiniwane w KKSP, w parciu zawarte tam definicje. KSU mŝe dknywać knwersji metdy transprtu dla dstswania się d interfejsu usług. KSU zapewnia autmatyczną identyfikację adresu usługi bsługi dkumentu na pdstawie właściwści przekazywanych dkumentów elektrnicznych (np. ustala właściwść miejscwą urzędu) i autmatyczne skierwanie dkumentu na właściwy adres. KSU mŝe udstępniać usługi działające zarówn synchrnicznie jak i asynchrnicznie. KSU pzwala na kreślenie dla pszczególnych usług ich spsbu realizacji (synchrniczne lub asynchrniczne). KSU pzwala na ustalanie spsbu realizacji usługi (synchrniczne/asynchrniczne) p wywłaniu usługi. KSU psługuje się w kmunikacji następującym prtkłem kmunikacji: kaŝde wywłanie usługi pprzez KSU zawiera w sbie URL adresu zwrtneg, na który naleŝy przekazać asynchrniczną dpwiedź usługi, KSU przekazuje ten adres zwrtny d usługi, 21/67

22 Prdukty epuap specyfikacja funkcjnalna usługa realizwana synchrnicznie dsyła w dpwiedzi znacznik, Ŝe zstała zrealizwana synchrnicznie, usługa realizwana asynchrnicznie dsyła w dpwiedzi na wywłanie infrmację, Ŝe realizacja dbędzie się asynchrnicznie, jeśli usługa realizwana asynchrnicznie zstanie wywłana z pustym lub błędnym URL adresu zwrtneg, w dpwiedzi na wywłanie zwraca kmunikat błędzie i nie zstaje uruchmina, dpwiedź asynchrniczna usługi zstaje przez usługę wysłana bezpśredni na przekazany adres zwrtny, bez wywływania usług KSU. KSU umŝliwia za swim pśrednictwem skrzystanie z innych usług epuap: dknania uwierzytelnienia wywłująceg usługę za pmcą Usług Bezpieczeństwa, walidacji pdpisów pd dkumentami. KSU dstarcza funkcji inteligentnej bsługi zapytań rejestrwych, plegającej na: przyjmwaniu zapytań rejestrwych zapisanych za pmcą ustalneg języka, identyfikacji właściwych rejestrów zawierających niezbędne infrmacje, twrzeniu dkumentów zapytań d rejestrów ptrzebne infrmacje i przesyłaniu ich d właściwych usług rejestrwych, pświadczaniu tŝsamści zadająceg pytanie rejestrwe za pmcą pieczęci urzędwej, przyjmwaniu dpwiedzi z rejestrów, krelacji i łączeniu dpwiedzi z rejestrów w wynik zadaneg zapytania, pświadczaniu wyniku pieczęcią urzędwą. W bsłudze zapytań rejestrwych KSU krzysta wyłącznie z usług realizwanych w trybie synchrnicznym. Zakres Usługi Skrytek Zwrtnych KSU umŝliwia twrzenie tymczaswych, jednrazwych skrytek zwrtnych słuŝących debraniu dpwiedzi asynchrnicznej d usługi klientm, których systemy nie dają takiej mŝliwści. Utwrzenie Skrytki Zwrtnej nie wymaga psiadania knta na epuap. Skrytka Zwrtna jest twrzna na kreślny w knfiguracji KSU czas. P upływie teg czasu jest uniewaŝniana, a jej zawartść kaswana. Skrytka zwrtna jest identyfikwana przez unikalny, niemŝliwy d dgadnięcia URL klienta. URL Klienta pzwala wyłącznie na dczytanie zawartści skrytki (w frmie pbrania pliku przez prtkół http). URL Klienta mŝe być dczytywany wielkrtnie, aŝ d upłynięcia terminu waŝnści Skrytki Zwrtnej. 22/67

23 Prdukty epuap specyfikacja funkcjnalna Dla kaŝdej Skrytki Zwrtnej jest twrzny unikalny, niemŝliwy d dgadnięcia bez znajmści URL klienta, URL d zapisu. Znajmść URL d zapisu nie pzwala na dtwrzenie URL Klienta. URL d zapisu pzwalana jednrazwy zapis dkumentu d Skrytki Zwrtnej. Pnwna próba zapisu na URL d zapisu innej zawartści niŝ pierwtny zapis skutkuje kmunikatem błędzie. Zakres Adapterów Usług Publicznych KSU pzwala na dłączanie d nieg usług nie bsługujących wymaganeg prtkłu za pmcą dedykwanych adapterów. KSU dstarcza narzędzi pzwalających na rejestrację twrznych adapterów w systemie i wiązanie ich z usługami. Adaptery kmunikują się z KSU za pmcą wymaganeg przez KSU prtkłu i zapewniają przekształcanie wywłań na dpwiedni prtkół kmunikacji z usługą Scenariusze Scenariusz 1: Wywłanie serwisu publiczneg sd Wywłanie usługi Klient Krajwa Szyna Usług Usługa Usługdawcy Wywłanie usługi(callback) wywłanie usługi(callback) Ptwierdzenie(Wynik usługi) Ptwierdzenie(Wynik usługi) pt [Usługa asynchrniczna] Wynik usługi() Ptwierdzenie() Rysunek 5 Scenariusz 1: Wywłanie serwisu publiczneg Klient wywłuje usługę z Krajwej Szyny Usług przekazując adres zwrtny d kmunikacji (callback). Krajwa Szyna usług kieruje wywłanie usługi d serwisu udstępnianeg przez usługdawcę, przekazując dalej adres zwrtny (callback). 23/67

24 Prdukty epuap specyfikacja funkcjnalna Serwis przesyła ptwierdzenie. Jeśli usługa działa w trybie synchrnicznym, razem z ptwierdzeniem przesyła wynik swjeg działania. Krajwa Szyna Usług przesyła ptwierdzenie i ewentualny wynik usługi d wywłującej aplikacji. Jeśli usługa nie działa w trybie synchrnicznym, p wytwrzeniu wyniku Usługa Usługdawcy przesyła wynik działania d wywłującej aplikacji krzystając z przekazaneg adresu zwrtneg (callback). Scenariusz 2: Wywłanie serwisu publiczneg przez włająceg niepsiadająceg adresu zwrtneg sd Wywłanie przez system bez adresu zwrtneg Klient Skrytka Krajwa Szyna Usług Usługa zwrtna Usługdawcy Wywłanie usługi() Wywłanie usługi() błąd(usługa asynchrniczna) błąd(usługa asynchrniczna) Inicjacja magazynu() Odpwiedź(URL klienta) ZałŜenie tymczasweg magazynu() Wywłanie usługi(url klienta) translacja adresu(url klienta) callback() Wywłanie usługi(callback) Ptwierdzenie() Ptwierdzenie() lp [d czasu udstepnienia UPO] URL Klienta() Odpwiedź(brak) wytwrzenie wyniku() Wynik usługi(callback) URL Klienta() Odpwiedź(Wynik Usługi) Rysunek 6 Scenariusz 2: Wywłanie serwisu publiczneg przez włająceg niepsiadająceg adresu zwrtneg Klient wywłuje usługę bez pdawania adresu zwrtneg. Krajwa Szyna Usług przekazuje wywłanie d usługi. Usługa nie daje dpwiedzi synchrnicznie i zgłasza błąd braku adresu zwrtneg. KSU przekazuje kmunikat błędzie Klientwi. Klient zakłada skrytkę zwrtną. 24/67

25 Prdukty epuap specyfikacja funkcjnalna KSU przesyła klientwi URL dbirczy załŝnej skrytki. Klient wywłuje usługę zamieszczając URL skrytki zwrtnej jak adres zwrtny. KSU przekształca załączny URL na URL d zapisu dla załŝnej skrytki zwrtnej. KSU przekazuje wywłanie usługi d serwisu usługdawcy, załączając jak adres zwrtny URL d zapisu skrytki zwrtnej. Usługdawca zwraca ptwierdzenie. KSU przekazuje ptwierdzenie Klientwi. Klient kresw dpytuje skrytkę zwrtną uŝywając URL klienta. Skrytka zwrtna zwraca infrmację braku dkumentów. Serwis Usługdawcy wytwarza wynik usługi. Serwis usługdawcy przesyła wynik na przekazany adres zwrtny (URL d zapisu skrytki zwrtnej). Klient dpytuje skrytkę zwrtną uŝywając URL klienta. Skrytka zwrtna przekazuje Klientwi trzymany dkument. Scenariusz 3: Wywłanie usługi nie bsługującej prtkłu kmunikacji KSU sd Wywłanie usługi nie bsługującej prtkłu KSU Klient Krajwa Szyna Usług Adapter Usługa Usługdawcy Wywłanie usługi(callback) Wywłanie usługi(callback) Wywłanie usługi() Odpwiedź() Ptwierdzenie() Ptwierdzenie() lp Kmunikacja z Usługą() Wytwrzenie wyniku() Kmunikacja z usługą() Wynik usługi() Wynik usługi() Ptwierdzenie() Rysunek 7 Scenariusz 3: Wywłanie usługi nie bsługującej prtkłu kmunikacji KSU Klient wywłuje usługę z Krajwej Szyny Usług przekazując adres zwrtny d kmunikacji (callback). Krajwa Szyna Usług uruchamia adapter dpwiedniej usługi i przekazuje mu wywłanie usługi i adres zwrtny. 25/67

26 Prdukty epuap specyfikacja funkcjnalna Adapter dknuje knwersji wywłania usługi na prtkół usługdawcy i przekazuje wywłanie usługi d serwisu usługdawcy. Serwis usługdawcy ptwierdza wywłanie. Adapter pprzez KSU ptwierdza wywłanie usługi Klientwi. Adapter kmunikuje się z serwisem usługdawcy zgdnie z jeg prtkłem kmunikacji aŝ d uzyskania wyniku usługi. Adapter przesyła wynik usługi na przekazany adres zwrtny. Scenariusz 4: Zapytanie rejestrwe Zapytanie rejestrwe jest szczególnym przypadkiem wywłania usługi. Wywłanie zapytania i dstarczenie dpwiedzi jest realizwane synchrnicznie zgdnie ze Scenariuszem 1. Przekazywany kmunikat ma ustandaryzwaną frmę, która definiuje dane, jakie naleŝy dstarczyć w dpwiedzi. System pytający nie musi znać rejestru, w którym znajdują się dane. Zapytanie mŝe zawierać Ŝądanie dstarczenia danych, które znajdują się w róŝnych rejestrach. Krajwa Szyna Usług przy pmcy wewnętrznej lgiki będzie analizwać zapytania i dpytywać dpwiednie rejestry, których dane będą dstępne. Dzięki temu z klienta Ŝądająceg danych zdjęty zstaje bwiązek psiadania wiedzy w zakresie, gdzie są dstępne dane które pyta Interfejsy Udstępniane Wywłanie usługi publicznej Inicjatrem kmunikacji jest dwlny system. System przesyła d KSU kmunikat wejściwy zgdny z definicją usługi raz swój adres zwrtny (URL) d asynchrniczneg przekazania dpwiedzi. Krajwa Szyna Usług przesyła przekazane przez usługę ptwierdzenie, ew. z wynikiem realizacji usługi (jeśli zstała zrealizwana synchrnicznie). Zapytanie rejestrwe Inicjatrem kmunikacji jest dwlny system. System przesyła d KSU zapytanie infrmację z rejestru zapisane w ustalnej frmie. Krajwa Szyna Usług zwraca wynik zapytania. ZałŜenie Skrytki Zwrtnej Inicjatrem kmunikacji jest dwlny system. System przesyła d KSU Ŝądanie załŝenia skrytki zwrtnej. KSU zwraca URL klienta załŝnej skrytki zwrtnej. Zapytanie d skrytki zwrtnej Inicjatrem kmunikacji jest dwlny system. System wywłuje URL klienta skrytki zwrtnej. 26/67

27 Prdukty epuap specyfikacja funkcjnalna Skrytka zwrtna zwraca swją zawartść. Zapis d skrytki zwrtnej Inicjatrem kmunikacji jest dwlna usługa publiczna. Usługa publiczna przesyła d Skrytki Zwrtnej dkument. Skrytka zwrtna ptwierdza przekazanie Wykrzystywane Wywłanie usługi publicznej Inicjatrem kmunikacji jest Krajwy Prtfel Usług. KSU wywłuje usługę w spsób kreślny w definicji tej usługi w KKSP, przekazując jej adres zwrtny zlecenidawcy. Usługa zwraca wynik zgdnie z definicją usługi w KKSP. Kmunikacja z usługą niestandardwą za pśrednictwem Adaptera Inicjatrem kmunikacji mŝe być Adapter Usługi lub Usługa Publiczna, zaleŝnie d prtkłu stswaneg przez Usługę. Kmunikacja dbywa się zgdnie z prtkłem wymaganym przez Usługę publiczną Skrytki Przeznaczenie Usługa pzwala na przekazywanie dkumentów pmiędzy usługbircami i usługdawcami usług publicznych (w bie strny) wraz z wystawieniem dpwiednich pświadczeń (zgdnie z przepisami KPA i ustawy infrmatyzacji). Usługa ta stanwi rzszerzenie usług przekazywania transakcji mechanizmy związane z generwaniem ptwierdzeń przedłŝenia i dbiru dkumentów. Skrzystanie z tych usług wymaga alb dyspnwania własną infrastrukturą pzwalającą na pracę z dkumentami i zarządzanie nimi, ich nadawanie i dbieranie alb ddatkweg wykrzystania usług Silnika Frmularzy Zakres prduktu Obsługa przedkładania dkumentów. Prdukt umŝliwia definiwanie i uruchamianie skrytek słuŝących d przyjmwania dkumentów elektrnicznych, zapytań i zdalnych wywłań przez pdmity publiczne. Definicje skrytek rejestrwane są w prdukcie z pśrednictwem Śrdwiska Budwy Aplikacji epuap przez znanych i uprawninych d teg uŝytkwników. Prdukt w mmencie zdefiniwania skrytki autmatycznie umieszcza w KSP pis serwisu publiczneg reprezentwaneg przez skrytkę. 27/67

28 Prdukty epuap specyfikacja funkcjnalna Skrytka przekazuje dkumenty nadane d przedłŝenia przez system (zewnętrzny lub epuap) d systemu infrmatyczneg dbircy lub d składu dkumentów dbircy prwadzneg w epuap (wg knfiguracji w metadanych dbircy). Skrytka natychmiastw (n-line) generuje UPP d nadawcy i dbircy. Skrytka natychmiastw p wygenerwaniu wysyła UPP d nadawcy Skrytka mŝe (zaleŝnie d knfiguracji) natychmiastw (n-line) wysyłać UPP d dbircy (d systemów lub d składów dkumentów w epuap). Skrytka mŝe (w zaleŝnści d knfiguracji) klejkwać przyjmwane dkumenty, UPP, UPD, pwiadmienia nieudanym dręczeniu. Stswane t mŝe być w razie niedstępnści, cyklicznej pracy systemów dbircy lub nieudstępnianiu przez nie funkcji przesyłania dkumentu. Skrytka mŝe (w zaleŝnści d knfiguracji) dstarczać dkumenty w trybie PULL (skrytka czekuje na zlecenie pbrania dkumentów d systemu dbircy) d systemów dbircy. Skrytka pwiadamia internetwą pcztą elektrniczną czekujących w klejce dkumentach, UPD, pwiadmieniach. Wymaganie dtyczy skrytki asynchrnicznej w trybie PULL, w której dkumenty nie zstały debrane przez system dbircy (w szczególnści dbirca, który nie krzysta z Silnika Frmularzy). Skrytka dbiera UPP wygenerwane natychmiastw przez system dbircy i zwraca d nadawcy (d systemu lub d składu dkumentów w epuap). System dbircy dpwiada dkumentem, który zstanie przekazany nadawcy w dpwiedzi na nadanie dkumentu. W szczególnści mŝe t być UPP, przy czym skrytka nie wnika w treść teg dkumentu. Skrytka zapewnia dstęp d wcześniejszych UPP dla nadawców i dbirców dkumentów (z systemów infrmatycznych lub przez GUI epuap). Skrytka mŝe (w zaleŝnści d knfiguracji) dknywać archiwizacji pdpisów w przekazywanych dkumentach, UPP, UPD (wg instrukcji w metadanych skjarznych z adresem przeznaczenia). Skrytka archiwizuje wygenerwane i przesyłane dkumenty UPP d zasbów ff-line i przywraca z archiwów d zasbów n-line - funkcja dstępna dla bsługi technicznej systemu. System będzie rzróŝniał UPO zarchiwizwane d niezarchiwizwanych i nie będzie pzwalał na usuwanie niezarchiwizwanych. Archiwizacja będzie wyknywana przez bsługę techniczną systemu. Skrytka mŝe (w zaleŝnści d knfiguracji) znaczać czasem przekazywane dkumenty. Skrytka udstępnia interfejs uŝytkwnika pzwalający na pdstawwe bezpśrednie zarządzanie metadanymi skjarznymi z adresami epuap (knfigurację skrytek). Skrytka bsługuje kmunikację wyłącznie zgdnie z prtkłem stswanym przez KSU (wywłanie musi zawierać adres zwrtny d dpwiedzi w sytuacjach, gdy nie jest na mŝliwa natychmiastw). Skrytka przekazuje adres zwrtny przesyłająceg dkument d systemu dbircy. 28/67

29 Prdukty epuap specyfikacja funkcjnalna Skrytka dknuje sprawdzanie autryzacji dbircy dkumentów. W przypadku skrytek działających w trybie pull d debrania dkumentów dbirca autryzuje się z wykrzystaniem usług bezpieczeństwa epuap. Skrytka mŝe dknywać autryzacji nadawców składających dkumenty i dpuszczać składanie dkumentów tylk przez nadawców mających nadane dpwiednie uprawnienia. Skrytka mŝe dknywać weryfikacji i nie dpuszczać d przekazania dkumentów niezgdnych z wymaganym wzrem dla knkretneg adresu przeznaczenia (wg definicji w metadanych skjarznych z adresem przeznaczenia). JeŜeli dkument jest w frmacie XML, weryfikacja plega na badaniu zgdnści ze schematem XML. Badanie zgdnści dla dkumentów w frmacie innym niŝ XML nie jest mŝliwe. Skrytka mŝe dknywać weryfikacji i nie dpuszczać d przekazania dkumentów niewłaściwej zawartści (wg reguł zdefiniwanych w metadanych skjarznych z adresem przeznaczenia). Skrytka mŝe dknywać weryfikacji i nie dpuszczać d przekazania dkumentów bez lub z nieprawidłwymi pdpisami cyfrwymi (wg instrukcji w metadanych skjarznych z adresem przeznaczenia). Skrytka mŝe wykrywać, bsługiwać i eliminwać duplikaty przesyłanych dkumentów. Duplikaty są szczególnie isttne w przypadku awarii, niepewnści czy dkument zstał dstarczny. W mmencie pnwneg wysłania teg sameg dkumentu nadawca dstanie UPP dla wcześniej wysłaneg dkumentu (dla skrytek wydających UPP). Wykrywanie duplikatu jest zawsze w ramach jednej skrytki. Skrytka daje mŝliwść sprawdzenia przez system (zewnętrzny lub epuap) autryzacji i kryteriów dmwy. UmŜliwia nadanie próbneg dkumentu w celu sprawdzenia czy wzór jest aktualny, raz sprawdzenie innych reguł na skrytce. Dkument nie jest przekazywany d systemu dbircy. 29/67

30 Prdukty epuap specyfikacja funkcjnalna Scenariusze współdziałania Scenariusz 1: Skrytka pracująca w trybie Push sd e-skrytka push Aplikacja Krajwa Szyna Usług e-skrytka System Odbircy Dkument(callback) Dkument(callback) pt Wytwrzenie UPP() Dkument(callback) dpwiedź(ok, UPP) ptwierdzenie(ok, UPP) ptwierdzenie(ok, UPP) pt UPP() Rysunek 8 Scenariusz 1: Skrytka pracująca w trybie Push Dwlna aplikacja przesyła dkument d skrytki (dla skrytek naleŝących d pdmitów publicznych dbywa się t pprzez KSU). Skrytka zaleŝnie d knfiguracji generuje UPO, ewentualnie takŝe znacza dkument czasem. Skrytka przesyła dkument d aplikacji właściciela. Aplikacja właściciela przesyła dpwiedź zwrtną. MŜe nią być UPO, jeśli ta aplikacja je generuje natychmiastw. Skrytka zaleŝnie d knfiguracji dknuje archiwizacji pdpisów pd dkumentem i UPO. Skrytka przesyła dpwiedź aplikacji właściciela, ew. zaleŝnie d knfiguracji z dłącznym wygenerwanym przez siebie UPO, jak dpwiedź d przekazująceg dkument. W przypadku, gdy UPO jest wystawiane przez system dbircy i nie ptrafi n (z pwdu knstrukcyjneg) wystawić g synchrnicznie, skrytka zwraca tylk ptwierdzenie techniczne dknanej kmunikacji. Przekazanie zwrtne UPP naleŝy d systemu dbircy i ma n przesłać je na przekazany przez Skrytkę adres zwrtny. Jeśli system sam nie ptrafi przesyłać zwrtnych dkumentów naleŝy zastswać mechanizmy KSU (adapter) bsługujące kmunikację zgdną ze standardami. 30/67

31 Prdukty epuap specyfikacja funkcjnalna W przypadku, gdy UPO jest wystawiane przez system dbircy, skrytka jest sknfigurwana d pracy w trybie PUSH (bez klejkwania), a system dbircy nie dpwiada (np. wskutek awarii), Skrytka dpwiada kmunikatem błędzie. Scenariusz 2: Przekazanie dkumentu d skrytki pracującej w trybie Pull sd e-skrytka pull Aplikacja Krajwa Szyna Usług e-skrytka System Odbircy Dkument(callback) Dkument(callback) pt Wytwrzenie UPO() pwiadmienie(callback) Ptwierdzenie(UPP) Ptwierdzenie(UPP) Rysunek 9 Scenariusz 2: Przekazanie dkumentu d skrytki pracującej w trybie Pull Dwlna aplikacja przesyła dkument d skrytki (dla skrytek naleŝących d pdmitów publicznych dbywa się t pprzez KSU). Skrytka zaleŝnie d knfiguracji generuje UPO, ewentualnie takŝe znacza dkument czasem. Skrytka zaleŝnie d knfiguracji dknuje archiwizacji pdpisów pd dkumentem i UPO. Skrytka wysyła pwiadmienie d systemu dbircy czekującym dkumencie. Skrytka dsyła przekazującemu dkument dpwiedź. W zaleŝnści d knfiguracji, dpwiedź mŝe zawierać UPO. 31/67

32 Prdukty epuap specyfikacja funkcjnalna Scenariusz 3: Pbranie dkumentów ze skrytki pracującej w trybie Pull sd e-skrytka pull Aplikacja składająceg e-skrytka System Odbircy Pwiadmienie dkumencie(callback) Plecenie pbrania dkumentów() Dkument(callback) pt Obsługa dkumentu() Odpwiedź() OK() Rysunek 10 Scenariusz 2: Przekazanie dkumentu d skrytki pracującej w trybie Pull Skrytka pwiadamia system dbircy czekujących dkumentach. System dbircy przesyła plecenie przekazania czekujących dkumentów. Skrytka przesyła czekujące dkumenty wraz z infrmacją adresie zwrtnym dla dpwiedzi d kaŝdeg z nich. System dbircy przetwarza przekazane dkumenty. Jeśli występuje taka ptrzeba, system dbircy przesyła dpwiedź na dkument na adres zwrtny przekazany razem dkumentem. W szczególnści dpwiedzią tą mŝe być UPP, jeśli t system dbircy je wydaje Interfejsy Udstępniane Pbranie dkumentów ze skrytki. Inicjatrem kmunikacji jest system dbircy. Klient przesyła d skrytki plecenie pbrania dkumentów. Kmunikacja zwrtna: skrytka przesyła wskazane dkumenty. 32/67

33 Prdukty epuap specyfikacja funkcjnalna Wykrzystywane Pwiadamianie nadejściu dkumentu. Inicjatrem kmunikacji jest Skrytka. Skrytka przesyła d właściciela skrytki (lub jeg systemu) kmunikat pjawieniu się dkumentu w skrytce. Kmunikacji zwrtnej brak. Przekazanie dkumentu. Inicjatrem kmunikacji jest Skrytka. Skrytka przesyła d systemu dbircy dkument raz adres zwrtny. Kmunikacja zwrtna: System dbircy przesyła dpwiedź na przesłany dkument (w szczególnści mŝe t być UPP) Elektrniczny Skład Dkumentów Przeznaczenie Prdukt jest przeznaczny dla instytucji, które z pwdów technicznych i rganizacyjnych nie są w stanie zapewnić własnej infrastruktury i/lub nie są w stanie lub nie mgą skrzystać z usług dmeny w tym zakresie raz krzystają z niewielkiej liczby dkumentów elektrnicznych. Obieg papierwy jest w nich dminujący Zakres prduktu ESD umŝliwia grmadzenie dkumentów elektrnicznych. ESD zapewnia przechwywania dkumentów w spsób zabezpieczający je przed zewnętrznymi czynnikami śrdwiskwymi. ESD zapewnia chrnę przechwywanych dkumentów na pzimie wymaganym dla danych sbwych (pzim 3). ESD zapewnia następujące pdstawwe peracje na dkumentach: zapisanie dkumentu d składu z zewnętrzneg źródła (w tym ze skrytek), wizualizację dkumentu, weryfikację pdpisu elektrniczneg złŝneg pd dkumentem, pbranie dkumentu ze składu, wysłanie dkumentu ze składu d usługi dstępnej pprzez KSU, skierwanie dkumentu d dręczenia. ESD dstarcza interfejs uŝytkwnika umŝliwiający realizację wszystkich wyŝej wymieninych peracji. Interfejs jest zrealizwany w śrdwisku przeglądarkwym. ESD składa się z infrastruktury serwerwej przechwującej dkumenty raz z kmpnentu instalwaneg p strnie klienta. 33/67

34 Prdukty epuap specyfikacja funkcjnalna Zadaniem kmpnentu ESD instalwaneg u klienta jest identyfikacja i przechwycenie pbieraneg dkumentu elektrniczneg. Identyfikacja następuje autmatycznie według ustalneg standardu techniczneg. Operacje przeprwadzane przez instalwany u klienta kmpnent ESD są realizwane w parciu ustalny standard kmunikacji i zdefiniwane publicznie dstępne API. ESD pzwala na knfigurację następujących limitów dla składów dkumentów: limit liczby dkumentów przechwywanych jedncześnie dla jedneg klienta, limit liczby dkumentów wprwadzanych przez jedneg klienta d ESD w jednstce czasu (np. miesiąc). Limity te są definiwane glbalnie dla wszystkich klientów raz mgą być indywidualnie zmieniane dla wskazanych klientów. ESD kntrluje wykrzystanie składów i nie dpuszcza d wyknania peracji pwdujących przekrczenie sknfigurwanych limitów Scenariusze współpracy ESD kmunikuje się z zewnętrznymi systemami wyłącznie za pśrednictwem standardwych mechanizmów kmunikacji epuap. Scenariusze tej kmunikacji pisane są przy pisach prduktów realizujących te usługi (Krajwa Szyna Usług, Skrytki, Dręczyciel) Interfejsy Elektrniczny Skład Dkumentów jest prduktem, który nie psiada interfejsów integracyjnych na pzimie epuap. Jedyna interakcja z prduktem realizwana jest pprzez GUI, które dstarcza Dręczyciel Przeznaczenie Przeznaczeniem prduktu jest zapewnienie dręczania dkumentów d dbircy zgdnie z KPA Zakres prduktu Dręczyciel udstępnia nadawcm usługę dręczania dkumentów. Dręczyciel realizuje dręczenie dkumentu w trybie kreślnym w KPA, Dręczyciel dknuje weryfikacji tŝsamści adresata: autryzacja dknywana za przy pmcy wskazanej przez nadawcę metdy autryzacji, dręczyciel pzwala wykrzystywać wszystkie metdy autryzacji bsługiwane w ramach epuap. 34/67

35 Prdukty epuap specyfikacja funkcjnalna Dręczyciel dknuje generacji UPD. Dręczyciel nadaje wytwrznemu UPD unikalny adres URL: Struktura adresu URL nie umŝliwia dstępu przez sbę nieuprawniną (nie mŝna jej zgadnąć). Dręczyciel przekazuje UPD na skrytkę dbircy lub pwiadamia dbircę pcztą elektrniczną adresie UPD d pbrania. Pwiadamianie jest pwtarzane cyklicznie d czasu pbrania UPD lub przekrczenia sknfigurwaneg terminu. Dręczyciel pzwala na definiwanie dla pszczególnych dbirców spsbu przekazywania im UPD i dkumentów (skrytka lub pwiadamianie) raz adresu dręczania. Dręczyciel dstarcza interfejs uŝytkwnika w śrdwisku przeglądarkwym, pzwalający na pbranie UPD, pdpisanie g i zwrt d dręczyciela raz pbranie i wizualizację dręczaneg dkumentu. Dręczyciel wymaga uwierzytelnienia się przez uŝytkwnika przed udstępnieniem UPD. Dręczycie przekazuje pdpisane UPD d nadawcy. Dręczyciel udstępnia usługę pzwalającą zewnętrznym systemm na przekazanie pdpisaneg UPD i pbranie dręczaneg dkumentu. Dręczane dkumenty są udstępniane pd unikalnym adresem URL: struktura adresu URL nie umŝliwia dstępu przez sbę nieuprawniną (nie mŝna jej zgadnąć), adres dręczaneg dkumentu jest udstępniany dbircy natychmiast p pdpisaniu UPD. Dręczane dkumenty są dstępne przez kreślny czas (knfigurwany w Dręczycielu), pbranie dkumentu nie pwduje wstrzymania udstępniania dkumentu. 35/67