Description

AlisonSDK Mobile is a native library for IOS and Android platforms. 

This library generates CAdES digital signatures for UTF-8 strings and allows the installation of digital certificates under a security policy that protects the certificate usage.

This library offers a similar behavior under both platforms, complying with a common security policy layer. This security policy protects certificate usage, controlled by the certificate issuer.

Platform compatibility

Download

You can download latest stable release of AlisonSDK-Mobile:

• AlisonMobileIOS
• AlisonMobileDroid
• AlisonCordovaPlugin

Future Releases

It is possible to access future releases of the library to test new features to be implemented.

.

Security Policy defines rules to protect certificate usage.

Following fields can be included into a security policy.

Note: a typo was introduced in original library and is maintained by backward compatibility.

Security Level table

.

Methods

List of available methods.

AlisonMobileSDK is a static class used to define some general behaviours of the library and to obtain execution results..

This class must be used to initialize the library before of using any of its methods or classes.

This method must be invoked after OnCreate callback and before of SetContent function. This is required condition to setup the language correctly.

initializeAlisonMobile(	String initializeName, String language, 
					   	boolean notification, Context context, 
						String baseUrl );

.

String getLibVersion();

This method can be used to determine the library version. This can be useful under certain development conditions. This is a static method of AlisonMobileSDK.

.

This library is implemented as an general administrator of operation to be performed. Each operation has its own result, which is communicated to the caller throw the corresponding callback.

The function onActivityResult(int requestCode, int resultCode, Intent data) is used as a callback.

Each kind of operation has a specific class, and specific methods to use.

.

This class can be used to obtain all the certificates. 

listOp = new AlisonListOperation(Context context, boolean eraseCerts);

To obtain the list of all certificates installed and controlled by the library and installed into the specific keystore of the application:

ArrayList<WebCertificate> certs= ListCertificates();

After obtaining the certificate, it is possible to get information of each certificate.

Certificate Status

Si no hay ningún certificado instalado devuelve una lista vacia.

.

This class can be used to generate a signed authentication token. This token is used to determine the certificate used to login into the application.

authOp = new AlisonAuthOperation(String certAlias);

.

This class can be used to generate a signature of a UTF-8 string.

The signature is CAdES format, without data included into it.

signOp = new AlisonSignatureOperation(String text2sign, String certAlias);

If none certAlias is specified, then the last used certificate is selected for this operation.

If there is more than one certificate that can be used, then the select-certificate windows is displayed.

.

This class can be used to import a certificate into the keystore.

importOp = new AlisonImportOperation(String certUrl);

This operation download the security policy related to this certificate and check if device comply with this its specification.

If device allows intallation, certificate is downloaded and installed into the keystore. Since that the certificate is protected by a password, user must enter the correct password to proceed with installation.

.

This operation allows renewal of a certificate close to expire.

A new certificate will be downloaded and installed replacing the certificate to expire. The new certificate can download a new security policy.

importOp = new AlisonRenewOperation(String renewUrl);

.

This operation erase the certificate corresponding to the alias passed as a parameter.

int deleteSelectedCertificate(String aliasCert);

To delete all the certificates stored into the keystore of this application:

int deleteCertificates();

Return code:

.

Since operation works in a asynchronic mode, the result of each operation is obtained throw the onActivityResult method.

void onActivityResult(int requestCode, int resultCode, Intent data);

Use this method to obtain information of the operation.

String value = data.getStringExtra(String key);

where key can be one of the following values:

.

Following error codes can be returned by this library. This values are defined into the class AlisonCodes.

Common codes

Import & Authentication Operation error codes

Signature Operation error codes

.

Following additional files must be included into the project to use the library.

Check that all these folders are defined and created, otherwise complete them.

layout

• Password_dialog.xml: dialog window to request certificate password. This window could be displayed on signature or installation operations.
• Renew_dialog.xml: dialog window to request certificate password to be renewed.
• sdk_activity: container used to show fragments of the windows used to renew or sign.
• popup_loading.xml: loading popup to show the downloading progress (distributed 

values

• Alison-leng.xml: english strings used by the library.
• Colors.xml: color pantone used  by popup_loading.xml.

value_es

• Alison-leng.xml: spanish strings used by the library.