Kappris Filer allows opening of documents from iManage or NetDocuments, external signing with LegalEsign or DocuSign and saving of the completed PDF back to the system that it came from.
These are the components required (current versions at time of writing):
Install the websites and plugins
These can be installed and uninstalled by using SetUpWebSite.ps1 from PowerShell
.\SetUpWebSite.ps1 -install -zipFileName KapprisFiler.126.96.36.19909.zip -commitChanges
To uninstall, use the
-uninstall switch instead of
-install, and you won't need
Each of the KF* zip files contains a KapprisFiler plugin. Once you've installed the main KapprisFiler website you can install each plugin with a command line like this:
.\SetUpWebSite.ps1 -install -zipFileName KFImanage10Deployment.188.8.131.5209.zip
This results in the creation and population of a folder like this:
C:\Program Files (x86)\Kutana\Kappris Filer\Plugins\KFImanage10
KapprisFiler scans the .\Plugins folder and loads whatever plugins it finds. This architecture lets us implement multiple plugins targeting various signing agencies and Document Management Systems, and the customer can cherry pick which of them are required.
As the KapprisFiler website needs external access you will need to add some extra bindings for localhost and a blank to allow connection via the IP address.
Set up external access to the KapprisFiler server
Make the changes in external DNS and route the incoming traffic to the KapprisFiler server - information is here
- Login to the LegalEsign portal at https://legalesign.com/auth/login/
- Click the down-arrow next to your name in the top right-hand corner of the page and select the API item.
- Note the username guid string from the web page, this will be the ClientID to be used later.
- Note the secret key string from the web page, this will be the ApiKey to be used later.
Now add a new API Callback pointing to the external URL of your KapprisFiler server:
In a web browser, go to https://developers.docusign.com/
- If there's a burger button in the top left-hand corner then click it and log in. Or if there's a Developer Account button in the top right-hand corner, click that and log in.
- If you don't already have a developer account, create one for yourself. This may involve entering a numeric confirmation security code sent via email by docusign.
- Once you're logged in, click the burger button (or the user image button in the top right) again, and this time select My Apps and Keys
- Note the API Account ID from the web page to be used later.
- Click the ADD APP AND INTEGRATION KEY button and specify a sensible name such as the name of your server.
- Note the Integration Key to be used later..
- Click the Add Secret Key button and note this to be used later. This secret key is only visible at its time of creation - you can't see it again in the portal afterwards but you can create a new one.
Now under Additional Settings, add your Redirect URIs:
Generate an RSA key pair:
Save the Public Key text as e.g. KutanaPublicKey.pem and the Private Key text as e.g. KutanaPrivateKey.pem
Save these files in a shared location and add an entry in the KapprisFiler appsettings.json as below:
This is only triggered if a company is using Connect in DocuSign (optional DocuSign component)
Add setting "ConnectHmacKey" this allows us to get to the file containing the HMAC key used for connect, if not using connect this must be blank or not exist.
If we specify a HMACKey then the signed document must have a HMAC verification header, or if an envelope has a HMAC verification header it must match with our key. If not we ignore the hook payload as its not valid.
KSS now checks for ConnectHmacKey having a value and set up the event packet in the envelope to use HMAC
In the environment, add the below (see instructions and batch file further down the page):
SETX KapprisFiler__DocuSign__ConnectHmacKey "XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX" /m
To obtain the HMAC key, go to your DocuSign account and choose 'Connect' in the LH menu then 'Connect Keys'
The admin login for DocuSign should be done using the DocuSign Admin Module which the client will need to add to their DocuSign account if they don't already have it.
Setup instructions for this can be found here
First you will need to add the KapprisFiler app to iManage:
In iManage 10 Control Centre go to Settings | Applications and click Add Application:
Create a new application called KapprisFiler with a ClientID and Secret as below:
Note that only the top 2 callbacks are needed in a live environment (we have the other two for testing)
Set the security for an admin user.
In the NetDocs Partner Portal App Registration choose New Application as below:
Configure as below noting the ClientID and Secret
Add settings into the environment
Using the ClientIDs and Client Secrets that you noted earlier use the SETX command to add them to the environment
KapprisSigning__InternalSigning__CursiveFont=Brush Script MT
KapprisSigning__InternalSigning__DatabaseConnection=Data Source=IW-Server2019;Initial Catalog=KapprisWIS;Integrated Security=SSPI;
Edit this batch file KapprisSetEnvironment.bat to add the settings more easily.
Other settings and configuration
On the SQL server we need to create the KapprisFiler database and the SQL login account 'KapprisFiler' with the password shown above under KapprisFiler__ConnectionStrings__QueueDatabase.
The account needs db_owner roles for the KapprisFiler database. The structure of the database is created automatically on first use.
In the KapprisFiler AppSettings.json add:
"DocPattern": "[NAME] ([ID]) Signed [DATE]"
"DocPattern": "[NAME] ([ID]) Signed [DATE]"
- DocuSign RetrievalType
- "" empty string - means retrieve individual files
- "combined" - for one file
- "archive" - for zip (not supported),
- "certificate" - for just certificate
- "portfolio" - for a portfolio pdf
Email configuration is the email account and administrator details for alerts when KapprisFiler has been unable to collect and file the final document.
See explanation of DocPattern here
In the Kappris Signing Server AppSettings.json add:
In the Kappris WebViewerAPI AppSettings.json set:
"SigningService": "O3.Legalesign", (OR O3.DocuSign)
"OCRLibFolder": "\\\\kutana.local\\dev\\Download\\KofaxOmnipage\\CSDK22\\bin", (If using OCR)
KapprisFiler home and submissions pages
KapprisFiler homepage e.g. https://kf-server2019.kutana.co.uk:44361/ is where the customer's administrator will login to iManage/NetDocs with the admin account specified when you created the apps earlier.
LegalEsign doesn't require a login and DocuSign login is done via DocuSign Admin mentioned earlier
You can view submissions to KapprisFiler at e.g. https://kf-server2019.kutana.co.uk:44361/submissions
The Status should change from Pending - Signed - Retrieved - Filed as the document goes through the various signing stages.
Clicking on 'Details' allows you to see further information and change the status for resubmission or testing.
Testing external route to KapprisFiler
External test to confirm connection to KapprisFiler (see prerequisites here):
Browse to HTTPS://kapprisfiler.kutana.co.uk:44361/legalesignagency and you should see the number of hooks that are set:
Link to original instructions here