ETSI TS 142 019-2005 Digital Cellular Telecommunications System (Phase 2+) Subscriber Identity Module Application Programming Interface (SIM API) Stage 1《数字蜂窝通信系统(第2+阶段) 用户识别模块应用编程.pdf

1、 ETSI TS 142 019 V5.1.0 (2005-06)Technical Specification Digital cellular telecommunications system (Phase 2+);Subscriber Identity Module ApplicationProgramming Interface (SIM API);Stage 1(3GPP TS 42.019 version 5.1.0 Release 5)GLOBAL SYSTEM FOR MOBILE COMMUNICATIONSRETSI ETSI TS 142 019 V5.1.0 (200

2、5-06) 1 3GPP TS 42.019 version 5.1.0 Release 5 Reference RTS/TSGC-0642019v510 Keywords GSM ETSI 650 Route des Lucioles F-06921 Sophia Antipolis Cedex - FRANCE Tel.: +33 4 92 94 42 00 Fax: +33 4 93 65 47 16 Siret N 348 623 562 00017 - NAF 742 C Association but non lucratif enregistre la Sous-Prfectur

3、e de Grasse (06) N 7803/88 Important notice Individual copies of the present document can be downloaded from: http:/www.etsi.org The present document may be made available in more than one electronic version or in print. In any case of existing or perceived difference in contents between such versio

4、ns, the reference version is the Portable Document Format (PDF). In case of dispute, the reference shall be the printing on ETSI printers of the PDF version kept on a specific network drive within ETSI Secretariat. Users of the present document should be aware that the document may be subject to rev

5、ision or change of status. Information on the current status of this and other ETSI documents is available at http:/portal.etsi.org/tb/status/status.asp If you find errors in the present document, please send your comment to one of the following services: http:/portal.etsi.org/chaircor/ETSI_support.

6、asp Copyright Notification No part may be reproduced except as authorized by written permission. The copyright and the foregoing restriction extend to reproduction in all media. European Telecommunications Standards Institute 2005. All rights reserved. DECTTM, PLUGTESTSTM and UMTSTM are Trade Marks

7、of ETSI registered for the benefit of its Members. TIPHONTMand the TIPHON logo are Trade Marks currently being registered by ETSI for the benefit of its Members. 3GPPTM is a Trade Mark of ETSI registered for the benefit of its Members and of the 3GPP Organizational Partners. ETSI ETSI TS 142 019 V5.

8、1.0 (2005-06) 2 3GPP TS 42.019 version 5.1.0 Release 5 Intellectual Property Rights IPRs essential or potentially essential to the present document may have been declared to ETSI. The information pertaining to these essential IPRs, if any, is publicly available for ETSI members and non-members, and

9、can be found in ETSI SR 000 314: “Intellectual Property Rights (IPRs); Essential, or potentially Essential, IPRs notified to ETSI in respect of ETSI standards“, which is available from the ETSI Secretariat. Latest updates are available on the ETSI Web server (http:/webapp.etsi.org/IPR/home.asp). Pur

10、suant to the ETSI IPR Policy, no investigation, including IPR searches, has been carried out by ETSI. No guarantee can be given as to the existence of other IPRs not referenced in ETSI SR 000 314 (or the updates on the ETSI Web server) which are, or may be, or may become, essential to the present do

11、cument. Foreword This Technical Specification (TS) has been produced by ETSI 3rd Generation Partnership Project (3GPP). The present document may refer to technical specifications or reports using their 3GPP identities, UMTS identities or GSM identities. These should be interpreted as being reference

12、s to the corresponding ETSI deliverables. The cross reference between GSM, UMTS, 3GPP and ETSI identities can be found under http:/webapp.etsi.org/key/queryform.asp . ETSI ETSI TS 142 019 V5.1.0 (2005-06) 3 3GPP TS 42.019 version 5.1.0 Release 5 Contents Intellectual Property Rights2 Foreword.2 Fore

13、word.5 1 Scope 6 2 References 6 3 Definitions and abbreviations.6 3.1 Definitions6 3.2 Abbreviations .7 4 Description .8 4.1 Design of SIM based applications using the SIM API .8 4.2 SIM API Architecture 10 4.3 GSM file data access 11 5 Card Interoperability 11 5.1 Loader Requirements .11 5.2 Applic

14、ation Transport.11 6 Applet triggering 12 7 Applet Life cycle management.12 7.1 Applet Preparation13 7.2 Loading 13 7.2.1 Arbitration.13 7.2.2 Transport.13 7.2.3 Verification.13 7.2.4 Linking13 7.3 Installation/Registration/Reactivation 13 7.4 Configuration .14 7.5 Execution14 7.6 Deactivation .14 7

15、.7 Removal .14 8 Security management .14 8.1 Management of Applets .14 8.2 Applet Certification14 9 API Compatibility 14 9.1 Level of Compatibility .14 9.2 Compatibility at the Interface.15 9.3 Compatibility at the programming interface 15 9.4 Compatibility with other specifications15 10 API Extensi

16、bility15 10.1 Evolution of SIM / ME Interface (TS 51.011) .15 10.2 Evolution of SIM Application Toolkit (TS 11.14) .15 10.3 Interworking with other systems 15 11 Data and Function Sharing and Access Control.16 11.1 Sharing resources between applets.16 11.2 Access to data.16 12 Technology Considerati

17、ons16 12.1 SIM hardware requirements .16 12.2 Technology limitations.16 12.2.1 Memory Recovery 16 12.3 Evolution 17 ETSI ETSI TS 142 019 V5.1.0 (2005-06) 4 3GPP TS 42.019 version 5.1.0 Release 5 12.3.1 Remote Procedure Call .17 Annex A: Change history 18 History 19 ETSI ETSI TS 142 019 V5.1.0 (2005-

18、06) 5 3GPP TS 42.019 version 5.1.0 Release 5 Foreword This Technical Specification has been produced by the 3rdGeneration Partnership Project (3GPP). The contents of the present document are subject to continuing work within the TSG and may change following formal TSG approval. Should the TSG modify

19、 the contents of the present document, it will be re-released by the TSG with an identifying change of release date and an increase in version number as follows: Version x.y.z where: x the first digit: 1 presented to TSG for information; 2 presented to TSG for approval; 3 or greater indicates TSG ap

20、proved document under change control. y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, updates, etc. z the third digit is incremented when editorial only changes have been incorporated in the document. ETSI ETSI TS 142 019 V5.1.0 (2005-06) 6 3

21、GPP TS 42.019 version 5.1.0 Release 5 1 Scope The present document defines the stage one description of the Subscriber Identity Module Application Programming Interface (SIM API) internal to the SIM. Stage one is an overall service description, and does not deal with the implementation details of th

22、e API. The present document includes information applicable to network operators, service providers and terminal, SIM, switch and database manufacturers. The present document contains the core requirements which are sufficient to provide a complete service. It is highly desirable however, that techn

23、ical solutions for a SIM API should be sufficiently flexible to allow for possible enhancements. Additional functionalities not documented in the present document may implement requirements which are considered outside the scope of the present document. This additional functionality may be on a netw

24、ork-wide basis, nation-wide basis or particular to a group of users. Such additional functionality shall not compromise conformance to the core requirements of the service. 2 References The following documents contain provisions which, through reference in this text, constitute provisions of the pre

25、sent document. References are either specific (identified by date of publication, edition number, version number, etc.) or non-specific. For a specific reference, subsequent revisions do not apply. For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP documen

26、t (including a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same Release as the present document. 1 3GPP TR 21.905: “Vocabulary for 3GPP Specifications“. 2 3GPP TS 51.011: “Specification of the Subscriber Identity Module - Mobile Equipment (

27、SIM - ME) interface“. 3 3GPP TS 11.14: “Specification of the SIM Application Toolkit for the Subscriber Identity Module - Mobile Equipment (SIM - ME) interface“. 4 3GPP TS 23.048: “Security Mechanisms for the SIM application toolkit; Stage 2“. 5 ISO/IEC 7816-3:1997: “Identification cards - Integrate

28、d circuit(s) cards with contacts, Part 3: Electronic signals and transmission protocols“. 6 ISO/IEC 7816-4: “Identification cards - Integrated circuit cards Part 4: Organization, security and commands for interchange“. 3 Definitions and abbreviations 3.1 Definitions For the purposes of the present d

29、ocument, the following terms and definitions apply. Applet: An Applet is an application built up using a number of modules which will run under the control of a virtual machine. Bytecode: Machine independent code generated by a bytecode compiler and executed by a bytecode interpreter. ETSI ETSI TS 1

30、42 019 V5.1.0 (2005-06) 7 3GPP TS 42.019 version 5.1.0 Release 5 Data Structure: A collection of related data values such as the age, birth date and height of an individual. Framework: A framework defines a set of Application Programming Interface (API) functions and data structures for developing a

31、pplications and for providing system services to those applications. Function: A callable and executable body of computer instructions which perform a specific computation or data processing task. GSM applet: The GSM application conforming to TS 51.011. Module: A collection of functions and data str

32、uctures which implement an entire application or a particular application feature or capability. SIM API Framework: Part of the SIM responsible for the handling of applications (including triggering and loading). It also contains the library for the proactive API. Toolkit applet: Applet loaded onto

33、the SIM seen by the mobile as being part of the SIM Toolkit application and containing only the code necessary to run the application. These applets might be downloaded over the radio interface. Trusted Party: A trusted party can be described as an entity trusted by the card issuer with respect to s

34、ecurity-related services and activities. Virtual Machine: The part of the Run-time environment responsible for interpreting the bytecode. 3.2 Abbreviations For the purposes of the present document, the following abbreviations apply: AC Application Code AID Applet IDentifier APDU Application Protocol

35、 Data Unit API Application Programming Interface AVN Applet Version Number CA Certification Authority CAD Card Acceptance Device CHV1/2 Card Holder Verification information 1 and 2 EEPROM Electrically Erasable and Programmable Read Only Memory EPOS Electronic Point of Sale FFS For Further Study GPRS

36、 General Packet Radio Service IFD Interface Device IN Intelligent Network ME Mobile Equipment MExE Mobile Station Execution Environment MS Mobile Station RAM Random Access Memory ROM Read Only Memory RPC Remote Procedure Call SIM Subscriber Identity Module SE Sending Entity SMS-CB Short Message Serv

37、ice Cell Broadcast SMS P-P Short Message Service, Point to Point TAR Toolkit Application Reference TLV Tag, Length, Value USSD Unstructured Supplementary Services Data WAP Wireless Application ProtocolWTLS WAP Transport Layer Security ETSI ETSI TS 142 019 V5.1.0 (2005-06) 8 3GPP TS 42.019 version 5.

38、1.0 Release 5 4 Description This document describes the high level requirements for an API for the GSM SIM. This API shall allow application programmers easy access to the functions and data described in TS 51.011 2 and TS 11.14 3, such that SIM based services can be developed and loaded onto SIMs,

39、quickly and, if necessarily, remotely, after the card has been issued. Card IssuerOperatorManagement linkCommunication linkApplet1 AID1,TAR1Applet2 TAR2Trusted PartyAppletn AIDn,TARnAIDx.TARxApplication provider 1AID1Application provider 2Application provider nAIDnCard IssuerTrusted PartySIMAIDxTARx

40、MEFigure 1: Toolkit applet management and communication 4.1 Design of SIM based applications using the SIM API Figure 2 shows how SIM applications can be developed in a standard development environment and converted into an interpreted format, then loaded into the card. ETSI ETSI TS 142 019 V5.1.0 (

41、2005-06) 9 3GPP TS 42.019 version 5.1.0 Release 5 DevelopmentEnvironment API;e.g. Visual BasicAPI, C API, JavaAPICard IssuerSmart CardApplicationplatform;e.g. Java Card,Multos, Smart Cardfor WindowsSource code; e.g. C,Java, Visual Basic, etc.BytecodeToolkitApplet FileApplet file stored inEEPROMExecu

42、tionenvironmentRunnable (activated)appletExecuted appletcompile (includinglibraries)optimise(optional)downloadinstallactivatetriggerFigure 2: Flow diagram of the development of a SIM application ETSI ETSI TS 142 019 V5.1.0 (2005-06) 103GPP TS 42.019 version 5.1.0 Release 5 4.2 SIM API Architecture T

43、he SIM API shall consist of APIs for TS 11.14 3 (pro-active functions) and TS 51.011 2 (transport functions). Figure 3 illustrates the interactions between these APIs. ToolkitApplet 1 Applet 2ToolkitApplet 3 Applet nProactivecommand managerGSM SIM KernelFilesSIM API FrameworkAppletinstall/uninstallS

44、ecurityApplettriggeringApplet securitymanagerActivationProactivecommandsP/CresponsesInstallUninstallAPDUInterface to terminalAPDUe.g.EnvelopesProactive polling, 91XX, Fetch,Proactive commands,Terminal ResponseFileaccessFile accessSIM-API(see NOTE 1)NOTE 1: The install / uninstallprocess does not for

45、mpart of the API. Itsrequirements are outlinedin subclause 7.Figure 3: SIM API Architecture In this model, the GSM data field structure is viewed as a series of data structures and data access functions to the API. In the physical model of course, they may still be stored in elementary files, but th

46、e functions will access these data as values within those data structures. The following figure mirrors the SIM API architecture, relating each part to the appropriate GSM or ISO/IEC specification. Toolkit Applet Process ( A series of instructions requiring Toolkit commands and variables ) SIM API T

47、S 23.048 4 Transport Security Mechanisms (e.g. applied to SMS Data download) TS 11.14 3 TLVs (Built from commands and variables) TS 51.011 2 Transport of TLVs (Envelope, Fetch, Terminal Response) Interaction with data (Other TS 51.011 2 commands) ISO/IEC 7816-3 5 Physical interface (e.g. T=0) Figure

48、 4: SIM API layers ETSI ETSI TS 142 019 V5.1.0 (2005-06) 113GPP TS 42.019 version 5.1.0 Release 5 A general requirement of the SIM API is that applets should not interfere with the basic GSM services. The SIM API framework shall prevent the toolkit applets from sending proactive commands which would

49、 interfere with the correct execution of the card operating system and/or other toolkit applets. 4.3 GSM file data access The following methods shall be offered by the SIM Toolkit API: Select File: Select a file without changing the current file of any other applet or of the subscriber session. At the beginning of an entry point of an applet, the current file is the MF. This function may return the selected file information; Status: Read the file status information of the current DF; Read Binary: Read data bytes of a transparent EF; R