link

# Signicat Sign for Salesforce

# Introduction

This document is aimed at Salesforce administrators and Salesforce integration partners and details the process of installing and configuring the Signicat Sign for Salesforce app.

# Product overview

  • Signicat Sign for Salesforce is an application for signing contracts and quotes as part of Salesforce CRM.
  • Salesforce administrators can download the app from AppExchange, which is the app store for Salesforce.
  • Signicat provides the Sign engine which the app communicates with.
  • Signicat acts as a pure data processor and does not store user data.
  • This document describes how to configure the app to interact with the Sign engine.
  • This document is intended for Salesforce administrators or customers' integration partners.

# Install and configure Signicat Sign for Salesforce

  • In AppExchange, search for Signicat and click on the listing for Signicat Sign. Click Get It Now to install.
  • If available, it is recommended to install the app in a Salesforce test environment.
  • After setup, you will be able to configure the app for Signicat's pre-production environment.
  • The default signing method will be InkSign + SMS.
  • Signicat provides a set of signing methods for multiple countries. Contact Signicat for more information.

Choose Install for All Users click-to-zoom

# Complete installation

Grant access to the remote site settings included in the package:

  • external.preprod.signicat.com
  • external.signicat.com

click-to-zoom

Click Done on the final screen. You will receive an email on completion.

click-to-zoom

click-to-zoom

When clicking Done, you will be guided to 'Installed Packages', where you should see 'Signicat Sign'.

Now you are ready to establish a connection to the Signicat Sign API.

click-to-zoom

# Create email notification service

To enable Signicat to alert Salesforce when events happen, an email service for inbound email notifications is necessary. Go to Setup - Custom Code (in Lightning) -> Email Service. Type Email Service in Quick find

# Set up email feedback channel

Set up a new Email Service (Apex) in Salesforce:

  • Apex Class: signicatsign.SignicatEmailNotificationService
  • Accept Email From: noreply@Signicat.com

Add a new email address using the same address as above. click-to-zoom

# Create a new Email Service

click-to-zoom

Give it a name and find the SignicatEmailNotificationService apex-class. Accept email from noreply@signicat.com.

click-to-zoom

Click Save and New and add noreply@signicat.com as an accepted recipient.

click-to-zoom

Click Activate.

click-to-zoom

# Signicat Sign for Salesforce app settings

Set up Signicat Sign for Salesforce app settings -- open the app.

click-to-zoom

# Edit Environment settings

Environment settings must correspond with the name you just added to the Named Credential for pre-production and production respectively Open 'Preprod Admin' settings

  • Input the name of the preprod named credentials in the field 'Environment'.
  • Save record. Open 'Prod Admin' settings
  • Input the name of the prod named credentials in the field 'Environment'.
  • Save record.

Adjust Admin settings -- make sure they are as below.

click-to-zoom

Scroll down and make sure 'Feedback channel' is set to "email"

click-to-zoom

# Test signatures

Go to 'New signing request' and test using the following steps:

  1. Find a user or contact to register a new task
  2. Click Add Signer
  3. Add a PDF document
  4. Click Upload Document
  5. Click Send
  6. Click Finish

If anything goes wrong or you receive errors, an error message should be displayed as a red "toast" on the screen.

# New Signing request

Open App Launcher and find Signicat Sign.

click-to-zoom

Add a title for the request. Add recipients that should sign the document (signers).

click-to-zoom

The signer will be added to the list on the right.

click-to-zoom

Select the PDF to be signed and click Upload File.

click-to-zoom

Verify that request is correctly set up with signers and documents. Click Send.

click-to-zoom

Click Finish to open the 'Details' page.

click-to-zoom

The signing parties will be able to sign when you distribute the link to them. Click on the task name to open the details.

click-to-zoom

On the task's 'Details' page, compose an email and send it to an existing or new contact.

click-to-zoom

When all signers have completed their signing tasks, Salesforce is updated and the signed document saved as a file.

click-to-zoom

Click Finish and then click the Perform signature link on the task.

click-to-zoom

Sign with the selected method.

click-to-zoom

click-to-zoom

Input the SMS OTP you received and click Continue. This step varies depending on the method, e.g.:

  • NemID
  • BankID
  • Email OTP

click-to-zoom

# See sign result in Salesforce

Salesforce will be alerted using the Email Service created in an earlier step and the signed document will be saved in Salesforce. The request's status will have been set to 'Completed'. Check the 'Signature order' tab in the app to verify this.

click-to-zoom

# Change landing page

  • Go to the 'Settings' tab in the Signicat Sign app.
  • Find the 'API Management' section and navigate to the 'Document Service admin' record in the list.
  • Set the 'On Task Complete URL' field to the desired URL. If left blank, you will see a blank page when completing a signing request.

click-to-zoom

# Enabling the solution for production

  • Contact Signicat sales for a contract.
  • Discuss with Signicat which Sign methods are to be used.

# Import the Signicat Sign certificate keystore

  • You will have received an email from Signicat with a link to download a Java keystore file (.jks) containing the certificate for the service. This file should be stored in a secure place.
  • You should be in possession of the encryption password for the keystore file (.jks). Signicat will have provided this by SMS. Import this keystore into Salesforce.

Go to 'Setup' -> 'Certificate and Key Managment'.

click-to-zoom

Upload the file downloaded from Signicat Vault and type in the encryption password.

click-to-zoom

You should have a successful import with a keystore label. Remember and copy this label.

click-to-zoom

Open the 'Settings' tab and find the 'Prod Admin' settings under 'Environments'.

click-to-zoom

Open and click Edit on this admin record.

click-to-zoom

Check the 'Default settings' checkbox and click Save.

click-to-zoom

Test the previous signing request from pre-production again. Check that everything still works. You are now in production.

# If you have your own service with Signicat

This will be the normal case for production.

# Establish a connection to the API

Create Named Credentials for Preprod and Prod. You will need two named credentials for each environment.

  • Same name for both, but the second needs the prefix 'SDS'.
  • Both are 'Password Authentication' with 'Named Principal' (User name and password are provided by Signicat -- the endpoint is specific for each environment).
  • The first should have all three checkboxes checked.
  • The second should only have the Generate Authorization Header checkbox checked.

# Named Credentials overview

click-to-zoom

# Named Credential, first version: all three checkboxes. Endpoint according to environment (preprod here)

click-to-zoom

# Named Credential, second version: prefix 'SDS' -- only first checkbox checked -- else identical to first version

click-to-zoom

# Repeat for production: new endpoint and password -- add also the certificate imported from Signicat

click-to-zoom

# Production second version

click-to-zoom

Last updated: 8/9/2021, 1:34:03 PM