為了提供更好的安全性，某些設備具有嵌入式安全元件 (SE)，它是專用的、獨立的防篡改硬件，用於儲存加密資料。開放式行動 API 是用於與裝置的安全元件通訊的標準 API 。 Android 9 引入了對此 API 的支持，並提供了包括安全元素服務和 SE HAL 的後端實作。
安全元件服務檢查對 Global 平台支援的安全元件的支援（本質上檢查設備是否具有 SE HAL 實現，如果是，則有多少）。這用作測試 API 和底層安全元件實現的基礎。
開放行動API測試案例
開放移動 API (OMAPI) 測試案例用於強制執行 API 準則並確認 Secure Elements 的底層實作符合開放移動 API 規範。這些測試案例需要安裝一個特殊的小程序，即 Secure Element 上的 Java Card 應用程序，CTS 應用程式使用它進行通訊。若要進行安裝，請使用google-cardlet.cap中找到的範例小程式。
要通過 OMAPI 測試案例，底層安全元素服務和 SE 應具備以下功能：
- 所有安全元件讀取器名稱應以 SIM、eSE 或 SD 開頭。
- 基於非 SIM 卡的讀卡機應能開啟基本通道。
-
CtsOmapiTestCases.apk不應能選擇 A000000476416E64726F6964435453FF AID： -
CtsOmapiTestCases.apk應該能夠選擇具有以下應用程式識別碼 (AID) 的小程式：- 0xA000000476416E64726F696443545331
- 當小程式在
android.se.omapi.Channel.Transmit( Transmit ) 中接收到下列應用程式協定資料單元 (APDU) 時，應拋出安全性例外：- 0x00700000
- 0x00708000
- 0x00A40404104A535231373754657374657220312E30
- 當小程式在Transmit中接收到以下 APDU 時，不應傳回任何資料：
- 0x00060000
- 0x80060000
- 0xA0060000
- 0x94060000
- 0x000A000001AA
- 0x800A000001AA
- 0xA00A000001AA
- 0x940A000001AA
- 小程式應為以下傳輸APDU 傳回 256 位元組資料：
- 0x0008000000
- 0x8008000000
- 0xA008000000
- 0x9408000000
- 0x000C000001AA00
- 0x800C000001AA00
- 0xA00C000001AA00
- 0x940C000001AA00
- 小程式應為對應的傳送APDU 傳回下列狀態字回應：
*回應應包含與輸入 APDU 相同的數據，但第一個位元組是 0x01 而不是 0x00。傳送APDU 狀態字 數據 0x00F30106 0x6200 不 0x00F30206 0x6281 不 0x00F30306 0x6282 不 0x00F30406 0x6283 不 0x00F30506 0x6285 不 0x00F30606 0x62F1 不 0x00F30706 0x62F2 不 0x00F30806 0x63F1 不 0x00F30906 0x63F2 不 0x00F30A06 0x63C2 不 0x00F30B06 0x6202 不 0x00F30C06 0x6280 不 0x00F30D06 0x6284 不 0x00F30E06 0x6286 不 0x00F30F06 0x6300 不 0x00F31006 0x6381 不 0x00F3010A01AA 0x6200 不 0x00F3020A01AA 0x6281 不 0x00F3030A01AA 0x6282 不 0x00F3040A01AA 0x6283 不 0x00F3050A01AA 0x6285 不 0x00F3060A01AA 0x62F1 不 0x00F3070A01AA 0x62F2 不 0x00F3080A01AA 0x63F1 不 0x00F3090A01AA 0x63F2 不 0x00F30A0A01AA 0x63C2 不 0x00F30B0A01AA 0x6202 不 0x00F30C0A01AA 0x6280 不 0x00F30D0A01AA 0x6284 不 0x00F30E0A01AA 0x6286 不 0x00F30F0A01AA 0x6300 不 0x00F3100A01AA 0x6381 不 0x00F3010800 0x6200 是的 0x00F3020800 0x6281 是的 0x00F3030800 0x6282 是的 0x00F3040800 0x6283 是的 0x00F3050800 0x6285 是的 0x00F3060800 0x62F1 是的 0x00F3070800 0x62F2 是的 0x00F3080800 0x63F1 是的 0x00F3090800 0x63F2 是的 0x00F30A0800 0x63C2 是的 0x00F30B0800 0x6202 是的 0x00F30C0800 0x6280 是的 0x00F30D0800 0x6284 是的 0x00F30E0800 0x6286 是的 0x00F30F0800 0x6300 是的 0x00F3100800 0x6381 是的 0x00F3010C01AA00 0x6200 是的* 0x00F3020C01AA00 0x6281 是的* 0x00F3030C01AA00 0x6282 是的* 0x00F3040C01AA00 0x6283 是的* 0x00F3050C01AA00 0x6285 是的* 0x00F3060C01AA00 0x62F1 是的* 0x00F3070C01AA00 0x62F2 是的* 0x00F3080C01AA00 0x63F1 是的* 0x00F3090C01AA00 0x63F2 是的* 0x00F30A0C01AA00 0x63C2 是的* 0x00F30B0C01AA00 0x6202 是的* 0x00F30C0C01AA00 0x6280 是的* 0x00F30D0C01AA00 0x6284 是的* 0x00F30E0C01AA00 0x6286 是的* 0x00F30F0C01AA00 0x6300 是的* 0x00F3100C01AA00 0x6381 是的* - 小程式應傳回分段回應，其中最後一個資料位元組為
0xFF，並具有後續 APDU 的對應狀態字和回應長度。APDU 狀態字 響應長度（位元組） 0x00C2080000 0x9000 2048 0x00C4080002123400 0x9000 2048 0x00C6080000 0x9000 2048 0x00C8080002123400 0x9000 2048 0x00C27FFF00 0x9000 32767 0x00CF080000 0x9000 2048 0x94C2080000 0x9000 2048 - 小程式應傳回 SELECT 指令中收到的 P2 值 + 給定 APDU 的成功狀態字（即
0x009000）：0x00F4000000
- 當小程式在
- A000000476416E64726F696443545332
- 選擇後，此 AID 應傳回大於 2 個位元組的選擇回應，該回應使用基本編碼規則 (BER) 和標記長度值 (TLV) 正確格式化。
- 0xA000000476416E64726F696443545331
CtsOmapiTestCases
- APK 的雜湊值： 0x5cc49e0bc83927486fbb3a17ed37276cbbceb290
存取控制測試用例
安全元件中配置的存取控制使用確保只有有權存取小程式的應用程式才能與其通訊。此外，Android 支援為可由 APK 交換的特定 APDU 設定規則。
若要通過這些測試，請設定特殊的存取控制規則，即存取規則應用程式主檔案 (ARA) 或存取規則檔案 (ARF)。您應該使用用於OMAPI 測試的小程序，因為需要支援相同的命令才能通過存取控制測試。
在這些 AID 下建立小程式的實例：
- 0xA000000476416E64726F696443545340
- 0xA000000476416E64726F696443545341
- 0xA000000476416E64726F696443545342
- 0xA000000476416E64726F696443545343
- 0xA000000476416E64726F696443545344
- 0xA000000476416E64726F696443545345
- 0xA000000476416E64726F696443545346
- 0xA000000476416E64726F696443545347
- 0xA000000476416E64726F696443545348
- 0xA000000476416E64726F696443545349
- 0xA000000476416E64726F69644354534A
- 0xA000000476416E64726F69644354534B
- 0xA000000476416E64726F69644354534C
- 0xA000000476416E64726F69644354534D
- 0xA000000476416E64726F69644354534E
- 0xA000000476416E64726F69644354534F
選擇後，這些 AID 中的任何一個都應傳回大於 2 個位元組的選擇回應，並且使用 BER 和 TLV 正確格式化。
CtsSecureElementAccessControlTestCases1
- APK 的雜湊值： 0x4bbe31beb2f753cfe71ec6bf112548687bb6c34e
授權的輔助器具
0xA000000476416E64726F696443545340
授權的 APDU：
- 0x00060000
- 0xA0060000
未經授權的 APDU：
- 0x0008000000
- 0x80060000
- 0xA008000000
- 0x9406000000
0xA000000476416E64726F696443545341
授權的 APDU：
- 0x94060000
- 0x9408000000
- 0x940C000001AA00
- 0x940A000001AA
未經授權的 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
未經授權的愛滋病毒
- 0xA000000476416E64726F696443545343
- 0xA000000476416E64726F696443545346
CtsSecureElementAccessControlTestCases2
- APK 的雜湊值： 0x93b0ff2260babd4c2a92c68aaa0039dc514d8a33
授權的輔助器具：
0xA000000476416E64726F696443545340
授權的 APDU：
- 0x00060000
- 0xA0060000
未經授權的 APDU：
- 0x0008000000
- 0x80060000
- 0xA008000000
- 0x9406000000
0xA000000476416E64726F696443545341
授權的 APDU：
- 0x94060000
- 0x9408000000
- 0x940C000001AA00
- 0x940A000001AA
未經授權的 APDU：
- 0x0006000
- 0x80060000
- 0xA0060000
- 0x0008000000
- 0x000A000001AA
- 0x800A000001AA
- 0xA00A000001AA
- 0x8008000000
- 0xA008000000
- 0x000C000001AA00
- 0x800C000001AA00
- 0xA00C000001AA00
0xA000000476416E64726F696443545343
0xA000000476416E64726F696443545345
0xA000000476416E64726F696443545346
未經授權的愛滋病毒
- 0xA000000476416E64726F696443545342
- 0xA000000476416E64726F696443545344
- 0xA000000476416E64726F696443545347
- 0xA000000476416E64726F696443545348
- 0xA000000476416E64726F696443545349
- 0xA000000476416E64726F69644354534A
- 0xA000000476416E64726F69644354534B
- 0xA000000476416E64726F69644354534C
- 0xA000000476416E64726F69644354534D
- 0xA000000476416E64726F69644354534E
- 0xA000000476416E64726F69644354534F
CtsSecureElementAccessControlTestCases3
- APK 的雜湊值： 0x5528ca826da49d0d7329f8117481ccb27b8833aa
授權的輔助器具：
0xA000000476416E64726F696443545340
授權的 APDU：
- 0x00060000
- 0x80060000
- 0xA0060000
- 0x94060000
- 0x000A000001AA
- 0x800A000001AA
- 0xA00A000001AA
- 0x940A000001AA
- 0x0008000000
- 0x8008000000
- 0xA008000000
- 0x9408000000
- 0x000C000001AA00
- 0x800C000001AA00
- A00C000001AA00
- 940C000001AA00
0xA000000476416E64726F696443545341
授權的 APDU：
- 0x94060000
- 0x9408000000
- 0x940C000001AA00
- 0x940A00000aAA
未經授權的 APDU：
- 0x00060000
- 0x80060000
- 0xA0060000
- 0x0008000000
- 0x000A000001AA
- 0x800A000001AA
- 0xA00A000001AA
- 0x8008000000
- 0xA008000000
- 0x000C000001AA00
- 0x800C000001AA00
- 0xA00C000001AA00
0xA000000476416E64726F696443545345
0xA000000476416E64726F696443545346
未經授權的愛滋病毒
- 0xA000000476416E64726F696443545342
- 0xA000000476416E64726F696443545343
- 0xA000000476416E64726F696443545344
- 0xA000000476416E64726F696443545347
- 0xA000000476416E64726F696443545348
- 0xA000000476416E64726F696443545349
- 0xA000000476416E64726F69644354534A
- 0xA000000476416E64726F69644354534B
- 0xA000000476416E64726F69644354534C
- 0xA000000476416E64726F69644354534D
- 0xA000000476416E64726F69644354534E
- 0xA000000476416E64726F69644354534F
附錄
UMTS 積體電路卡 (UICC) 的範例小程式和安裝步驟
1. 封裝規格
檔案名稱: google-cardlet.cap
封裝輔助： 6F 6D 61 70 69 63 61 72 64 6C 65 74
版本： 1.63
雜湊值： 5F72E0A073BA9E61A7358F2FE3F031A99F3F81E9
小程式：
6F 6D 61 70 69 4A 53 52 31 37 37 = 選擇響應模組
6F 6D 61 70 69 43 61 63 68 69 6E 67 = XXL響應模組
進口：
javacard.framework v1.3 - A0000000620101
java.lang v1.0 - A0000000620001
uicc.hci.framework v1.0 - A0000000090005FFFFFFFF8916010000
uicc.hci.services.cardemulation v1.0 - A0000000090005FFFFFFFF8916020100
uicc.hci.services.connectivity v1.0 - A0000000090005FFFFFF8916020200
卡片上尺寸： 39597
2、安裝步驟
使用適當的程式將google-cardlet.cap檔案載入到 SIM 卡（請諮詢您的 SE 製造商）。
為每個小程式執行安裝命令。
OMAPI 測試
安裝小程式的命令
80E60C00300C6F6D617069636172646C65740B module_AID 10 AID 01000EEF0AA008810101A5038201C0C9000000
模組_輔助：6F 6D 61 70 69 4A 53 52 31 37 37
援助： A000000476416E64726F696443545331
80E60C00310C6F6D617069636172646C65740B module_AID 10 AID 010002C9000
模組_輔助：6F 6D 61 70 69 43 61 63 68 69 6E 67
援助： A000000476416E64726F696443545332
AccessControl 測試（使用 PKCS#15 結構的範本）
80E60C003C0C6F6D617069636172646C65740B module_AID 10 AID 01000EEF0AA008810101A5038201C0C9000000
模組_輔助：6F 6D 61 70 69 4A 53 52 31 37 37
愛滋病:
- 0xA000000476416E64726F696443545340
- 0xA000000476416E64726F696443545341
- 0xA000000476416E64726F696443545342
- 0xA000000476416E64726F696443545344
- 0xA000000476416E64726F696443545345
- 0xA000000476416E64726F696443545347
- 0xA000000476416E64726F696443545348
- 0xA000000476416E64726F696443545349
- 0xA000000476416E64726F69644354534A
- 0xA000000476416E64726F69644354534B
- 0xA000000476416E64726F69644354534C
- 0xA000000476416E64726F69644354534D
- 0xA000000476416E64726F69644354534E
- 0xA000000476416E64726F69644354534F
有關設定與 CTS 測試相符的 PKCS#15 結構的逐步命令，請參閱PKCS#15 的命令。