# Windows Socket Service Connector

# Installation

Execute to provided installation file and follow the installation wizard.

[![image.png](https://help.sadevio.com/uploads/images/gallery/2025-01/scaled-1680-/bt1image.png)](https://help.sadevio.com/uploads/images/gallery/2025-01/bt1image.png)

After the installation was successful executed, you will find the service in the Microsoft services overview.

[![image.png](https://help.sadevio.com/uploads/images/gallery/2025-01/scaled-1680-/YLeimage.png)](https://help.sadevio.com/uploads/images/gallery/2025-01/YLeimage.png)

The configuration file you can find under **C:\\ProgramData\\Sadevio\\appsettings.json**

# Configure Access Control Cloud Connector

Create a Sadevio connector token in the sadevio cloud system.

Go to Maintenance -> Access System -> New Access System.

As Connector Type, select Web Socket.

The system will generate a unique Application Id which you need for the service.

[![image.png](https://help.sadevio.com/uploads/images/gallery/2025-01/scaled-1680-/rFiimage.png)](https://help.sadevio.com/uploads/images/gallery/2025-01/rFiimage.png)

Now we need to configure the windows service. Open the configuration file as Administrator C:\\ProgramData\\Sadevio\\appsettings.json.

  
Simply open it with a text editor.

<table border="0" cellpadding="0" cellspacing="0" class="MsoNormalTable" id="bkmrk-%7B-%C2%A0-%22logging%22%3A-%7B-%C2%A0%C2%A0%C2%A0" style="margin-left: 5.4pt; border-collapse: collapse; height: 754.781px;" width="576"><tbody><tr style="height: 734.781px;"><td nowrap="nowrap" style="width: 5in; border-top: 1pt solid windowtext; border-left: 1pt solid windowtext; border-bottom: none; border-right: none; padding: 0in 5.4pt; height: 734.781px;" valign="bottom" width="480"><span style="font-size: 7pt; color: rgb(255, 255, 255);">{</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Logging": {</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Console": {</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Default": "Trace",</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Microsoft": "Warning",</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Microsoft.Hosting.Lifetime": "Information"</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>},</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"LogLevel": {</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Default": "Information",</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Microsoft": "Warning",</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Microsoft.Hosting.Lifetime": "Information"</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>}</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>},</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"AllowedHosts": "\*",</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"> </span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"SADEVIO": {</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"> </span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"local\_ip": "",</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"service\_port\_loop": 5005,</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"service\_port\_any": 5010,</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"certificate\_path": "",</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"certificate\_password": "",</span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"> </span>

**<span style="font-size: 7.0pt; color: #00b0f0;"><span style="mso-spacerun: yes;"> </span>"cloud\_connector": true,</span>**

**<span style="font-size: 7.0pt; color: #00b0f0;"><span style="mso-spacerun: yes;"> </span>"cloud\_connector\_url": "wss://cloud.sadevio.com/sadevio\_socket\_module/socket/{0}/accesscontrol",</span>**

**<span style="font-size: 7.0pt; color: #00b0f0;"><span style="mso-spacerun: yes;"> </span>"cloud\_connector\_application\_id": "wst-52bd91eb0c180d9b0e82e36df82382898402c935282599cab9bbe04c8dec ",</span>**

**<span style="font-size: 7.0pt; color: #00b0f0;"> </span>**

**<span style="font-size: 7.0pt; color: #00b0f0;"><span style="mso-spacerun: yes;"> </span>"access\_system\_database\_connector": "Data Source=192.168.1.174\\\\SQLEXPRESS,1433;Initial Catalog=Velocity;User Id=sadeviointegration;Password=sadeviointegration",</span>**

**<span style="font-size: 7.0pt; color: #00b0f0;"><span style="mso-spacerun: yes;"> </span>"access\_system\_database\_connector\_dialect": "NHibernate.Dialect.MsSql2012Dialect, NHibernate",</span>**

**<span style="font-size: 7.0pt; color: #00b0f0;"><span style="mso-spacerun: yes;"> </span>"access\_system\_database\_connector\_connection\_driver": "NHibernate.Driver.SqlClientDriver"</span>**

<span style="font-size: 7.0pt; color: black;"> </span>

<span style="font-size: 7pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>}</span>

<span style="font-size: 8pt; color: rgb(255, 255, 255);"> </span>

<span style="font-size: 8pt; color: rgb(255, 255, 255);">}</span>

</td><td nowrap="nowrap" style="width: 1in; border-top: 1pt solid windowtext; border-left: none; border-bottom: none; border-right: 1pt solid windowtext; padding: 0in 5.4pt; height: 734.781px;" valign="bottom" width="96"> </td></tr><tr style="height: 20px;"><td nowrap="nowrap" style="width: 5in; border-top: none; border-left: 1pt solid windowtext; border-bottom: 1pt solid windowtext; border-right: none; padding: 0in 5.4pt; height: 20px;" valign="bottom" width="480"> </td><td nowrap="nowrap" style="width: 1in; border-top: none; border-left: none; border-bottom: 1pt solid windowtext; border-right: 1pt solid windowtext; padding: 0in 5.4pt; height: 20px;" valign="bottom" width="96">  
</td></tr></tbody></table>

# Passport Reader Integration

<table border="0" cellpadding="0" cellspacing="0" class="MsoNormalTable" id="bkmrk-%7B-%C2%A0-%22logging%22%3A-%7B-%C2%A0%C2%A0%C2%A0" style="margin-left: 5.4pt; border-collapse: collapse; mso-table-layout-alt: fixed; mso-yfti-tbllook: 1184; mso-padding-alt: 0in 5.4pt 0in 5.4pt;" width="576"><tbody><tr style="mso-yfti-irow: 0; mso-yfti-firstrow: yes; height: 14.8pt;"><td nowrap="nowrap" style="width: 5.0in; border-top: solid windowtext 1.0pt; border-left: solid windowtext 1.0pt; border-bottom: none; border-right: none; mso-border-top-alt: solid windowtext .5pt; mso-border-left-alt: solid windowtext .5pt; padding: 0in 5.4pt 0in 5.4pt; height: 14.8pt;" valign="bottom" width="480"><span style="font-size: 11pt; color: rgb(255, 255, 255);">{</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Logging": {</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Console": {</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Default": "Trace",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Microsoft": "Warning",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Microsoft.Hosting.Lifetime": "Information"</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>},</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"LogLevel": {</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Default": "Information",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Microsoft": "Warning",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"Microsoft.Hosting.Lifetime": "Information"</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>}</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>},</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"AllowedHosts": "\*",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"SADEVIO": {</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"local\_ip": "",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"service\_port\_loop": 5005,</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"service\_port\_any": 5010,</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"certificate\_path": "",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"certificate\_password": "",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span><span style="color: rgb(53, 152, 219);">"passport\_reader\_uv": true,</span></span>

<span style="font-size: 11pt; color: rgb(53, 152, 219);"><span style="mso-spacerun: yes;"> </span>"passport\_reader\_ir": true,</span>

<span style="font-size: 11pt; color: rgb(53, 152, 219);"><span style="mso-spacerun: yes;"> </span>"passport\_authentication": true,</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"cloud\_connector": false,</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"cloud\_connector\_url": "wss://cloud.sadevio.com/sadevio\_socket\_module/socket/{0}/accesscontrol",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"cloud\_connector\_application\_id": "",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"access\_system\_type": "",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"velocity\_rest\_ip": "",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"velocity\_rest\_password": "",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"velocity\_rest\_transfer\_qr\_code": false,</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"velocity\_rest\_template\_id": "",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"velocity\_rest\_card\_format": "",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"velocity\_requried\_udf\_fields": \[\],</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"access\_system\_database\_connector": "",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"access\_system\_database\_connector\_dialect": "NHibernate.Dialect.MsSql2012Dialect, NHibernate",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"access\_system\_database\_connector\_connection\_driver": "NHibernate.Driver.SqlClientDriver",</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>"philippines\_id": true</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="mso-spacerun: yes;"> </span>}</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);">}</span>

</td><td nowrap="nowrap" style="width: 1.0in; border-top: solid windowtext 1.0pt; border-left: none; border-bottom: none; border-right: solid windowtext 1.0pt; mso-border-top-alt: solid windowtext .5pt; mso-border-right-alt: solid windowtext .5pt; padding: 0in 5.4pt 0in 5.4pt; height: 14.8pt;" valign="bottom" width="96"> </td></tr><tr style="mso-yfti-irow: 1; mso-yfti-lastrow: yes; height: 15.0pt;"><td nowrap="nowrap" style="width: 5.0in; border-top: none; border-left: solid windowtext 1.0pt; border-bottom: solid windowtext 1.0pt; border-right: none; mso-border-left-alt: solid windowtext .5pt; mso-border-bottom-alt: solid windowtext .5pt; padding: 0in 5.4pt 0in 5.4pt; height: 15.0pt;" valign="bottom" width="480"> </td><td nowrap="nowrap" style="width: 1.0in; border-top: none; border-left: none; border-bottom: solid windowtext 1.0pt; border-right: solid windowtext 1.0pt; mso-border-bottom-alt: solid windowtext .5pt; mso-border-right-alt: solid windowtext .5pt; padding: 0in 5.4pt 0in 5.4pt; height: 15.0pt;" valign="bottom" width="96">  
</td></tr></tbody></table>

### Passport Reader Authentication

To activate the authentication feature with Assure Id, you need to set following configuration

<span style="font-size: 11pt; color: rgb(255, 255, 255);"><span style="color: rgb(53, 152, 219);">"passport\_reader\_uv": true,</span></span>

<span style="font-size: 11pt; color: rgb(53, 152, 219);"><span style="mso-spacerun: yes;"> </span>"passport\_reader\_ir": true,</span>

<span style="font-size: 11pt; color: rgb(53, 152, 219);"><span style="mso-spacerun: yes;"> </span>"passport\_authentication": true,</span>

#### <span style="font-size: 11pt; color: rgb(255, 255, 255);">Installation</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);">Download the Assure ID software from the installation share.</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);">[https://drive.google.com/drive/folders/1EU\_DoR-2Mjub9eWgm-omcPZIqcF0o64M?usp=sharing](https://drive.google.com/drive/folders/1EU_DoR-2Mjub9eWgm-omcPZIqcF0o64M?usp=sharing)</span>

<span style="font-size: 11pt; color: rgb(255, 255, 255);">Execute the "Install AssureID"</span>

[![Screenshot 2025-01-23 at 9.48.45 AM.png](https://help.sadevio.com/uploads/images/gallery/2025-01/scaled-1680-/screenshot-2025-01-23-at-9-48-45-am.png)](https://help.sadevio.com/uploads/images/gallery/2025-01/screenshot-2025-01-23-at-9-48-45-am.png)

Enter your license code

[![Screenshot 2025-01-23 at 9.53.07 AM.png](https://help.sadevio.com/uploads/images/gallery/2025-01/scaled-1680-/screenshot-2025-01-23-at-9-53-07-am.png)](https://help.sadevio.com/uploads/images/gallery/2025-01/screenshot-2025-01-23-at-9-53-07-am.png)

Select the option to install "Complete"

[![Screenshot 2025-01-23 at 9.53.58 AM.png](https://help.sadevio.com/uploads/images/gallery/2025-01/scaled-1680-/screenshot-2025-01-23-at-9-53-58-am.png)](https://help.sadevio.com/uploads/images/gallery/2025-01/screenshot-2025-01-23-at-9-53-58-am.png)

Activate your license with the AssurreID License Activation

[![Screenshot 2025-01-23 at 9.57.02 AM.png](https://help.sadevio.com/uploads/images/gallery/2025-01/scaled-1680-/screenshot-2025-01-23-at-9-57-02-am.png)](https://help.sadevio.com/uploads/images/gallery/2025-01/screenshot-2025-01-23-at-9-57-02-am.png)

[![Screenshot 2025-01-23 at 9.58.04 AM.png](https://help.sadevio.com/uploads/images/gallery/2025-01/scaled-1680-/screenshot-2025-01-23-at-9-58-04-am.png)](https://help.sadevio.com/uploads/images/gallery/2025-01/screenshot-2025-01-23-at-9-58-04-am.png)