Launching Live Connect Using a Custom URL Scheme

Live Connect can be launched via a custom URL scheme. The URL format is liveconnect://. Along with this URL protocol identifier, you will append a payload, which provides all of the information needed to authenticate and begin a Live Connect session to an endpoint. With Live Connect installed on the client computer, the operating system will know how to interpret this URL and associate it with the Live Connect application.

Prerequisites

Install Live Connect from a licensed VSA. Once installed, Live Connect registers itself with the operating system, allowing it to be launched using the custom URL scheme.

Payload

The payload is a Base64 encoded JSON object that is appended to the custom URL protocol mentioned above. The JSON object has the following structure:

{
   "homePageUrl": "https://my-vsa-host/liveconnect/",
   "payload": {
     "auth": {
       "Token": "98765432"
     },
      "agentId": "123456789012345",
     "navId": "files"
    }
}

Payload Fields

homePageUrl - this points to the root location on your VSA that Live Connect will connect to, once launched. Should match your VSA hostname, along with /liveconnect/
payload - the main payload

auth - An object containing authentication details. Currently, this is just the VSA Bearer Token, which can be acquired using the /auth REST API. Take note that the inner Token ﬁeld is capitalized. If this is omitted, Live Connect will navigate to the login view.
agentId - This is the GUID for the agent that you are planning to connect to. If this is omitted, Live Connect will display the Asset Browser view on launch.
navId - A key that indicates which module within Live Connect you want to immediately navigate to, on a successful launch. If this is omitted, the initial view will be the dashboard (Asset Summary). The currently available module keys are:

assetinfo
chat
commandshell
dashboard
documents
events
ﬁles
logviewer
patchstatus
procedures
processes
registryeditor
remotecontrol
services
software
terminal
ticketing
users

Encoding The URL

After constructing the JSON payload above, you will Base64 Encode the JSON string. See Base64 for more information. Ultimately, you will end up with a URL string like the following:

liveconnect:///eyJKdXN0QW5FeGFtcGxlIjoiQW4gZXhhbXBsZSB1c2VkIGluIHRoZSBLTEMgY3VzdG9tIFVSSSBzY2hlbWUgZG9jcyJ9

Making Use Of The URL

Armed with a valid Live Connect URL, a third-party application can launch Live Connect. For desktop applications, this can be as simple as shelling out to:

Windows - start liveconnect:///...
Mac OSX - open liveconnect:///... For web applications, ﬁnding a fool-proof, cross-browser solution can be tricky. This 3rd-party JavaScript library is recommended: Custom Protocol Detection.

*Note: If you'd like further assistance with getting this setup, you can contact your Account Manager so that we can get you in touch with our Professional Services team. As of 9.5.4, we changed the custom URL schema from kaseyaliveconnect to liveconnect.

Browse this section