MojeID: Pravidla motivačního programu pro poskytovatele služeb

MojeID: Pravidla motivačního programu pro poskytovatele služeb V platnosti od 1. 3. 2015 1 Vyhlašovatel CZ.NIC, z. s. p. o. Milešovská 5, 130 00 Praha 3 IČ: 67985726 DIČ: CZ67985726 Zapsáno ve spolkovém rejstříku vedeném u Městského soudu v Praze, sp. zn. L 58624 2 Vymezení pojmů Služba: je otevřený decentralizovaný a svobodný systém pro správu elektronické identity Uživatelů umožňující používání jednotných identifikačních údajů pro přístup k různým informačním systémům provozovaným různými Poskytovateli. Poskytovatel: fyzická nebo právnická osoba provozující systémy, do nichž umožňuje vstup třetím osobám s využitím Služby. Uživatel: fyzická nebo právnická osoba, která užívá Službu. Registr identit: informační systém provozovaný Vyhlašovatelem, který obsahuje údaje o Kontaktech. Registr identit může být spojen s centrálním registrem, který Vyhlašovatel provozuje jako databázi o doménových jménech, jejich držitelích a dalších osobách, případně může být s centrálním registrem identický. Pojmy zde neuvedené mají význam zejména dle Pravidel poskytování služby mojeid pro koncové uživatele či Podmínek užití služby mojeid pro přihlášení k systémům poskytovatelů. 3 Předmět a účel motivačního programu Za účelem rozšiřování počtu Uživatelů Služby a s přihlédnutím ke skutečnosti, že jedním z účelů služby mojeid je rovněž zvyšování správnosti, přesnosti a úplnosti údajů uživatelů, kteří užívají Službu a jsou či mohou být držiteli doménového jména registrovaného v cctld.cz, a že Uživatelé Služby, jejichž údaje byly ověřeny, mohou více zabezpečit své osobní údaje, neboť poštovní adresa Kontaktu, jehož údaje byly ověřeny, může být skryta, se Vyhlašovatel zavazuje za podmínek určených těmito mojeid: Pravidly motivačního programu pro poskytovatele služeb (dále jen tato Pravidla ) odměnit ty Poskytovatele, kteří zavedou ve svých systémech používání Služby, umožní svým uživatelům založení účtu mojeid (uživatelského účtu Služby), a to pomocí údajů, které příslušný uživatel má již uloženy v systému Poskytovatele a které budou převedeny do Registru identit a u nichž jejich Uživatel provede plnou identifikaci či validaci. Pro účely plnění Vyhlašovatele dle těchto pravidel se založeným účtem mojeid rozumí účet mojeid identifikovaný nebo podmíněně identifikovaný dle čl. 3.3. Pravidel poskytování služby CZ.NIC, z. s. p. o. IČ 67985726 T +420 222 745 111 kontakt@nic.cz Milešovská 5, 130 00 Praha 3 DIČ CZ67985726 M +420 731 657 660 www.nic.cz 1/5

mojeid pro koncové uživatele, plně identifikovaným se rozumí účet mojeid, který byl ověřen prostřednictvím jednorázového hesla zaslaného třemi různými kanály (PIN 1, PIN 2 i PIN3) a validovaným účtem se rozumí účet, u něhož byla jednoznačně ověřena totožnost Uživatele, a to některým ze způsobů dle čl. 3.4. Pravidel poskytování služby mojeid pro koncové uživatele. 4 Podmínky účasti v programu Programu se může zúčastnit pouze takový Poskytovatel, který má s Vyhlašovatelem uzavřenou Smlouvu o užití služby mojeid pro přihlášení k systémům poskytovatele, zavede Službu do svých systémů tak, že taková aplikace bude splňovat požadavky dle přílohy č. 1 těchto Pravidel, bude předávat data svých uživatelů speciálním rozhraním dle přílohy č. 2 těchto Pravidel. Náklady spojené s účastí v programu nese Poskytovatel, který nemá nárok na jejich úhradu ani v případě předčasného ukončení programu. 5 Práva a povinnosti 5.1 Poskytovatel Poskytovatel je oprávněn uspořádat na vlastní náklady komunikační kampaň směrem ke svým uživatelům tak, aby je motivoval k zakládání uživatelských účtů Služby; rozsah i forma této kampaně je libovolná a závisí na uvážení a možnostech každého Poskytovatele; na žádost poskytne Vyhlašovatel Poskytovateli sadu komunikačních materiálů (text, grafika a podobně), které bude moci Vyhlašovatel za tímto účelem použít; každá komunikační kampaň či jiná aktivita, jejímž účelem je také motivace uživatelů k zakládání uživatelských účtů Služby podléhá předchozímu schválení Vyhlašovatelem; Poskytovatel nesmí provádět zakládání uživatelských účtů Služby bez vědomí a souhlasu svých uživatelů. Poskytovatel je povinen upozornit Uživatele na předání údajů účtu Uživatele u Poskytovatele do uživatelského účtu služby mojeid; Poskytovatel není oprávněn vyhlásit vlastní provizní (affiliate) program, jehož účel je, byť jen zčásti, shodný s účelem tohoto motivačního programu či vede ke stejnému výsledku, tedy umožnění uživatelům založit si uživatelský účet Služby, a na jehož základě by Poskytovatel vyplácel finanční plnění, poskytoval věci, služby či jiné penězi ocenitelné hodnoty třetím osobám zprostředkovatelům, pro něž je proviní program Poskytovatele určen. 5.2 Vyhlašovatel Vyhlašovatel je oprávněn v průběhu programu provádět vlastní komunikační aktivity spojené se Službou CZ.NIC, z. s. p. o. IČ 67985726 T +420 222 745 111 kontakt@nic.cz Milešovská 5, 130 00 Praha 3 DIČ CZ67985726 M +420 731 657 660 www.nic.cz 2/5

6 Finanční odměny, podmínky a způsob jejich vyplácení 6.1 Výše finančních odměn 6.1.1. Za každý založený uživatelský účet Služby, který bude založen prostřednictvím údajů uložených v systému Poskytovatele a jehož data budou předána v souladu s ustanoveními těchto Pravidel a ověřena prostřednictvím jednorázového hesla (kódy PIN1 a PIN2) - tzv. částečná identifikace; ověření e-mailové adresy a telefonního čísla, vzniká Poskytovateli nárok na odměnu ve výši 20,-- Kč za každý takový uživatelský účet Služby; 6.1.2. Poskytovateli vzniká nárok na dodatečnou odměnu ve výši 80,-- Kč, budou-li data uživatelského účtu Služby, který byl založen a ověřen dle čl. 6.1.1., ověřena i prostřednictvím kódu PIN3 (ověření poštovní adresy, tzv. plná identifikace); 6.1.3. Poskytovateli vzniká nárok na dodatečnou odměnu ve výši 100,-- Kč, budou-li data uživatelského účtu Služby, který byl založen a ověřen dle čl. 6.1.1., ověřena i prostřednictvím tzv. validace (fyzického ověření totožnosti uživatele). 6.1.4. Poskytovatel může získat finanční odměny dle těchto Pravidel v maximální výši 500.000,-- Kč (slovy: pět set tisíc korun českých) za kalendářní rok; na základě dohody Poskytovatele s Vyhlašovatelem lze tento limit navýšit, a to i opakovaně; na navýšení limitu však nemá Poskytovatel nárok, Vyhlašovatel je oprávněn požadavek na navýšení limitu odmítnout, a to i bez udání důvodu. 6.1.5. Veškeré částky dle čl. 6.1.1. až 6.1.4. jsou bez příslušné daně z přidané hodnoty. 6.2 Výplata odměn 6.2.1. Počty založených a ověřených uživatelských účtů a dosažená výše odměn se evidují za kalendářní měsíc, a to počínaje 1. 3. 2015. Každý Poskytovatel, který splní podmínky pro výplatu odměny dle čl. 6.2.2., obdrží do 6. pracovního dne následujícího kalendářního měsíce přehled s uvedením počtu založených účtů a celkovou výši dosažené odměny. 6.2.2. Odměna je vyplacena pouze Poskytovateli, jehož výše odměny za kalendářní měsíc dosáhne alespoň 1.000,-- Kč (dále jen minimální výše odměny ) a zároveň z celkového počtu založených a ověřených uživatelských účtů Služby za kalendářní měsíc bude alespoň 60 % plně identifikováno (tzn. ověřeno všemi částmi jednorázového hesla PIN1, PIN2, PIN3). Výplata je provedena výhradně na základě Poskytovatelem řádně vystaveného daňového dokladu (faktury) s třicetidenní splatností. Tento daňový doklad musí být Vyhlašovateli doručen nejpozději do 15. dne kalendářního měsíce, bezprostředně následujícího po měsíci, za který má být odměna vyplacena. Není-li daňový doklad Vyhlašovateli doručen v této lhůtě, nárok na výplatu odměny zaniká. Daňový doklad musí splňovat náležitosti vyžadované příslušnými právními předpisy, zejm. zákonem č. 235/2004 Sb., o dani z přidané hodnoty. Úhrada bude Vyhlašovatelem provedena na účet Poskytovatele zveřejněný správcem daně dle 98 zákona č. 235/2004 Sb., o dani z přidané hodnoty, a to i v případě, že na daňovém dokladu bude uveden bankovní účet jiný. Pokud Poskytovatel nemá u správce daně zveřejněn bankovní účet ve smyslu výše uvedeného ustanovení, CZ.NIC, z. s. p. o. IČ 67985726 T +420 222 745 111 kontakt@nic.cz Milešovská 5, 130 00 Praha 3 DIČ CZ67985726 M +420 731 657 660 www.nic.cz 3/5

provede Vyhlašovatel úhradu až po jeho zveřejnění, přičemž po tuto dobu není v prodlení s úhradou. Poskytovatel je povinen Vyhlašovateli uveřejnění takového bankovního účtu neprodleně oznámit. 6.2.3. Poskytovatel, který za kalendářní měsíc nedosáhne minimální výše odměny, avšak splní podmínku alespoň 60 % plně identifikovaných účtů Služby (viz čl. 6.2.2.), může uplatnit nárok na vyplacení v okamžiku, kdy této výše dosáhne součet všech doposud dosažených a nevyplacených odměn, a to daňovým dokladem doručeným Vyhlašovateli nejpozději do 15. dne kalendářního měsíce, bezprostředně následujícího po měsíci, kdy bylo minimální výše odměny dosaženo. Vždy (v každém takovém kalendářním měsíci) však musí být splněna podmínka alespoň 60 % plně identifikovaných účtů služby! Není-li daňový doklad Vyhlašovateli doručen v této lhůtě, nárok na výplatu odměny zaniká. 6.2.4. Odměny nedosahující minimální výše se nevyplácejí, a to ani po skončení programu. 7 Trvání programu Program trvá od 1. 3. 2015 do 31. 12. 2015 nebo do okamžiku, kdy jsou vyčerpány finanční prostředky vyčleněné Vyhlašovatelem pro účely výplaty finančních odměn dle těchto Pravidel, které pro dané období činí 2,5 mil. Kč (slovy: dva miliony pět set tisíc korun českých), podle toho, jaká z těchto událostí nastane dříve. 8 Způsob komunikace Komunikace mezi Poskytovatelem a Vyhlašovatelem probíhá zásadně elektronicky. Vyhlašovatel pro komunikaci s Poskytovatelem používá e-mailovou adresu uvedenou v uzavřené Smlouvě o užití služby mojeid pro přihlášení k systémům poskytovatele, případně jinou adresu sdělenou pro účely plnění dle těchto Pravidel Poskytovatelem. 9 Odpovědnost za újmu Poskytovatel odpovídá za újmu způsobenou Vyhlašovateli zejména tím, že poruší tato Pravidla. Poskytovatel zároveň bere na vědomí, že odpovědnost Vyhlašovatele za újmu se řídí příslušným ustanovením Podmínek užití služby mojeid pro přihlášení k systémům poskytovatelů, jejichž aktuální znění je k dispozici na webových stránkách Vyhlašovatele. 10 Závěrečná ustanovení 10.1 Vyhlášení programu Program se vyhlašuje prostřednictvím webové stránky Vyhlašovatele www.nic.cz a www.mojeid.cz. CZ.NIC, z. s. p. o. IČ 67985726 T +420 222 745 111 kontakt@nic.cz Milešovská 5, 130 00 Praha 3 DIČ CZ67985726 M +420 731 657 660 www.nic.cz 4/5

10.2 Ukončení programu Vyhlašovatel si ponechává právo program ze závažných důvodů i bez udání důvodu kdykoli změnit či zrušit. Změny či zrušení budou provedeny prostřednictvím webových stránek vyhlašovatele použitých pro vyhlášení programu. 10.3 Právní rámec programu Program se řídí platnými právními předpisy České republiky. Jakékoliv dodatky, výhrady, omezení či odchylky k těmto Pravidlům motivačního programu či souvisejícím dokumentům jsou vyloučeny. 11 Přílohy Příloha č. 1 Všeobecné principy podpory Služby Příloha č. 2 Technické podmínky provozu Příloha č. 3 Podmínky užití služby mojeid pro přihlášení k systémům Poskytovatele CZ.NIC, z. s. p. o. IČ 67985726 T +420 222 745 111 kontakt@nic.cz Milešovská 5, 130 00 Praha 3 DIČ CZ67985726 M +420 731 657 660 www.nic.cz 5/5

Příloha č. 1 - Všeobecné principy podpory Služby Zavedení služby mojeid do webové aplikace Poskytovatele se musí řídit následujícími pravidly: 1. Přihlášení přes mojeid probíhá bez nutnosti zadávat uživatelské jméno na straně Poskytovatele, a to pomocí některého z níže vyobrazených grafických prvků (dále jen přihlašovací tlačítka ): Sada přihlašovacích tlačítek je k dispozici na www.mojeid.cz. Použití jiných grafických prvků podléhá schválení ze strany CZ.NIC. 2. Přihlašovací tlačítko je vhodně doplněno o odkazy Proč mojeid? příp. Založit účet mojeid směřující na odpovídající text umístěný na lokální webové stránce nebo na www.mojeid.cz. 3. Pokud při přihlášení přes mojeid vyžaduje Poskytovatel předání údajů o uživateli, je v případě, že se tyto údaje liší od údajů evidovaných v lokálním účtu služby Poskytovatele, povinen dát uživateli na výběr, zda-li si přeje stávající údaje v lokálním účtu služby ponechat, nebo zda mají být aktualizovány údaji přenesenými z mojeid. 4. Všechny údaje, které jsou v systému Poskytovatele považovány za povinné a bez jejichž zadání nelze začít službu Poskytovatele používat, musí být vyžadovány jako povinné také při přihlašování prostřednictvím služby mojeid. 5. Přihlášení prostřednictvím služby mojeid nesmí být použito pouze jako prostředek pro vyplnění registračního formuláře pro běžné založení účtu v systému Poskytovatele. 6. Implementace služby mojeid musí být navržena tak, aby uživatel mojeid měl při svém prvním přístupu ke službě Poskytovatele prostřednictvím mojeid na výběr z následujících dvou možností: 6.1. spárování mojeid s existujícím lokálním účtem nebo 6.2. vytvoření nového lokálního účtu pomocí dat přenesených z mojeid a spárování tohoto nově založeného lokálního účtu s mojeid. 7. Spárování s mojeid musí být možné také v autentizovaném režimu v rámci administrace lokálního účtu. Na stejném místě musí mít uživatel možnost lokální účet a mojeid rozpárovat. CZ.NIC, z. s. p. o. Americká 23, 120 00 Praha 2 T +420 222 745 111 F +420 222 745 112 kontakt@nic.cz www.nic.cz 1/1

Technické podmínky provozu Vydáno: 1. 9. 2014

MojeID technické podmínky provozu Obsah 1 Úvod...3 2 Terminologie...4 3 Seznámení s mojeid...5 3.1 Základní principy mojeid...5 3.2 MojeID identita...5 3.3 Proces komunikace přes mojeid...6 4 Implementace podpory mojeid...8 4.1 Ustanovení asociace...8 4.2 Žádost o přihlášení přes mojeid...8 4.3 Iniciace...9 4.4 Žádost o ověření identity...10 4.5 Provedení autentizace...12 4.5.1 XRDS dokument a jeho formát...13 4.5.2 Výběr vhodné Oblasti URL poskytovatele služeb...14 4.6 Odpověď s výsledkem ověření identity...14 4.7 Ověření odpovědi...15 4.8 Zpracování odpovědi...16 4.8.1 Výsledek přihlášení...16 4.8.2 Údaje z mojeid identity...17 5 Rozhraní pro zakládání účtů mojeid...19 5.1 Žádost o založení účtu mojeid...19 5.2 Kontrola validity dat...19 5.3 Dokončení registrace...21 6 Testovací instance...22 7 Přílohy...24 7.1 Příloha č.1 Seznam údajů pro přihlášení...24 7.2 Příloha č.2 Seznam údajů pro registraci...24 7.3 Příloha č.3 Příklady a řešení chybových hlášek...24 2

MojeID technické podmínky provozu 1 Úvod Tento dokument obsahuje obecný úvod do principů a fungování služby mojeid. Naleznete zde také příklady a další obecné informace, které Vám pomohou navrhnout jakým způsobem implementovat podporu služby mojeid do Vaší webové aplikace. Získáte tak rychlý základní přehled o krocích, které bude potřeba provést při implementaci podpory mojeid a budete moci odhadnout náročnost této implementace. Na stránce https://www.mojeid.cz/page/1863/vzorove-implementace/ jsou k dispozici vzorové implementace pro některé programovací jazyky a volně ke stažení pluginy pro nejrozšířenější open source platformy. 3

MojeID technické podmínky provozu 2 Terminologie V dalších kapitolách týkajících se implementace mojeid bude používána následující terminologie: Identifikátor URL se schématem http či https, pod kterým jsou definovaná a dostupná určitá data v rámci procesu ověřování identity, např. http://specs.nic.cz/attr/contact/valid. Identita soubor dat o uživateli, které jsou vázané na identifikátor a jsou spravované poskytovatelem OpenID. Poskytovatel služeb provozovatel webové aplikace (či přeneseně samotná aplikace, protože vše je řešeno automaticky bez manuálních zásahů), která požaduje ověření uživatelovy identity pomocí mojeid. OpenID poskytovatel (OP) zřizovatel a správce OpenID identit, na jehož webu dochází k autentizaci. V případě mojeid vždy CZ.NIC. Jméno identity jméno mojeid identity ve tvaru jmeno.mojeid.cz, které uživatel uvede do přihlašovacího formuláře jako identitu, pod kterou se chce přihlásit, např. jnovakova.mojeid.cz. Prohlášený identifikátor identifikátor vzniklý ze jména identity, pod kterým je tato identita dostupná u OpenID poskytovatele a odkud lze získat metadata k tomuto identifikátoru, např. https://jnovakova.mojeid.cz/#nchflooqql. Koncový bod OP URL adresa, na které poskytovatel OpenID přijímá zprávy. V případě mojeid je to vždy https://mojeid.cz/endpoint/. 4

MojeID technické podmínky provozu 3 Seznámení s mojeid 3.1 Základní principy mojeid MojeID je služba, která dovoluje uživatelům zřídit si a centrálně spravovat svoji internetovou identitu (soubor osobních údajů, například jméno, příjmení, emailová adresa, telefon a další, doplněný o přihlašovací metody a údaje). S takovou identitou se pak uživatelé mohou přihlašovat na libovolných externích webových aplikacích (aplikací jiných poskytovatelů služeb než je poskytovatel identit), přičemž si nemusí vytvářet nové účty a opakovaně u nich vyplňovat základní informace a používat různá přihlašovací jména a hesla. Služba mojeid je konkrétní implementací standardu OpenID ve verzi 2.0 pro decentralizovanou správu internetových identit, který definuje, jak se tyto centrálně spravované identity ověřují a jak vypadají jejich identifikátory. Ofciální specifkaci OpenID protokolu naleznete na htp://openid.net/developers/specs. MojeID je specifické pro prostředí českého internetu a nabízí poskytovatelům služeb další výhody oproti standardnímu OpenID, například rozšířenou sadu osobních údajů v identitách a jejich předávání, více přihlašovacích metod s možností požadovat určitou úroveň autentizace apod. 3.2 MojeID identita Uživatelé si při zakládání identity musí zvolit jméno své identity, které jednoznačně určuje každou mojeid identitu a které má vždy tvar: jmeno.mojeid.cz (např. jnovakova.mojeid.cz) Toto jméno pak uživatelé používají pro přihlašování na stránkách poskytovatelé služeb vkládají jej do příslušného přihlašovacího políčka. MojeID identita pak obsahuje: Údaje, které o sobě uživatel do identity uvede (běžné osobní údaje jako jméno, adresa, telefon, nickname, apod.) Údaje, které jsou o uživateli poskytovány provozovatelem služby mojeid sdružením CZ.NIC (zejména informace o fyzickém ověření identity resp. vybraných osobních údajích uživatele tzv. validaci či údaj o tom zda je osoba starší 18 let) Konkrétní výčet možných údajů v mojeid identtě naleznete v příloze č. 1. 5

MojeID technické podmínky provozu 3.3 Proces komunikace přes mojeid Proces přihlášení pomocí mojeid se skládá z několika kroků, viz následující schéma. 0. Ustanovení asociace Dohodnutí sdíleného tajemství, pomocí kterého se budou ověřovat zprávy od poskytovatele OpenID. 1. Žádost o přihlášení přes mojeid Uživatel klikne na tlačítko Přihlásit přes mojeid. 2. Iniciace V rámci iniciace se získají metadata o poskytovateli OpenID. 3. Žádost o ověření identity Poskytovatel služeb sestaví žádost o ověření identity a tu nepřímo skrze přesměrování uživatelova prohlížeče odešle na koncový bod poskytovatele OpenID, kde se uživatel autentizuje. 4. Provedení autentizace Uživatel se na přihlašovací stránce mojeid přihlásí pomocí některé z přihlašovacích metod a tím je jeho identita ověřena. V současnosti je podporováno heslo, digitální certifikát a jednorázové heslo. 5. Odpověď s výsledkem ověření identity Pokud o to poskytovatel služeb v žádosti o ověření identity požádá, je uživatel přesměrován zpět na 6

MojeID technické podmínky provozu stránky poskytovatele služeb a přes uživatelův prohlížeč je mu předána odpověď s výsledkem ověření identity. 6. Ověření odpovědi Každá zpráva, kterou poskytovatel služeb obdrží od poskytovatele OpenID nepřímo přes uživatelův prohlížeč musí být ověřena, zda opravdu pochází od poskytovatele OpenID a nebyla změněna. To se udělá buď pomocí asociace, viz bod 0 (ve valné většině případů), nebo se musí o toto ověření požádat. 7. Zpracování odpovědi Na základě toho zda se jedná o úspěšné či neúspěšné přihlášení musí aplikace poskytovatele služeb reagovat a případně zpracovat další data, která jsou z této odpovědi získána. 7

MojeID technické podmínky provozu 4 Implementace podpory mojeid V této sekci se seznámíte s technickými aspekty implementace služby mojeid do webových aplikací. Znalost tohoto textu není nezbytná k implementaci, ale je doporučená pro dobré a přesné porozumění principů a procesů fungování mojeid/openid. Většinu toho co, zde bude popsáno, vyřeší dostupné knihovny pro implementaci OpenID, které doporučujeme využívat. Pokud chcete rovnou začít s implementací, přejděte přímo na dokument pro specifický programovací jazyk či webovou technologii. Seznam údajů pro přihlášení se nachází v příloze č. 1. Příklady a řešení chybových hlášek se nachází v příloze č. 3. 4.1 Ustanovení asociace Zprávy, které poskytovatel služeb obdrží nepřímo přes uživatelův prohlížeč od poskytovatele OpenID jsou digitálně podepsány. U každé takové zprávy je nutné podpisy ověřit a ujistit se, že opravdu pochází od poskytovatele OpenID. Je pro to možné využít dvou různých možností tzv. stavovou a bezstavovou komunikaci mezi poskytovatelem služeb poskytovatelem OpenID. Při bezstavové komunikaci musí poskytovatel služeb ověřit zprávu navázáním komunikace s poskytovatelem OpenID se žádostí o ověření konkrétní zprávy. To je náročnější na výkon a čas. Stavová komunikace začíná dohodnutím sdíleného tajemství ještě před začátkem samotného procesu přihlašování uživatele resp. ověřování identit tzv. ustanovení asociace. Toto sdílené tajemství má platnost nejdéle 14 dní a po jeho expiraci je nutné ustanovit asociaci znovu. Obě strany (poskytovatel OpenID i poskytovatel služeb) mohou také kdykoliv během platnosti sdíleného tajemství prohlásit toto sdílené tajemství za neplatné a v tomto případě je pak vhodné ustanovit asociaci znovu, tak aby nebylo nutné používat bezstavovou komunikaci. OpenID knihovny, které je možné pro implementaci mojeid využít, mohou používat obě možnost. Pro běžné podmínky, doporučujeme používat stavovou komunikaci v co největší míře. V některých případech je nutné použít i bezstavovou komunikaci např. pokud sdílené tajemství vypršelo nebo jej jedna ze stran zneplatnila, je nutné zprávy ověřovat bezstavovou komunikací do doby než je ustavena nová asociace. 4.2 Žádost o přihlášení přes mojeid Proces ověřování uživatelovy identity začne tím, že na stránkách poskytovatele služeb uživatel projeví žádost o přihlášení přes mojeid. Pro maximální uživatelskou přívětivost stačí pouze tlačítko pro přihlášení, viz 8

MojeID technické podmínky provozu následující obrázky. Uživatelské jméno uživatel zadá později na serveru mojeid. Tlačítko pro přihlašování přes mojeid. Vlastní dialog pro vložení mojeid identifikátoru na stránkách mojeid. Přihlašování ke službě mojeid tlačítkem je jediná doporučená a správná metoda. 4.3 Iniciace Aby poskytovatel služby mohl odeslat žádost o ověření identity, musí u většiny knihoven uvést buď identifikátor uživatele, nebo koncový bod OP. Pokud poskytovatel služeb nezná identifikátor uživatele (např. přihlášení uživatele) uvede místo něj koncový bod OP. Pokud poskytovatel služeb zná identifikátor uživatele (např. znovuověření uživatele), získá jeho pomocí metadata o uživatelově identitě a o OpenID 9

MojeID technické podmínky provozu poskytovateli včetně koncového bodu OP. Na identifikátor uživatele se pošle HTTP požadavek a v těle stránky, která je tímto požadavkem získána se nachází mimo jiné i: Prohlášený identifikátor uživatele Výsledné URL, z něhož se vrátilo tělo stránky s metadaty. Vnitřní identifikátor uživatele Od jména identity se liší tím, že jde o identifikátor, který má tvar https://mojeid.cz/id/unikatni_retezec/, kde unikatni_retezec je unikátní identifikace uživatele v systému mojeid. Například https://mojeid.cz/id/nczflohqqu/. Tuto vnitřní identitu je pak potřeba v dalších fázích přihlašovacího procesu kontrolovat, neboť to je identita, kterou rozpoznává poskytovatel OpenID, viz kapitola 4.7. Koncový bod OP to je vždy https://mojeid.cz/endpoint/ a na tuto adresu budou směrovány žádosti o ověření identity. 4.4 Žádost o ověření identity Jakmile poskytovatel služeb zná koncový bod OP, případně i prohlášený identifikátor a vnitřní identifikátor zasílá skrze přesměrování uživatelova prohlížeče žádost o ověření identity (o autentizaci). Žádost obsahuje speciální parametry pro její realizaci. Tyto parametry se uvádějí pomocí svých identifikátorů do těla zprávy. Konstrukci této žádosti o ověření identity opět přímo zajistí OpenID knihovny, které budete pro implementaci používat. Žádost o ověření identity obsahuje obvykle následující parametry: Návratovou adresu (URL) aplikace poskytovatele služby Na tuto adresu se vrátí uživatel po provedení přihlášení ze stránek poskytovatele OpenID a zde bude výsledek přihlašování aplikací poskytovatelem služeb zpracován. Oblast URL poskytovatele služeb definuje část prostoru URL, pro niž je žádost o ověření identity platná. Návratová adresa poskytovatele služeb musí ležet v této oblasti URL. Na této nebo odpovídající adrese by měl být k dispozici XRDS dokument nebo zveřejněna jeho poloha. Volba vyžadované přihlašovací metody toho se dociluje umístěním identifikátoru příslušné přihlašovací metody do žádosti o ověření identity. Služba mojeid podporuje mimo běžného přihlašování heslem přihlašování pomocí digitálního certifikátu nebo jednorázového hesla. 10

MojeID technické podmínky provozu Přihlášení pomocí certifikátu je možné vyžádat s pomocí rozšíření PAPE použitím identifikátoru: http://schemas.openid.net/pape/policies/2007/06/phishing-resistant V případě přihlášení pomocí certifikátu se zobrazují uživateli následující hlášky: "The service provider wants you to login with your certificate." "Poskytovatel služby požaduje přihlášení jednorázovým heslem." Přihlášení pomocí jednorázového hesla je možné vyžádat použitím identifikátoru: http://schemas.openid.net/pape/policies/2007/06/multi-factor V případě přihlášení pomocí jednorázového hesla se zobrazují uživateli následující hlášky: "The service provider wants you to login with one time password." "Poskytovatel služby požaduje přihlášení certifikátem." Omezení doby přihlášení uživatele pokud se uživatel úspěšně přihlásí k poskytovateli služeb systém mojeid udržuje přihlášení tohoto uživatele. Pokud se uživatel v této době přihlašuje k jinému poskytovateli služeb, nemusí se na přihlašovací stránce mojeid znovu autentizovat. Poskytovatel služeb má ovšem možnost omezit svoji žádost o ověření identity na libovolnou dobu od poslední autentizace, pokud to považuje za potřebné, např. z hlediska bezpečnosti. Tuto volbu je možné vyžádat použitím pole max_auth_age rozšíření PAPE. Pokud se uživatel nepřihlásil do mojeid za posledních max_auth_age sekund, je po něm vyžadováno nové přihlášení. Prohlášený identifikátor uživatele, který bude ověřován Jméno identity odpovídající tomuto prohlášenému identifikátoru bude uživateli zobrazena na přihlašovací stránce mojeid. Pokud uživatel vybírá identifikátor u OP, obsahuje zvláštní hodnotu. Požadované údaje z mojeid identity do žádosti o ověření identity lze přidat i seznam jednotlivých údajů z mojeid identity, které aplikace poskytovatele služeb vyžaduje a které budou po úspěšném přihlášení a se souhlasem uživatele předány poskytovateli služeb. Pro každý údaj je nutné uvést jeho identifikátor. MojeID podporuje vyžádání následující údaje (podrobnosti a formáty jednotlivých položek lze nalézt přímo na 11

MojeID technické podmínky provozu uvedené adrese identifikátoru údaje; některé z těchto údajů jméno, přezdívka, email, datum narození, PSČ a stát lze získat jednodušším rozšíření SReg). Údaje jsou uvedeny v příloze. Příklad položek v požadavku, které může žádost o ověření identity obsahovat, shrnuje následující tabulka: Parametr (klíč) openid.ns openid.claimed_id openid.identity openid.assoc_handle openid.return_to openid.realm openid.ns.ax openid.ax.mode openid.ax.type.firstname openid.ax.type.validated openid.ax.type.jabber openid.ax.required openid.ax.if_available openid.ns.pape openid.pape.max_auth_age Popis (hodnota) Určení použitého OpenID protokolu. http://specs.openid.net/auth/2.0 Prohlášený identifikátor uživatele. http://jnovakova.mojeid.cz/ Vnitřní identifikátor uživatele http://mojeid.cz/id/unikatni_retezec/ Identifikační řetězec dříve navázané asociace. {HMAC-SHA256}{4c486ac3}{Ze6JZA==} Návratová adresa z mojeid. Ve starších specifikacích protokolu OpenID se toto pole označuje openid.trust_root. http://www.poskytovatel-sluzeb.cz/mojeid-navrat.html Oblast URL poskytovatele služeb. http://www.poskytovatel-sluzeb.cz/ Určení rozšíření pro výměnu atributů. Řetězec ax může být jakékoliv jiné pojmenování, které si zvolí vaše knihovna. Zde se pouze řekne, jak se na něj bude dále odkazovat. http://openid.net/srv/ax/1.0 Režim výměny atributů (získání, uložení). fetch_request Vyžádání atributu na místo firstname může být libovolný řetězec. http://axschema.org/nameperson/first Další atribut tentokrát informace o ověření uživatelových údajů. http://specs.nic.cz/attr/contact/valid http://axschema.org/contact/im/jabber Seznam atributů, o kterých poskytovatel služeb tvrdí, že jsou nezbytné pro řádné založení/aktualizaci účtu resp. pro fungování aplikace poskytovatele služeb samotné. firstname,validated Seznam dodatečných atributů. Poskytovatel služeb by si je přál, ale nevadí, pokud je nedostane. Jabber Určení rozšíření pro autentizační politiky. http://specs.openid.net/extensions/pape/1.0 Počet sekund od poslední autentizace. Pokud se uživatel neautentizoval v této době musí se autentizovat znovu. 3600 12

MojeID technické podmínky provozu openid.pape.preferred_auth _policies Mezerou oddělený seznam identifikátorů požadovaných politik. http://schemas.openid.net/pape/policies/2007/06/phishingresistant 4.5 Provedení autentizace V okamžiku, kdy uživatel dorazí s žádostí o ověření identity od poskytovatele služeb n a koncový bod OP, je mu zobrazena přihlašovací stránka, kde proběhne samotné přihlášení. Tato autentizace je provedena poskytovatelem OpenID. V rámci tohoto ověření se poskytovatel OpenID pokusí provést maximum úkonů, které byly specifikovány pomocí parametrů v žádosti o ověření identity. Celý proces se odehrává v systémech poskytovatele OpenID a z hlediska poskytovatele služeb nevyžaduje žádnou činnost. Součástí je ověření návratové adresy poskytovatele služeb, uživatel je o výsledku tohoto ověření informován. V rámci tohoto ověření jsou získána d a t a o poskytovateli služeb pomocí protokolu YADIS a ta jsou následně ověřena oproti údajům ve zprávě. Korektní poskytovatel služeb na dotaz z protokolu YADIS vrátí buď XRDS dokument nebo HTML dokument, v němž bude zveřejněna poloha XRDS dokumentu. 4.5.1 XRDS dokument a jeho formát Poloha XRDS dokumentu se zveřejňuje následující značkou META v hlavičce: <meta http-equiv="x-xrds-location" content="http://www.poskytovatelsluzeb.cz/xrds.xml"/> Příklad vlastního XRDS dokumentu pro přihlášení ke službě mojeid: <?xml version="1.0" encoding="utf-8"?> <xrds:xrds xmlns:xrds="xri://$xrds" xmlns="xri://$xrd*($v*2.0)"> <XRD> <Service> <Type>http://specs.openid.net/auth/2.0/return_to</Type> <URI>http://www.poskytovatel-sluzeb.cz/MojeID-Navrat.html</URI> </Service> </XRD> </xrds:xrds> 13

MojeID technické podmínky provozu Příklad XRDS dokumentu pro registraci ke službě mojeid: <?xml version="1.0" encoding="utf-8"?> <xrds:xrds xmlns:xrds="xri://$xrds" xmlns="xri://$xrd*($v*2.0)"> <XRD> <Service> <Type>http://specs.openid.net/auth/2.0/assert_url</Type> <URI>URL rozhraní</uri> </Service> </XRD> </xrds:xrds> kde ve značce URI musí být návratová adresa poskytovatele služeb z žádosti o ověření identity. Během celého procesu k získání dokumentu nesmí server poskytovatele služeb vrátit přesměrování (HTTP kód 3xx), jinak je dokument považován za neplatný/podvržený. 4.5.2 Výběr vhodné Oblasti URL poskytovatele služeb Oblast URL je v systému mojeid jednoznačným identifikátorem poskytovatele služeb, jeho správná volba tedy usnadní orientaci uživatelům. Dle specifikace OpenID by měla oblast URL odpovídat části URL prostoru, pro níž je požadavek platný. V případě přihlašování by tedy oblast URL neměla být menší než je část URL prostoru, která je pokrytá následně vzniklou session. Z tohoto plyne naše doporučení používat právě jeden realm na jednu doménu druhého řádu. Protože dvě URL, které se liší byť jen schématem, jsou dle specifikací rozdílné, velmi doporučujeme použití výhradně HTTPS v případě, že je dostupné. Tím se také zabrání odposlechu dat uživatelů, během jejich odesílání poskytovateli služeb. Pokud používáte pouze jedinou doménu druhého řádu, pak doporučujeme zvolit oblast URL ve tvaru: https://example.cz/ nebo https://www.example.cz/. Zde je třeba upozornit, že návratová adresa musí mít stejnou doménu jako realm, jinak je OpenID požadavek neplatný. Pokud používáte poddomény třetích a nižších řádů, doporučujeme využít náhražkový znak * a zvolit oblast URL ve tvaru https://*.example.cz/. Tato oblast URL umožňuje používat návratové adresy s libovolnou poddoménou (ale ne s doménou samotnou v tomto případě https://example.cz/), například: 14

MojeID technické podmínky provozu https://www.example.cz/, https://sub.example.cz/navratova/adresa/, https://pod.do.me.na.example.cz/. XRDS dokument se bude hledat na URL, kde se znak * nahradí za www" tedy na https://www.example.cz/. 4.6 Odpověď s výsledkem ověření identity V případě, že o to poskytovatel služby požádal, je mu opět nepřímo přes přesměrování uživatelova prohlížeče zaslána zpět zpráva s odpovědí resp. výsledkem ověřování identity a dalšími daty, které si vyžádal. Tato odpověď má opět formu HTTP zprávy, přičemž v těle této zprávy jsou uvedena jednotlivá data vyjadřující jednotlivé informace výstupu z procesu ověření identity. Následují příklady položek polí odpovědi na žádost o ověření identity: Klíč openid.claimed_id openid.op_endpoint Popis Vrací prohlášený identifikátor uživatele, od výchozího se může lišit fragmentem. Tento řetězec použije poskytovatel služeb k párování dat specifických pro uživatele. Je důležité při porovnávání dbát zřetel na všechny části řetězce včetně schématu a fragmentu. https://jnovakova.mojeid.cz/#unikatni_retezec MojeID endpoint URL https://mojeid.cz/endpoint/ openid.response_nonce Unikátní značka odpovědi. Žádné dvě odpovědi nemají stejnou slouží k obraně před znovu odesláním odpovědi (tzv. replay attack). 2010-07-22T16:13:08ZiEnTtR openid.signed openid.sig openid.ax.type.firstname openid.ax.value.firstname openid.pape.auth_policies openid.pape.auth_time Seznam polí, která jsou podepsána podpisem, viz následující klíč. assoc_handle,claimed_id,ns,op_endpoint,pape.auth_policies, response_nonce,signed Podpis vyjmenovaných polí pro ověření pravosti. hdtopg3jcup1n6+elcxn+ylzayc= Mapování oficiálního URL identifikátoru na řetězec používaný ve zprávě. http://axschema.org/nameperson/first Hodnota atributu identity pro uvedený řetězec. Jana Mezerou oddělený výčet přihlašovacích politik, které byly ve skutečnosti aplikovány. http://schemas.openid.net/pape/policies/2007/06/phishingresistant Čas kdy byla ověřena uživatelova identita na serveru (UTC). 2005-05-15T17:11:51Z 15

MojeID technické podmínky provozu 4.7 Ověření odpovědi Každá zpráva s odpovědí je digitálně podepsána a musí být ověřena. Ověřují se následující části zprávy: návratová URL Hodnota openid.return_to musí souhlasit s URL, na kterou byl požadavek doručen. Všechny parametry této URL musí být obsaženy v HTTP zprávě, již poskytovatel služeb obdržel. prohlášený identifikátor M e t a d a t a n á l e ž í c í k prohlášenému identifikátoru získaná během iniciace nebo opakováním části tohoto procesu musí souhlasit s údaji obsaženými ve zprávě prohlášený identifikátor, vnitřní identifikátor, koncový bod OP a verze protokolu. značka odpovědi Zpráva se stejnou značkou nebyla od tohoto poskytovatele OpenID ještě přijata. podpis Všechna pole, která musí být podepsána, jsou podepsána a podpis je platný. Podpis si buď poskytovatel služeb ověří sám ve stavové komunikaci, nebo o kontrolu podpisu požádá poskytovatele OpenID. Pokud jsou všechny tyto podmínky splněny, pak je zpráva platná a bylo ověřeno, že prohlášený identifikátor náleží uživateli. Všechny části by ale měla zpracovat knihovna implementující protokol. 4.8 Zpracování odpovědi Pokud je zpráva s odpovědí na žádost o ověření identity úspěšně ověřena, může aplikace poskytovatele služeb data, která obsahuje, zpracovat a dokončit tak proces přihlašování pomocí mojeid. Toto zpracování musí zajistit webová aplikace na návratové adrese, která byla obsažena v žádosti na ověření identity. 4.8.1 Výsledek přihlášení Při zpracování výsledku přihlášení je potřeba ošetřit následující speciální situace týkající se úspěšného přihlášení: První přihlášení uživatele pokud se uživatel, který se úspěšně přihlásil, ve webové aplikaci poskytovatele služeb poprvé, je ve většině případů nutné aby mu poskytovatel služeb založil v této své aplikaci účet, kde budou udržována data získaná z mojeid identity a samozřejmě i veškerá další data specifická pro příslušnou aplikaci. Při zakládání účtu je doporučeno: 16

MojeID technické podmínky provozu využít data získaná z mojeid identity zcela místo vyplňování registračního formuláře, případně zobrazit uživateli v registračním formuláři pouze ta políčka, jejichž obsah nebyl získán z mojeid a seznámit uživatele s tím, jaká data z mojeid identity příslušná aplikace potřebuje a doporučit mu, že je vhodné, aby umožnil jejich předávání při každém přihlášení. Opakované přihlášení versus přihlášení nového uživatele při každém zpracování odpovědi je třeba kontrolovat prohlášenou identitu uživatele, protože se může stát, že dva různí uživatelé mají stejné jméno identity a to tak, že jedna osoba zruší svoji mojeid identitu (a uvolní tak příslušné jméno identity) a jiná osoba si založí identitu se stejným jménem identity. Tito uživatelé jsou pak rozlišeni pomocí unikátního řetězce na konci URL prohlášené identity. Přihlášení uživatele, který o něj nepožádal přímo Aplikace poskytovatele služby může obdržet odpověď s úspěšným přihlášením i v případě, že o přihlášení tento uživatel nepožádal přímo v aplikaci příslušného poskytovatele služeb. Jde o normální situaci, která by neměla být považována za chybu požadavek na přihlášení šel z jiných stránek než na, kterou se vrací data (v protokolu se neuchovává informace o aplikaci, jež vygenerovala zprávu, pokud poskytovatel služeb takovou informaci vyžaduje, musí si ji doplnit sám). Uživatel je si ovšem vždy díky upozornění na přihlašovací stránce mojeid vědom, ke které službě se přihlašuje a komu předává data. Při zpracování výsledku přihlášení je potřeba ošetřit následující situace týkající se negativního výsledku přihlašování: Zamítnutí žádosti o přihlášení - uživatel může po příchodu na přihlašovací stránku zamítnout žádost o přihlášení např. z důvodu, že jej sám neinicioval. Aplikace pak musí ošetřit tento stav. Nemožnost okamžitého ověření - Poskytovatel služeb může vynutit ověření identity bez kontaktu s uživatelem, pokud toto ověření není poskytovatel OpenID schopen poskytnout, vrátí se tento typ odpovědi znamenající, že je třeba provést klasické ověření uživatele. Některé knihovny tento stav nerozlišují od předchozího stavu. Chyba v protokolu - Poskytovatel OpenID vrátí tento typ zprávy, pokud je schopen určit návratovou adresu poskytovatele služeb, ale není schopen rozpoznat jiná pole ve zprávě, neboť obsahuje data, jež jsou v rozporu 17

MojeID technické podmínky provozu s protokolem. Poskytovatel OpenID MojeID vrací tento chyb zpráv, např. pokud mu je doručena zpráva s vnitřním identifikátorem, jež není schopen ověřit. 4.8.2 Údaje z mojeid identity Pokud je využito dotazování na údaje z mojeid identity, je nutné ošetřit následující speciální situace: Opakované přihlašování uživatele - při každém opakovaném přihlášení uživatele pomocí mojeid je potřeba zkontrolovat, zda data, která jsou uložena v interním účtu aplikace poskytovatele služeb, jsou shodná jako data, která byla v rámci přihlášení získána z mojeid identity uživatele. V případě že se liší, je potřeba aktualizovat data v interním účtu daty z mojeid identity, ta jsou pravděpodobně aktuální. Neobdržení požadovaných údajů - uživatel má možnost vždy ovlivnit jaké údaje budou či nebudou při přihlášení předávány poskytovateli služeb. Může se tedy stát, že aplikace poskytovatele služeb některé údaje vyžaduje a přesto je díky uživatelově volbě nedostane. Je doporučeno ošetřit tuto situaci, aby data, která aplikace požaduje, byla rozdělena na nutná pro fungování aplikace a nepovinná, bez kterých se aplikace obejde. Podle toho rozdělení je pak vhodné navrhovat konkrétní chování dotyčné aplikace. Zvláštním případem je možnost přihlášení pouze pro plně identifikované nebo validované (fyzicky ověřené) uživatele mojeid. Položky: http://specs.nic.cz/attr/contact/valid a http://specs.nic.cz/attr/contact/status jsou předávány vždy, pokud si o ně poskytovatel s rozšířeným přístupem požádá. Údaje, u kterých uživatel nepovolil předání poskytovateli služeb, jsou v těle odpovědi vráceny bez hodnoty. 18

MojeID technické podmínky provozu 5 Rozhraní pro zakládání účtů mojeid Tato kapitola popisuje mechanismus registrace mojeid účtů ze systémů Poskytovatelů. Poskytovatelé mohou tento mechanismus nabídnout svým uživatelům za účelem převedení u nich evidovaných údajů do mojeid. 5.1 Žádost o založení účtu mojeid Uživatel si v systému Poskytovatele zvolí možnost založit mojeid. Toto vygeneruje v prohlížeči uživatele HTTPS POST požadavek na registrační server na adrese https://mojeid.nic.cz/registration/endpoint/. V p ara metrech požadavku jsou spolu s požadovaným uživatelským jménem všechny evidované údaje o daném uživateli (Seznam údajů pro registraci se nachází v příloze č.2.) a navíc: identifikátor poskytovatele služeb (realm) volitelné URI, přičemž by se mělo jednat o stejnou hodnotu, která se používá pro OpenID přihlašování k službě mojeid jednoznačný identifikátorem transakce (registration_nonce) slouží ke spárování odpovědi na tento požadavek P o s k y t o v a t e l m á m o ž n o s t v o l b o u a d r e s y https://mojeid.nic.cz/transfer/endpoint/ nabídnout uživateli převod existujícího kontaktu v centrálním registru. V takovém případě se ignorují zaslané údaje o uživateli a je vyplněno uživatelské jméno, neboli identifikátor kontaktu, který nelze měnit. Pokud je identifikátor nevalidní, nelze ho převést do mojeid, uživatel musí kontaktovat určeného registrátora pro změnu. Dále je uživateli zobrazen formulář se seznamem údajů, které se po registraci vloží do mojeid. U základních údajů se zobrazí i hodnota a je možné je změnit. Uživatel na tomto formuláři: odsouhlasí podmínky služby bude ověřen pomocí CAPTCHA 5.2 Kontrola validity dat Registrační server po odeslání formuláře zkontroluje validitu dat a nechá uživatele opravit chyby. V případě správnosti dat je zahájen proces registrace nového účtu. Do tohoto účtu registrační server uloží požadovaná data a připojí identifikaci poskytovatele služeb. Následně je zahájena identifikace odesláním PIN1 a PIN2. 19

MojeID technické podmínky provozu Následujícím krokem je informovat poskytovatele služeb o úspěšné registraci. S pomocí URI, jež označuje poskytovatele služeb, se server pokusí nalézt XRDS dokument s alespoň jedním <xrd:service> elementem obsahujícím elementy <xrd:type> s hodnotou http://specs.nic.cz/registration/assert_url a <xrd:uri> s URL, na které se zašle informace o registraci. Během tohoto procesu nesmí dojít k přesměrování a výsledná URL musí ležet v URI poskytovatele služeb, viz http://openid.net/specs/openid-authentication-2_0.html#realms Poskytovateli je poslán přímo HTTPS POST zpráva na rozhraní. Obsahem zprávy jsou tři parametry: registration_nonce jednoznačný identifikátor transakce pro spárování s původním požadavkem claimed_id zvolený mojeid identifikátor uživatele status hodnota REGISTERED Poskytovatel musí tuto zprávu nejprve ověřit: musí zkontrolovat, že zpráva byla doručena na některou z adres zjištěných v bodě 5.1 musí ověřit, že response_nonce byla opravdu vytvořena musí ověřit, že klientský certifikát, který byl použit pro vytvoření SSL tunelu je platný a podepsaný certifikační autoritou CZ.NIC. Tento certifikát je dostupný na adrese http://www.mojeid.cz/page/1864/motivacni-program/ pro produkční i testovací prostředí. Certifikát je potřeba pro notifikace na produkci i na testu. Pro poskytovatele bez HTTPS, který chce na testovacím prostředí zkoušet přihlašování a zakládání účtů tento certifikát není třeba. Pro poskytovatele s HTTPS, pokud jde o testovací prostředí, je tento certifikát třeba v případě notifikací z registrace, pro přihlášení není třeba (komunikace mojeid -> server poskytovatele služby se jen táže na obecné veřejné věci, takže není třeba ověřovat "totožnost" toho, kdo je žádá). Notifikace se posílají po registraci, částečné identifikaci (PIN1+2) a validaci (PIN3) na assert_url, které je uvedeno v XRDS dokumentu na realmu. Toto je funkční i na testu. Aby poskytovatel dostával notifikace, musí mít realm 20

MojeID technické podmínky provozu s https. Dále pak po přijetí notifikace je třeba odpovědět řetězcem 'mode:accept\n', kde \n je znak nové řádky. Ověřování klientského certifikátu umí zajistit HTTP server např. Apache s použitím konfigurační volby SSLVerifyClient. Pokud jsou splněny všechny požadavky, může Poskytovatel při zpracování této zprávy spárovat mojeid identifikátor se svým záznamem o uživateli pro účely autentizace přes mojeid. Pokud není možné zaslat tuto zprávu bezpečným způsobem protokolem HTTPS, pokračuje registrace bez zaslání této zprávy. 5.3 Dokončení registrace Poskytovatel odešle odpověď na zprávu z bodu 5.2 v těle http odpovědi ve formátu klíč-hodnota OpenID protokolu: výsledek (mode) hodnota accept nebo reject značící, zda uživatelův účet byl úspěšně spárován. důvod zamítnutí (reason) nepovinný parametr obsahující důvod, proč k párování nedošlo. Pokud nebude odpověď poslána ve správném formátu, bude zpráva s výsledkem registrace poslána na další adresu z bodu 5.2, dokud nebude získána odpověď nebo nebudou adresy vyčerpány. Registrace pak pokračuje buď přímou výzvou k vyplnění PIN1 a PIN2 a vstoupením do profilu, kde si uživatel zvolí heslo, nebo je uživateli zobrazena informace a dokončení registrace. Pokud má poskytovatel služeb plný přístup, budou mu zasílány informace i o změně stavu uživatelova účtu. Tyto zprávy jsou posílány podobně jako v bodě 5.2, se dvěma parametry v každé zprávě: claimed_id zvolený mojeid identifikátor uživatele status jedna z hodnot: o o o CONDITIONALLY_IDENTIFIED částečně identifikovaný (zadán PIN1 a PIN2) IDENTIFIED plně identifikovaný (zadán PIN1, PIN2 a PIN3) VALIDATED validovaný (zadán PIN1, PIN2, PIN3 a příznak validace) Pokud selže odesílání této zprávy nebo na ni nebude správně odpovězeno, bude informace o změně stavu zaslána opakovaně po dobu několika hodin. 21

MojeID technické podmínky provozu 6 Testovací instance Před zahájením testování zašlete na adresu podpora@mojeid.cz REALM, ze kterého bude testovat přihlášení a registrace. Na testovacím serveru je třeba povolit přístupy a nastavit tzv. plný přístup. Bez toho nebudou zasílány pro potřebu testování parametry status a valid! Pro testování mojeid doporučujeme založit 3 testovací uživatele: 1) částečně identifikovaného, u kterého bude zadaný jen PIN1 a PIN2, 2) plně identifikovaného, u kterého bude zadaný PIN1, PIN2 a PIN3 a 3) validovaného, u kterého bude zadaný PIN1, PIN2, PIN3 a příznak validace Tím je možné otestovat vracené hodnoty v parametru status pro obě varianty identifikace a validaci. Na adrese https://mojeid.fred.nic.cz/registration/ si založte jednotlivé testovací účty. Kontaktní údaje můžete vyplnit libovolné, PINy a validační dopis se neposílají. Zadejte univerzální PINy: PIN1: 11111111 (8 jedniček) PIN2: 22222222 (8 dvojek) PIN3: 33333333 (8 trojek) Pro validaci účtu je potřeba vygenerovat dokument (pdf) z uživatelského profilu. Pro vygenerování dokumentu je nutné mít zadané libovolné datum narození. Vygenerovaný pdf dokument pošlete na adresu podpora@mojeid.cz, nastavíme pak na odpovídajícím profilu validaci. Testovací instance s podrobnějšími výstupy v případě chyb je dostupná na následujících adresách: Koncový bod https://mojeid.fred.nic.cz/endpoint/ Profil a přihlášení do profilu https://mojeid.fred.nic.cz/editor/ Registrační obrazovky: https://mojeid.fred.nic.cz/registration/ - nový účet https://mojeid.fred.nic.cz/transfer/ - převod účtu Koncové body pro motivační program: https://mojeid.fred.nic.cz/registration/endpoint/ 22

https://mojeid.fred.nic.cz/transfer/endpoint/ MojeID technické podmínky provozu Účty vzniklé v rámci testování se nezapočítávají do motivačního programu. Po zavedení mojeid na stránky poskytovatelů na ostrý provoz budou k dispozici následující adresy: Nový účet: https://mojeid.cz/registration/endpoint/ Převod existujícího účtu: https://mojeid.cz/transfer/endpoint/ 23

MojeID technické podmínky provozu 7 Přílohy 7.1 Příloha č.1 Seznam údajů pro přihlášení 7.2 Příloha č.2 Seznam údajů pro registraci 7.3 Příloha č.3 Příklady a řešení chybových hlášek 24

Příloha č.1 Seznam údajů pro přihlášení Údaj Identifikátory AX Identifik. SReg Jméno Celé jméno http://axschema.org/nameperson fullname http://specs.nic.cz/attr/contact/name Křestní jméno http://axschema.org/nameperson/first http://specs.nic.cz/attr/contact/name/first Příjmení http://axschema.org/nameperson/last http://specs.nic.cz/attr/contact/name/last Přezdívka http://axschema.org/nameperson/friendly nickname http://specs.nic.cz/attr/contact/nickname Email Hlavní http://axschema.org/contact/email email http://specs.nic.cz/attr/email/main Notifikační Další http://specs.nic.cz/attr/email/notify http://specs.nic.cz/attr/email/next Domácí adresa Ulice http://axschema.org/contact/postaladdress/home http://specs.nic.cz/attr/addr/main/street Ulice2 http://axschema.org/contact/postaladdressadditional/home http://specs.nic.cz/attr/addr/main/street2 Ulice3 Město http://specs.nic.cz/attr/addr/main/street3 http://axschema.org/contact/city/home http://specs.nic.cz/attr/addr/main/city Stát http://axschema.org/contact/state/home http://specs.nic.cz/attr/addr/main/sp Země http://axschema.org/contact/country/home http://specs.nic.cz/attr/addr/main/cc 1