Security Library 2.2.2 Release Notes

The Security Library for Open AT: an Open AT library, ready to be integrated into customer application thanks to a high level simple and generic SSL API set. See “Security User’s Manual” for API description and porting guidelines..
The Crypto Sample application: This application is available in source code. This application uses the cryptographic API to demonstrate how to encrypt, decrypt or sign different messages
The Client Sample application: This application is available in source code. This application uses the WIP SSL API to exchange information with an SSL server.
The HTTPS Sample application: This application is available in source code. This application uses the WIP SSL API to exchange information with an HTTPS server.

The Security_AT_cmd sample application (so called WIPSSLSoft): an application offering AT commands on top of Security Library . This application is available in source code and in binary allowing customer to use it as an example, to integrate it in its application, or to enhance it. See “Security AT Commands Interface Guide” for description of the Security AT commands implemented

1.2. Document Audience

This release note may be distributed to all direct and indirect customers and will be posted in Sierra Wireless Source

1.3. New Features/Enhancements

Table 1. New Features/Enhancements

Feature	Description

2. Abbreviations and Definitions

Table 2. Abbreviations and Definitions

Abbreviation/Acronym	Definitions
3DES	Triple DES.
AES	Advanced Encryption Standard.
API	Application Programming Interface.
DES	Data Encryption Standard.
DSA	Digital Signature Algorithm.
DSS	Digital Signature Standard.
HTTPS	HTTP over SSL.
MAC	Message Authentication Code.
MD5	Message Digest version 5.
OpenSSL	A free SSL toolkit. Please refer to http://www.openssl.org/ for more information.
RSA	The RSA algorithm. R, S, A are the first letter of the surnames of the three creators.
SHA1	Secure Hash Algorithm, version 1.
SHA2	Secure Hash Algorithm, version 2, is a collective name for SHA256, SHA384, and SHA512.
SHA256	Secure Hash Algorithm, version 2, with digest length of 256 bits.
SSL	Secure Socket Layer. See TLS.
TLS	Transport Layer Security. The successor to SSL version. Sometimes referred to as SSL when talking generally about TLS/SSL.

Abbreviation/Acronym

Definitions

3DES

Triple DES.

AES

Advanced Encryption Standard.

API

Application Programming Interface.

DES

Data Encryption Standard.

DSA

Digital Signature Algorithm.

DSS

Digital Signature Standard.

HTTPS

HTTP over SSL.

MAC

Message Authentication Code.

MD5

Message Digest version 5.

OpenSSL

A free SSL toolkit. Please refer to http://www.openssl.org/ for more information.

RSA

The RSA algorithm. R, S, A are the first letter of the surnames of the three creators.

SHA1

Secure Hash Algorithm, version 1.

SHA2

Secure Hash Algorithm, version 2, is a collective name for SHA256, SHA384, and SHA512.

SHA256

Secure Hash Algorithm, version 2, with digest length of 256 bits.

SSL

Secure Socket Layer. See TLS.

TLS

Transport Layer Security. The successor to SSL version. Sometimes referred to as SSL when talking generally about TLS/SSL.

3. Related Documentation

Table 3. Related Documentation

Ref. #	Doc. #	Rev.	Document title
[R-1]	4112704	R01.0	AirPrime - Security AT Commands for Open AT Application Framework - Interface Guide
[R-2]	4111868	R06.4	AirPrime - Security Library for Open AT Application Framework - Development Guide
[R-3]	4117611	R01.11	Customer Release Notes – Firmware 7.54.0.A1
[R-4]	4118112	R01.03	Customer Release Notes – OS 6.54.0.A1

4. Compatibility

Table 4. Hardware Compatibility

AirPrime Compatibility List
AirPrime SL808xBTA, SL808xT, SL808xBT

AirPrime Compatibility List

AirPrime SL808xBTA, SL808xT, SL808xBT

Table 5. Software Compatibility

Component	Version
Firmware	7.53.1.A1.201504291449 or 7.54.0.A1.201603171313
OS	6.53.1.A1.201504291036 or 6.54.0.A1.201511201000
Internet Library	5.57.1.A1.201502101805 or 5.58.0.A1.201512161421
Open AT Application Framework	2.53.1.A1.201505180957 or 2.54.0.A1.201603181529

5. Software Release Description

5.1. Release Identification

Table 6. Libraries Release Information

Component	Revision
Software Identification	2.2.2.201502061454 or 2.2.2.201512220314
Date of generation	2015-12-22 03:14
OpenSSL release	1.0.1c

Note: The library file, RVDS#Release_wipssl.lib, is identical in SSL 2.2.2.201502061454 & SSL 2.2.2.201512220314. The differences in the package are limited to update in samples and documentation.

5.2. Software Tools Versions

Table 7. Software Tools Versions

S/W Tools Name	Version
Developer Studio	3.3
Compilation Tool Chain	ARM_EABI_GCC and RVDS

5.3. Released Files

Download Option	Files
Upgrade through X-modem	WipsslSoft\bin\[Target.qct]_RVDS_Release\WipsslSoft.dwl

For the upgrade procedure, you can refer to:

• In-line help for upgrade procedure through Developer Studio

• The upgrade procedure through X-modem

6. Software Changes Description

6.1. Validated Corrections/Improvements

ID	Description	Impacted Domain	Impacted Sub-Domain	Fixed in
77820	wip_SSLGetSessionFromHTTPSDataChannel() might cause reset	Security Library	HTTPS	2.2.2

Description

Impacted Domain

Impacted Sub-Domain

Fixed in

77820

wip_SSLGetSessionFromHTTPSDataChannel() might cause reset

Security Library

HTTPS

2.2.2

6.2. Interface Changes

Table 8. Interface Changes

Command	Comment

7. Troubleshooting

For Open AT Developers, please refer to the Troubleshooting Guide available in Sierra Wireless Source (formerly "Developer Zone") before contacting customer support.

For AT developers, please contact customer service for support and debugging information.

8. Restrictions and Additional Information

8.1. Restrictions

This section presents additional information or restrictions that must be taken into account regarding Security 2.2.2 Library package.

Please note that Open AT restrictions linked to Firmware and OS part are listed in “7.54.0.A1 Firmware Customer Release Note” [R-3] and “OS 6.54.0.A1 Customer Release Note” [R-4]

Table 9. Restrictions and Additional Information

Issue ID	Description (What/When)	Impacted Domain
82306	When SSL handshaking fails, invalid error code (WIP_CEV_ERROR 5) is returned in callback for wip_getFileOpts().	OTHER
66482	Unable to make TSV1_2 connection using DSA. Not possible to use DSA certificates when doing TLS1.2	OTHER
52725	With some URLs two WIP_CEV_PEER_CLOSE events are received instead of one, after getting an HTTPS page through the GPRS bearer	OTHER
53990	There is a limitation of the SSL buffer size and this impacts communicating with older Microsoft® applications that use non-standard SSL record sizes	OTHER
62185	When trying to get the Authority Key Identifier, only the key id is returned by wip_getOpts() API. The issuer authority and serial number entries are not returned	OTHER
87940	WIPSSL returns WIPSSL_CERR_BAD_KEY if PKCS8 certificates are used with header text as “BEGIN PRIVATE KEY”.	OTHER

Issue ID

Description (What/When)

Impacted Domain

82306

When SSL handshaking fails, invalid error code (WIP_CEV_ERROR 5) is returned in callback for wip_getFileOpts().

OTHER

66482

Unable to make TSV1_2 connection using DSA.

Not possible to use DSA certificates when doing TLS1.2

OTHER

52725

With some URLs two WIP_CEV_PEER_CLOSE events are received instead of one, after getting an HTTPS page through the GPRS bearer

OTHER

53990

There is a limitation of the SSL buffer size and this impacts communicating with older Microsoft® applications that use non-standard SSL record sizes

OTHER

62185

When trying to get the Authority Key Identifier, only the key id is returned by wip_getOpts() API. The issuer authority and serial number entries are not returned

OTHER

87940

WIPSSL returns WIPSSL_CERR_BAD_KEY if PKCS8 certificates are used with header text as “BEGIN PRIVATE KEY”.

OTHER

Related items

ADL User Guide OS 6.54.0.A1

This document provides full description of the APIs associated with the Open AT Application Framework OS

Open AT Application Framework 2.54.0.A1 Full Installer for SL808xT/BT

Full installer for Open AT Application Framework 2.54.0.A1 for AirPrime SL808xT/BT

Internet Library 5.58.0.A1 Connectivity Development Guide

This document provides full description of the APIs associated with the IP Connectivity library 5.58.0.A1.

Location Library for Open AT Framework Development Guide

This document provides full description of the APIs associated with the Location Library

Security Library for Open AT Framework Development Guide

This document provides full description of the APIs associated with Internet Library SSL API, which provides SSL-secured communication channels to the Internet Library. This document assumes the reader is already familiar with Internet Library. Please refer to the following section for a list of related documents.

eCall In-Band Modem Library Development Guide

This document provides Sierra Wireless customers with full description of the APIs associated with the eCall In-Band Modem Library.

ERA Glonass Service Library Development Guide

This document is to provide Sierra Wireless customers with a full description of the APIs associated with the ERA Glonass Service Manager Library.

Extended AT Commands Manual

This document provides full description of AT commands supported by AirPrime wireless modules and AirLink Programmable Gateways through Extended AT Application.

Sign in to the Source

Security Library 2.2.2 Release Notes

1. Introduction

1.1. Document Scope

1.2. Document Audience

1.3. New Features/Enhancements

2. Abbreviations and Definitions

3. Related Documentation

4. Compatibility

5. Software Release Description

5.1. Release Identification

5.2. Software Tools Versions

5.3. Released Files

6. Software Changes Description

6.1. Validated Corrections/Improvements

6.2. Interface Changes

7. Troubleshooting

8. Restrictions and Additional Information

8.1. Restrictions

Tags

Related items

Sign in to the Source

Security Library 2.2.2 Release Notes

1.1. Document Scope

1.2. Document Audience

5.1. Release Identification

Tags

Related items

Download License Agreement

Get updates on this product