Security Library 2.2.2 Release Notes

Apr 03, 2016 - Author: Sierra Wireless - Version 2.2.2 - 3249 Views


List of Figures

No table of figures entries found.



1.        Introduction

1.1.           Document Scope

The scope of this document is the Security Library 2.2.2 release description for the AirPrimes listed in the compatibility section.

 

The Security Library 2.2.2 release includes

  • 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.

 


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

 


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


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





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.
©2022 Sierra Wireless. All rights reserved.
×
You have been successfully unsubscribed to this product. To access your subscription click here.