Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Sinadura 5 for Alfresco ECM

Protocol based digital signatures for Alfresco


Sinadura 5 for Alfresco is an addon for digital signature in Alfresco 5. The addon provides:

  • Actions for signing one or several files in Alfresco Share client.
  • The possibility of signing any type of file. Pades signatures are used for PDF files and Xades dettached for the other mimetypes.
  • Advanced signature properties, such as timestamps or digital signature validations.
  • Digital signature profiles, depending on your corporate certificates using custom images for signature stamps (for PDF only). You can - also place these visible stamps in a customized position of the document.
  • Previews and metadata indicators for digital signatures

Video demo


  • Sinadura 5 Desktop (in your local machine): download desktop client from
  • Sinadura Cloud Services (in Alfresco server)
  • Alfresco AMPs (in Alfresco server)

The installers of Sinadura 5 are available for Linux and Windows, and they include the installation of sinadura protocol in the operating system. The sinadura protocol works via a third party service (sinaduraCloud.war) installed in a servlet container that can be part of your Alfresco installation. Also, two AMP files are needed for Alfresco repository and Alfresco Share respectively. Another two AMPs are available for the validation of the digital signatures and the visualization of properties in Alfresco Share.


In the client:

  • Download sinadura 5 Desktop (for Windows or Linux)
  • Install your software certificates or smartcards in your OS
  • Check that Sinadura Desktop is able to sign locally

In the server:

  • Install AMPs in Alfresco repo and Alfresco Share
  • Copy sinaduraCloud.war into $ALF_HOME/tomcat/webapps
  • Restart Alfresco service


Configuring Sinadura Services Endpoint

This configuration may be in file

# Sinadura online properties

# Sinadura Services endpoint<alfresco-host-frontend-url>/sinaduraCloud

# This option configures the signature type for PDF files. It may be PDF|XADES

# This option enable to store all digital signatures in the same directory of the original document

# If previous property is false, a rootpath may be configured

Advanced and custom configuration

Configuring mimetypes

In addition, you can configure the mimetypes, for which you want to show the Sign with Sinadura action in:

zk-sign-online-context.xml (the evaluator is disabled by default)

<config evaluator="string-compare" condition="DocLibActions">
          <action id="zk-sign-online" type="javascript" label="" icon="zk-sign-online">
          <param name="function">onActionZKSignOnline</param>
          <!-- evaluator>zk-evaluator.doclib.action.signOnline</evaluator> -->
               <permission allow="true">Write</permission>


<!-- evaluator mimetypes -->
<bean id="zk-evaluator.doclib.action.signOnlineMimetype" parent="evaluator.doclib.action.isMimetype">
	<property name="mimetypes">

Configuring Share previews for PDF signatures

According to the Alfresco share version, you must comement part of code on the file /tomcat/webcomponents/preview/pdfjs/pdf.worker.js:

if ( === 'Sig') { 
	warn('unimplemented annotation type: Widget signature'); 
	return false;

Make sure to update the minified file pdf.worker-min.js

commenting this part.

Cluster mode configuration

By the moment, in a clustered setup we need to configure a hot standby (active-passive). For example with an Apache frontend:

<VirtualHost *:8080>
	ServerName alfserver

	ErrorLog /var/log/apache2/alf-error.log
	CustomLog /var/log/apache2/alf-access.log combined
	<Proxy balancer://sinaduraCloud>
		BalancerMember ajp://alfnode2:8009 retry=30
		# the hot standby
		BalancerMember ajp://alfnode1:8009 status=+H retry=0

	ProxyPass /sinaduraCloud balancer://sinaduraCloud/sinaduraCloud lbmethod=byrequests stickysession=JSESSIONID|jsessionid
	ProxyPassReverse /sinaduraCloud ajp://alfnode1:8009/sinaduraCloud
	ProxyPassReverse /sinaduraCloud ajp://alfnode2:8009/sinaduraCloud
	ProxyPass / ajp://alfnode1:8009/
	ProxyPassReverse / ajp://alfnode2:8009/

Please consider contribute to Sinadura for an improved cluster mode or new types of signature compatibility.


Sign action in Alfresco Share

Sign Action in Alfresco Share

Sign multiple action in Alfresco Share

Sign Multiple Action in Alfresco Share

Previews and custom position for digital signatures for PDF files

Previewing PDF signatures

Signature preview for PDF files

Previewing PDF signatures

Target setup

  • Sinadura 5 Desktop
  • Alfresco 201602GA
  • Alfresco 201702GA
  • Alfresco 5.0.3
  • Alfresco 5.1.2

Main contributors

Sinadura addon for Alfresco

Sinadura Desktop client and Sinadura Services (sinaduraCloud.war)

Internationalization of Sinadura


201705 - Full config via

201704 - Brazilian Portuguese translation

201703 - Maven SDK 2.2 based initial version
       - Revision of content model and properties
       - Surf extension configuration
       - Custom indicator 
       - Module naming, properties, and action labeling        
       - English translation