Upozornění: Text přílohy byl získán strojově a nemusí přesně odpovídat originálu. Zejména u strojově nečitelných smluv, kde jsme použili OCR. originál smlouvy stáhnete odsud
Struktura BČK Moravskoslezské karty
Struktura BČK
Moravskoslezské karty
Vlastník dokumentace: Koordinátor ODIS s.r.o.
Verze 32
21. 3. 2014
Vlastník dokumentace: Koordinátor ODIS s.ro. List 1/41
Struktura BČK Moravskoslezské karty
Obsah
2. Požadavky na funkčnost odbavovacího zařízení .............................................................................................7
3. Úvod ................................................................................................................................................................7
3.1 Shoda návrhu se standardy ....................................................................................................................7
3.2 Popis návrhu struktury BČK MSK............................................................................................................8
3.3 Definice zkratek a pojmů......................................................................................................................10
4. Specifikace použitých datových typů ............................................................................................................11
5. Struktura popisovaných aplikací ...................................................................................................................12
6. Aplikace na MSK ............................................................................................................................................14
6.1 Personalizační aplikace.........................................................................................................................14
6.1.1 Struktura souboru Informace o kartě..........................................................................................14
6.1.2 Struktura souboru Informace o držiteli .......................................................................................15
6.1.3 Klíče .............................................................................................................................................16
6.2 Aplikace Průkazy/Benefity....................................................................................................................18
6.2.1 Soubor Průkaz/Benefit ................................................................................................................18
6.2.2 Klíče .............................................................................................................................................19
6.2.3 Aplikace v jednotlivých souborech Průkaz/Benefit .....................................................................19
6.3 Aplikace IDS jízdenky ............................................................................................................................21
6.3.1 Soubor Jízdenka...........................................................................................................................21
6.3.2 Soubor Kontrola jízdenky.............................................................................................................29
6.3.3 Soubor Místenka .........................................................................................................................30
6.3.4 Klíče .............................................................................................................................................32
6.4 Aplikace elektronická peněženka(EP)...................................................................................................34
6.4.1 Soubor Nastavení EP....................................................................................................................34
6.4.2 Soubor Osobní nastavení EP........................................................................................................35
6.4.3 Hodnota EP..................................................................................................................................36
6.4.4 Log EP ..........................................................................................................................................36
6.4.5 Klíče .............................................................................................................................................38
6.5 Rezerva 1 ..............................................................................................................................................39
6.5.1 Struktura......................................................................................................................................39
6.5.2 Klíče .............................................................................................................................................39
6.6 Rezerva 2 ..............................................................................................................................................39
6.6.1 Struktura......................................................................................................................................39
6.6.2 Klíče .............................................................................................................................................39
Vlastník dokumentace: Koordinátor ODIS s.ro. List 2/41
Struktura BČK Moravskoslezské karty
6.7 Rezerva 3 ..............................................................................................................................................39
6.7.1 Struktura......................................................................................................................................39
6.7.2 Klíče .............................................................................................................................................40
6.8 Rezerva 4 ..............................................................................................................................................40
6.8.1 Struktura......................................................................................................................................40
6.8.2 Klíče .............................................................................................................................................40
Vlastník dokumentace: Koordinátor ODIS s.ro. List 3/41
Struktura BČK Moravskoslezské karty
Historie změn:
Vlastník dokumentace: Koordinátor ODIS s.ro. List 4/41
Struktura BČK Moravskoslezské karty
Ver Datum Jméno Důvod vydání
ze
27 20.03.2012 Holešovský Změna v číslování kupónů a typu
28 26.03.2012 Matoušek Doplatek do 1. třídy v souboru místenka
Holešovský
29 25.9. 2012 Holešovský Dobití EP + doplnění významu publisherProviderID, úprava v couponType
29a 28.11.2013 Koštuřík Úprava pro CheckIn CheckOut v rámci MHD Ostrava. Přidána struktura
nového benefitu, viz kapitola 6.2.2 Klíče
Klíč Název Význam
#0 MSK_5346_0 Master – klíč aplikace
#1 MSK_5346_1 Čtení souboru 1 – 5
#2 MSK_5346_2 Čtení/zápis souboru 1
#3 MSK_5346_3 Čtení/zápis souboru 2
#4 MSK_5346_4 Čtení/zápis souboru 3
#5 MSK_5346_5 Čtení/zápis souboru 4
#6 MSK_5346_6 Čtení/zápis souboru 5
#7 MSK_5346_7 RFU
1.1.1.1 Přístupová práva souborů
Change
Soubor Název Read Write Read & Write Access
Rights
#0
0 Soubor 1 #1 #0 #2 #0
#0
1 Soubor 2 #1 #0 #3 #0
#0
2 Soubor 3 #1 #4 #0
3 Soubor 4 #1 #5 #0
4 Soubor 5 #1 #6 #0
1.1.2 Aplikace v jednotlivých souborech Průkaz/Benefit
1.1.2.1 Soubor 1 – CheckIn/CheckOut pro DPO
29b 3.12. 2013 Koštuřík Datová struktura benefitCheckInCheckOut.
30 10.2. 2014 Koštuřík Přidána kapitola 6.2.3 Aplikace v jednotlivých souborech Průkaz/Benefit
31 21.3. 2014 Škapa Přidána položka couponsPrepaidTransaction viz kapitola 6.1.1.1 Datová
struktura cardInfo.
32 14.10.2014 Nenka Změna struktury datum u Benefitu
viz kapitola 6.1.1.1.1 Datová struktura cardInfo
Úprava kapitoly 2
Vlastník dokumentace: Koordinátor ODIS s.ro. List 5/41
Ver Datum Jméno Struktura BČK Moravskoslezské karty
ze
Důvod vydání
Vlastník dokumentace: Koordinátor ODIS s.ro. List 6/41
Struktura BČK Moravskoslezské karty
2. Požadavky na funkčnost odbavovacího zařízení
Odbavovací zařízení musí zajistit bezproblémový proces odbavení cestujících na bázi bezkontaktní čipové karty
typu MIFAREDESFireEV1 8 kB (dále BČK). Musí umožnit prodej cestovního dokladu (jak papírového, tak na
platformě BČK) podle platného tarifu ODIS.. Zařízení musí splňovat požadavky Bezpečnostní politiky BČK
Moravskoslezské karty (bezpečné úložiště klíčů v odbavovacím zařízení – SAM modul, bezpečná komunikace
odbavovacího zařízení s bezkontaktní čipovou kartou, atd.). Komunikace zařízení s kartou musí trvat krátkou
dobu – za jakékoliv situace a při jakékoliv tarifní kombinaci do 3 sekund od přiložení karty a zadání cílové
zastávky řidičem.
Odbavovací zařízení musí obecně splnit úkony - prodej papírového jízdního dokladu, plnění elektronické
peněženky, nahrání jednotlivého jízdného ODIS na BČK při prodeji z elektronické peněženky, nahrání
dlouhodobého časového jízdného ODIS na BČK při platbě z elektronické peněženky nebo za hotovost, nahrání
dlouhodobého časového jízdného ODIS zakoupeného přes e-shop, nahrání kreditu elektronické peněženky
zakoupeného přes e-shop, reklamační proces, čímž se rozumí vystornováníjakékoliv operace provedené v rámci
odbavení na BČK; odbavovací zařízení musí mít dostatečnou paměťovou kapacitu pro tarif ODIS, musí zvládat
zapisovat data přímo do paměti BČK, musí generovat výstupní sestavy dle požadavků clearingového centra,
musí umět pracovat s jednotnými vstupními daty popisujícími Tarif ODIS, který bude spravovat Koordinátor
ODIS, a který je součástí clearingového centra.
Společnost Koordinátor ODIS s.r.o. poskytne pro dopravce bezpečným způsobem klíče ke kartám a SAM
modulům a SW nástroje pro nahrání datové struktury karty ODIS zejména pak Dopravní aplikace a aplikace
elektronické peněženky a dále poskytne design karty pro potřeby výroby karty.
3. Úvod
Dokument obsahuje informace o BČK Moravskoslezské karty týkající se:
• struktury aplikací/souborů a jejích formátů
Popisované struktury aplikací se týkají BČK standardu Mifare DESFire. BČK pro IDS je tzv. multi-aplikační BČK,
což znamená, že na jedné BČK mohou být nahrány jak aplikace vydavatele karty, tak i aplikace jiných
poskytovatelů aplikací. Aplikace vydavatele BČK jsou obecně známé ostatním poskytovatelům aplikací či
subjektům akceptujícím BČK.
Z důvodů mnoha subjektů, pracujících s kartou, jsou všechny použité datové typy co nejlépe dokumentované a
zejména pak jsou převzaty z normativních dokumentů, jejichž seznam je součástí tohoto dokumentu jako
kapitola 0 – Použité normativní dokumenty. Návrh je také v souladu s připravovanou vyhláškou ustanovující
standardy platby a odbavení cestujících ve veřejné dopravě s využitím bezkonatktních čipových technologií.
Architektura je navržena tak, aby mohla být použita metoda postupného budování infrastruktury a využívání
MSK, kde v první části (fázi) bude budována dopravní aplikace, tj. využití karty jako nositele elektronického
jízdného.
Každá aplikace má přiděleno jedno AID dle specifikace NXP pro Mifare DESFire – celkem 3 byty.
MIFARE DESFire AID Byte 0 MIFARE DESFire AID Byte 1 MIFARE DESFire AID Byte 2
Nibble 0 Nibble 1 Nibble 2 Nibble 3 Nibble 4 Nibble 5
0xF MIFARE classic AID 0x0
3.1 Shoda návrhu se standardy
• komunikace je řešena ve shodě s ISO 14443 A, definující bezkontaktní interface, čímž výsledné řešení
zajistí technologickou interoperabilitu plošně skrze všechny uživatele
• operační systém navržené BČK odděluje ve své paměti datové prostory tak, aby karta umožnila práci s
nezávislými aplikacemi
Vlastník dokumentace: Koordinátor ODIS s.ro. List 7/41
Struktura BČK Moravskoslezské karty
• přístup k odděleným datovým prostorům je řízen podle typu operací
• operační systém navržené BČK a autentizační mechanismy BČK umožňují jednomu subjektu vykonávat
správu obsahu karty bez možnosti přístupu k datům a klíčům uvnitř jednotlivých aplikací, tj.
nahrávat dopravní aplikace jejich správu i vymazání takovým způsobem, že neoprávněné subjekty
nejsou schopny zjistit ani ovlivnit jejich obsah
• návrh BČK umožňuje multifunkční použití, tj. paralelní umístění, užívání a správu aplikací různých
subjektů
• návrh BČK nabízí kromě standardní bezpečnosti karet Mifare DESFire i vlastní nativní bezpečnostní
prvky - šifrování obsahu, podpis obsahu pomocí symetrických i asymetrických kryptografických
mechanismů
• návrh BČK umožňuje zavedení dodatečné bezpečnostní vrstvy prostředky, které jsou na nativních
bezpečnostních mechanismech karty nezávislé
• BČK umožňuje obnovovat bezpečným způsobem kryptografické klíče použité pro ochranu karty a jejich
aplikací
• Návrh BČK umožňuje bezpečným způsobem zapisovat na kartu nové aplikace, popř. je vymazávat
• Datové struktury jsou navržené na základě standardu pro běžně používané technologie
• Použité číselníky odpovídají stávajícím používaným číselníkům u ostatních IDS
• Návrh BČK umožňuje nahrávat strukturu také na NFC mobilní telefony podporující v Secure Elementu
karty Mifare DESFire
3.2 Popis návrhu struktury BČK MSK
Návrh obsahuje 4 kompletní aplikace a 4 rezervní aplikace pro případné další dopnění struktury BČK MSK.
Kompletní aplikace:
• Personalizační, tvořená 2 soubory:
o Informace o kartě
Podrobněji viz. Struktura souboru Informace o kartě
o Informace o držiteli
Umožnuje identifikaci držitele, podporuje ale i anonymní karty
Podrobněji viz. Struktura souboru Informace o držiteli
• Průkazy/Benefity
o Obecná aplikace tvořená 5 stejným soubory s různými právy na zápis do jednotlivých souborů
o Možné využití aplikace například pro:
Parkování
Slevová karta
Rezervační systém
Stravovací systém (SS)
Docházkový systém
Knihovní systém
Portál úředníka (PÚ
Dopravní aplikace Českých drah
o Podrobněji viz. Soubor Průkaz/Benefit
• IDS jízdenky
o Aplikace podporující jak dlouhodobé časové kupóny tak i jednorázové jízdenky
o Pro každou jízdenku podporuje záznam o kontrole, včetně záznamu o nástupu do vozidla
o Tvořená 5 soubory pro časový kupón/jednorázovou jízdenku
o Tvořená 5 soubory o záznamu o kontrole
o Tvořená 2 soubory pro podporu místenek ke kupónům
Vlastník dokumentace: Koordinátor ODIS s.ro. List 8/41
Struktura BČK Moravskoslezské karty
o Návrh podporuje použití ve všech dopravních prostředcích
o Podrobněji viz. Aplikace IDS jízdenky
• Elektronická peněženka(EP)
o Obsahuje 4 soubory včetně souboru s transakčním logem pro kontrolu stavu peněženky
o Podporuje až 4 měny
o Podrobněji viz. Aplikace elektronická peněženka(EP)
Vlastník dokumentace: Koordinátor ODIS s.ro. List 9/41
Struktura BČK Moravskoslezské karty
3.3 Definice zkratek a pojmů
Pojem Definice
AID Identifikátor aplikace Application Identifier ISO/IEC 7816-5:2004
BČK Bezkontaktní čipová karta
ČD České dráhy
DD Odbavovací zařízení, které mají charakter odbavení zákazníka (například
odbavení kupónu nebo el. peněženky na validátoru (strojku), obecná platba el.
EP peněženkou...). DD operace s BČK jsou obecně považovány za časté a méně
KC spolehlivé s ohledem na zápis dat na BČK
HW Elektronická peněženka
IDS Kartové centrum, provádí grafickou a datovou personalizaci
Lsb Hardware
LSB Integrovaný dopravní systém Moravskoslezského kraje
MHD Least Significant Bit, nejméně významný bit
Msb Least Significant Byte, nejméně významný bajt
MSB Městská hromadná doprava
N/A Most Significant Bit, nejvíce významný bit
MKA Most Significant Byte, nejvíce významný bajt
MKK Not Available, není k dispozici
MSK Master klíč aplikace
MSK_CMK Master klíč karty
PAD Moravskoslezská karta
POS Master klíč MSK
Příměstská autobusová doprava
RFU Point Of Sale - zařízení, které mají charakter POS (dobití kupónu či el. peněženky
Secure Element na KC nebo v automatu nebo u řidiče...). POS operace s BČK jsou obecně
SAM považovány za méně časté a více spolehlivé s ohledem na zápis dat na BČK
SW Reserved for Future Use, rezervováno pro budoucí použití
Tarif ODIS čip bezpečně emulující kartu Mifare a JavaCard na NFC zařízeních
Secure Application Module
Software
Filozofie tarifu pro MS kartu zpracovanou Koordinátorem ODIS s.r.o.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 10/41
Struktura BČK Moravskoslezské karty
4. Specifikace použitých datových typů
Název Byte Popis
INT1 1 INTEGER (0..255)
INT2 2 INTEGER (0..65535)
INT3 3 INTEGER (0..16777215)
INT4 4 INTEGER (0..4294967295)
BCDString Sekvence BCD číslic (BCDString). Každý byte obsahuje dvě 4-bitové BCD číslice,
4 zakódované v horní a dolní polovině bytu.
UTF8String 1,6 Příklad: desítkové číslo 123456 bude ve tvaru BCD uloženo jako sekvence byte 0x12,
1,4 0x34, 0x56.
Datef L×8 Řetězec znaků v kódování UTF-8. U každého výskytu UTF8String musí být v tomto
DateStamp dokumentu specifikována jeho maximální délka v bajtech (nikoli znacích). Je-li
TimeStamp řetězec kratší než jeho maximální délka, bude zprava doplněn byty o hodnotě 0x00.
OCTET Dle EN 1545
STRING (L) Počet dní od 1.1.1997. Rozsah 1.1.1997 až 9.11.2041.
Počet minut po půlnoci, půlnoc je 0
Řetězec byte (oktetů) o maximální specifikované délce (tzv. bytové pole). Řetězec je
vždy zarovnán na celé byte. Je-li zapisané pole byte kratší než specifikovaná délka,
bude zprava vyplněno byty v hodnotě 0x00.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 11/41
Struktura BČK Moravskoslezské karty
5. Struktura popisovaných aplikací
Všechny soubory ve všech aplikacích v tomto návrhu MSK mají jednotnou strukturu a jednotný formát popisu
(s drobnou odchylkou u typu souboru „Value File“).
#Num FileName FileType
Název Bitů Typ
Verze 8 INT1
Status souboru 8 cancelled (5)
ok (7)
pre-allocated (16) Nešifrovaná oblast souboru
disabled (88)
Typ podpisu 4
Typ šifrování 4
Proměnné 1 32 Typ 1
Proměnné 2 X Typ 2 Potenciálně šifrovaná oblast
Podpis 64 souboru (u tohoto souboru
nemá šifrování význam)
Využito
RFU x
Celkem B (= X × 32 B)
Význam:
#Num: Pořadové číslo souboru v aplikaci
FileName: Jméno souboru (pouze mnemotechnická pomůcka, není uloženo na kartě)
FileType: Typ souboru dle speficikace DESFire
Verze: Verze záznamu (inkrementální počítadlo od 0). Nula znamená, že soubor existuje, neobsahuje ale žádná
data. Všechny zde prezentované datové formáty jsou ve verzi 1.
Podpis: Digitální podpis (nebo jeho ekvivalent) dle položky Typ podpisu
Typ podpisu: nepodepsáno
0 privátní algoritmus poskytovatele aplikace
1 bloková šifra DES-CBC-MAC8
2 bloková šifra 3DES-CBC-MAC8
3 hash funkce MD5
4 hash funkce SHA-1
5 hash funkce SHA-2
6 hash funkce HMAC
7 eliptická křivka SECT193R1
8 RFU
specifický pro danou síť
9 - 12
13 - 15
Typ šifrování: Nekryptováno
0 privátní algoritmus poskytovatele aplikace
1 symetrický algoritmus DES-CBC, padding Method 0
2 symetrický algoritmus 3DES-CBC, padding Method 0
3 symetrický algoritmus AES128
4 symetrický algoritmus AES256
5 RFU
specifický pro danou síť
6 - 12
13 - 15
Vlastník dokumentace: Koordinátor ODIS s.ro. List 12/41
Struktura BČK Moravskoslezské karty
Proměnné 1: 4 byte k dipozici v nešifrované velikosti souboru, může být definováno nebo RFU
Proměnné 2: 16 + n × 32 byte šifrovaného obsahu souboru. Zaokrouhlení na 32 byte je z důvodů omezení
vnitřní fragmentace souborů DESFire karet. Z důvodu zvýšení přehlednosti je vlastní obsah souboru obvykle
vypsán ve zvláštní tabulce, popsané pod popisem souboru.
Tento princip umožňuje snadnou znovupoužitelnost a jednotný pohled na struktury jak na různých kartách, tak
i v různých aplikací stejné karty.
Vlastník dokumentace: Koordinátor ODIS s.ro. List 13/41
Struktura BČK Moravskoslezské karty
6. Aplikace na MSK
Návrh aplikací, souborů a typů položek souborů se řídí těmito pravidly:
• režim komunikace souborů bude nastaven na Encrypted
• RFU bude vyplněno nulami
• vícebajtové číselné datové typy (INT2, INT3, INT4, DateStemp, TimeStamp) jsou uloženy v bajtovém
kódování LittleEndian
6.1 Personalizační aplikace
• AID aplikace – 0027
• obsahuje 2 soubory
• zahrnuje identifikační znaky vydavatele, podpis UID, informace o kartě a o držiteli karty
6.1.1 Struktura souboru Informace o kartě
0 Bitů Typ cardInfoFile Hodnota (popis) Standard Data File
Název Typ editace
8 INT1 KC 1 Nešifrovaná oblast
Verze souboru
Status 8 KC 7 (Ok)
souboru Potenciálně šifrovaná
Typ podpisu 4 KC 0 (nepodepsáno) oblast souboru
Typ šifrování 4 KC 0 (nekryptováno) (u tohoto souboru
RFU 40 nemá šifrování
cardInfo 640 Datová volné místo vyplněné '0'B význam)
Kód definující datovou
Podpis struktura strukturu cardInfo (viz
cardInfo 6.1.1.1).
Využito 64
RFU KC volné místo vyplněné '0'B
Celkem B
768
0
96 (= 3 × 32 B)
6.1.1.1 Datová struktura cardInfo
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
publisherProviderID editace
Identifikace INT3 24 0811 – vydavatel DPO u
publisherNetworkID KC karet vydaných do 15.11.
vydavatele karty 2011
signatureVersion KC 062 – vydavatel DPO
signatureUID dle číselníku XXX
203811
Identifikace INT3 24 (dle Číselníku NetworkID &
ProviderID)
transportní sítě
do které patří
vydavatel karty
verze klíče INT1 8 KC 1
ECDSA
privátním klíčem OCTET 448 KC MSK_0027_ECC_P
ECDSA STRING
Vlastník dokumentace: Koordinátor ODIS s.ro. List 14/41
Struktura BČK Moravskoslezské karty
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
editace
podepsané UID (56)
karty – typ 8
cardNumber Logické číslo 72 KC
karty – dle
ISO7812
appStartDate Počátek platnosti DateStamp 14 KC
karty datum výroby karty
appEndDate Konec platnosti DateStamp 14 KC
karty datum výroby karty + 6 let
couponsPrepaidTransaction Číslo INT4 32 POS Ekvivalent položky
předplacené DD walletPersCreditTransaction
transakce
kuponu ve struktuře EP, zde však
používaný pro kupony.
RFU 4 KC volné místo vyplněné '0'B
Celkem bitů 640
Celkem byte 80
6.1.2 Struktura souboru Informace o držiteli
1 cardHolderInfoFile Standard Data File
Název
Verze Bitů Název Typ editace Hodnota (popis) Nešifrovaná oblast
Status 8 INT1 souboru
souboru 8 KC 1
Typ podpisu Potenciálně šifrovaná
Typ šifrování KC 7 (Ok) oblast souboru
Typ držitele
4 POS 0 (nepodepsáno)
RFU
cardHolderInf 4 POS 0 (nekryptováno)
o
8 INT1 POS druh karty dle držitele a
Podpis způsobu použití - Viz níže
Využito
RFU 32 N/A volné místo vyplněné '0'B
Celkem B
896 Datová Kód definující datovou
struktura strukturu cardHolderInfo
cardHolderInfo (viz 6.1.2.1).
64 POS 0
1024
0
128 (= 4 × 32 B)
6.1.2.1 Datová struktura cardHolderInfo
Proměnná Popis Datový typ Bit Typ editace Hodnota (popis)
holderBirth Datum narození (nebo Datef
jiný datumový údaj) 32 KC RFU
holderSex BCDString
Pohlaví držitele dle ČSN POS
holderID ISO/IEC 5218
4 KC RFU
Bezvýznamový
identifikátor držitele POS
Např. identifikátor MPSV,
případně RFU 80 KC RFU
POS
Vlastník dokumentace: Koordinátor ODIS s.ro. List 15/41
Struktura BČK Moravskoslezské karty
holderName Identifikace držitele (75 B, UTF8String 600 KC RFU
tedy 37 až 75 znaků) POS
holderProfile1 Profil1 držitele BČK dle EN ProfileCodeIOP 6 KC
1545 POS
profile1StartDat Platnost profilu1 od DateStamp 14 KC
e
POS
profile1EndDate Platnost profilu1 do DateStamp 14 KC
KC
POS
holderProfile2 Profil2 držitele BČK dle EN ProfileCodeIOP 6 KC
1545 POS
profile2StartDat Platnost profilu2 od DateStamp 14 KC
e
POS
profile2EndDate Platnost profilu2 do DateStamp 14 KC
POS
RFU 112 KC volné místo vyplněné
'0'B
Celkem bitů 896
Celkem byte 112
Poznámky ke struktuře:
• Typ držitele je jeden z následujících:
o 0: Anonymní karta (položky holderBirth a holderName jsou vyplněny nulami; položka
holderSex je nastavena v souladu s normou na 9).
o 1: Personalizovaná karta (položky holderBirth a holderSex jsou vyplněny; holderName
obsahuje jméno a příjmení držitele, toto může být případně zkrácené na celé znaky).
o 2: Přenosná karta (položka holderBirth je vyplněna nulami; holderSex obsahuje 9 a
holderName je jménem organizace, vlastnící přenosnou kartu, holderID obsahuje
identifikátor organizace).
o 3: Nepřenosná nepersonalizovaná karta (holderID může obsahovat identifikaci držitele,
holderName není vyplněno, položky holderBirth a holderSex jsou vyplněny).
o 4: Graficky personalizovaná karta (položky holderBirth a holderName jsou vyplněny nulami;
položka holderSex je nastavena v souladu s normou na 9).
o 5: Náhradní karta (položky holderBirth a holderName jsou vyplněny nulami; položka
holderSex je nastavena v souladu s normou na 9).
o 6: Zaměstnanecká graficky personalizovaná karta (položky holderBirth a holderName jsou
vyplněny nulami; položka holderSex je nastavena v souladu s normou na 9).
• Pohlaví držitele norma ČSN ISO/IEC 5218 udává jako:
o 0: není známo
o 1: mužské
o 2: ženské
o 9: není aplikováno (nemá význam)
6.1.3 Klíče
Klíč Název Význam
#0 MSK_0027_0 Master – klíč aplikace
#1 MSK_0027_1 Čtení souboru informace o kartě
Vlastník dokumentace: Koordinátor ODIS s.ro. List 16/41
Struktura BČK Moravskoslezské karty
#2 MSK_0027_2 Čtení/zápis souboru informace o kartě
#3 MSK_0027_3 Čtení souboru informace o držiteli
#4 MSK_0027_4 Čtení/zápis souboru informace o držiteli
#5 RFU
6.1.3.1 Přístupová práva souborů
Soubor Název Read Write Read & Write Change
Access Rights
0 Informace o kartě #1 (nebo bez klíče) #0 #2
1 Informace o držiteli #4 #0
#3 (nebo bez klíče) #0 #0
Vlastník dokumentace: Koordinátor ODIS s.ro. List 17/41
Struktura BČK Moravskoslezské karty
6.2 Aplikace Průkazy/Benefity
• AID aplikace – 5346
• obsahuje 5 souborů
• možné použít pro
o slevovou kartu,
o turistickou „City/Region Card“,
o průkaz, opravňující ke vstupu či k nějaké činnosti,
o průkaz, ověřující vlastnost držitele (žákovský průkaz, zaměstnanecký průkaz),
o permanentní vstupenka (s nebo bez možnosti počítání vstupů na kartě),
o dopravní aplikaci ČD
6.2.1 Soubor Průkaz/Benefit
0-4 benefitFile Standard Data File
Název Nešifrovaná oblast
Verze Bitů Název Typ editace Hodnota (popis) souboru
Status 8 INT1
souboru 8 KC 1 Potenciálně šifrovaná
Typ podpisu oblast souboru
Typ šifrování 4 KC 7 (Ok)
benefitNetwo 4
rk 24 Kód sítě KC 0 (nepodepsáno)
BenefitProvid
er KC 0 (nekryptováno)
RFU
Benefit POS 203811
Podpis 8 Kód vydavatele POS Doplnit dle vydavatele a
Využito
Celkem B číselníku
Využito
8 N/A volné místo vyplněné '0'B
128 Datová KC
struktura
benefitInfo,
Datová
struktura
benefitCheckIn Kód definující datovou
CheckOut, strukturu benefitu.
Datová
struktura
benefitBusAcc
ess případně
jiná struktura
64 KC 0
256
32
256 (= 1 × 32 B)
6.2.1.1 Datová struktura benefitInfo
Obecná datová struktura vhodná pro použití v souboru Průkazy/Benefity, může být však nahrazena libovolnou
jinou strukturou.
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
DateStamp editace
benefitValidityStart Datum platnosti od
14 POS
Vlastník dokumentace: Koordinátor ODIS s.ro. List 18/41
Struktura BČK Moravskoslezské karty
benefitValidityEnd Datum platnosti do DateStamp 14 POS
POS volné místo vyplněné '0'B
RFU 4 POS
benefitType Data průkazu OCTET STRING (8) 96
(strukturu stanovuje
každá aplikace sama)
Celkem bitů 128
Celkem byte 16
6.2.2 Klíče
Klíč Název Význam
#0 MSK_5346_0 Master – klíč aplikace
#1 MSK_5346_1 Čtení souboru 1 – 5
#2 MSK_5346_2 Čtení/zápis souboru 1
#3 MSK_5346_3 Čtení/zápis souboru 2
#4 MSK_5346_4 Čtení/zápis souboru 3
#5 MSK_5346_5 Čtení/zápis souboru 4
#6 MSK_5346_6 Čtení/zápis souboru 5
#7 MSK_5346_7 RFU
6.2.2.1 Přístupová práva souborů
Soubor Název Read Write Read & Write Change
Access Rights
0 Soubor 1 #1 #0 #2
1 Soubor 2 #1 #0 #3 #0
2 Soubor 3 #1 #0 #4 #0
3 Soubor 4 #1 #0 #5 #0
4 Soubor 5 #1 #0 #6 #0
#0
6.2.3 Aplikace v jednotlivých souborech Průkaz/Benefit
6.2.3.1 Soubor 1 – CheckIn/CheckOut pro DPO
6.2.3.1.1 Datová struktura benefitCheckInCheckOut
Datová struktura pro uchování kontraktů pro ChechIn CheckOut odbavení v rámci DPO. Jedná se o tři další
dokupované jízdenky k lístku držitele uloženém ve struktuře seasonTicketInfo (proměnná contract1) v souboru
seasonTicketFile. Zde uvedená struktura je uložena v souboru benefitFile (proměnná Benefit).
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
editace
benefitValidityEndDate Datum platnosti do DateStamp 14 POS
benefitValidityEndTime Čas platnosti do TimeStamp 11 POS
RFU 7 POS volné místo vyplněné '0'B
contract1 Informace o seasonTicketC 32 POS
prvním profilu
cestujícího. ontract (viz
kap. 6.3.1.2)
contract2 Informace o seasonTicketC 32 POS
Vlastník dokumentace: Koordinátor ODIS s.ro. List 19/41
Struktura BČK Moravskoslezské karty
druhém profilu ontract (viz
cestujícího. kap. 6.3.1.2)
contract3 Informace o třetím seasonTicketC 32 POS
Celkem bitů profilu cestujícího. ontract (viz
Celkem byte
kap. 6.3.1.2)
128
16
6.2.3.2 Soubor 2
Soubor prozatím není využíván.
6.2.3.3 Soubor 3
Soubor prozatím není využíván.
6.2.3.4 Soubor 4
Soubor prozatím není využíván.
6.2.3.5 Soubor 5 – Přístup ke strojkům v autobusech (odemykací karta)
6.2.3.5.1 Datová struktura benefitBusAccess
Datová struktura pro uchování bezpečnostních informací (PIN) pro odemykání strojků v autobusech pomocí
přístupové karty. Zde uvedená struktura je uložena v souboru benefitFile (proměnná Benefit).
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
BenefitPIN editace
Hodnota PIN
RFU šifrována algoritmem 64 POS
Celkem bitů ALG_DES_CBC_NOPA
Celkem byte D
64
128
16
Vlastník dokumentace: Koordinátor ODIS s.ro. List 20/41
Struktura BČK Moravskoslezské karty
6.3 Aplikace IDS jízdenky
• AID aplikace - 1201
• obsahuje 5 souborů jízdenek, 5 souborů pro kontrolu jízdenky a 2 soubory místenek
• V datových strukturách v této aplikaci jsou na rozdíl od zbytku dokumentu použity datové typy dle
norem ČSN EN 1545-1 a ČSN EN 15320.
6.3.1 Soubor Jízdenka
Filozofie souboru: Soubor jízdenka slouží umožňuje výdej libovolného dokladu (jednorázového nebo časového)
platného v IDS. Umožňuje i nahrání většiny jízdních dokladů dopravců mimo IDS. Vlastnosti:
• Na jeden jízdní doklad lze odbavit až 4 × 15 cestujících, v libovolné kombinaci „dospělých“, „slev“
a „zavazadel/psů“.
• Jízdenka platí v čase, který je na ní uveden při prodeji, lze určit platnost „od prvního označení“
• Trasu lze definovat:
o definicí sítě
o výčtem zón platnosti
o relačně
• Pro zjednodušení prodejních a kontrolních operací jsou všechny záznamy pevné délky (nedojde tak
k situaci, že by sice v souboru s jízdenkami bylo dostatek místa, ale díky vnitřní fragmentaci by nebylo
možné novou jízdenku zapsat).
• Časovou platnost dokladu lze nastavit v podstatě libovolně.
• Je počítáno s tím, že k jízdnímu dokladu je možné vydat doplatek nebo doklad refundovat cestujícícmu
i na zařízení, které je off-line (umožňují-li to tarifní a jiné administrativní podmínky).
• Hlavní zásadou při tvorbě dokladu je minimalizace dat, zapisovaných na kartu a vyměňovaných mezi
jednotlivými (dopravními) subjekty. Proto nejsou na kartě zejména žádné údaje, které se
vytvářejí/ověřují pouze při zpracování karty oproti centrálním systémům. Typicky není potřeba na
kartu nahrávat přesné názvy tarifních dokladů. Tedy například jednodenní, pětidenní, týdenní, měsíční,
čtvrtletní, desetiměsíční a roční jízdenku je pro kontrolu ve vozidle možné vést pouze jako jízdenku
časovou. Navíc je pro potřeby kontroly ve voze obecně jedno, zda-li se jedná o jízdenku občanskou,
pro dárce krve nebo jinou. Je třeba pouze odlišit různé typy dokladů, které vyžadují při kontrole ve
vozidle, nikoli při prodeji různé dodatečné ověření způsobem, který neumožňuje přímo MSK jako
datový nosič (například předložení jiného průkazu).
Vlastník dokumentace: Koordinátor ODIS s.ro. List 21/41
Struktura BČK Moravskoslezské karty
0-4 seasonTicketFile Backup Data File
Název Typ editace
Verze Bitů Název Hodnota (popis)
Status
souboru 8 INT1 KC 1
Typ podpisu 8 KC
Typ šifrování POS/DD 7 (Ok) Nešifrovaná oblast
RFU 4 POS/DD souboru
seasonTicket 4 3 (3DES-CBC-MAC8)
24 POS/DD 0 (nekryptováno)
Podpis 656 Datová volné místo vyplněné '0'B
Využito struktura Kód definující datovou Potenciálně šifrovaná
Celkem B seasonTicketIn strukturu seasonTicketInfo oblast souboru
Využito fo (viz 6.3.1.1).
64
Struktura od Verze po
seasonTicket podepsán
klíčem MSK_1201_SIGN
768
0
96 (= 3 × 32 B)
6.3.1.1 Datová struktura seasonTicketInfo
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
NetworkId editace 203811
contractNetwork Identifikace transportní sítě do ProviderID
contractProvider které patří provozovatel uvedený v 24 POS
RFU proměnné contractProvider. Dle INT3 DD
couponType číselníku NetworkID & ProviderID INT4
Kód provozovatele, který prodal či INT1 8 POS
contractSaleAgent dobil kupón INT3 DD
DateStamp
Typ kupónu 3
0 – časový kupón 3 POS
1 – krátkodobá jízdenka
2 – kilometrické jízdné DD
3 – jednotlivé jízdné
4 – zaměstnanecký kupón 24 POS
5 .. 6 - RFU
7 - pro použití vydavatele karty
Pokladník, který doklad prodal
DD
contractSaleDevice Číslo prodejního místa (terminálu) 32 POS
DD
contractSerialNum Číslo kupónu rozdělené pro 8 POS Inkrementuje se při
ber kupóny(soubory 0..3) a
jízdenku(soubor 4) DD prodeji
contractSaleSerialN
umber Jedinečné číslo kupónu pro 24 POS Inkrementuje se při
prodejní místo(terminál, eshop)
DD prodeji
contractValiditySta Počátek platnosti – datum 14 POS
Vlastník dokumentace: Koordinátor ODIS s.ro. List 22/41
Struktura BČK Moravskoslezské karty
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
editace 0x7F
rtDate DD 0x00
contractValiditySta Počátek platnosti – čas TimeStam 11 POS 0x00
rtTime p DD 0x00
0x00
contractValidityEn Konec platnosti – datum DateStamp 14 POS
dDate DD
contractValidityEn Konec platnosti – čas TimeStam 11 POS
dTime p DD
contractValidityRes Omezení platnosti na dny (vhodné Restrict 8 POS
trictDay např. pro žákovské jízdenky). Days of DD
Week
bity: 0 – 6 = Po až Ne, bit 7 = ‚h’. 8 POS
Nastavený bit = doklad platí. DD
Standardně tedy bude vyplněno
hodnotou 0x7F (7 bitů) 32 POS
DD
contractValidityRes Omezení platnosti dle číselníku, INT1
32 POS
trictCode uplatňuje se, pokud je nastaven DD
nejvyšší bit ‚h‘ položky 32 POS
DD
contractValidityRestrictDays.
32 POS
Číselník bude vytvořen později. DD
contract1 Informace o prvním profilu seasonTick 3 POS
cestujícího. etContract DD
(viz kap. 16 POS
6.3.1.2) DD
contract2 Informace o druhém profilu seasonTick 2 POS
cestujícího. etContract DD
(viz kap. 3 POS
6.3.1.2)
contract3 Informace o třetím profilu seasonTick
cestujícího. etContract
(viz kap.
6.3.1.2)
contract4 Informace o čtvrtém profilu seasonTick
cestujícího. etContract
(viz kap.
6.3.1.2)
seatReservationFile Číslo souboru s místenkou
0 – bez místenky,
1 – soubor místenka 1 (číslo
souboru 10)
2 – soubor místenka 2 (číslo
souboru 11)
contractTransport Bitové pole povolených dopravních
MeansRestriction prostředků. Více pod tabulkou.
contractVehicleCla Povolená vozová třída (v závislosti
ssCodeRestriction na dopravním prostředku)
0: bez omezení
1: 1. třída nebo její ekvivalent
2: 1. i 2. třída nebo jejich ekvivalent
3: RFU
contractHasJourne 0: Doklad nemá trasu (síťová
Vlastník dokumentace: Koordinátor ODIS s.ro. List 23/41
Struktura BČK Moravskoslezské karty
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
y editace
jízdenka) Payment DD
contractPaymentM 1: Doklad je dán relací (Z, Do, Přes) Means
eans 2: Doklad je dán výčtem zón 8 POS 0x00
3: Doklad je dán číslem trasy PayUnitMa
contractPriceUnit 4-7: RFU p DD
contractPrice Typ prodejní transakce. Číselník
RFU pod tabulkou. Amount 4 POS 1000b
variantPart Určuje, zda je možné provést (167 DD
vrácení peněz při offline anulaci
samNumber nebo check-out. 77 215) 24
Celkem bitů Měna a násobek ceny jízdenky
Celkem byte 1000b – CZK v haléřích 4
1001b – EUR v centech 256
Cena jízdenky dle contractPriceUnit
16 POS Zapisuje pouze
Variantní část jízdenky dle DD SAM
contractHasJourney, právě jedna
ze struktur 656
82
• seasonTicketNetworkInfo
• seasonTicketRelationInfo
• seasonTicketZonesInfo
• seasonTicketTraceInfo
Číslo SAM, který provedl záznam
contractPaymentMeans je jedno z nebo kombinace: List 24/41
• '0000' Nespecifikováno;
• '0001' Hotovost;
• '0010' Šek;
• '0011' Kreditní/Debetní karta;
• '0100' IEP (Internet Payment);
• '0101' CTA;
• '0110' Direct Debit (elektronická peněženka);
• '0111' Fakturováno/úvěr;
• '1000' Stored Travel Rights;
• '1001' Loyalty redemption;
• '1010' Token;
• '1100' Členská výhoda;
• '1101' Automatické obnovení/prodloužení;
• '1110' Poukázka;
• '1111' Voucher;
Vlastník dokumentace: Koordinátor ODIS s.ro.
Struktura BČK Moravskoslezské karty
• '00010010' Kombinace hotovost – šek;
contractTransportMeansRestriction:
Nastavený bit 1 až 15 při nastaveném bitu 0 znamená, že v daném prostředku je jízdenka platná.
Bit Omezení Bit Omezení
0 0: Bez omezení 8 Tramvaj
1: Omezení aplikováno
1 Vlak Os, Sp, Ex 9 Trolejbus
2 Vlak R 10
3 Vlak EC, IC 11
4 Vlak SC 12
5 Lanovka RFU
13
6 Bus 14
7 Loď 15
V případě některých contractPaymentMeans nemusí mít cestující nárok na vrácení jízdného.
Vzájemné refundace mezi subjekty musí řešit následné systémy, není předmětem struktur na kartě.
6.3.1.2 Datová struktura seasonTicketContract
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
editace 0x00
contractFlags Příznaky, upřesňující typ INT2 16 POS
dokladu (zjednodušení
číselníků). Viz komentář pod DD
tabulkou.
contractAmount Počet cestujících (zavazadel Amount 4 POS
atp.) zde popsaného tarifu,
profilu a příznaku. (15) DD
contractTariffProf Kód určující tarif kupónu 6 POS
ile relativně v rámci daného DD
profilu zákazníka a transportní
sítě. Číselník dle TarifProfile z
„struktura_tarifu_KODIS_xxx.x
lsx“
contractCustome Kód klasifikující kupón dle ProfileCod 6 POS
rProfile určitých kritérií. Profil eIOP DD
zákazníka popisuje zákazníka
(např. důchodce). Číselník dle
CustomerProfile z
„struktura_tarifu_KODIS_xxx.x
lsx“
Celkem 32
Význam contractFlags: List 25/41
Vlastník dokumentace: Koordinátor ODIS s.ro.
Struktura BČK Moravskoslezské karty
Bit Vlastnost
0 1: Jízdenka je zpáteční. Týká se všech jízdenek s contractHasJourney = 2 a 0. Jízdenka může být
uznána i v opačném směru oproti údajům, uloženým v seasonTicketRelationInfo.
1–5 Číslo průkazu v aplikaci Průkazy, který je potřeba ověřit pro ověření platnosti jízdenky. Vlastní
ověření je dáno aplikační logikou daného průkazu, je nad rámec specifikace elektronické jízdenky.
6 Byl zakoupen přestupní lístek
7–15 RFU
Smyslem zavedení položky contractFlags je minimalizace číselníků dokladů a typů.
6.3.1.3 Datová struktura seasonTicketNetworkInfo
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
editace 203811
contractNetworkI Identifikace sítě, v níž je
D jízdenka platná NetworkID 24 POS Hodnota (popis)
DD 203811
RFU
232 POS
Celkem DD
256
6.3.1.4 Datová struktura seasonTicketRelationInfo
Proměnná Popis Datový typ Bit Typ
editace
contractNetworkID Identifikace sítě, k níž jsou NetworkID 24 POS
vztaženy stanice (zóny) DD
contractDistance Počet kilometrů Amount 8 POS
(255) DD
contractTransferEn Datum do kdy lze přestoupit DateStamp 14 POS
dDate na následný spoj – pro ČD DD
contractTransferEn Čas do kdy lze přestoupit na TimeStam 11 POS
dTime následný spoj – pro ČD p DD
contractJourneyVia Počet stanic (zón) „přes“, 0 Amount 8 POS
Count až 5 (255) DD
contractJourneyEle Velikost jedné datové Amount 5 POS
mSize položky (reprezentace (32) DD
stanice, zóny) v bitech –
ElemS, zmenšená o 1 (tedy
z rozsahu 1 až 32 bitů)
Zda se jedná o stanice nebo
zóny je dáno sítí
(contractNetworkID)
RFU 2 POS
DD
contractjourney Stanice / zóna Z, Do a pole OCTET 184 POS
stanic / zón přes (0 až
contractJourneyViaCount), STRING DD
každá o velikosti ElemS
(23)
Celkem 256
Vlastník dokumentace: Koordinátor ODIS s.ro. List 26/41
Struktura BČK Moravskoslezské karty
6.3.1.5 Datová struktura seasonTicketZonesInfo
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
editace 203811
contractNetworkID Identifikace sítě, k níž jsou NetworkID 24
vztaženy zóny (od sítě se POS Udává počet zón
odvíjí max. velikost čísla DD v položce
zóny a počet uložených zón)
POS contractJourneyZones
contractDistance Počet kilometrů Amount 8 DD 01000b
(255) POS
DD
contractTransferEn Datum do kdy lze přestoupit DateStamp 14 POS
DD
dDate na následný spoj POS
DD
contractTransferEn Čas do kdy lze přestoupit na TimeStam 11
dTime následný spoj p
contractJourneyZo Počet zón v seznamu Amount 8
nesCount (255)
contractJourneyEle Velikost jedné datové Amount 5 POS
mSize položky (reprezentace
stanice, zóny) v bitech – (32) DD
RFU ElemS, zmenšená o 1 (tedy
contractJourneyZo z rozsahu 1 až 32 bitů) 2
nes
Pole Zón přes OCTET 184 POS
STRING DD
(23)
Celkem 256
Poznámky:
contractJourneyZonesCount je maximálně 10, jinak je contractHasJourney = 0)
Počty zón: ElemSize Počet zón uložitelných do seasonTicketZonesInfo
Nejvyšší číslo zóny 7 až 26
127 8 až 23
255 9 až 20 – využito pro MSK
511 10 až 18
1023 11 až 16
2047 12 až 15
4095 … …
…
Příklad pro MSK:
Jízdenka platná v zónách 230, 126,125,124,135
contractJourneyZonesCount : 0x05
contractJourneyZones : ‘011100110001111110001111101001111100010000111’b
Vlastník dokumentace: Koordinátor ODIS s.ro. List 27/41
Struktura BČK Moravskoslezské karty
6.3.1.6 Datová struktura seasonTicketTraceInfo
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
editace 203811
contractNetworkID Identifikace sítě, k níž jsou NetworkID 24 POS Udává počet
zón/zastávek v položce
vztaženy zóny (od sítě se DD contractJourneyZones
odvíjí max. velikost čísla 00000010b
01000b pro zónu
zóny a počet uložených zón) 11111b pro zastávku
contractDistance Počet kilometrů na kolik je Amount 8 POS
jízdenka platná (255) DD
contractTransferEn Datum do kdy lze přestupit DateStamp 14 POS
dDate na následný spoj DD
contractTransferEn Čas do kdy lze přestupit na TimeStam 11 POS
dTime následný spoj p DD
ticketJourneyLine Číslo linky, kde je jízdenka INT4 32 POS
platná
DD
ticketJourneyConn Číslo spoje INT4 32 POS
ection
DD
contractJourneyZo Počet zón/zastávek Amount 8 POS
nesCount v seznamu (255) DD
contractJourneyEle Velikost jedné datové Amount 5 POS
mSize položky (reprezentace
stanice, zóny) v bitech – (32) DD
contractJourneyZo ElemS, zmenšená o 1 (tedy
nes z rozsahu 1 až 32 bitů) OCTET 122 POS
Celkem
Od zóny/Do zóny STRING DD
resp.
Od Zastávky/ Do zastávky (23)
256
Vlastník dokumentace: Koordinátor ODIS s.ro. List 28/41
Struktura BČK Moravskoslezské karty
6.3.2 Soubor Kontrola jízdenky
5-9 Bitů Typ ticketPliersFile Hodnota (popis) Standard Data File
Název Typ
8 INT1 Nešifrovaná oblast
Verze 8 editace souboru
Status
souboru KC 1
ticketCheck
KC 7 (Ok)
Využito
RFU 240 Struktura
Celkem B ticketPliersInfo
256
0
32 (= 1 × 32 B)
6.3.2.1 Struktura ticketPliersInfo
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
editace 203811
contractNetwork Identifikace transportní sítě
do které patří provozovatel NetworkId 24 DD 0x00
contractProvider
Kód provozovatele, který ProviderID 8 DD
ticketCheckInDevic zkontroloval jízdenku
e INT4 32 DD
ticketCheckInDate Číslo kontrolujícího místa
(terminálu) DateStamp 14 DD
ticketCheckInTime
Datum provedeného TimeStam 11 DD
označení p
Čas provedeného označení
ticketCheckInLine Číslo linky, ve kterém došlo INT3 24 DD
ticketCheckInRoute k označení
ticketCheckInBus INT3 24 DD
ticketCheckInZone Číslo spoje, ve kterém došlo
ticketCheckInStop k označení INT4 32 DD
ticketCross
ticketCounter Číslo vozidla, ve kterém INT3 24 DD
Celkem bitů došlo k označení
INT4 32 DD
Číslo zóny, ve které došlo
k označení 4 DD
Číslo stanice, ve které došlo 11 DD
k označení
Počítadlo přestupů
Počítadlo jízd na jeden
kupón
240
Vlastník dokumentace: Koordinátor ODIS s.ro. List 29/41
Struktura BČK Moravskoslezské karty
6.3.3 Soubor Místenka
10 - 11 seatReservationTicketFile Standard
Název Typ editace Data File
Bitů Typ Hodnota (popis)
Verze 8 INT1 KC 1
Status souboru 8 KC 7 (Ok)
Typ podpisu 4 KC 0 Nešifrovaná
KC 0 oblast
Typ šifrování 4 KC, POS, 0 – viz Struktura souboru
DD seatReservationTicketInfo
structureType 8
1 – viz Struktura
FirstClassTicketInfo
seatReservation 160 Struktura Potenciálně
seatReservationTicketInfo šifrovaná
oblast
nebo souboru
Struktura
FirstClassTicketInfo
Podpis 64 KC 0
Využito 256
RFU 0
Celkem B 32 (= 1 × 32 B)
6.3.3.1 Struktura seatReservationTicketInfo
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
List 30/41
editace
seatValidityStartDa Počátek platnosti – datum DateStamp 14 POS
te DD
seatValidityStartTi Počátek platnosti – čas TimeStam 11 POS
me
p DD
contractLineRestric Číslo linky, ve které je INT3 24 POS
tion místenka platná (0 = bez DD
omezení)
contractRouteRestr Číslo spoje, ve které je INT3 24 POS
iction místenka platná (0 = bez DD
omezení)
contractVehicleRes Číslo vozu, ve kterém je INT3 16 POS
triction místenka platná (0 bez DD
omezení)
contractVehicleCla Povolená vozová třída (v 2 POS
ssCodeRestriction závislosti na dopravním
prostředku) DD
0: bez omezení
1: 1. třída nebo její
ekvivalent
2: 1. i 2. třída nebo jejich
ekvivalent
3: RFU
Lze dokoupit i místenku na
Vlastník dokumentace: Koordinátor ODIS s.ro.
Struktura BČK Moravskoslezské karty
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
editace
vyšší třídu než je jízdenka
contractPaymentM Typ prodejní transakce. Payment 4 POS
eans (viz. výše) Means DD
contractSeatCount Počet místenek v souboru 3 POS
DD
contractSeatPlace1 Číslo místa1 ve vozidle, na INT1 8 POS
Restriction kterém je místenka platná DD
contractSeatPlace2 Číslo místa2 ve vozidle, na INT1 8 POS
Restriction kterém je místenka platná DD
contractSeatPlace3 Číslo místa3 ve vozidle, na INT1 8 POS
Restriction kterém je místenka platná DD
contractSeatPlace4 Číslo místa4 ve vozidle, na INT1 8 POS
Restriction kterém je místenka platná DD
seatPriceUnit Měna a násobek ceny PayUnitMa 4 POS ‘1000‘B
místenky p DD
‘1000‘B – CZK v haléřích
‘1001‘B – EUR v centech
seatPrice Cena místenky dle Amount 24 POS
contractPriceUnit
(167 DD
77 215)
RFU 2
Celkem bitů 160
6.3.3.2 Struktura FirstClassTicketInfo
Poznámky:
• Struktura se týká pouze souboru 11
o Na kartě mohou být 2 místenky nebo místenka + doplatek
• Položky contractSeatPlaceXRestriction (X = 1 až 4) jsou nahrazeny koncem platnosti doplatku
• Čas konce platnosti bude nastaven na půlnoc (00:00), pro doplatek platící D dnů by tedy po-
slední den platnosti měl být D + 1 od počátku.
• Položka contractVehicleClassCodeRestriction bude nastavena na „1“ (doplatek do 1. třídy)
• Ukládání ceny je u doplatku není nutné
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
editace
seatValidityStartDa Počátek platnosti – datum DateStamp 14 První den, kdy doplatek
te POS platí
DD Pokud doplatek platí více
seatValidityStartTi Počátek platnosti – čas TimeStam 11 POS než jeden den, pak
me p DD uložena 0, jinak počátek
platnosti
contractLineRestric Číslo linky, ve které je INT3 24 POS 0, nyní nevyužito
DD
tion místenka platná (0 = bez
omezení)
contractRouteRestr Číslo spoje, ve které je INT3 24 POS 0, nyní nevyužito
DD
iction místenka platná (0 = bez
List 31/41
Vlastník dokumentace: Koordinátor ODIS s.ro.
Struktura BČK Moravskoslezské karty
omezení)
contractVehicleRes Číslo vozu, ve kterém je INT3 16 POS 0, nyní nevyužito
triction místenka platná (0 bez DD Dle vozové třídy
doplatku (doplatek do 1.
omezení) třídy tedy má uloženo 1)
contractVehicleCla Povolená vozová třída 2 POS
ssCodeRestriction (v závislosti na dopravním
prostředku) DD
0: bez omezení
1: 1. třída nebo její
ekvivalent
2: 1. i 2. třída nebo jejich
ekvivalent
3: RFU
Lze dokoupit i místenku na
vyšší třídu než je jízdenka
contractPaymentM Typ prodejní transakce. (viz. Payment 4 POS
eans výše) Means DD
contractSeatCount Počet místenek v souboru 3 POS Vždy 0.
DD
seatValidityEndDat Konec platnosti – datum DateStamp 14 POS Pokud je platnost
e DD doplatku vyjádřena
v celých dnech (či delším
období), pak první den,
kdy již doplatek neplatí,
jinak poslední den
platnosti doplatku.
seatValidityEndTim Konec platnosti – čas TimeStam 11 POS Pokud je platnost
e
p DD doplatku vyjádřena
v celých dnech (či delším
období), pak 0, jinak čas
konce platnosti
doplatku.
RFU 7 POS 0
seatPriceUnit
DD
seatPrice
RFU Měna a násobek ceny PayUnitMa 4 POS ‘1000’B
Celkem bitů
místenky p DD
‘1000‘B – CZK v haléřích
‘1001‘B – EUR v centech
Cena místenky dle Amount 24 POS
contractPriceUnit (167 DD
77 215)
2
160
6.3.4 Klíče
Klíč Název Význam
#0 MSK_1201_0 Master – klíč aplikace
#1 MSK_1201_1 Čtení jízdenky 1 – 5, Kontroly jízdenky 1 – 5, Místenky 1 - 2
#2 MSK_1201_2 Čtení/zápis jízdenky 1 – 5, Místenky 1 – 2
#3 MSK_1201_3 Čtení/zápis Kontroly jízdenek 1 – 5
Vlastník dokumentace: Koordinátor ODIS s.ro. List 32/41
Struktura BČK Moravskoslezské karty
Klíč Název Význam
#4 MSK_1201_4 RFU
#5 MSK_1201_5 RFU
6.3.4.1 Přístupová práva souborů
Soubor Název Read Write Read & Write Change
Access Rights
0 Jízdenka 1 #1 #0 #2
1 Jízdenka 2 #1 #0 #2 #0
2 Jízdenka 3 #1 #0 #2 #0
3 Jízdenka 4 #1 #0 #2 #0
4 Jízdenka 5 #1 #0 #2 #0
5 Kontrola jízdenky 1 #1 #0 #3 #0
6 Kontrola jízdenky 2 #1 #0 #3 #0
7 Kontrola jízdenky 3 #1 #0 #3 #0
8 Kontrola jízdenky 4 #1 #0 #3 #0
9 Kontrola jízdenky 5 #1 #0 #3 #0
10 Místenka 1 #1 #0 #2 #0
11 Místenka 2 #1 #0 #2 #0
#0
Vlastník dokumentace: Koordinátor ODIS s.ro. List 33/41
Struktura BČK Moravskoslezské karty
6.4 Aplikace elektronická peněženka(EP)
• AID aplikace - 8895
• obsahuje 4 soubory
• V tomto dokumentu jsou popsány pouze struktury EP na kartě. Operacemi prováděnými s EP se
zabývá zvláštní dokument.
6.4.1 Soubor Nastavení EP
Soubor popisuje základní vlastnosti elektronické peněženky, dané typicky legislativou.
0 walletSettingsFile Standard Data File
Název Bitů Typ Typ Hodnota (popis)
editace
Verze 8 INT1 KC 1
Status 8
souboru KC 7 – status EP OK Nešifrovaná oblast
Typ podpisu 4 KC 0 souboru
Typ šifrování 4
logVersion 4 Verze souboru logů KC 0
RFU 36
KC 1
KC volné místo vyplněné
'0'B
walletInfo 384 Struktura KC 0 Potenciálně
walletSettingsInfo šifrovaná oblast
Podpis souboru
Využito 64
RFU 512
Celkem B
0
64 (= 2 × 32 B)
6.4.1.1 Struktura walletSettingsInfo
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
editace
contractNetwor Identifikace NetworkId 24 POS
k transportní sítě do
které patří vydavatel
EP
contractProvider Kód vydavatele EP ProviderID 8 POS
maxValueEP Maximální hodnota INT4 32 KC 450 000
EP
Pro CZK
s exponentem 2
nastaveno na 450
000
minValueEP Minimální hodnota INT4 32 KC 0
EP
Nastaveno na 0
maxDebet Maximální výše INT4 32 KC 0 – neomezeno
povoleného debetu
Vlastník dokumentace: Koordinátor ODIS s.ro. List 34/41
Struktura BČK Moravskoslezské karty
Proměnná Popis Datový typ Bit Typ Hodnota (popis)
maxOnePay editace
expirationDate
allowedDebet Maximální výše INT4 32 KC 0 – bez limitu
dobití
baseCurrencyEP
Datum expirace DateStamp 14 POS Nastaveno dle
RFU platnosti EP platnosti karty
Celkem bitů
Celkem byte Povolený debet 2 KC ‘00’B
‘00‘B – debet POS
povolen
‘01‘B – debet
zakázán
Měna EP dle EN PayUnitMa 4 KC ‘1000’B
1545 p
‘1000‘B – CZK v
haléřích
204
384
48
6.4.2 Soubor Osobní nastavení EP
Soubor popisuje aktuální uživatelské nastavení EP.
Se souborem se v MSK nepracuje, slouží pro případné budoucí využití.
1 walletPersonalSettingsFile Standard Data File
Název Nešifrovaná oblast souboru
Bitů Typ Typ Hodnota (popis)
Verze editace
Status 8 INT1
souboru 8 KC 1
Typ
podpisu KC 7
Typ
šifrování 4 KC 0
RFU
4 KC 0
walletInfo
40 KC volné místo vyplněné
Podpis '0'B
128
Využito Potenciálně šifrovaná
RFU Struktura oblast souboru
Celkem B walletPersonalSettingsInfo
64 POS
DD
256
0
32 (= 1 × 32 B)
Vlastník dokumentace: Koordinátor ODIS s.ro. List 35/41
Struktura BČK Moravskoslezské karty
6.4.2.1 Struktura walletPersonalSettingsInfo
Proměnná Popis Datový typ Bit Typ editace Hodnota (popis)
walletPersNetwork Identifikace transportní sítě do
které patří společnost, která NetworkId 24 POS
walletPersProvider záznam provedla
Společnost, která záznam DD
walletPersCreditTr provedla
ansaction ProviderID 8 POS
walletPersDate Číslo transakce kreditu
předplacené transakce DD
Datum zápisu souboru INT4 32 POS
DD
DateStamp 14 POS
DD
walletPersTime Čas zápisu souboru TimeStamp 11 POS
DD
walletStatus Status EP dle ČSN EN 1546-1 8 POS
RFU 31
Celkem bitů 128
Celkem byte 16
6.4.3 Hodnota EP
Hodnotový soubor bude vytvořen bez horního limitu.
2 valueEPFile Value File
Název Bitů Typ
valueEP 32 INT32 - Aktuální hodnota EP
Využito 32
Nevyužitelné 224
Celkem B 32 (= 1 × 32 B)
6.4.4 Log EP
Počet níže popsaných záznamů v souboru je 6, počet posledních uchovávaných transakcí je 5. Soubor typu CRF.
3 logEPFile Cyclic Record File
Název Bitů Typ Typ editace Hodnota (popis)
Verze 8 INT1 POS 1
DD
Status 8 POS 7
souboru DD
Nešifrovaná oblast
Typ podpisu 4 POS 3 (3DES-CBC-MAC8) souboru
DD
Typ šifrování 4 POS 0
DD
RFU 0 POS
DD
Log 168 Struktura logEPInfo Potenciálně
Vlastník dokumentace: Koordinátor ODIS s.ro. List 36/41
Struktura BČK Moravskoslezské karty
3 logEPFile Cyclic Record File
POS šifrovaná oblast
Podpis 64 DD Struktura od Verze souboru
po Log podepsána
klíčem
MSK_8895_SIGN
Využito 256
1 záznam 0
Nevyužito
v souboru 224 (= 7 × 32 B)
Celkem
soubor B Struktura logEPInfo
6.4.4.1
Proměnná Popis Datový typ Bit Typ editace Hodnota (popis)
counterEP
prevValueEP Pořadové číslo transakce v INT3 24 POS
changeEP
changeDevice rámci elektronické peněženky DD
samNumber na konkrétní kartě.
dateEP
timeEP Hodnota EP před transakcí INT4 32 POS
typeEP
DD
RFU
Hodnota transakce INT4 32 POS
DD
Číslo zařízení, které provedlo INT4 32 POS
záznam DD
čísloSAM, který provedl 16 POS Zapisuje SAM
záznam
DD
Datum transakce EP DateStamp 14 POS
DD
Čas transakce EP TimeStamp 11 POS
DD
Typ operace 4 POS
0 – inicializováno
1 – Debet DD
2 – Credit
3 – Limited credit
3
Celkem bitů 168
Celkem byte 21
Vlastník dokumentace: Koordinátor ODIS s.ro. List 37/41
Struktura BČK Moravskoslezské karty
6.4.5 Klíče
Klíč Název Význam
#0 MSK_8895_0 Master – klíč aplikace
#1 MSK_8895_1 Čtení souboru nastavení EP a osobní nastavení EP, Log EP
#2 MSK_8895_2 Zápis souboru nastavení EP
#3 MSK_8895_3 Čtení, debet (dekrementace) a limited credit souboru hodnota EP, zápis Log EP
#4 MSK_8895_4 Kredit (inkrementace) souboru hodnota EP
#5 MSK_8895_5 Zápis souboru osobního nastavení
6.4.5.1 Přístupová práva souborů
Soubor Název Read Write Read & Write Change
Access Rights
0 Nastavení EP #1 #0 #2
1 Osobní nastavení EP #1 #0 #5 #0
2 Hodnota EP #3 #3 #4 #0
3 Log EP #1 #0 #3 #0
#0
Vlastník dokumentace: Koordinátor ODIS s.ro. List 38/41
6.5 Rezerva 1 Struktura BČK Moravskoslezské karty
List 39/41
Aplikace „Rezerva 1“
• AID aplikace – 1202
• neobsahuje žádné soubory
• slouží jako rezervní aplikace
6.5.1 Struktura
• Není definována
6.5.2 Klíče
Klíč Název Význam
#0 MSK_1202_0 Master – klíč aplikace
#1 MSK_1202_1 RFU
#2 MSK_1202_2 RFU
#3 MSK_1202_3 RFU
#4 MSK_1202_4 RFU
#5 MSK_1202_5 RFU
6.6 Rezerva 2
Aplikace „Rezerva 2“
• AID aplikace – 1108
• neobsahuje žádné soubory
• slouží jako rezervní aplikace
6.6.1 Struktura
• Není definována
6.6.2 Klíče
Klíč Název Význam
#0 MSK_1108_0 Master – klíč aplikace
#1 MSK_1108_1 RFU
#2 MSK_1108_2 RFU
#3 MSK_1108_3 RFU
#4 MSK_1108_4 RFU
#5 MSK_1108_5 RFU
6.7 Rezerva 3
Aplikace „Rezerva 3“
• AID aplikace – 111A
• neobsahuje žádné soubory
• slouží jako rezervní aplikace
6.7.1 Struktura
• Není definována
Vlastník dokumentace: Koordinátor ODIS s.ro.
Struktura BČK Moravskoslezské karty
6.7.2 Klíče
Klíč Název Význam
#0 MSK_111A_0 Master – klíč aplikace
#1 MSK_111A_1 RFU
#2 MSK_111A_2 RFU
#3 MSK_111A_3 RFU
6.8 Rezerva 4
Aplikace „Rezerva 4“
• AID aplikace – 100B
• neobsahuje žádné soubory
• slouží jako rezervní aplikace
6.8.1 Struktura
• Není definována
6.8.2 Klíče
Klíč Název Význam
#0 MSK_100B_0 Master – klíč aplikace
#1 MSK_100B_1 RFU
#2 MSK_100B_2 RFU
#3 MSK_100B_3 RFU
Vlastník dokumentace: Koordinátor ODIS s.ro. List 40/41
Struktura BČK Moravskoslezské karty
Použité normativní dokumenty
ČSN EN 1545–1 : Systémy identifikačních karet – Aplikace pro povrchovou dopravu – Část 1: Základní datové
typy, všeobecný seznam kódů a datových prvků. Praha : Český normalizační institut, 2006. 98 s.
ČSN EN 15320 : Systémy s identifikačními kartami – Rozhraní přepravy – Interoperabilita veřejné přepravy osob
– Struktura (IOPTA). Praha : Český normalizační institut, 2008. 152 s.
ČSN EN ISO 24014–1 : Interoperabilní systém managementu jízdného – Část 1: Architektura. Praha : Český
normalizační institut, 2007. 76 s.
ČSN EN 1546–1 : Systémy s identifikačními kartami – Mezioborová elektronická peněženka – Část 1: Definice,
pojmy a struktury. Praha : Český normalizační institut, 1999. 36 s.
ČSN EN 1546–2 : Systémy s identifikačními kartami – Mezioborová elektronická peněženka – Část 2:
Bezpečnostní architektura. Praha : Český normalizační institut, 2000. 106 s.
ČSN EN 1546–3 : Systémy s identifikačními kartami – Mezioborová elektronická peněženka – Část 3: Datové
prvky a výměny. Praha : Český normalizační institut, 2000. 72 s.
ČSN EN 1546–4 : Systémy s identifikačními kartami – Mezioborová elektronická peněženka – Část 4: Datové
objekty. Praha : Český normalizační institut, 2000. 36s.
ČSN ISO/IEC 5218 : Informační technologie – Kódy pro prezentaci lidského pohlaví. Praha : Český normalizační
institut, 2006. 24s.
ČSN ISO 4217 : Kódy pro měny a fondy. Praha : Český normalizační institut, 2002. 20s.
ČSN ISO/IEC 11770–1 : Informační technologie – Bezpečnostní techniky – Správa klíčů – Část 1: Struktura. Praha
: Český normalizační institut, 19988. 28s.
ČSN ISO/IEC 11770–2 : Informační technologie – Bezpečnostní techniky – Správa klíčů – Část 2: Mechanismy
používající symetrické techniky. Praha : Český normalizační institut, 1999. 24s.
ČSN ISO/IEC 11770–3 : Informační technologie – Bezpečnostní techniky – Správa klíčů – Část 3: Mechanismy
používající asymetrické techniky. Praha : Český normalizační institut, 2002. 44s.
ČSN ISO/IEC 15946–1 : Informační technologie – Bezpečnostní techniky – Kryptografické techniky založené na
eliptických křivkách – Část 1: Všeobecně. Praha : Český normalizační institut, 2005. 32s.
ČSN ISO/IEC 15946–2 : Informační technologie – Bezpečnostní techniky – Kryptografické techniky založené na
eliptických křivkách – Část 2: Digitální podpisy. Praha : Český normalizační institut, 2006. 32s.
ČSN ISO/IEC 7816–5 : Identifikační karty – Karty s integrovanými obvody – Část 5: Registrace poskytovatelů
aplikací. Praha : Český normalizační institut, 2005. 12s.
ČSN ISO/IEC 7816–6 : Identifikační karty – Karty s integrovanými obvody – Část 6: Mezioborové datové prvky
pro výměnu. Praha : Český normalizační institut, 2005. 24s.
AN10787 MIFARE Application Directory (MAD) Rev. 04 — 5 March 2009
Vlastník dokumentace: Koordinátor ODIS s.ro. List 41/41
