GP Open Mobile API V3.3传输测试规范专利与授权公告

需积分: 5 90 浏览量更新于2024-06-27 收藏 2.31MB PDF 举报

本文档是GlobalPlatform Technology发布的Open Mobile API (OMAPI) 测试规范的最新版本，即Transport API v3.3，于2018年11月公开发布。该规范旨在确保设备和服务提供商在实现和遵循GP Open Mobile API时，能够达到标准一致性并避免侵犯知识产权。文档的版权归属GlobalPlatform， Inc.，所有权利受保护。重要的是，接收此文档的各方被邀请分享他们所知可能与本规范或相关技术实施有关的任何专利或其他知识产权（统称为“IPR”），并提供支持性文件。这表明，尽管技术内容可能会随着时间和需求变化而更新、修订和扩展，但其使用必须遵循GlobalPlatform的许可证协议，任何不符合该协议的行为都将被严格禁止。全球平台技术提供的Open Mobile API Test Specification for Transport API v3.3涵盖了测试框架，旨在确保在传输层上实现OMAPI功能的正确性和兼容性。它详细规定了接口定义、数据格式、安全措施和错误处理等方面的要求，确保设备之间的互操作性，尤其是在移动支付、身份验证和金融交易等领域。值得注意的是，文档的发布伴随着一份文档参考，GPP_SPE_004，这是整个OMAPI测试规格系列的一部分。对于任何想要采用或开发基于GP Open Mobile API的产品和服务的开发者来说，理解和遵守这份测试规范至关重要，因为它为开发者提供了清晰的指导，如何按照既定的标准进行设计、开发和测试，以确保产品符合国际标准并能够在广泛的平台上无缝运行。 GP Open Mobile API 测试规范v3.3是推动移动设备安全和标准化的重要工具，它不仅强调了知识产权保护，还为确保全球范围内移动应用服务的互操作性和安全性奠定了基础。开发者在使用过程中，应确保遵守文档中的各项规定，同时保持对最新版规范的关注，以适应不断演进的技术环境。

16 / 117 OMAPI Test Specification for Transport API – Public Release v3.3

R RIRP,G

UGGUGUGUGUGUP

UPUGUPUPGUPU

UG

2.3 TableofDUTOptions

The DUT supplier shall specify the following information:

• Supported readers (number and type)

• Supported Platform Binding (e.g. Android Binding)

• Core version of OMAPI implemented by the DUT

• ATR of the eSE and mSD, if available

The DUT supplier shall state the support of possible options in Table 2-1 for each SE.

Table2-1:DUTOptions

Item



Option



Status



Optional

Item



DUT offers possibility to log ATR and APDU communication to

eSE or mSD

OP OP-001

2 Access to the basic channel is blocked by the DUT OP OP-002

3 Access to the basic channel is allowed by the DUT OP OP-003

4 The ATR is available OP OP-004

5 The ATR is not available OP OP-005

6 DUT supports T=0 communication with UICC OP OP-006

7 DUT supports T=1 communication with UICC OP OP-007

The selection response can be retrieved by the reader

implementation

OP OP-008

The selection response cannot be retrieved by the reader

implementation

OP OP-009

10 Access to the default applet is allowed by the DUT OP OP-010

11 Access to the default applet is blocked by the DUT OP OP-011

12 DUT knows when all SE logical channels are already opened OP OP-012

DUT relies on SE to know if all logical channels are already

opened and check access control rules on openSession. This

DUT option shall not be used from OMAPI v3.3. See Note 1.

OP OP-013

DUT relies on SE to know if all logical channels are already

opened and check access control rules on openLogicalChannel.

See Note 1.

OP OP-014

15 VOID

16 VOID

DUT has a reader from which the SE (UICC, or mSD) is

removable also when the DUT is in power on state (e.g. DUT

with UICC/mSD tray).

OP OP-017

DUT has a reader from which the SE (UICC, or mSD) is

removable only when the DUT is in power off state (e.g. DUT

with UICC/mSD under the battery)

OP OP-018

18 / 117 OMAPI Test Specification for Transport API – Public Release v3.3

R RIRP,G

UG

2.4 ApplicabilityTable

Table 2-2 specifies the applicability of each test case.

Table2-2:ApplicabilityTable

Clause TestCaseNumberandDescription

Core

Version

SUE

RSE



UICC



eSE



mSD



class SEService

6.1.1

Constructor: SEService(Context context,

SEService.CallBack listener) ID1 – ID3, ID5,

ID6

2.05 M M M M

6.1.1

Constructor: SEService(Context context,

SEService.CallBack listener) ID4

2.05 OP-022 OP-022 OP-022 OP-022

6.1.2 Method: Reader[] getReaders() 2.05 M M M M

6.1.3 Method: Boolean isConnected () 2.05 M M M M

6.1.4 Method: Void shutdown () 2.05 M M M M

6.1.5 Method: String getVersion() 2.05 M M M M

6.2.1

Method: Void serviceConnected(SEService

service)

2.05 OP-022 OP-022 OP-022 OP-022

class Reader

6.3.1 Method: String getName() 2.05 M M M M

6.3.2 Method SEService getSEService() 2.05 M M M M

6.3.3

Method: Boolean isSecureElementPresent()

ID1

2.05 M M M M

6.3.3

Method: Boolean isSecureElementPresent()

ID2

2.05 M M N/A M

6.3.4 Method: Session openSession() 2.05 M M M M

6.3.5 Method: Void closeSessions() ID1 2.05 M M M M

6.3.5 Method: Void closeSessions() ID2 2.05 M M N/A N/A

6.3.5 Method: void closeSessions() ID3 2.05 N/A N/A OP-023 OP-023

6.3.6 Reader: Event types value ID1 3.2 OP-019 OP-019 OP-019 OP-019

6.3.6 Reader: Event types value ID2 3.2 OP-019 OP-019 N/A OP-019

6.3.7

Method: Void

registerReaderEventCallback(Reader.Event

CallBack cb) ID1 – ID3

3.2 OP-019 OP-019 OP-019 OP-019

6.3.7

Method: Void

registerReaderEventCallback(Reader.Event

CallBack cb) ID4 – ID6

3.2 OP-019 OP-019 N/A OP-019

OMAPI Test Specification for Transport API – Public Release v3.3 19 / 117

R  RIRP,G

UG

Clause TestCaseNumberandDescription

Core

Version

SUE

RSE



UICC



eSE



mSD



6.3.7

Method: Void

registerReaderEventCallback(Reader.Event

CallBack cb) ID7 – ID8

3.2

OP-017

and

OP-019

OP-017

and

OP-019

N/A

OP-017

and

OP-019

6.3.7

Method: Void

registerReaderEventCallback(Reader.Event

CallBack cb) ID10 – ID11

3.2

OP-003

and

OP-019

N/A N/A N/A

6.3.7

Method: Void

registerReaderEventCallback(Reader.Event

CallBack cb) ID12 – ID15

3.2 OP-019 N/A N/A N/A

6.3.8

Method: Boolean

unregisterReaderEventCallback(Reader.Eve

ntCallBack cb) ID1 – ID3

3.2 OP-019 OP-019 OP-019 OP-019

6.3.8

Method: Boolean

unregisterReaderEventCallback(Reader.Eve

ntCallBack cb) ID4, ID5

3.2

OP-017

and

OP-019

OP-017

and

OP-019

N/A

OP-017

and

OP-019

6.3.8

Method: Boolean

unregisterReaderEventCallback(Reader.Eve

ntCallBack cb) ID7, ID8

3.2

OP-003

and

OP-019

N/A N/A N/A

6.3.8

Method: Boolean

unregisterReaderEventCallback(Reader.Eve

ntCallBack cb) ID9 – ID12

3.2 OP-019 N/A N/A N/A

class Session

6.4.1 Method: Reader getReader() 2.05 M M M M

6.4.2 Method: byte[] getATR() ID1 2.05 OP-004 OP-004 OP-004 OP-004

6.4.2 Method: byte[] getATR() ID2 2.05 OP-004 OP-004 N/A N/A

6.4.2 Method: byte[] getATR() ID3 2.05 OP-005 OP-005 OP-005 OP-005

6.4.2 Method: byte[] getATR() ID4 2.05 N/A N/A OP-004 OP-004

6.4.3 Method: Void close() ID1, ID2 2.05 M M N/A N/A

6.4.3 Method: void close() ID3 2.05 N/A N/A OP-023 OP-023

6.4.4 Method: Boolean isClosed() 2.05 M M M M

6.4.5 Method: Void closeChannels() ID1 2.05 M M N/A N/A

6.4.5 Method: Void closeChannels() ID2 2.05 M M M M

6.4.5 Method: void closeChannels() ID3 2.05 N/A N/A OP-023 OP-023

6.4.6

Method: Channel openBasicChannel ID1 –

ID3, ID6, ID8, ID9, ID11 – ID13

2.05 OP-003 OP-003 M M

6.4.6 Method: Channel openBasicChannel ID4b 2.05 OP-003 OP-003 N/A N/A

20 / 117 OMAPI Test Specification for Transport API – Public Release v3.3

R RIRP,G

UG

Clause TestCaseNumberandDescription

Core

Version

SUE

RSE



UICC



eSE



mSD



6.4.6 Method: Channel openBasicChannel ID5

2.05 up

to 3.1

OP-003 OP-003 M M

6.4.6 Method: Channel openBasicChannel ID7 2.05 OP-002 OP-002 N/A N/A

6.4.6 Method: Channel openBasicChannel ID10 2.05 OP-003 N/A N/A N/A

6.4.7

Method: Channel openLogicalChannel ID1,

ID2, ID6, ID7, ID09 – ID17

2.05 M M M M

6.4.7

Method: Channel openLogicalChannel ID18

– ID23

3.2 M M M M

6.4.7 Method: Channel openLogicalChannel ID3a 2.05 OP-010 OP-010 M M

6.4.7 Method: Channel openLogicalChannel ID3b 2.05 OP-011 OP-011 N/A N/A

6.4.7 Method: Channel openLogicalChannel ID4b 2.05 OP-010 OP-010 N/A N/A

6.4.7 Method: Channel openLogicalChannel ID5a 2.05 OP-012 OP-012 OP-012 OP-012

6.4.7 Method: Channel openLogicalChannel ID5b

2.05 up

to 3.2

OP-013 OP-013 OP-013 OP-013

6.4.7 Method: Channel openLogicalChannel ID5c 3.0 OP-014 OP-014 OP-014 OP-014

6.4.7 Method: Channel openLogicalChannel ID5d

3.0 up

to 3.2

OP-013 OP-013 OP-013 OP-013

6.4.7

Method: Channel openLogicalChannel ID8,

ID24

2.05 OP-021 N/A N/A N/A

6.4.8

Method: Channel openLogicalChannel –

Extended logical channels ID1

3.0 OP-012 OP-012

N/A

OP-012

6.4.8

Method: Channel openLogicalChannel –

Extended logical channels ID2

3.0 up

to 3.2

OP-013 OP-013

N/A

OP-013

6.4.8

Method: Channel openLogicalChannel –

Extended logical channels ID3

3.0 OP-014 OP-014

N/A

OP-014

6.4.9