SparkView integration guide
1. – Deployment
2. – Integration without programming
2.1 – Microsoft RD Web Access portal
Assume your web portal address is: https://MyRDPortal/RdWeb. You need to set up the following two...
2.2 – Active Directory and LDAP
If all your users are domain users, please create a plain text file (encoding: UTF-8 without Byte...
2.3 – Radius
{ "source": { "type": "RADIUS", "properties": { "server": "192.168.12.128", ...
2.4 – OAuth2
First, save your OAuth2 provider configuration into a JSON file, for example: { "providers" : [...
2.5 – SAML
You can get the integration of SAML from this document.
2.6 – Single Sign-On (SSO) with HTTP basic authentication
You can enable HTTP Basic Authentication on SparkView by setting authorization=Basic in gateway.c...
3. – Client side (browser) integration
3.1 – Use 8 lines of code to start a remote connection from a web page
Save a JavaScript file as tutorial1.page.js with the following content: window.onload = function(...
3.2 – Using object or cookie for parameters
You can also use objects or cookie for parameters: Object parameters with Rdp2: window.onload = f...
3.3 – Resource redirection and parameters
SparkView has resource redirection (clipboard, drive, audio redirection etc.) disabled by default...
3.4 – Start a program on connection (as shell)
Set up the following parameters: startProgram=shell command=encodeURIComponent(‘C:\\apps\\notepad...
3.5 – Start RemoteApp
Add the following parameters if you want to start the RemtoeApp in current browser window: startP...
3.6 – Virtual Channel (VC) and Dynamic Virtual Channel extension
SparkView JavaScript client supports standard RDP virtual channel and dynamical virtual channel e...
3.7 – Gateway channel
You can create multiple gateway channels to create a communication layer between client browser a...
3.8 – Configuration file and others
You can use appcfg.js to configure some parameters for the client. Please check the source code o...
3.8.1 – Start up a server or application automatically after login
To start up a server or application automatically after login, you can set the following paramete...
4. – Server side integration
4.1 – HTTP API
You can use HTTP request to create a server, symlink dynamically if you don't want to write a plu...
4.2 – Plug-in
The gateway is a multi-thread application, so make sure your plug-in is: Thread safe. Spawn a th...
4.2.1 – Start gateway and the plug-in example project in Eclipse
Download the plug-in example:http://remotespark.com/Plugin.zip Extract the zip to your Eclipse wo...
4.2.2 – Handshake plug-in
Handshake plug-in is invoked before establishing a RDP connection. It’s a good place to verify, m...
4.2.3 – Deploy your plug-in
Export the jar file: Right click on the project, "Export", select "Runable JAR file" under Java....
4.3 – Downloading files unprompted
Users can download files through custom apps and programs. This can be archived by using the clip...
Appendices
Appendix A – Integration with symlink use case
Actors: User, User Portal, Spark Gateway Preconditions: User Portal: Have user credentials in pl...
Appendix B – Integration with third party application or HTTP service
Actors: User Portal, Spark Gateway, Third party application or HTTP server Preconditions: User Po...
Appendix C – Integration with plugin use case
Actors: User, User Portal, Spark Gateway Preconditions: User Portal: Have user credentials in pl...
Appendix D – Chromium Embedded Framework (CEF), WebView and Electron
You can use CEF or Electron to make a standalone client, so SparkView client can access local res...