Aby zapewnić wyższy poziom bezpieczeństwa, niektóre urządzenia mają wbudowany element zabezpieczeń (SE), czyli oddzielny sprzęt odporny na manipulacje, na którym są przechowywane dane kryptograficzne. Open Mobile API to standardowy interfejs API używany do komunikacji z elementem zabezpieczeń urządzenia. Android 9 wprowadza obsługę tego interfejsu API i zapewnia implementację backendu, w tym Secure Element Service i SE HAL.
Usługa Bezpieczny element sprawdza obsługę globalnych bezpiecznych elementów obsługiwanych przez platformę (głównie sprawdza, czy urządzenia mają implementację SE HAL, a jeśli tak, to ile). Jest on używany jako podstawa do testowania interfejsu API i podstawowej implementacji elementu zabezpieczeń.
Otwieranie przypadków testowych interfejsu Mobile API
Przypadki testowe interfejsu Open Mobile API (OMAPI) służą do egzekwowania wytycznych interfejsu API i potwierdzenia, że implementacja elementów zabezpieczeń spełnia specyfikację interfejsu Open Mobile API. Te przypadki testowe wymagają zainstalowania specjalnej aplikacji JavaCard na Secure Element, która jest używana przez aplikację CTS do komunikacji. Do instalacji użyj przykładowego apletu ze strony google-cardlet.cap
.
Aby przejść testy OMAPI, usługa Secure Element Service i urządzenie SE powinny:
- Wszystkie nazwy czytników Secure Element powinny zaczynać się od SIM, eSE lub SD.
- Czytniki nieobsługujące kart SIM powinny mieć możliwość otwierania podstawowych kanałów.
CtsOmapiTestCases.apk
nie powinna mieć możliwości wybrania identyfikatora A000000476416E64726F6964435453FF AID:CtsOmapiTestCases.apk
powinien mieć możliwość wyboru apletu z tymi identyfikatorami aplikacji (AID):- 0xA000000476416E64726F696443545331
- Applet powinien wywołać wyjątek zabezpieczeń, gdy otrzyma te jednostki danych protokołu aplikacji (APDU) w
android.se.omapi.Channel.Transmit
(Transmit):- 0x00700000
- 0x00708000
- 0x00A40404104A535231373754657374657220312E30
- Applet nie powinien zwracać żadnych danych, gdy otrzyma te dane:APDU w Transmit:
- 0x00060000
- 0x80060000
- 0xA0060000
- 0x94060000
- 0x000A000001AA
- 0x800A000001AA
- 0xA00A000001AA
- 0x940A000001AA
- Aplet powinien zwrócić 256-bajtowe dane dla tych jednostek interfejsu Transmit (APDU):
- 0x0008000000
- 0x8008000000
- 0xA008000000
- 0x9408000000
- 0x000C000001AA00
- 0x800C000001AA00
- 0xA00C000001AA00
- 0x940C000001AA00
- W przypadku odpowiedniego Transmit APDU applet powinien zwracać te odpowiedzi słowne stanu:
Przesyłanie APDU Słowo stanu Dane 0x00F30106 0x6200 Nie 0x00F30206 0x6281 Nie 0x00F30306 0x6282 Nie 0x00F30406 0x6283 Nie 0x00F30506 0x6285 Nie 0x00F30606 0x62F1 Nie 0x00F30706 0x62F2 Nie 0x00F30806 0x63F1 Nie 0x00F30906 0x63F2 Nie 0x00F30A06 0x63C2 Nie 0x00F30B06 0x6202 Nie 0x00F30C06 0x6280 Nie 0x00F30D06 0x6284 Nie 0x00F30E06 0x6286 Nie 0x00F30F06 0x6300 Nie 0x00F31006 0x6381 Nie 0x00F3010A01AA 0x6200 Nie 0x00F3020A01AA 0x6281 Nie 0x00F3030A01AA 0x6282 Nie 0x00F3040A01AA 0x6283 Nie 0x00F3050A01AA 0x6285 Nie 0x00F3060A01AA 0x62F1 Nie 0x00F3070A01AA 0x62F2 Nie 0x00F3080A01AA 0x63F1 Nie 0x00F3090A01AA 0x63F2 Nie 0x00F30A0A01AA 0x63C2 Nie 0x00F30B0A01AA 0x6202 Nie 0x00F30C0A01AA 0x6280 Nie 0x00F30D0A01AA 0x6284 Nie 0x00F30E0A01AA 0x6286 Nie 0x00F30F0A01AA 0x6300 Nie 0x00F3100A01AA 0x6381 Nie 0x00F3010800 0x6200 Tak 0x00F3020800 0x6281 Tak 0x00F3030800 0 × 6282 Tak 0x00F3040800 0x6283 Tak 0x00F3050800 0x6285 Tak 0x00F3060800 0x62F1 Tak 0x00F3070800 0x62F2 Tak 0x00F3080800 0x63F1 Tak 0x00F3090800 0x63F2 Tak 0x00F30A0800 0x63C2 Tak 0x00F30B0800 0x6202 Tak 0x00F30C0800 0x6280 Tak 0x00F30D0800 0x6284 Tak 0x00F30E0800 0x6286 Tak 0x00F30F0800 0x6300 Tak 0x00F3100800 0x6381 Tak 0x00F3010C01AA00 0x6200 Tak* 0x00F3020C01AA00 0x6281 Tak* 0x00F3030C01AA00 0x6282 Tak* 0x00F3040C01AA00 0x6283 Tak* 0x00F3050C01AA00 0x6285 Tak* 0x00F3060C01AA00 0x62F1 Tak* 0x00F3070C01AA00 0x62F2 Tak* 0x00F3080C01AA00 0x63F1 Tak* 0x00F3090C01AA00 0x63F2 Tak* 0x00F30A0C01AA00 0x63C2 Tak* 0x00F30B0C01AA00 0x6202 Tak* 0x00F30C0C01AA00 0x6280 Tak* 0x00F30D0C01AA00 0x6284 Tak* 0x00F30E0C01AA00 0x6286 Tak* 0x00F30F0C01AA00 0x6300 Tak* 0x00F3100C01AA00 0x6381 Tak* - Applet powinien zwracać odpowiedzi podzielone na segmenty z
0xFF
jako ostatnim bajtem danych oraz mieć odpowiednie słowa stanu i odpowiednie długości odpowiedzi dla tych APDU.APDU Słowo stanu Długość odpowiedzi (bajty) 0x00C2080000 0x9000 2048 0x00C4080002123400 0x9000 2048 0x00C6080000 0x9000 2048 0x00C8080002123400 0x9000 2048 0x00C27FFF00 0x9000 32767 0x00CF080000 0x9000 2048 0x94C2080000 0x9000 2048 - Applet powinien zwrócić wartość P2 otrzymaną w komendzie SELECT oraz słowo stanu powodzenia (np.
0x009000
) dla danego APDU: 0x00F4000000.
- Applet powinien wywołać wyjątek zabezpieczeń, gdy otrzyma te jednostki danych protokołu aplikacji (APDU) w
- A000000476416E64726F696443545332
- Gdy ta opcja jest wybrana, AID powinien zwrócić odpowiedź typu select o wielokrotności większej niż 2 bajty, która jest prawidłowo sformatowana za pomocą zasad kodowania podstawowego (BER) i tagu długość-wartość (TLV).
- 0xA000000476416E64726F696443545331
CtsOmapiTestCases
- Hash pliku APK: 0x5cc49e0bc83927486fbb3a17ed37276cbbceb290
Przypadki testowe dotyczące kontroli dostępu
Kontrola dostępu korzysta z elementu chronionego, aby zapewnić, że tylko aplikacja z dostępem do appleta może z nim się komunikować. Dodatkowo Android obsługuje konfigurowanie reguł dla konkretnych aplikacji na platformie APK, które mogą być wymieniane przez plik APK.
Aby zaliczyć te testy, skonfiguruj specjalne reguły kontroli dostępu: Access Rule Application Master (ARA) lub Access Rule File (ARF). Użyj appleta używanego do testów OMAPI, ponieważ do zaliczenia testów kontroli dostępu wymagane jest obsługiwanie tych samych poleceń.
Utwórz instancję appleta pod tymi identyfikatorami AID:
- 0xA000000476416E64726F696443545340
- 0xA000000476416E64726F696443545341
- 0xA000000476416E64726F696443545342
- 0xA000000476416E64726F696443545343
- 0xA000000476416E64726F696443545344
- 0xA000000476416E64726F696443545345
- 0xA000000476416E64726F696443545346
- 0xA000000476416E64726F696443545347
- 0xA000000476416E64726F696443545348
- 0xA000000476416E64726F696443545349
- 0xA000000476416E64726F69644354534A
- 0xA000000476416E64726F69644354534B
- 0xA000000476416E64726F69644354534C
- 0xA000000476416E64726F69644354534D
- 0xA000000476416E64726F69644354534E
- 0xA000000476416E64726F69644354534F
Po wybraniu dowolny z tych identyfikatorów AID powinien zwrócić odpowiedź typu select o długości większej niż 2 bajty, prawidłowo sformatowaną za pomocą BER i TLV.
CtsSecureElementAccessControlTestCases1
- Hash pliku APK: 0x4bbe31beb2f753cfe71ec6bf112548687bb6c34e
Autoryzowane identyfikatory AID
0xA000000476416E64726F696443545340
Autoryzowane APDU:
- 0x00060000
- 0xA0060000
Nieautoryzowane APDU:
- 0x0008000000
- 0x80060000
- 0xA008000000
- 0x9406000000
0xA000000476416E64726F696443545341
Autoryzowane urządzenia ADU:
- 0x94060000
- 0x9408000000
- 0x940C000001AA00
- 0x940A000001AA
Nieautoryzowane APDU:
- 0x00060000
- 0x80060000
- 0xA0060000
- 0x0008000000
- 0x000A000001AA
- 0x800A000001AA
- 0xA00A000001AA
- 0x8008000000
- 0xA008000000
- 0x000C0000001AA00
- 0x800C000001AA00
- 0xA00C000001AA00
0xA000000476416E64726F696443545342
0xA000000476416E64726F696443545344
0xA000000476416E64726F696443545345
0xA000000476416E64726F696443545347
0xA000000476416E64726F696443545348
0xA000000476416E64726F696443545349
0xA000000476416E64726F69644354534A
0xA000000476416E64726F69644354534B
0xA000000476416E64726F69644354534C
0xA000000476416E64726F69644354534D
0xA000000476416E64726F69644354534E
0xA000000476416E64726F69644354534F
Nieautoryzowane identyfikatory AID
- 0xA000000476416E64726F696443545343
- 0xA000000476416E64726F696443545346
CtsSecureElementAccessControlTestCases2
- Skrót pliku APK: 0x93b0ff2260babd4c2a92c68aaa0039dc514d8a33
Upoważnione identyfikatory AID:
0xA000000476416E64726F696443545340
Autoryzowane APDU:
- 0x00060000
- 0xA0060000
Nieautoryzowane APDU:
- 0x0008000000
- 0x80060000
- 0xA008000000
- 0x9406000000
0xA000000476416E64726F696443545341
Autoryzowane urządzenia ADU:
- 0x94060000
- 0x9408000000
- 0x940C000001AA00
- 0x940A000001AA
Nieautoryzowane APDU:
- 0x0006000
- 0x80060000
- 0xA0060000
- 0x0008000000
- 0x000A000001AA
- 0x800A000001AA
- 0xA00A000001AA
- 0x8008000000
- 0xA008000000
- 0x000C000001AA00
- 0x800C000001AA00
- 0xA00C000001AA00
0xA000000476416E64726F696443545343
0xA000000476416E64726F696443545345
0xA000000476416E64726F696443545346
Nieautoryzowane identyfikatory AID
- 0xA000000476416E64726F696443545342
- 0xA000000476416E64726F696443545344
- 0xA000000476416E64726F696443545347
- 0xA000000476416E64726F696443545348
- 0xA000000476416E64726F696443545349
- 0xA000000476416E64726F69644354534A
- 0xA000000476416E64726F69644354534B
- 0xA000000476416E64726F69644354534C
- 0xA000000476416E64726F69644354534D
- 0xA000000476416E64726F69644354534E
- 0xA000000476416E64726F69644354534F
CtsSecureElementAccessControlTestCases3
- Hash pliku APK: 0x5528ca826da49d0d7329f8117481ccb27b8833aa
Autoryzowane identyfikatory AID:
0xA000000476416E64726F696443545340
Autoryzowane APDU:
- 0x00060000
- 0x80060000
- 0xA0060000
- 0x94060000
- 0x000A000001AA
- 0x800A000001AA
- 0xA00A000001AA
- 0x940A000001AA
- 0x0008000000
- 0x8008000000
- 0xA008000000
- 0x9408000000
- 0x000C000001AA00
- 0x800C000001AA00
- A00C000001AA00
- 940C000001AA00
0xA000000476416E64726F696443545341
Autoryzowane urządzenia ADU:
- 0x94060000
- 0x9408000000
- 0x940C000001AA00
- 0x940A00000aAA
Nieautoryzowane APDU:
- 0x00060000
- 0x80060000
- 0xA0060000
- 0x0008000000
- 0x000A000001AA
- 0x800A000001AA
- 0xA00A000001AA
- 0x8008000000
- 0xA008000000
- 0x000C000001AA00
- 0x800C000001AA00
- 0xA00C000001AA00
0xA000000476416E64726F696443545345
0xA000000476416E64726F696443545346
Nieautoryzowane identyfikatory AID
- 0xA000000476416E64726F696443545342
- 0xA000000476416E64726F696443545343
- 0xA000000476416E64726F696443545344
- 0xA000000476416E64726F696443545347
- 0xA000000476416E64726F696443545348
- 0xA000000476416E64726F696443545349
- 0xA000000476416E64726F69644354534A
- 0xA000000476416E64726F69644354534B
- 0xA000000476416E64726F69644354534C
- 0xA000000476416E64726F69644354534D
- 0xA000000476416E64726F69644354534E
- 0xA000000476416E64726F69644354534F
Dodatek
Przykładowa aplikacja i procedura instalacji karty UMTS (UICC)
1. Specyfikacja pakietu
Nazwa pliku: google-cardlet.cap
AID pakietu: 6F 6D 61 70 69 63 61 72 64 6C 65 74
Wersja: 1.63
Suma kontrolna: 5F72E0A073BA9E61A7358F2FE3F031A99F3F81E9
Applets:
6F 6D 61 70 69 4A 53 52 31 37 37 = SelectResponse module
6F 6D 61 70 69 43 61 63 68 69 6E 67 = XXLResponse module
Importy:
javacard.framework w wersji 1.3 – A0000000620101
java.lang w wersji 1.0 – A0000000620001
uicc.hci.framework w wersji 1.0 – A0000000090005FFFFFFFF8916010000
uicc.hci.services.cardemulation w wersji 1.0 – A0000000090005FFFFFFFF8916020100
uicc.hci.services.connectivity w wersji 1.0 – A0000000090005FFFFFFFF8916020200
Rozmiar na karcie: 39597
2. Etapy instalacji
Wczytaj plik google-cardlet.cap
na kartę SIM, postępując zgodnie z odpowiednią procedurą (skontaktuj się z producentami układów scalonych).
Uruchom polecenie instalacji dla każdej aplikacji.
Testy OMAPI
Polecenie instalacji appleta
80E60C00300C6F6D617069636172646C65740Bmodule_AID10AID01000EEF0AA008810101A5038201C0C9000000
Module_AID: 6F 6D 61 70 69 4A 53 52 31 37 37
AID: A000000476416E64726F696443545331
80E60C00310C6F6D617069636172646C65740Bmodule_AID10AID010002C9000
Module_AID: 6F 6D 61 70 69 43 61 63 68 69 6E 67
AID: A000000476416E64726F696443545332
Testy kontroli dostępu (szablon korzystający ze struktury PKCS#15)
80E60C003C0C6F6D617069636172646C65740Bmodule_AID10AID01000EEF0AA008810101A5038201C0C9000000
Module_AID: 6F 6D 61 70 69 4A 53 52 31 37 37
Identyfikatory AID:
- 0xA000000476416E64726F696443545340
- 0xA000000476416E64726F696443545341
- 0xA000000476416E64726F696443545342
- 0xA000000476416E64726F696443545344
- 0xA000000476416E64726F696443545345
- 0xA000000476416E64726F696443545347
- 0xA000000476416E64726F696443545348
- 0xA000000476416E64726F696443545349
- 0xA000000476416E64726F69644354534A
- 0xA000000476416E64726F69644354534B
- 0xA000000476416E64726F69644354534C
- 0xA000000476416E64726F69644354534D
- 0xA000000476416E64726F69644354534E
- 0xA000000476416E64726F69644354534F
Szczegółowe instrukcje konfigurowania struktury PKCS#15 pasującej do testów CTS znajdziesz w sekcji Polecenia dla PKCS#15.