没有合适的资源?快使用搜索试试~ 我知道了~
GPD_TEE_SE_API
需积分: 9 7 下载量 32 浏览量
2018-01-02
11:45:08
上传
评论
收藏 580KB PDF 举报
温馨提示
试读
57页
GPD_TEE_SE_API_v1.1.pdf文档规范,TEE,SE,GP规范,globalplatform
资源推荐
资源详情
资源评论
Copyright 2012-2015, GlobalPlatform, Inc. All Rights Reserved.
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
Copyright 2012-2015 GlobalPlatform, Inc. All Rights Reserved.
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.
THIS SPECIFICATION OR OTHER WORK PRODUCT IS BEING OFFERED WITHOUT ANY WARRANTY
WHATSOEVER, AND IN PARTICULAR, ANY WARRANTY OF NON-INFRINGEMENT IS EXPRESSLY
DISCLAIMED. ANY IMPLEMENTATION OF THIS SPECIFICATION OR OTHER WORK PRODUCT SHALL
BE MADE ENTIRELY AT THE IMPLEMENTER’S OWN RISK, AND NEITHER THE COMPANY, NOR ANY
OF ITS MEMBERS OR SUBMITTERS, SHALL HAVE ANY LIABILITY WHATSOEVER TO ANY
IMPLEMENTER OR THIRD PARTY FOR ANY DAMAGES OF ANY NATURE WHATSOEVER DIRECTLY
OR INDIRECTLY ARISING FROM THE IMPLEMENTATION OF THIS SPECIFICATION OR OTHER
WORK PRODUCT.
TEE Secure Element API – Public Release v1.1 3 / 57
Copyright 2012-2015 GlobalPlatform, Inc. All Rights Reserved.
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
Copyright 2012-2015 GlobalPlatform, Inc. All Rights Reserved.
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
Copyright 2012-2015 GlobalPlatform, Inc. All Rights Reserved.
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
剩余56页未读,继续阅读
资源评论
北国客
- 粉丝: 65
- 资源: 21
上传资源 快速赚钱
- 我的内容管理 展开
- 我的资源 快来上传第一个资源
- 我的收益 登录查看自己的收益
- 我的积分 登录查看自己的积分
- 我的C币 登录后查看C币余额
- 我的收藏
- 我的下载
- 下载帮助
安全验证
文档复制为VIP权益,开通VIP直接复制
信息提交成功