ETSI TS 101 413-2005 Digital cellular telecommunications system (Phase 2+) Subscriber Identity Module Application Programming Interface (SIM API) Stage 1 (3GPP TS 02 19 Version 8 1_1.pdf

1、 ETSI TS 101 413 V8.1.0 (2005-06)Technical Specification Digital cellular telecommunications system (Phase 2+);Subscriber Identity Module ApplicationProgramming Interface (SIM API);Stage 1(3GPP TS 02.19 version 8.1.0 Release 1999)GLOBAL SYSTEM FOR MOBILE COMMUNICATIONSRETSI ETSI TS 101 413 V8.1.0 (2

2、005-06) 1 3GPP TS 02.19 version 8.1.0 Release 1999 Reference RTS/TSGC-060219v810 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-Prfec

3、ture 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 ver

4、sions, 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

5、revision 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_suppo

6、rt.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 Mar

7、ks 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 101 413

8、V8.1.0 (2005-06) 2 3GPP TS 02.19 version 8.1.0 Release 1999 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,

9、 and 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)

10、. Pursuant 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 prese

11、nt document. 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 refe

12、rences 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 101 413 V8.1.0 (2005-06) 3 3GPP TS 02.19 version 8.1.0 Release 1999 Contents Intellectual Property Rights2 Foreword

13、.2 Foreword.5 1 Scope 6 2 References 6 2.1 Normative 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

14、 Loader Requirements .11 5.2 Application 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

15、.5 Execution14 7.6 Deactivation .14 7.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 wit

16、h other specifications15 10 API Extensibility15 10.1 Evolution of SIM / ME Interface (3GPP TS 11.11) .15 10.2 Evolution of SIM Application Toolkit (3GPP 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 1

17、1.2 Access to data.16 12 Technology Considerations16 12.1 SIM hardware requirements .16 12.2 Technology limitations.16 12.2.1 Memory Recovery 16 ETSI ETSI TS 101 413 V8.1.0 (2005-06) 4 3GPP TS 02.19 version 8.1.0 Release 1999 12.3 Evolution 17 12.3.1 Remote Procedure Call .17 Annex A (Informative):

18、Change History 18 History 19 ETSI ETSI TS 101 413 V8.1.0 (2005-06) 5 3GPP TS 02.19 version 8.1.0 Release 1999 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 an

19、d may change following formal TSG approval. Should the TSG modify 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 informatio

20、n; 2 presented to TSG for approval; 3 or greater indicates TSG approved 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 incorp

21、orated in the document. ETSI ETSI TS 101 413 V8.1.0 (2005-06) 6 3GPP TS 02.19 version 8.1.0 Release 1999 1 Scope This Technical Specification defines the stage one description of the Subscriber Identity Module Application Programming Interface (SIM API) internal to the SIM. Stage one is an overall s

22、ervice description, and does not deal with the implementation details of the API. This TS includes information applicable to network operators, service providers and terminal, SIM, switch and database manufacturers. This TS contains the core requirements which are sufficient to provide a complete se

23、rvice. It is highly desirable however, that technical solutions for a SIM API should be sufficiently flexible to allow for possible enhancements. Additional functionalities not documented in this TS may implement requirements which are considered outside the scope of this TS. This additional functio

24、nality may be on a network-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, constitut

25、e provisions of the present 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 refe

26、rence to a 3GPP document (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. 2.1 Normative references 1 3GPP TR 21.905: “Vocabulary for 3GPP Specifications“. 2 3GPP TS 11.11: “Specification of the

27、Subscriber Identity Module - Mobile Equipment (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 03.48: “Security Mechanisms for the SIM application toolkit; Stage 2“. 5 ISO/IEC

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

29、tions For the purposes of this TS the following definitions apply: ETSI ETSI TS 101 413 V8.1.0 (2005-06) 7 3GPP TS 02.19 version 8.1.0 Release 1999 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 independ

30、ent code generated by a bytecode compiler and executed by a bytecode interpreter. 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

31、 for developing applications 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 3GPP TS 11.11. Module: A collection of f

32、unctions and data structures 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

33、: Applet loaded onto 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 iss

34、uer with respect to security-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 this TS the following abbreviations apply: AC Application Code AID Applet IDentifier APDU Application P

35、rotocol 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 Stu

36、dy GPRS 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 Messa

37、ge Service 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 101 413 V8.1.0 (2005-06) 8 3GPP TS 02.19 vers

38、ion 8.1.0 Release 1999 Further abbreviations are given in TR 21.905 1. 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 3GPP TS 11.11 2 and 3GPP TS 11.14 3, su

39、ch that SIM based services can be developed and loaded onto SIMs, quickly and, if necessarily, remotely, after the card has been issued. Card IssuerOperatorManagement linkCommunication linkApplet1 AID1,TAR1Applet2 TAR2Trusted PartyAppletn AIDn,TARnAIDx.TARxApplication provider 1AID1Application provi

40、der 2Application provider nAIDnCard IssuerTrusted PartySIMAIDxTARxMEFigure 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 interprete

41、d format, then loaded into the card. ETSI ETSI TS 101 413 V8.1.0 (2005-06) 9 3GPP TS 02.19 version 8.1.0 Release 1999 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 B

42、asic, etc.BytecodeToolkitApplet FileApplet file stored inEEPROMExecutionenvironmentRunnable (activated)appletExecuted appletcompile (includinglibraries)optimise(optional)downloadinstallactivatetriggerFigure 2: Flow diagram of the development of a SIM application ETSI ETSI TS 101 413 V8.1.0 (2005-06)

43、 103GPP TS 02.19 version 8.1.0 Release 1999 4.2 SIM API Architecture The SIM API shall consist of APIs for 3GPP TS 11.14 3 (pro-active functions) and 3GPP TS 11.11 2 (transport functions). Figure 3 illustrates the interactions between these APIs. ToolkitApplet 1 Applet 2ToolkitApplet 3 Applet nProac

44、tivecommand managerGSM SIM KernelFilesSIM API FrameworkAppletinstall/uninstallSecurityApplettriggeringApplet securitymanagerActivationProactivecommandsP/CresponsesInstallUninstallAPDUInterface to terminalAPDUe.g.EnvelopesProactive polling, 91XX, Fetch,Proactive commands,Terminal ResponseFileaccessFi

45、le accessSIM-API(see NOTE 1)NOTE 1: The install / uninstallprocess does not formpart 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

46、 physical model of course, they may still be stored in elementary files, but the 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 ETSI/GSM or ISO/IEC specification. Toolkit Applet Pro

47、cess ( A series of instructions requiring Toolkit commands and variables ) SIM API 3GPP TS 03.48 4 Transport Security Mechanisms (e.g. applied to SMS Data download) 3GPP TS 11.14 3 TLVs (Built from commands and variables) 3GPP TS 11.11 2 Transport of TLVs (Envelope, Fetch, Terminal Response) Interac

48、tion with data (Other 3GPP TS 11.11 2 commands) ISO/IEC 7816-3 5 Physical interface (e.g. T=0) Figure 4: SIM API layers ETSI ETSI TS 101 413 V8.1.0 (2005-06) 113GPP TS 02.19 version 8.1.0 Release 1999 A general requirement of the SIM API is that applets should not interfere with the basic GSM servic

49、es. 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; Read Record: Read data bytes of a linear fixed or cyclic EF without changing the current rec