API and realization of GSM 03.48 / ETSI TS 102 225 / ETSI TS 131 115 / 3GPP TS 31.115 standard for Java
The project provides API and realization of the Secured Packets using Short Message Service Point to Point (SMS-PP). It is used to the exchange of secured packets between an entity in a GSM PLMN and an entity in the SIM. Secured Packets contain application messages to which certain mechanisms according to GSM 03.48 have been applied. Application messages are commands or data exchanged between an application resident in or behind the GSM/3G/4G PLMN and on the SIM/UICC.
The project was originally developed by Victor Platov. Initially the code was hosted on Google Code (https://code.google.com/archive/p/gsm0348/). After Google shutdown Google Code, the code was moved to GitHub (https://github.com/TapuGithub/gsm0348). Finally, the code was adopted by the Open Telecoms project.
- Minimum Java is now 1.7, rewrite using ByteBuffer, prepare for other transports (SMS-CB, CATTP, HTTPS). The goal is to support ETSI TS 102 225, ETSI TS 131 115, and 3GPP TS 31.115.
- Version 1.2.9 is out
- Fixed NPE during response packet recovering (thanks to Tomas)
- Fixed testcases dataset schema location - now autotest should pass
- Added AES and RC
- Moved to the Open Telecoms GitHub and published in Maven Central repository
The Sending Application prepares an Application Message and forwards it to the Sending Entity, with an indication of the security to be applied to the message. The Sending Entity prepends a Security Header (the Command Header) to the Application Message. It then applies the requested security to part of the Command Header and all of the Application Message, including any padding octets. The resulting structure is here referred to as the (Secured) Command Packet.
Under normal circumstances the Receiving Entity receives the Command Packet and unpacks it according to the security parameters indicated in the Command Header. The Receiving Entity subsequently forwards the Application Message to the Receiving Application indicating to the Receiving Application the security that was applied. The interface between the Sending Application and Sending Entity and the interface between the Receiving Entity and Receiving Application are proprietary.
If so indicated in the Command Header, the Receiving Entity shall create a (Secured) Response Packet. The Response Packet consists of a Security Header (the Response Header) and optionally, application specific data supplied by the Receiving Application. Both the Response Header and the application specific data are secured using the security mechanisms indicated in the received Command Packet. The Response Packet will be returned to the Sending Entity, subject to constraints in the transport layer, (e.g. timing).
This project designed to help building Receiving/Sending Entity. It provides library for construction of Secured Packets with all required security procedures - signing and ciphering, padding, redundancy checking and etc.
Short Message Service Cell Broadcast (SMS-CB), CAT-TP and HTTPS (HTTPS) are not supported as for now.
<repository>
<id>GSM 03.48 Library</id>
<url>https://github.com/opentelecoms-org/gsm0348</url>
</repository>
<dependencies>
<dependency>
<groupId>org.opentelecoms.gsm0348</groupId>
<artifactId>gsm0348-api</artifactId>
<version>1.2.9</version>
</dependency>
<dependency>
<groupId>org.opentelecoms.gsm0348</groupId>
<artifactId>gsm0348-impl</artifactId>
<version>1.2.9</version>
</dependency>
</dependencies>
For a snapshot:
mvn clean deploy
For a proper release:
mvn versions:set -DnewVersion=1.2.9
mvn clean deploy -P release
mvn nexus-staging:release
# Or when something went wrong
mvn nexus-staging:drop