MobbSign Advanced features

Customization

The PDF Viewer can be customizable for adapt it to the look&feel of the client application. You can hide or show the top and bottom bars, change their background colours, etc. using a customization dictionary or class if we talk to Android platform:

For activating the biometric signature acquisition / drawing

mobbSignView.signDocument();

For actually signing the PDF document using the previously acquired biometric signature

mobbSignView.stampDocument();

For deleting the previously acquired biometric signature

mobbSignView.deleteSignature();

For triggering the end of the process, once the document has been finished

mobbSignView.endProcess();

For going to the next page of the document

mobbSignView.goToNextPage();

For going to the previous page of the document

mobbSignView.goToPrevioustPage();

For going to the first page of the document

mobbSignView.goToFirstPage();

For going to the last page of the document

mobbSignView.goToLastPage();

For zoom in the document

mobbSignView.zoomIn();

For zoom out the document

mobbSignView.zoomOut();

For saving changes on an editable document

mobbSignView.saveForms();

Internationalization

You can customize some texts with your own literals replacing the content value of the following keys in the resource file of your project (res/values/strings.):

<string name="mobbsign_sign">Sign</string>
<string name="mobbsign_back">Back</string>
<string name="mobbsign_save">Save</string>
<string name="mobbsign_confirm">Confirm</string>
<string name="mobbsign_delete">Delete</string>
<string name="mobbsign_send">Send</string>
<string name="mobbsign_finalize">Finalize</string>
<string name="mobbsign_zoom_in">Zoom In</string>
<string name="mobbsign_zoom_out">Zoom Out</string>
<string name="mobbsign_previous">Previous</string>
<string name="mobbsign_next">Next</string>

Adding geolocation to signatures

MobbSign for Android supports adding geolocation properties to the signature; location fields are added to the signature so it can be reviewed later to geolocate the user. Fields included are:

  • Latitude
  • Longitude
  • Accuracy (in meters)
  • Locality
  • Country
  • CountryCode (ISO)

First of all, you have to add location permissions to your app, by editing the AndroidManifest.xml file:

<uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
<uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />

To include location data on the signature you have to add a property to MobbSignView:

Bundle customizationBundle = new Bundle();
customizationBundle.putBoolean(MobbSignCustomizationProperties.DEVICE_POSITION_ENABLED, true)
// Configure the rest of the MobbSign properties

MobbSignView mobbSignView = new MobbSignView(this, customizationBundle);

Additionally, you can also configure the minimum accuracy and maximum location time for the location to be included using the DEVICE_POSITION_LAST_TIME and DEVICE_POSITION_ACCURACY properties.

Signature verification with MobbID

MobbSign can work together with MobbID to verify the user signature in use cases where it is important to be sure that only the genuine user can sign on the document.

IMPORTANT: This functionality is not present in the standard MobbSign SDK, so if you need to use it, please contact with Mobbeel team to make sure you have the correct SDK with both MobbID and MobbSign in it.

If you want to verify the user signature before actually sign the document, you just need to use two extra parameters on the SignatureConfiguration object for the next signature to be acquired. You just need to specify that the signature will need verification, along with the uuid of the user in MobbID*:

SignatureConfiguration signatureConfiguration = new SignatureConfiguration();
signatureConfiguration.setVerification(true);
signatureConfiguration.setUserId(userId);
mobbSignView.configureNextSignature(signatureConfiguration);

By doing that, when the user tries to confirm their signature, the verification will be performed against the MobbID instance (online or offline, as configured) and the document will only be actually signed if the verification success. If not, an error will be reported using the MobbSignErrorOccurredListener.onErrorOccurred method.

(*) The way you create a user in MobbID and how you enroll the user signature for subsequents verification is out of the scope of this document. Please refer to MobbID SDK documentation.

← MobbSign Additional ConfigurationAdd a watermark to the signature →