GPD_TEE_SE_API

需积分: 9 43 浏览量更新于2023-05-28 收藏 580KB PDF 举报

身份认证购VIP最低享 7 折!

领优惠券(最高得80元）

资源详情

资源推荐

Recipients of this document are invited to submit, with their comments, notification of any relevant patents or other intellectual

property rights (collectively, “IPR”) of which they may be aware which might be necessarily infringed by the implementation of

the specification or other work product set forth in this document, and to provide supporting documentation. The technology

provided or described herein is subject to updates, revisions, and extensions by GlobalPlatform. Use of this information is

governed by the GlobalPlatform license agreement and any use inconsistent with that agreement is strictly prohibited.

GlobalPlatform Device Technology

TEE Secure Element API

Version 1.1

Public Release

July 2015

Document Reference: GPD_SPE_024

TEE Secure Element API – Public Release v1.1 3 / 57

The technology provided or described herein is subject to updates, revisions, and extensions by GlobalPlatform. Use of this

information is governed by the GlobalPlatform license agreement and any use inconsistent with that agreement is strictly

prohibited.

Contents

1 Introduction ............................................................................................................................ 6

1.1 Audience ............................................................................................................................................... 6

1.2 IPR Disclaimer....................................................................................................................................... 6

1.3 References ............................................................................................................................................ 6

1.4 Terminology and Definitions .................................................................................................................. 7

1.5 Abbreviations and Notations ................................................................................................................. 9

1.6 Revision History .................................................................................................................................. 10

2 Background .......................................................................................................................... 11

3 Requirements for TEE Secure Element API ........................................................................ 12

3.1 Assumptions and Scope ..................................................................................................................... 12

3.1.1 Error Handling .............................................................................................................................. 12

3.1.2 Implementations ........................................................................................................................... 12

4 API Overview ........................................................................................................................ 13

5 Transport Layer API ............................................................................................................. 15

5.1 Header File .......................................................................................................................................... 15

5.2 Constants ............................................................................................................................................ 15

5.2.1 Return Codes ............................................................................................................................... 15

5.2.2 Secure Element Reader Properties ............................................................................................. 15

5.2.3 Secure Element Applet’s AID ....................................................................................................... 16

5.2.4 Handles ........................................................................................................................................ 16

5.3 API Levels and Classes ...................................................................................................................... 17

5.4 Specification Version Number Property .............................................................................................. 18

5.5 SEService Class ................................................................................................................................. 19

5.5.1 TEE_SEServiceOpen ................................................................................................................... 19

5.5.2 TEE_SEServiceClose .................................................................................................................. 20

5.5.3 TEE_SEServiceGetReaders ........................................................................................................ 21

5.6 SEReader Class .................................................................................................................................. 22

5.6.1 TEE_SEReaderGetProperties ..................................................................................................... 22

5.6.2 TEE_SEReaderGetName ............................................................................................................ 23

5.6.3 TEE_SEReaderOpenSession ...................................................................................................... 24

5.6.4 TEE_SEReaderCloseSessions .................................................................................................... 25

5.7 SESession Class ................................................................................................................................. 26

5.7.1 TEE_SESessionGetATR .............................................................................................................. 26

5.7.2 TEE_SESessionIsClosed ............................................................................................................. 27

5.7.3 TEE_SESessionClose ................................................................................................................. 28

5.7.4 TEE_SESessionCloseChannels .................................................................................................. 28

5.7.5 TEE_SESessionOpenBasicChannel ........................................................................................... 29

5.7.6 TEE_SESessionOpenLogicalChannel ......................................................................................... 31

5.8 SEChannel Class ................................................................................................................................ 32

5.8.1 TEE_SEChannelClose ................................................................................................................. 32

5.8.2 TEE_SEChannelSelectNext ......................................................................................................... 33

5.8.3 TEE_SEChannelGetSelectResponse .......................................................................................... 34

5.8.4 TEE_SEChannelTransmit ............................................................................................................ 35

5.8.5 TEE_SEChannelGetResponseLength ......................................................................................... 37

6 Service Layer APIs ............................................................................................................... 38

6.1 Discovery API ...................................................................................................................................... 38

6.1.1 Property ........................................................................................................................................ 38

4 / 57 TEE Secure Element API – Public Release v1.1

The technology provided or described herein is subject to updates, revisions, and extensions by GlobalPlatform. Use of this

information is governed by the GlobalPlatform license agreement and any use inconsistent with that agreement is strictly

prohibited.

6.1.2 Discovery Handle ......................................................................................................................... 38

6.1.3 TEE_SEDiscoveryByAIDInit ......................................................................................................... 39

6.1.4 TEE_SEDiscoveryByHistoricalBytesInit ....................................................................................... 40

6.1.5 TEE_SEDiscoveryByATRInit ....................................................................................................... 41

6.1.6 TEE_SEDiscoveryFirstMatch ....................................................................................................... 42

6.1.7 TEE_SEDiscoveryNextMatch ...................................................................................................... 43

6.1.8 TEE_SEDiscoveryIsDone ............................................................................................................ 44

6.1.9 TEE_SEDiscoveryClose .............................................................................................................. 44

6.2 Secure Channel API ............................................................................................................................ 45

6.2.1 Property ........................................................................................................................................ 45

6.2.2 Secure Channel Parameters ........................................................................................................ 45

6.2.2.1 TEE_SC_Params ................................................................................................................. 45

6.2.2.2 TEE_SC_OID ....................................................................................................................... 46

6.2.2.3 TEE_SC_SecurityLevel ....................................................................................................... 46

6.2.2.4 TEE_SC_CardKeyRef.......................................................................................................... 47

6.2.2.5 TEE_SC_DeviceKeyRef ...................................................................................................... 47

6.2.2.6 TEE_SC_KeyType ............................................................................................................... 47

6.2.2.7 TEE_SC_KeySetRef ............................................................................................................ 48

6.2.3 Secure Channel Protocol Support................................................................................................ 49

6.2.4 Security Levels ............................................................................................................................. 50

6.2.5 TEE_SESecureChannelOpen ...................................................................................................... 51

6.2.6 TEE_SESecureChannelGetSecurityLevel ................................................................................... 53

6.2.7 TEE_SESecureChannelClose ..................................................................................................... 55

Annex A Panicked Function Identification ............................................................................. 56

TEE Secure Element API – Public Release v1.1 5 / 57

The technology provided or described herein is subject to updates, revisions, and extensions by GlobalPlatform. Use of this

information is governed by the GlobalPlatform license agreement and any use inconsistent with that agreement is strictly

prohibited.

Figures

Figure 4-1: Typical Device with Multiple SE Readers ..................................................................................... 13

Figure 6-1: Discovery Mechanism ................................................................................................................... 38

Tables

Table 1-1: Normative References ...................................................................................................................... 6

Table 1-2: Informative References .................................................................................................................... 7

Table 1-3: Terminology and Definitions ............................................................................................................. 7

Table 1-4: Abbreviations and Notations ............................................................................................................ 9

Table 1-5: Revision History ............................................................................................................................. 10

Table 5-1: API Return Codes .......................................................................................................................... 15

Table 5-2: API Levels and Classes ................................................................................................................. 17

Table 5-3: Specification Version Number Property – 32-bit Integer Structure ................................................ 18

Table 6-1: Secure Channel Protocol Type OIDs ............................................................................................. 49

Table 6-2: Secure Channel Type Constants ................................................................................................... 49

Table 6-3: Secure Channel Protocol Features ................................................................................................ 49

Table 6-4: Security Level Constants ................................................................................................................ 50

Table 6-5: Security Level Coding .................................................................................................................... 53

Table A-1: Function Identification Values ........................................................................................................ 56