There are a number of prerequisites that need to be in place to allow users to download and install DataShare Connect (vClient) on their machines.
Please forward the below prerequisites to an IT department that will be able to confirm and apply any changes needed to run vClient.
Registry Key Access
In order for the vClient application to be installed via ClickOnce, the user installing the application must have read/write permissions to some registry keys and folders.
Read/Write access should be provided to the following registry keys:
- HKEY_CURRENT_USER\Software\Classes\Software\
- HKEY_CURRENT_USER\Microsoft\Windows\CurrentVersion\Uninstall
Read/Write access should be provided to the following folders:
- %userprofile%\AppData\Roaming
- %userprofile%\AppData\Local
Provisioner URL
The below provisioner URL needs to be 'white-listed' on the machine for the user running vClient. Please ensure that the correct URL for your region is added to the machine's Antivirus, Firewall, and Proxy 'white-list' as the provisioner URL is where vClient is downloaded from.
| The region where you are uploading from | URL to white-list |
| Europe: | http://vclient-provisioner-uk-validis.azurewebsites.net/ |
| North America (US): | http://vclient-provisioner-us-validis.azurewebsites.net/ |
| North America (CA): |
http://vclient-provisioner-ca-validis.azurewebsites.net/ |
| Australia (AU): | https://vclient-provisioner-au-validis.azurewebsites.net/ |
Product Specifications
|
Name |
Description |
Note |
|---|---|---|
|
Technology |
Microsoft ClickOnce Name - vClient Publisher - Validis LLC |
|
|
Http and Https ports |
80, 443 |
|
|
FTP |
FTP is not used. File downloads and uploads are performed using HTTP. |
|
|
.NET Framework |
4.8 |
|
|
Security |
TLS 1.3, TLS 1.2 |
TLS 12.3 is the preferable Transport Layer Security |
|
Operating System |
Windows |
Any version of Windows that support .NET Framework. 4.8 |
|
Administrative Privileges |
None |
|
|
File System |
%APPDATA%\Roaming\Validis |
Validis\Logs - Time-stamped logs produced by running vClient Validis\Storage - ClickOnce downloaded executable, icons, and configuration files Validis\temp - Optional intermediate file storage |
|
Network Speed |
The minimum network speed and reliability have to be sufficient to allow the data uploads to succeed. |
The minimum network speed is difficult to quantify and measure as it is complex and can be dependent on the volume of information being uploaded. |
|
Browser Processing |
The Chrome and Firefox browsers download a vclient.application which when clicked on "Download", the vClient core files into the %APPDATA% Validis Storage location. The Microsoft Edge browser, typically, automatically opens the file vclient.application in the browser. |
|
|
vClient Core Files |
1icon.ico.depoly
2Azure.Core.dll
3Azure.Storage.Blobs.dll
4Azure.Storage.Common.dll
5Microsoft.Bcl.AsyncInterfaces.dll
6System.Buffers.dll
7System.Diagnostics.DiagnosticSource.dll
8System.IO.Hashing.dll
9System.Memory.Data.dll
10System.Memory.dll
11System.Numerics.Vectors.dll
12System.Runtime.CompilerServices.Unsafe.dll
13System.Text.Encodings.Web.dll
14System.Text.Json.dll
15System.Threading.Tasks.Extensions.dll
16System.ValueTuple.dll
17vClient.exe
18vClient.exe.config
19vClient.Uninstaller.exe
20Microsoft.Bcl.HashCode.dll
|
The downloaded files are automatically deleted from the Validis\Storage location when vClient Upload processing is complete. |
|
Download file processing |
The files are downloaded with the file extension of “deploy” and the file is converted to a DLL executable binary by ClickOnce. Other conversions also occur, for example to icon files of type “ico”.
|
A call is made to a Web endpoint to download the required files. For example, when System.Text.Json.dll.deploy is downloaded it will become System.Text.Json.dll. |
Comments
0 comments
Please sign in to leave a comment.