MobbSign Additional Configuration

This page contains some additional configuration for MobbSign.

Signature configuration

You can configure some details of the signature process:

• mobbSignView.setStampImage(Bitmap); Indicates an image to be drawn within the signature as a stamp.
• mobbSignView.addCustomField(String, String); Indicates a key-value pair field to be written in the non-visible part of the signature field.
• mobbSignView.addSignedCustomField(String, String); Indicates a key-value pair field to be written in the signed information of the signature field.
• mobbSignView.configureNextSignature(SignatureConfiguration); With this method you can configure how signature will be drawn in the document. You can configure:
  • positionRect for specifying a position for the signature image.
  • positionPage for specifying a page for the signature image.
  • strokeColor for specifying the color of the signature.
  • strokeWidth for specifying the width of the of the signature stroke.
  • signatureDate for specifying the date of the signature.
  • signerName for specifying the name of the sign.
  • duplicateSignatureImageListfor specifying the range of pages where sign will duplicate.

With this SignatureConfiguration object you can also setup a bundle with signature.type configuration property:

Key name	Type	Default value	Description
signature.type	SignatureType	SignatureType.ALL	With this property, the SDK can be setup in three modes: HANDWRITTEN: Sign the document with the handwritten signature using the finger or a pen. FINGERPRINT: Sign the document with a fingerprint reader. ALL: The SDK attends all available methods and the user chooses which one he/she prefers.

• mobbSignView.addTimestampServer(String, String, String); Configure a timestamp server to be used for timestamping the signatures. You should configure the server URL along with the username and password, if needed. IMPORTANT: timestamp servers are paid services whose prices are not included in MobbSign licence.

Fingerprint configuration

MobbSign allows users to use their fingerprint as a method to sign document instead of handwritten signature, using fingerprint readers provided by Precise Biometrics.

You can configure the SDK to sign documents using your fingerprint.

1. Install Tactivo Manager from play store.

   You must include the following permission:

   <uses-permission android:name="com.precisebiometrics.android.mtk.manager.permission.BIOMETRIC_DATA" />
   

2. Set “SignatureType.FINGERPRINT” to the appropriate key in the MobbSign bundle configuration:

   SignatureConfiguration signatureConfiguration = new SignatureConfiguration();
   signatureConfiguration.getExtras().putSerializable(”signature.type”, SignatureType.FINGERPRINT);
   

Please check out the javadoc documentation to see all the possible customizable keys for fingerprint acquisition process.

Allow the MobbSign SDK to show relevant messages to the user

Since version v3.6.0 of the MobbSign Android SDK, it is possible to allow the SDK to show relevant messages to the user in the use of the application and during the signing process. The user would be notified in the following cases:

• If the length of the signature drawn by the signer does not complain the configured minimum length
• If the MobbSign usage license could not be verified
• If there is any error in obtaining the signer's location data

The customization parameter is MobbSignCustomizationProperties.SHOW_RELEVANT_MESSAGES, default true. Messages will always be displayed using a long-duration Toast.

Validate the length of the signature drawn by the signer

Since version v3.6.0 of the MobbSign Android SDK, it is possible to validate the length of the signature drawn by the signer. If this length is less than a set minimum number of points, the signature is automatically discarded and the signature capture process is finished.

The minimum number of points that the signature must have can be configured in the MobbSign Customization Bundle using the MobbSignCustomizationProperties.SIGNATURE_MIN_NUM_POINTS parameter. Its default value is 50.

If the signature is discarded for not fulfilling the minimum length and the onErrorOccurred() listener is filled, the discard event is notified by this listener with error code 1 — MobbSignResultCodes.ERROR_ACQUIRING_SIGNATURE.

If the SDK has been allowed to display relevant messages to the user (MobbSignCustomizationProperties.SHOW_RELEVANT_MESSAGES = true), the user will be notified that the stroke they have drawn does not have the minimum length required to be considered as a valid signature.