D.Signer/XAdES. príručka

Transcription

1 Používateľská D.Signer/XAdES príručka

2 Copyright Všetky práva vyhradené Tento dokument je vlastníctvom spoločnosti DITEC, a. s. Žiadna jeho časť sa nesmie akýmkoľvek spôsobom (elektronickým, mechanickým) poskytnúť tretej strane, rozmnožovať, kopírovať, vrátane spätného prevodu do elektronickej podoby, bez písomného povolenia spracovávateľa. Popisné charakteristiky dokumentu Projekt GOV_ZEP A3019_002 Podnázov D.Signer/XAdES Ref. číslo GOV_ZEP.13 Verzia 6 Vypracoval Vittek Róbert Podpis Dátum Preveril Podpis Dátum Schválil Podpis Dátum Formulár Dokument Ref. číslo Fo 11 Dátum poslednej aktualizácie Dátum Akceptované dňa : <Dátum akceptácie> Za <Objednávateľa>: Za <Dodávateľa>.: <Meno zodpovednej osoby> < Meno zodpovednej osoby > Copyright -2/42-

3 Záz namy o zmenách Autor Popis zmien Dátum Verzia Pripomienkovanie a kontrola Autor Stanovisko Dátum Verzia Rozdeľovník Originál Kópia Kópia Kópia Priezvisko Meno Firma, Funkcia Copyright -3/42-

4 Obsah 1. Úvod Popis aplikácie Systémové požiadavky Inštalácia Inštalácia z distribučného CD Inštalácia v rámci klientskej aplikácie Inštalácia z Internetu Architektúra riešenia Postavenie aplikácie v rámci prevádzkového prostredia Vnútorná architektúra aplikácie Funkčný pohľad Pohľad na vrstvy architektúry P opis činnosti aplikácie I ntegrácia s klientskými aplikáciami Integračné API hlavnej aplikácie Net API COM API COM API prostredníctvom ATL knižnice Popis funkcií a premenných API hlavnej aplikácie SetWindowSize Sign AddObject ErrorMessage SignedXmlWithEnvelope Integračné API pluginu Net API COM API COM API prostredníctvom ATL knižnice Popis funkcií a premenných API pluginu...26 Obsah -4/42-

5 CreateObject ErrorMessage Integračné API komponentu D.Signer/XAdES XML Plugin Net API COM API COM API prostredníctvom ATL knižnice Popis funkcií a premenných API pluginu CreateObject ErrorMessge Abstraktné API pre pluginy Popis metód abstraktného API pre pluginy GetVisualizer ErrorMessage SetData TypeName PluginVersion GetObjectId GetObjectDescription GetDSObjects GetDSManifests GetXadesDataObjectFormats GetDSReferences Príklad použitia K onfigurácia aplikácie Vytvorenie ZEP používateľom Načítanie vstupných parametrov Zobrazenie podpisovaných dát Zobrazenie XML dokumentov Podpísanie dokumentu Zobrazenie parametrov podpisu Obsah -5/42-

6 1. Úvod Tento dokument je určený pre používateľov aplikácie D.Signer/XAdES a pre zhotoviteľov, prípadne prevádzkovateľov systémov, v rámci ktorých bude aplikácia D.Signer/XAdES pre zaručený elektronický podpis (ZEP) integrovaná. Jednotlivé časti dokumentácie aplikácie D.Signer/XAdES je možné použiť pri tvorbe používateľských príručiek týchto systémov po dohode s vlastníkmi autorských práv aplikácie D.Signer/XAdES. Úvod -6/42-

7 2. Popis aplikácie Aplikácia D.Signer/XAdES predstavuje riešenie pre vytváranie zaručeného elektronického podpisu (ZEP) nad množinou rôznych formátov dokumentov, resp. typov dát (XML dokumenty, PDF dokumenty atď.), prípadne nad ľubovoľnou kombináciou podporovaných formátov dát, ktoré spolu vytvárajú tzv. multipart dokument. Zaručený elektronický podpis na druhej strane zabezpečuje integritu podpísaných dát a nepopierateľnosť podpisu. Aplikácia D.Signer/XAdES môže byť teda nasadená v rámci akéhokoľvek systému, kde je potrebné zabezpečiť jednak integritu prenášaných a spracovávaných dokumentov, ako aj nepopierateľnosť identity ich podpisovateľa. Aplikácia D.Signer/XAdES pred samotnou procedúrou vytvorenia ZEP v zmysle zákona č. 215/2002 Z.z. o elektronickom podpise a o zmene a doplnení niektorých zákonov: zabezpečí podpisovateľovi zobrazenie všetkých podpisovaných dát jednoznačným a adekvátnym spôsobom, zaručí, že dáta sa pri podpise nezmenia. Pre vytvorenie ZEP musí byť aplikácia použitá len v súlade s platnou podpisovou politikou pre ZEP, ktorá bola schválená NBÚ SR. Používateľ je pred vytvorením podpisu povinný presvedčiť sa, že podpisová politika, ktorú aplikácia používa, je stále platná a nebola zo strany vydavateľa predčasne zrušená. Výrobca, resp. integrátor aplikácie D.Signer/XAdES je povinný zabezpečiť také nastavenie konfigurácie aplikácie a parametrov volania metód rozhrania aplikácie, aby aplikácia vytvárala podpis v súlade so špecifikovanou podpisovou politikou. Za obsah a sformátovanie vstupných dát (dokumentov), ako aj za dodržanie správneho postupu vytvorenia ZEP, definovaného v rámci podpisovej politiky, je zodpovedný podpisovateľ. Za správne vyhodnotenie platnosti vytvoreného ZEP a za špecifikovanie parametrov procesu verifikácie ZEP v súlade s podpisovou politikou je zodpovedný prijímateľ alebo prevádzkovateľ systému, ktorý tieto dáta spracováva. Aplikácia D.Signer/XAdES vytvára ZEP v súlade so schváleným formátom pre zaručený elektronický podpis XAdES_ZEP, verzia 1.0 ( Aplikácia D.Signer/XAdES vytvára typ podpisu XAdES_ZEP-EPES, teda elektronický podpis rozšírený o informáciu o čase vzniku ZEP, o explicitnú podpísanú referenciu podpisovej politiky a podpísané informácie o typoch a formátoch podpísaných dátových objektov. Popis aplikácie -7/42-

8 3. Systémové požiadavky Systémové požiadavky aplikácie D.Signer/XAdES sú nasledujúce: OS Windows 2000, XP, 2003 Server, Vista, platforma.net framework, verzia 2.0, certifikované SSCD zariadenie pre generovanie kľúčových párov a vytváranie elektronického podpisu, web prehliadač MS Internet Explorer, verzia 6.0 alebo viac. Pri vytváraní zaručeného elektronického podpisu pomocou aplikácie D.Signer/XAdES sa vyžaduje použitie certifikovaného zariadenia pre generovanie a uloženie privátneho kľúča a pre vytvorenie zaručeného elektronického podpisu (SSCD napr. čipová karta, USB token apod.) a použitie kvalifikovaného certifikátu, vydaného akreditovanou certifikačnou autoritou. Aplikácia D.Signer/XAdES pristupuje k danému SSCD zariadeniu prostredníctvom príslušného CSP providera (implementácia MS Crypto API pre dané SSCD zariadenie). Pre aplikáciu D.Signer/XAdES nie sú potrebné vyššie hardwarové požiadavky, ako vyžaduje samotný operačný systém, prípadne platforma.net framework 2.0. Požiadavky aplikácie na voľný priestor na disku sú nasledujúce: Komponent D.Signer/XAdES D.Signer/XAdES XML Plugin Veľkosť (KB) 530 KB 180 KB Aplikácia D.Signer/XAdES môže byť distribuovaná na inštalačnom CD alebo v rámci klientskej aplikácie, ktorá komponent pre zaručený elektronický podpis používa, či už v rámci jej inštalačných súborov alebo priamo cez Internet. Veľkosť distribučných, resp. inštalačných súborov jednotlivých komponentov aplikácie D.Signer/XAdES je uvedená v nasledujúcej tabuľke. Komponent D.Signer/XAdES D.Signer/XAdES XML Plugin Veľkosť (KB) 1 MB 750 KB Podrobný popis požiadaviek na prevádzku aplikácie D.Signer/XAdES, teda požiadaviek na SSCD zariadenie, požiadaviek na prevádzkové prostredie aplikácie, bezpečnostných požiadaviek apod. je špecifikovaný v rámci dokumentu Požiadavky na prevádzkové prostredie a SSCD. Systémové požiadavky -8/42-

9 4. Inštalácia Inštalácia aplikácie D.Signer/XAdES závisí primárne od spôsobu komponentov aplikácie: 1) inštalácia z distribučného CD spustením inštalačného z distribučného CD, distribúcie programu 2) inštalácia v rámci klientskej aplikácie spustením inštalačného programu klientskej aplikácie (ktorá komponent pre ZEP využíva a v rámci ktorej sa distribuuje), 3) inštalácia z Internetu spustením inštalácie z web stránky Internetovej klientskej aplikácie, ktorá komponent pre ZEP využíva. Integritu inštalačných súborov aplikácie je možné overiť náhľadom na vlastnosti inštalačného programu (setup.exe alebo príslušného msi balíčka). Všetky inštalačné súbory musia byť podpísané certifikátom spoločnosti Ditec, a.s. a je na ne vyžiadaná časová pečiatka. To isté platí aj pre všetky knižnice (dll súbory), ktoré tvoria aplikáciu. Okrem elektronického podpisu certifikátom spoločnosti Ditec, a.s. sú.net assembly zabezpečené aj pomocou tzv. strong name. Daná kontrola sa uplatňuje napr. pri spustení aplikácie D.Signer/XAdES aplikácia načíta len také plugin moduly, ktoré boli podpísané tým istým kľúčom ako hlavná aplikácia Inštalácia z distribučného CD Inštalácia samotnej aplikácie D.Signer/XAdES sa vykoná spustením programu SETUP.EXE. Pre úspešnú inštaláciu musí mať používateľ v rámci operačného systému administrátorské privilégia. Pre operačný systém MS Windows Vista je možné spustiť inštaláciu aplikácie D.Signer/XAdES pod administrátorskými privilégiami z kontextového menu. 1 Toto neplatí pre knižnice tretích strán, ktoré môže aplikácia D.Signer/XAdES využívať. Tieto by mali byť chránené príslušným certifikátom ich výrobcu. Inštalácia -9/42-

10 Po spustení inštalačného programu sa zobrazí úvodná obrazovka. V nasledujúcom kroku potvrďte tlačidlom NEXT, prípadne zvoľte adresár, do ktorého bude aplikácia D.Signer/XAdES nainštalovaná a špecifikujte, kto bude mať právo aplikáciu na počítači používať. Inštalácia -10/42-

11 Kliknutím na tlačidlo Next sa spustí samotná inštalácia. Inštalačný program skopíruje požadované aplikačné súbory do špecifikovaného adresára a zabezpečí zaregistrovanie komponentov aplikácie D.Signer/XAdES v rámci operačného systému Windows. Inštalácia -11/42-

12 Používateľ je o priebehu inštalácie informovaný v okne inštalačného programu. V každom okamihu je možné inštaláciu aplikácie D.Signer/XAdES prerušiť kliknutím na tlačidlo Cancel (Zrušiť). Inštalácia -12/42-

13 Po ukončení inštalácie kliknite na tlačidlo Close (Zavrieť). Inštalácia -13/42-

14 Po úspešnej inštalácii aplikácie D.Signer/XAdES je potrebné rovnako vykonať inštaláciu pluginov aplikácie pre jednotlivé typy formátov dokumentov. Pre vykonanie inštalácie jednotlivých pluginov pre podporované typy formátov dát (XML, PDF apod.) je potrebné spustiť inštalačné programy príslušných pluginov SETUP.EXE Inštalácia v rámci klientskej aplikácie V prípade inštalácie aplikácie D.Signer/XAdES v rámci inštalácie klientskej aplikácie (ktorá komponent pre zaručený elektronický podpis využíva a v rámci ktorej sa distribuuje), musí správne nainštalovanie a zaregistrovanie jednotlivých komponentov aplikácie D.Signer/XAdES zabezpečiť výrobca klientskej aplikácie. Odporúčame, aby používateľ postupoval podľa inštalačnej príručky danej klientskej aplikácie Inštalácia z Internetu V prípade použitia aplikácie D.Signer/XAdES v rámci Internetovej aplikácie doporučujeme, aby tvorca klientskej Internetovej aplikácie sprístupnil na stránkach svojej aplikácie aj inštalačné súbory jednotlivých komponentov D.Signer/XAdES, najlepšie zabezpečené protokolom HTTPS. Používateľ si bude môcť takto inštalačné súbory bezpečne stiahnuť a spustiť na svojom PC. Opäť je potrebné zabezpečiť, aby používateľ, ktorý inštaluje komponenty aplikácie D.Signer/XAdES z Internetu mal počas inštalácie administrátorské práva. Odporúčame, aby používateľ postupoval podľa inštalačnej príručky príslušnej klientskej Internetovej aplikácie. Inštalácia -14/42-

15 5. Architektúra riešenia 5.1. Postavenie aplikácie v rámci prevádzkového prostredia Aplikácia D.Signer/XAdES je realizovaná ako hlavná aplikácia (modul) a sada komponentov (pluginov) pre jednotlivé podporované dátové typy, ktoré môžu byť v súlade s požiadavkami zákazníka nasadené ako súčasť rozsiahlejších aplikácií a informačných systémov napr. pre elektronickú výmenu dokumentov medzi rôznymi subjektami, v rámci ktorých je potrebné zabezpečiť: jednoznačnú identifikáciu pôvodcu dokumentu a neodmietnuteľnosť autorstva, integritu (prenášaných) dokumentov. Aplikácia D.Signer/XAdES poskytuje pre klientské aplikácie nasledujúce integračné rozhrania API:.Net API umožňuje volanie služieb komponentu D.Signer/XAdES priamo z.net prostredia, COM API wrapper nad.net API, ktorý umožňuje volanie služieb komponentu D.Signer/XAdES z iných prostredí (kontajnerov), napr. javascript. Pre interakciu s podpisovateľom aplikácia D.Signer/XAdES poskytuje GUI rozhranie, v rámci ktorého je realizované: zobrazenie obsahu podpisovaných dokumentov ako aj všetkých relevantných parametrov ZEP pred spustením procedúry vytvorenia ZEP, výber kvalifikovaného certifikátu pre vytvorenie ZEP, štandardné ovládacie prvky potvrdenie procedúry vytvorenia ZEP, zrušenie procedúry vytvárania ZEP apod. Architektúra riešenia -15/42-

16 Pre kryptografické operácie spojené s výpočtami digitálnych odtlačkov a samotného elektronického podpisu aplikácia využíva: kód knižníc Bouncy Castle Crypto, certifikované SSCD zariadenie pre generovanie kľúčových párov a vytváranie elektronického podpisu, ku ktorému pristupuje pomocou CSP implementácie MS CryptoAPI Vnútorná architektúra aplikácie Funkčný pohľad Vnútorná architektúra aplikácie D.Signer/XAdES vychádza a je v súlade s funkčným komponentovým modelom dokumentu CWA14170:2004 E Security requirements for signature creation applications. Jednotlivé súčasti aplikácie D.Signer/XAdES je teda možné rozdeliť do dvoch skupín: dôveryhodné komponenty povinné komponenty zabezpečujúce základnú požadovanú funkcionalitu SCA, aplikačne závislé komponenty komponenty, ktorých existencia, architektúra a funkcionalita je aplikačne závislá. Z pohľadu funkčného komponentového modelu SCA sú v rámci aplikácie D.Signer/XAdES implementované nasledujúce dôveryhodné komponenty: SDP Signer's Document Presentation Component zabezpečuje zobrazenie podpisovaných dokumentov podpisovateľovi, SAV Signature Attributes Viewer zabezpečuje zobrazenie atribútov vytváraného ZEP podpisovateľovi, DTBSF Data To Be Signed Formatter zabezpečuje sformátovanie a transformáciu vstupných dokumentov a ďalších parametrov podpisu do kanonickej formy a vytvorenie štruktúry DTBSF, SIC Signer Interaction Component rozhranie pre interakciu medzi podpisovateľom a aplikáciou D.Signer/XAdES, DHC Data Hashing Component umožňuje vytvorenie DTBSR z DTBSF pomocou príslušnej hashovacej funkcie, Aplikácia D.Signer/XAdES obsahuje nasledujúce aplikačne závislé komponenty všeobecnej architektúry SCA: SDOC Signed Data Object Composer modul pre vytvorenie dokumentu elektronického podpisu vo formáte XAdES_ZEP zo vstupných dokumentov, ďalších vstupných parametrov, DTBSF a vypočítanej hodnoty elektronického podpisu, Medzi ďalšie implementované súčasti komponentu D.Signer/XAdES patria: Config Reader modul pre načítanie konfiguračných údajov aplikácie D.Signer/XAdES z MS Windows Registry, Nasledujúce komponenty netvoria súčasť aplikácie D.Signer/XAdES: Architektúra riešenia -16/42-

17 SAC Signer's Authentication Component umožňuje autentifikáciu podpisovateľa pre použitie SSCD zariadenia, je realizovaný v rámci CSP príslušného certifikovaného SSCD zariadenia, SSA SCDev/SCA Authenticator voliteľný modul pre vytvorenie dôveryhodnej cesty medzi aplikáciou D.Signer/XAdES a SSCD, je realizovaný v rámci CSP príslušného certifikovaného SSCD zariadenia, SSC SCDev/SCA Communicator rozhranie pre komunikáciu medzi aplikáciou D.Signer/XAdES a SSCD, je realizovaný v rámci CSP príslušného certifikovaného SSCD zariadenia, SDC Signer's Document Composer umožňuje podpisovateľovi vytvoriť podpisované dokumenty, bude realizovaný v rámci klientskej aplikácie, SLC Signature Logging Component. zabezpečuje vytváranie auditných záznamov o činnosti aplikácie D.Signer/XAdES, voliteľný komponent nie je realizovaný, SHI SCDev Holder Indicator umožňuje zobraziť meno vlastníka SCDev (SSCD) zariadenia, voliteľný komponent nie je realizovaný. Aplikácia D.Signer/XAdES umožňuje vytváranie ZEP nad komplexnými dátovými štruktúrami, ktoré môžu zahŕňať rôzne typy dátových objektov (XML, PDF, atď.), pričom aplikácia musí byť schopná rozširovania podpory pre nové typy dátových objektov a jej architektúra musí byť prísne komponentová tak, aby v rámci cieľového prostredia mohli byť nasadené len komponenty (pluginy) s podporou pre relevantné typy dátových objektov. Z pohľadu rozdelenia funkcionality SCA do samostatných modulov, ktoré je možné pri nasadení aplikácie D.Signer/XAdES kombinovať podľa požiadaviek zákazníka, bude aplikácia tvorená nasledujúcimi komponentami: D.Signer/XAdES Main hlavný modul: poskytuje integračné API pre klientské aplikácie, spracovanie tých parametrov vytvorenia ZEP, ktoré nie sú závislé na typoch podpisovaných dátových objektov, poskytuje hlavné prezentačné GUI pre podpisovateľa, má na starosti vytvorenie ZEP a formátu podpisu podľa profilu XAdES_ZEP, pre svoju činnosť využíva rozhranie pluginov pre jednotlivé typy dátových objektov (vizualizácia, vytvorenie príslušných DTBSF apod.), pluginy pre jednotlivé typy dátových objektov poskytujú funkcie: pre spracovanie tých parametrov vytvorenia ZEP, ktoré sú závislé od typu podpisovaného dátového objektu, pre vytvorenie dátových objektov pre podpisované dáta a príslušné verifikačné parametre, Architektúra riešenia -17/42-

18 pre vytvorenie príslušných XML štruktúr pre jednotlivé spracovávané dátové objekty v rámci vytváraného ZEP podľa profilu XAdES_ZEP, pre vizualizáciu daného typu dátového objektu, D.Signer/XAdES Core poskytuje funkcie, ktoré sú spoločné pre hlavnú aplikáciu a jednotlivé pluginy (kanonikalizácia XML, výpočet digitálnych odtlačkov apod.) Na nasledujúcom obrázku je zobrazená bloková schéma dekompozície aplikácie D.Signer/XAdES na jednotlivé popísané súčasti a tok informácií medzi jednotlivými komponentami aplikácie. Elektronické dokumenty (XML, PDF, TIFF) + ďalšie parametre podpisu Podpísaný elektronický dokument vo formáte XAdES_XML + návratový kód D.Signer/XAdES SDP & SAV DTBS Formatted DTBS SIC Podpísaný elektronický dokument vo formáte XAdES_XML SDP/SAV pre XML SDP/SAV pre PDF... SDP/SAV pre TIFF DTBS Formatted DTBSF (využíva DTBSF pre jednotlivé typy dátových objektov) Config Reader DHC DTBSR DTBSR SDOC (využíva subkomponenty pre jednotlivé typy dátových objektov) Hodnota elektronického podpisu konfiguračné údaje v MS Windows Registry SSCD CSP (SAC,SSC,SSA) SSCD HW Pohľad na vrstvy architektúry Na nasledujúcom obrázku je zobrazený pohľad na jednotlivé vrstvy architektúry aplikácie, ktorá využíva služby vytvárania ZEP aplikácie D.Signer/XAdES, a postavenie komponentu D.Signer/XAdES v rámci tejto architektúry. Architektúra riešenia -18/42-

19 Business aplikácia Aplikačná vrstva D.Signer/XAdES D.Signer/ XAdES Main (+Core) D.Signer/XAdES XML Plugin D.Signer/XAdES PDF Plugin D.Signer/XAdES RTF Plugin MS.Net Libs MS.Net Framework Runtime MS Crypto API MS Windows CSP SSCD D.Signer/XAdES poskytuje integračné API rozhranie pre aplikačnú vrstvu, teda pre aplikácie, ktoré potrebujú vytvárať ZEP. Pre svoju činnosť využíva knižnice prostredia MS.Net Framework Runtime a prostredníctvom nich pristupuje k MS Windows API a implementácii CSP príslušného SSCD zariadenia. Architektúra riešenia -19/42-

20 6. Popis činnosti aplikácie Aplikácia (modul) D.Signer/XAdES bude nasadená ako súčasť klientských systémov a aplikácií, v rámci ktorých je potrebné implementovať vytváranie ZEP. Ak chce klientská aplikácia využívať služby modulu D.Signer/XAdES, musí vytvoriť jeho inštanciu. V rámci vytvorenia inštancie modulu prebehne zároveň jeho inicializácia (pozri ďalej). Následne môže klientská aplikácia pomocou metód integračného API predať modulu D.Signer/XAdES vstupné dokumenty a ďalšie parametre, potrebné pre vytvorenie ZEP. Výsledok procesu vytvorenia ZEP je klientskej aplikácii prístupný cez návratové premenné modulu D.Signer/XAdES: ErrorMessage a SignedXmlWithEnvelope. Činnosť aplikácie (modulu) D.Signer/XAdES pre vytváranie ZEP je možné popísať nasledovne: po vytvorení inštancie modulu D.Signer/XAdES klientskou aplikáciou modul načíta na základe svojich konfiguračných dát z MS Windows Registry zoznam nainštalovaných pluginov D.Signer/XAdES pre typy dátových objektov, klientská aplikácia ďalej vytvorí inštancie jednotlivých pluginov pre požadované dátové typy a pomocou volaní metód pluginov CreateObject vytvorí príslušné dátové objekty pre jednotlivé vstupné dokumenty, ktoré majú byť podpísané, následne klientská aplikácia zavolá pre jednotlivé vytvorené dátové objekty metódu hlavného modulu addobject, ktorá pridá jednotlivé vstupné dátové objekty do kolekcie dátových objektov na podpísanie (DTBS), keď sú pripravené všetky dátové objekty na podpis, klientská aplikácia zavolá metódu Sign hlavného modulu, ktorá vykoná validáciu vstupných dokumentov a ich spracovanie v rámci jednotlivých pluginov na DTBSF (aplikovanie príslušných transformácií, napr. kanonikalizácia) zobrazí sa hlavné okno aplikácie D.Signer/XAdES, pričom vizualizácia jednotlivých podpisovaných dátových objektov je realizovaná prostredníctvom príslušných funkcií pluginov pre jednotlivé typy dátových objektov, používateľ má možnosť si cez GUI aplikácie D.Signer/XAdES prezrieť podpisované dátové objekty a ďalšie parametre podpisu, v ďalšom kroku používateľ vyberie pomocou GUI podpisový certifikát, po výbere certifikátu, modulu pripraví vstupné dáta (ds:signedinfo) pre výpočet DTBSR a sprístupní objekt zvoleného poskytovateľa pre výpočet digitálneho odtlačku, Popis činnosti aplikácie -20/42-

21 v ďalšom kroku prebehne autentifikácia používateľa pre použitie príslušného SSCD zariadenia, na ktorom je uložený privátny kľúč pre zvolený podpisový certifikát. Autentifikácia prebehne podľa nastavení daného zariadenia, 2 ak je autentifikácia pre použitie SSCD úspešná, SSCD vypočíta a vráti modulu D.Signer/XAdES hodnotu elektronického podpisu, modul D.Signer/XAdES následne algoritmicky overí hodnotu elektronického podpisu pomocou kódu z knižníc Bouncy Castle Crypto, čím sa zároveň overí dôveryhodná cesta medzi D.Signer/XAdES a SSCD, modul D.Signer/XAdES nakoniec vytvorí XML štruktúru podľa profilu XAdES_ZEP a uloží ju do návratovej premennej SignedXmlWithEnvelope, v prípade, že došlo pri vytváraní ZEP k chybe, modul D.Signer/XAdES nastaví návratovú premennú ErrorMessage (hodnota návratovej premennej SignedXmlWithEnvelope bude nastavená na prázdny reťazec), používateľ následne potvrdí (tlačidlo OK) alebo zruší (tlačidlo Zrušiť) vytvorenie ZEP a modul D.Signer/XAdES vráti riadenie klientskej aplikácii. Klientská aplikácia môže následne získať informáciu o výsledku vytvorenia ZEP pomocou modulu D.Signer/XAdES a samotný ZEP z návratových premenných komponentu ErrorMessage a SignedXmlWithEnvelope. 2 Nastavenia SSCD (napr. timeout pre PIN, dĺžka PIN apod.) sú v správe používateľa SSCD zariadenia. Aplikácia D.Signer/XAdES neumožňuje meniť tieto nastavenia. Popis činnosti aplikácie -21/42-

22 7. Integrácia s klientskými aplikáciami Funkcionalita SCA je v rámci aplikácie D.Signer/XAdES rozdelená do samostatných modulov, ktoré je možné pri nasadení aplikácie kombinovať podľa požiadaviek zákazníka. Aplikáciu D.Signer/XAdES tvorí sada DLL knižníc, ktoré poskytujú pre klientské aplikácie nasledujúce integračné rozhrania:.net API pre.net aplikácie, COM API wrapper nad.net API pre iné ako.net aplikácie, COM API (prostredníctvom ATL knižnice) wrapper nad COM API (primárne pre Internet Explorer). Aby bolo možné postupne budovať podporu pre ďalšie typy dátových objektov, medzi hlavným modulom D.Signer/XAdES a pluginmi je navrhnuté abstraktné API, ktoré musí každý plugin implementovať. Hlavný modul komunikuje s jednotlivými pluginmi prostredníctvom tohto rozhrania. Každý plugin musí navyše definovať triedu pre typ dátového objektu, pre ktorý je určený. Metódy a atribúty tejto triedy sú závislé na type dátového objektu a musia byť definované v samostatnom dokumente špecifikácie daného pluginu. V nasledujúcich kapitolách sú popísané jednotlivé rozhrania Integračné API hlavnej aplikácie Net API Pre.Net aplikácie hlavný modul aplikácie DSigner/XAdES publikuje: Triedu: Ditec.Zep.DsigXades.XadesSig Metódy a premenné: void SetWindowSize(int width, int height); int Sign(string signatureid, string digestalguri, string signaturepolicyidentifier); int AddObject(object obj); string ErrorMessage { get;} string SignedXmlWithEnvelope { get;} COM API Pre iné prostredia ako.net hlavný modul aplikácie DSigner/XAdES publikuje nasledujúce COM rozhranie: Integrácia s klientskými aplikáciami -22/42-

23 ProgId: DSig.XadesSig Funkcie a premenné: HRESULT SetWindowSize([in] LONG width, [in] LONG height); long Sign ( [in] BSTR signatureid, [in] BSTR digestalguri, [in] BSTR signaturepolicyidentifier); long AddObject ( [in] VARIANT obj); [propget] BSTR ErrorMessage(); [propget] BSTR SignedXmlWithEnvelope(); COM API prostredníctvom ATL knižnice Aby bolo možné v rámci MS Internet Explorer identifikovať v rámci AddOns výrobcu aplikácie DSigner/XAdES, hlavný modul aplikácie DSigner/XAdES publikuje popísané COM rozhranie aj prostredníctvom ATL knižnice. ProgId: DSig.XadesSigAtl Funkcie a premenné: HRESULT SetWindowSize([in] LONG width, [in] LONG height); long Sign ( [in] BSTR signatureid, [in] BSTR digestalguri, [in] BSTR signaturepolicyidentifier); long AddObject ( [in] VARIANT obj); [propget] BSTR ErrorMessage(); [propget] BSTR SignedXmlWithEnvelope() ; Popis funkcií a premenných API hlavnej aplikácie SetWindowSize Nastavuje veľkosť okna aplikácie D.Signer/XAdES. Štandardná veľkosť okna aplikácie D.Signer/XAdES je 600x450 bodov. Metóda umožňuje programovo nastaviť inú veľkosť okna aplikácie. Metóda však nedovolí nastaviť veľkosť okna menšiu ako 450x350 bodov a väčšiu ako je rozlíšenie obrazovky používateľa. Parametre: width šírka okna aplikácie D.Signer/XAdES v obrazových bodoch height výška okna aplikácie D.Signer/XAdES v obrazových bodoch, Sign Metóda Sign spúšťa samotnú procedúru vytvorenia ZEP. Pri zavolaní metódy Sign sa vykonajú nasledujúce činnosti: zobrazenie GUI aplikácie D.Signer/XAdES, spracovanie a vizualizácia všetkých dátových objetov, ktoré boli pridané do kolekcie dátových objektov na podpis, pomocou funkcií príslušných pluginov pre príslušné typy dátových objektov, spracovanie a vizualizácia ostatných parametrov vytvárania ZEP (napr. verifikačných údajov), Integrácia s klientskými aplikáciami -23/42-

24 umožnenie výberu podpisového certifikátu, po výbere podpisového certifikátu používateľom spustenie procedúry pre výpočet hodnoty eletronického podpisu, matematické overenie elektronického podpisu pomocou kódu z knižníc Bouncy Castle Crypto, vytvorenie XML štruktúry ZEP podľa profilu XAdES_ZEP. Tvorca klientskej aplikácie, v rámci ktorej je D.Signer/XAdES integrovaný musí zabezpečiť, že Sign bude volaná s parametrom, ktorý zodpovedá algorimu digitálneho odtlačku, ktorý sa nachádza v rámci ETSI SR a je schválený v rámci vyhlášky NBÚ č. 537/2002 Z.z. Parametre: signatureid XML Id daného objektu v rámci výslednej XML štruktúry podľa XAdES_ZEP, povolené znaky: a..z, A..Z, 0..9,. (bodka), - (pomlčka), _ (podčiarkovník), digestalguri identifikátor požadovaného digest algoritmu pre výpočet hodnôt odtlačkov: SHA, SHA1, SHA-1 sig#sha1 SHA256, SHA /04/xmlenc#sha256 SHA384, SHA SHA512, SHA signaturepolicyidentifier identifikátor podpisovej politiky AddObject Umožňuje pridať dátový objekt vytvorený pomocou metódy CreateObject príslušného pluginu pre daný dátový typ do kolekcie dátových objektov určených na podpis ErrorMessage V prípade výskytu chyby v rámci procesu vytvárania ZEP bude obsahovať príslušnú chybovú správu SignedXmlWithEnvelope V prípade úspešného vytvorenia ZEP bude obsahovať výslednú XML štruktúru podľa profilu XAdES_ZEP Integračné API pluginu Net API Pre.Net aplikácie musí každý plugin aplikácie DSigner/XAdES publikovať: Integrácia s klientskými aplikáciami -24/42-

25 Triedu: <názov_triedy_pluginu> kde <názov_triedy_pluginu> je skutočný názov triedy, napr. Ditec.Zep.DsigXades.Plugins. XmlPlugin Metódy a premenné: object CreateObject(<parametre>); string ErrorMessage { get;} kde <parametre> sú skutočné parametre metódy CreateObject pre daný typ dátového objektu. Parametre tejto metódy sú závislé na type dátového objektu, pre ktorý je plugin určený a musia byť definované v samostatnom dokumente špecifikácie daného pluginu COM API Pre iné prostredia ako.net musí každý plugin aplikácie DSigner/XAdES publikovať nasledujúce COM rozhranie: ProgId: <progid> kde <progid> je programový identifikátor príslušného COM objektu, napr. DSig.XmlPlugin. Funkcie a premenné: VARIANT CreateObject ( <parametre> ); [propget] BSTR ErrorMessage(); kde <parametre> sú skutočné parametre funkcie CreateObject pre daný typ dátového objektu, odvodené pre COM prostredie z parametrov tej istej funkcie pre.net prostredie COM API prostredníctvom ATL knižnice Plugin aplikácie DSigner/XAdES musí publikovať popísané COM rozhranie aj prostredníctvom ATL knižnice. ProgId: <progid> kde <progid> je programový identifikátor príslušného ATL COM objektu, napr. DSig.XmlPluginAtl. Funkcie a premenné: VARIANT CreateObject ( <parametre> ); [propget] BSTR ErrorMessage(); kde <parametre> sú skutočné parametre funkcie CreateObject pre daný typ dátového objektu, odvodené pre ATL COM prostredie z parametrov tej istej funkcie pre COM prostredie. Integrácia s klientskými aplikáciami -25/42-

26 Dokument Používateľská príručka Popis funkcií a premenných API pluginu CreateObject Umožňuje vytvoriť dátový objekt pre daný dátový typ. Parametre tejto metódy sú závislé na type dátového objektu, pre ktorý je plugin určený a musia byť definované v samostatnom dokumente špecifikácie daného pluginu ErrorMessage V prípade výskytu chyby v rámci procesu vytvárania dátového obsahovať príslušnú chybovú správu. objektu bude 7.3. Integračné API komponentu D.Signer/XAdES XML Plugin Net API Pre.Net aplikácie XML Plugin pre aplikáciu D.Signer/XAdES publikuje: Triedu: Ditec.Zep.DSigXades.Plugins. XmlPlugin Metódy a premenné: object CreateObject ( string objectid, string objectdescription, string sourcexml, string sourcexsd, string namespaceuri, string xsdreference, string sourcexsl, string xslreference ); string ErrorMessage { get;} COM API Pre iné prostredia ako.net XML Plugin pre aplikáciu D.Signer/XAdES publikuje nasledujúce COM rozhranie: Integrácia s klientskými aplikáciami -26/42-

27 ProgId: <DSig.XmlPlugin> Funkcie a premenné: VARIANT CreateObject ( [in] BSTR objectid, [in] BSTR objectdescription, [in] BSTR sourcexml, [in] BSTR sourcexsd, [in] BSTR namespaceuri, [in] BSTR xsdreference, [in] BSTR sourcexsl, [in] BSTR xslreference ); [propget] BSTR ErrorMessage(); COM API prostredníctvom ATL knižnice Aby bolo možné v rámci MS Internet Explorer 7 identifikovať v rámci AddOns výrobcu pluginu pre daný typ dátových objektov, XML Plugin pre aplikáciu DSigner/XAdES publikuje popísané COM rozhranie aj prostredníctvom ATL knižnice. ProgId: <DSig.XmlPluginAtl> Funkcie a premenné: VARIANT CreateObject ( [in] BSTR objectid, [in] BSTR objectdescription, [in] BSTR sourcexml, [in] BSTR sourcexsd, [in] BSTR namespaceuri, [in] BSTR xsdreference, [in] BSTR sourcexsl, [in] BSTR xslreference ); [propget] BSTR ErrorMessage(); Popis funkcií a premenných API pluginu CreateObject Umožňuje vytvoriť dátový objekt typu XML dokument pre aplikáciu D.Signer/XAdES. Parametre: objectid XML Id daného objektu v rámci výslednej XML štruktúry podľa XAdES_ZEP, povolené znaky: a..z, A..Z, 0..9,. (bodka), - (pomlčka), _ (podčiarkovník), objectdescription popis obsahu daného XML objektu, napr: "DPPO 2007", Integrácia s klientskými aplikáciami -27/42-

28 sourcexml samotný vstupný XML dokument, sourcexsd XML schéma pre vstupný XML dokument, namespaceuri namespace URI vstupného XML dokumentu, xsdreference URI referencia XML schémy, sourcexsl XSL transformácia vstupného XML dokumentu do plain textu, xslreference URI referencia XSL transformácie ErrorMessge V prípade výsytu chyby v rámci procesu vytvárania dátového objektu typu XML dokument bude obsahovať príslušnú chybovú správu Abstraktné API pre pluginy Každý plugin, ktorý má byť integrovaný ako súčasť aplikácie D.Signer/XAdES musí implementovať nasledujúce abstraktné API. Integrácia s klientskými aplikáciami -28/42-

29 public interface IPlugin { /// <summary> /// get visualizationm control /// </summary> /// <returns>< /returns> Control GetVisualizer(); /// <summary> /// get error message /// </summary> string ErrorMessage {get;} /// <summary> /// set object data /// </summary> /// <param name="data"></param> bool SetData(object data, Core.DigestAlgs hashalg); /// <summary> /// get full type name of data object /// </summary> string TypeName { get;} /// <summary> /// get version of plugin /// </summary> string PluginVersion { get;} /// <summary> /// get objectid of data object /// </summary> string GetObjectId(object data); /// <summary> /// get objectdescription of data object /// </summary> string GetObjectDescription(object data); /// <summary> /// get string array of objects /// </summary> /// <returns>list of objects, or empty list</returns> List<string> GetDSObjects(); /// <summary> /// get sring array of manifests /// </summary> /// <returns>list of Manifests, or empty list</returns> List<string> GetDSManifests(); /// <summary> /// get string array of dataobjectformat /// </summary> /// <returns>list of DataObjectFormats, or empty list</returns> List<string> GetXadesDataObjectFormats(); Integrácia s klientskými aplikáciami -29/42-

30 } /// <summary> /// get sring array of references /// </summary> /// <returns>list of References, or empty list</returns> List<string> GetDSReferences(); Trieda, ktorá implementuje definované abstraktné rozhranie, musí mať zároveň definovaný nasledujúci atribút: [AttributeUsage(AttributeTargets.Class)] public class PluginDescriptionAttribute : Attribute { public PluginDescriptionAttribute(string description) { this.description = description; } priv ate string description; } public string Description { get { return this.description; } set { this.description = value; } } Popis metód abstraktného API pre pluginy GetVisualizer Vráti GUI ovládač pre vizualizáciu dát a verifikačných parametrov pre daný typ dátového objektu (typu Control) ErrorMessage V prípade výskytu chyby v rámci vykonávania metódy pluginu bude obsahovať príslušnú chybovú správu (typu string) SetData Pridá dátový objekt do kolekcie dátových objektov na podpis, spracuje dátový objekt (aplikovanie príslušných transformácií, vytvorenie DTBSF). V prípade úspechu vráti true, inak false. Parametre: data dátový objekt (typ object), hashalg algoritmus pre výpočet digitálneho odtlačku (typ Core.DigestAlgs) TypeName Vráti úplný názov dátového objektu pre dáta a verifikačné parametre pre daný dátový typ (typu string). Integrácia s klientskými aplikáciami -30/42-

31 PluginVersion Vráti informáciu o verzii pluginu (typu string) GetObjectId Vráti objectid (typu string) príslušného dátového objektu data. Parametre: data dátový objekt (typ object) GetObjectDescription Vráti objectdescription (typu string) príslušného dátového objektu data. Parametre: data dátový objekt (typ object) GetDSObjects Vráti zoznam XML štruktúr (typu List<string>) ds:object pre jednotlivé dátové objekty a príslušné verifikačné údaje z kolekcie dátových objektov daného typu, ktoré sú určené na podpis, podľa profilu XAdES_ZEP GetDSManifests Vráti zoznam XML štruktúr (typu List<string>) ds:manifest pre jednotlivé dátové objekty a príslušné verifikačné údaje z kolekcie dátových objektov daného typu, ktoré sú určené na podpis, podľa profilu XAdES_ZEP GetXadesDataObjectFormats Vráti zoznam XML štruktúr (typu List<string>) xades:dataobjectformat pre jednotlivé dátové objekty a príslušné verifikačné údaje z kolekcie dátových objektov daného typu, ktoré sú určené na podpis, podľa profilu XAdES_ZEP GetDSReferences Vráti zoznam XML štruktúr (typu List<string>) ds:reference do ds:signedinfo pre jednotlivé dátové objekty a príslušné verifikačné údaje z kolekcie dátových objektov daného typu, ktoré sú určené na podpis, podľa profilu XAdES_ZEP Príklad použitia Nasledujúci kód znázorňuje vytvorenie a použitie komponentu D.Signer/XAdES a pluginu pre dátový typ XML dokument v rámci HTML stránky webovej aplikácie v jazyku JavaScript. function btnsign() { var xml=createxml(); // vytvorenie vstupneho XML dokumentu var odsig=new ActiveXObject("DSig.XadesSig"); // instancia D.Signer/XAdES var oxmlplugin=new ActiveXObject("DSig.XmlPlugin"); // inst. XML pluginu Integrácia s klientskými aplikáciami -31/42-

32 // ziskanie vstupnych parametrov pre XML dokument (XML schema a XSLT) var xsd = getxsd(); var xsduri = getxsduri(); var xsl = getxsl(); var xsluri = getxsluri(); // vytvorenie vstupneho datoveho objektu pre XML dokument var obj=oxmlplugin.createobject('objectid', 'objectdesc', xml, xsd, ' xsduri, xsl, xsluri); if(obj == null) { } alert(oxmlplugin.errormessage); //chyba! return; // pridanie datoveho objektu do kolekcie objektov na podpis var addobj = odsig.addobject(obj); if(addobj!= 0) { alert(odsig.errormessage); //chyba! return; } } // spustenie vytvorenia ZEP var res= odsig.sign('signatureid', 'sha1', "urn:oid: "); if(res==0) { alert(odsig.signedxmlwithenvelope); // zobrazenie vytvoreneho ZEP } else { aler(odsig.errormessage); // chyba! } Integrácia s klientskými aplikáciami -32/42-

33 Pozor! Z uvedeného príkladu je zrejmé, že aplikácia D.Signer/XAdES nie je thread safe. Tvorca klientskej aplikácie musí zabezpečiť, že jednotlivé volania funkcií rozhrania aplikácie D.Signer/XAdES sú realizované tak, aby nedošlo k vytvoreniu elektronického podpisu nad nesprávnou kombináciou vstupných dokumentov. Integrácia s klientskými aplikáciami -33/42-

34 8. Konfigurácia aplikácie Aplikácia D.Signer/XAdES využíva nasledujúce konfiguračné parametre, ktoré sú uložené v rámci MS Windows Registry: Systémové nastavenia aplikácie D.Signer/XAdES, ktoré sú uložené v kľúčihkey_local_machine\software\ditec\dsigxades: Value Name Typ Value Data CodeBase string cesta k adresáru aplikácie D.Signer/XAdES Aplikácia D.Signer/XAdES využíva túto hodnotu pri svojej inicializácii pri načítaní zoznamu nainštalovaných pluginov pre jednotlivé dátové typy. Nastavenia podporovaných podpisových politík, ktoré sú uložené v kľúčoch: HKEY_LOCAL_MACHINE\SOFTWARE\Ditec\DSigXades\SignaturePolici es Subk ey: Názov podpisovej politiky Value Name Typ Value Data Identifier string Identifikátor podpisovej politiky, napr. "urn:oid: " DigestAlgUri string Identifikátor algoritmu pre výpočet odtlačku podpisovej politiky, napr. " DigestValue string Hodnota odtlačku podpisovej politiky kódovaná do base64, napr. "L46aPtnrjmOk2g6AuxsUrWlNCh8=" NotBefore string Dátum a čas začiatku platnosti podpisovej politiky, napr. " T01:01:00Z" NotAfter string Dátum a čas konca platnosti podpisovej politiky, napr. " T01:01:01Z" URL string URL, na ktorom je možné overiť, či podpisová politika nebola predčasne zrušená, napr. " Aplikácia využíva tieto nastavenia pri vytváraní elementu xades:signaturepolicyidentifier v rámci štruktúry XAdES_ZEP-EPES. Informácie o použitej podpisovej politike sú používateľovi zobrazené v rámci GUI okno Parametre podpisu (pozri kapitolu 9.4). Konfigurácia aplikácie -34/42-

35 9. Vytvorenie ZEP používateľom 9.1. Načítanie vstupných parametrov Po zavolaní metódy Sign pre vytvorenie elektronického podpisu, aplikácia D.Signer/XAdES vykoná validáciu vstupných parametrov (teda jednotlivých podpisovaných častí multipart dokumentu) a zobrazí hlavné dialógové okno aplikácie. Spracovanie vstupných parametrov, najmä rozsiahlych dokumentov, môže vyžadovať istý čas, počas ktorého je zobrazený tzv. splash screen Zobrazenie podpisovaných dát Pokiaľ všetky kontroly vstupných parametrov prebehli úspešne, na jednotlivých záložkách hlavného okna sú zobrazené časti podpisovaného multipart dokumentu. Používateľ má možnosť prezrieť všetky podpisované dátové objekty a ďalšie parametre podpisu. Pozor! Do ZEP sú zahrnuté všetky zobrazované dátové objekty (dokumenty) a parametre elektronického podpisu. Vzhľadom k tomu, že vytvorením ZEP používateľ vyjadruje svoj súhlas s obsahom jednotlivých dokumentov, je v jeho záujme, aby sa dôkladne oboznámil s obsahom všetkých zobrazených dátových objektov. Vytvorenie ZEP používateľom -35/42-

36 Pokiaľ sa vyskytli pri kontrole vstupných parametrov chyby, aplikácia D.Signer/XAdES zobrazí chybovú správu. V takomto prípade sa tiež zobrazí hlavné okno aplikácie D.Signer/XAdES, ale nebude možné uskutočniť vytvorenie podpisu (tlačidlo Podpísať bude neprístupné). Vytvorenie ZEP používateľom -36/42-

37 V rámci hlavného okna aplikcácie D.Signer/XAdES je tiež zobrazený stav podpisovaného dokumentu, ktorý môže nadobúdať nasledujúce hodnoty: Dokument nie je podpísaný Dokument bol podpísaný V závislosti od stavu dokumentu sú jednotlivé tlačidlá hlavného okna aplikácie D.Signer/XAdES prístupné alebo neprístupné. Aplikácia D.Signer/XAdES slúži na vytváranie (zaručeného) elektronického podpisu nad množinou rôznych formátov dokumentov, resp. typov dát ( XML dokumenty, PDF dokumenty atď.), prípadne nad ľubovoľnou kombináciou podporovaných formátov dát, ktoré spolu vytvárajú tzv. multipart dokument. Pre jednotlivé požadované formáty dokumentov musí mať používateľ nainštalované príslušné plugin moduly aplikácie D.Signer/XAdES. Informácia o nainštalovaných plugin moduloch je používateľovi prístupná prostredníctvom tlačidla "O aplikácii" (pravý horný roh okna aplikácie D.Signer/XAdES). Vytvorenie ZEP používateľom -37/42-

38 Zobrazenie XML dokumentov Zobrazenie XML dokumentov je realizované v rámci aplikácie D.Signer/XAdES pomocou XML pluginu, ktorý poskytuje aplikácii D.Signer/XAdES funkcie pre vizualizáciu štruktúrovaných XML dát v čitateľnej textovej forme plain text. Transformácia XML dát do plain textu je realizovaná pomocou tzv. XML transformácie, pričom pôvodné dáta zostávajú nezmenené. Samotná XML transformácia (čiže predpis pre zobrazenie XML dát) tvorí pritom takisto jeden z podpisovaných parametrov. Vytvorenie ZEP používateľom -38/42-

39 Vizualizačný komponent XML pluginu poskytuje používateľovi nasledujúce funkcie: Zalomiť text umožňuje zalomiť zobrazenie príliš širokého textu na okna, šírku Xml dáta zobrazí v samostatnom okne pôvodné (netransformované) XML dáta, Verifikačné dáta zobrazí podpisované atribúty (parametre) XML dát, t.j. XML schému pre validáciu podpisovaných XML dát, XML transformáciu pre zobrazenie podpisovaných XML dát v plain texte Podpísanie dokumentu V prípade úspešného načítania všetkých častí podpisovaného dokumentu je prístupné tlačidlo Podpísať, ktoré aktivuje proces vytvorenia elektronického podpisu dokumentu. Prvým krokom procesu vytvorenia podpisu je výber certifikátu, ktorým bude daný dokument podpísaný. Na nasledujúcom obrázku je znázornený dialóg pre výber certifikátu podpisovateľa. V rámci zoznamu osobných certifikátov na danom PC sú zobrazené položky: meno subjektu, pre ktorý bol certifikát vydaný, meno vydavateľa certifikátu, Vytvorenie ZEP používateľom -39/42-

40 dátum konca platnosti certifikátu. Detaily zvoleného certifikátu je možné prezrieť stlačením tlačidla Zobraziť certifikát. Po zvolení certifikátu a potvrdení výberu tlačidlom OK sa vykoná proces vytvorenia elektronického podpisu. Aplikácia D.Signer/XAdES vytvorí reprezentáciu podpisovaných dát a parametrov podpisu digitálny odtlačok. Pomocou rozhrania MS CryptoAPI a príslušného SSCD zariadenia, na ktorom je uložený privátny kľúč patriaci k zvolenému podpisovému certifikátu, vytvorí hodnotu elektronického podpisu. Sprístupnenie privátneho kľúča na SSCD zariadení môže vyžadovať autentifikáciu používateľa zadanie PINu. 3 Aplikácia D.Signer/XAdES následne vytvorí a sformátuje výstupný podpísaný dokument v súlade s profilom XAdES_ZEP. V prípade chyby v rámci procesu vytvorenia podpisu sa zobrazí príslušné chybové hlásenie. Ak sa dokument podarilo podpísať, v hlavnom okne sa zmení stav dokumentu a niektorých tlačidiel (sprístupnia sa tlačidlá tých funkcií, ktoré je možné vykonať len nad podpísaným dokumentom). 3 Nastavenia SSCD (napr. timeout pre PIN, dĺžka PIN apod.) sú v správe používateľa SSCD zariadenia. Aplikácia D.Signer/XAdES neumožňuje meniť tieto nastavenia. Vytvorenie ZEP používateľom -40/42-

41 Po úspešnom vytvorení elektronického podpisu je podpísaný odovzdaný klientskej aplikácii až po stlačení tlačidla OK. dokument 9.4. Zobrazenie parametrov podpisu Používateľ, resp. podpisovateľ si môže pred alebo po podpísaní dokumentu zobraziť parametre podpisu (ikona s ozubeným kolieskom v hornej časti). V prípade ich zobrazenia pred vytvorením podpisu, resp. po vymazaní podpisu (tlačidlo Zmazať podpis s ikonou s červeným krížikom v hornej časti okna), zobrazené informácie nebudú úplné, pretože niektoré z nich sú závislé na výbere podpisového certifikátu. Na nasledujúcom obrázku je zobrazené dialógové okno s parametrami podpisu po podpísaní dokumentu. K dispozícii sú všetky tlačidlá, ako aj informácie o podpisovom certifikáte, podpisovej politike, použitých kryptografických algoritmoch a vypočítaných hodnôt odtlačkov, ako aj samotná hodnota vytvoreného podpisu. V prípade, že podpis je z nejakého dôvodu potrebné zrušiť, tak je toto umožnené kliknutím na ikonu s červeným krížikom v hornej časti Zrušiť vytvorený podpis a uviesť aplikáciu do východzieho stavu. Vytvorenie ZEP používateľom -41/42-

42 Vytvorenie ZEP používateľom -42/42-