Deploying the Push Notification Service for OneSpan Sign for Microsoft SharePoint
The Push Notification Service is needed only if your connector is installed on-premises. If you have a SaaS deployment, please ignore this section.
The deployment instructions below are relevant only if you are using OneSpan Sign for Microsoft SharePoint. If you are using v2.1 of eSignLive for Microsoft Dynamics CRM, click here. If you are using v1.2 of eSignLive for Microsoft Dynamics CRM, click here.
The Push Notification Service:
- Receives an Event Notification (callback) from OneSpan Sign every time the status of an e-signature process changes;
- Transmits that information to the relevant connector.
The rest of this section describes:
- Installing the Push Notification Service
- Verifying the Push Notification Service
- Uninstalling the Push Notification Service
To install the Push Notification Service:
Create an IIS Website by doing the following:
- Connect to IIS with sufficient privileges.
- Click Add Web Site. A new dialog box appears.
- Specify the following parameters:
- Site name: You can specify any name you want.
- Physical path: This path should identify the folder where the Push Notification Service will be installed.
- Port: You can specify any port number you want.
- Click OK.
- Ensure that the Application Pool version is 4.0 by selecting the Basic Settings of the Application Pool, as illustrated below.
- Double-click the file
- On the Welcome screen, click Next. A new dialog box appears.
- Specify the IIS Site and Application Pool.
Specify a Virtual directory only if you want to host the service on a virtual directory inside the IIS Website. Otherwise, leave that field blank.
- Click Next. The Connection Settings page appears.
- Specify the following parameters, which will be used to store the service's notifications. Their values were determined when the SQL database was installed as part of your connector's deployment.
- Server Name: Name of the SQL server
- Database Name: Name of the SQL database
- User Name: The user name associated with the database
- Password: Password for the User name
- The URL for the Push Notification Service is:
SERVER_NAME:PORT} is a placeholder for the server name and port number.
The service can be hosted on any port you want.
The server name and port must be accessible from the Internet. You may want to open your firewall exclusively to OneSpan Sign's IP address. If so, you can obtain that IP address from our Support Team.
This URL should be used in OneSpan Sign Account > Callback URL in the connector configuration.
PostESLEvent is the method in the service that receives
HTTP POST requests with a JSON payload as event data.
To verify that events are being properly received by the Push Notification Service:
- Create a package using your OneSpan Sign connector.
- The service should have received at least one event associated with the new package. Verify that it has by checking the SQL table:
Select * From EslNotifications
- If the expected events do not appear, check the following service log:
- If the log files have not been created, there could be a permission issue on the IIS Website directory. Ensure that the account running the Application Pool has write permissions to the Website folder.
The Push Notification Service will not work if there is not enough free memory. If you find that it isn't working, ensure that on the server where the service is installed, the free memory is > 5% of the total memory.
The Push Notification Service is needed by your connector if it was installed on-premises. Thus you should uninstall the service only if you also want to uninstall the on-premises deployment of your connector.
To uninstall the Push Notification Service for your connector:
- Run the file
ESLEventReceiverInstaller.msi, and select Remove ESLEventReceiverInstaller. Then click Finish.
- Delete the IIS Website and Application Pool by right-clicking PushNotificationService, and selecting Remove.