URL Schemes provides an easy method to launch preconfigured application and desktop sessions using AccessToGo. AccessToGo connections may be automatically launched by using the URL scheme “ericom”. When the user selects (or clicks) a .rdp or .blaze configuration file that is referenced by the “ericom” URL scheme, AccessToGo will launch the session as configured in the settings file.
NOTE Clicking on a URL link while AccessToGo is already running will just switch to the AccessToGo application. In order to load the configuration defined in the link, AccessToGo must not be running when the URL is launched.
There are three methods to launch an AccessToGo session by using the URL scheme:
1) Using the URL scheme to launch a .rdp or .blaze file using HTTP/HTTPS (supported on iOS and Android).
Examples:
<a href="ericom://http://www.test.com/myconnection.rdp">Connect to RDP Demo from WWW </a>
<a href="ericom://https://www.test.com/myconnection.blaze">Connect to Blaze Demo from WWW </a>
2) Using the URL scheme to launch a .rdp or .blaze file in the Ericom folder of the device (supported on Android only).
Example:
<a href="ericom://myconnection.rdp">Connect to RDP Demo from root folder </a>
3) Using the URL scheme to launch a .rdp or .blaze file from a subfolder on the device (supported on Android only).
Example:
<a href="ericom:///sdcard/myconnection.blaze">Connect to Blaze Demo from subfolder
</a>
Creating .rdp or .blaze files
The best method to create a .rdp or .blaze file for use with AccessToGo is to download the Ericom Blaze client from the Ericom website. Test the connection using the Blaze client, and then perform a Save As operation to save the settings into a configuration file. Refer to the Connection Parameter Definitions table to manually configure any setting in the .rdp or .blaze file.
41 NOTE Saved passwords are not automatically transferred when moving .rdp and .blaze files
from one machine to another.
To pass passwords using the configuration file, the desired password will need to be manually entered into the file using the value “html password” or “x password”. Delete any entry for “Blaze password”.
Add MIME Type to Web Server
In order to use the AccessToGo URL Scheme, a MIME type must be added to a web server hosting the URL links. Here is an example of how to do this in Microsoft IIS 7:
1. Go to the IIS Manager and launch MIME Types:
2. Click Action | Add and enter a new MIME Type:
a. File name extension: .rdp b. MIME type: text/simple
c. Create another one for File name extension: .blaze
42 3. Now use the device where AccessToGo is installed and use a browser to
navigate to the web page with the configured link. Click the link and AccessToGo will automatically launch with the configured parameters:
Configuration File Parameter Definitions
NOTE Some settings (e.g. Printing) are not used by AccessToGo
Parameter Type Default Description
alternate shell s none
Sets the shell used in the Terminal Services session. This can be used to set an alternate shell such as progman.exe or use it to set the application which the user runs on logon to the Terminal Server.
Sample value: c:\temp\test.exe
audiomode i 2 (Blaze) 0, Bring to this computer
43 0 (AccessNow) 1, Leave at remote computer
2, Do not play
auto connect i Not used
autoreconnection enabled i 1 Attempts to reconnect when connection drops
bitmapcachepersistenable i Not used
connect to console i 0 0, connect to a virtual session
1, connect to the console session
desktopheight i 600 height of session desktop in pixels
desktopwidth i 800 width of session desktop in pixels
disable cursor setting i Not used
disable full window drag i 0, Blaze 1, AccessNow
1, disables display of window contents while dragging in session
disable menu animation i 0 1, disables menu animations in session
disable themes i 0 1, disables use of themes in session
disable wallpaper i 0 1, disables display of wallpaper in session
displayconnectionbar i 1 1, displays the connection bar in a full-screen session
domain s Not used
full address s IP address/name of server (and optional port value)
Sample value: 192.168.1.1:3389
keyboardhook i 2
For applying standard Windows key combinations 0, On the local computer
1, On the remote computer 2, In fullscreen mode only
maximizeshell i Not used
password 51 b Not used
port i 3389 Not used
redirectcomports i Not used
redirectdrives i Not used, see "drivestoredirect:s:" instead
redirectprinters i 0 0, don’t redirect
44 1, redirects client printers in session
2, redirect with blaze universal printer driver
redirectsmartcards i 0 1, redirects client smart cards in session (XP/.NET only). Currently in Linux version only.
screen mode id i 2 1, window
2, Full screen
server port i Not used
session bpp i 32 all options are supported: 8,15,16,24,32
shell working directory s Working directory if an alternate shell was specified.
Sample value: c:\temp\
smart sizing i Not used
username s Username to be used for logon
Sample value: administrator
winposstr s Not used
allow font smoothing i 1 1, enabled font smoothing
redirectclipboard i 1 0, disabled
1, enabled
drivestoredirect s Drives to be redirected: Local disks (C:);CD-ROM / DVD Drive (D:)
dirstoredirect s Folders to be redirected: "Desktop", "My Docs", (and "Media" on non-win)
45
use multimon i 0
0, current
1, use multi monitors 2, span multi monitors
#, use monitor #
remoteapplicationmode i 1 Not used
allow desktop composition i 2 Not used
compression i Not used
disable cursor setting i Not used
bitmapcachepersistenable i Not used
redirectposdevices i Not used
authentication level i Not used
negotiate security layer i Not used
gatewayhostname s Not used
gatewayusagemethod i Not used
gatewaycredentialssource i Not used
gatewayprofileusagemethod i Not used
promptcredentialonce i Not used
audiocapturemode i Not used
videoplaybackmode i Not used
use redirection server name i Not used
Ericom Parameters
46
Blaze password s Encrypted password
html password s No encryption
wc password s decrypt using CryptUnprotectData
x password s decrypt using XTEA
use ericom secure gateway i 0 0, disabled
1, enabled
use secure gateway creds I 0
0, disabled 1, enabled
ask secure gateway creds i 0 0, disabled
1, enabled
secure gateway hostname s Ericom Secure Gateway address
Sample value: Test.abc.com
timezone standard name s for Mac and Linux
timezone daylight name s for Mac and Linux
addins to use s list of add-in component names to be used
ui language s Not Used
Launching Applications using AccessToGo URL Scheme
When using the URL Scheme to launch just an application from a Terminal
Server/Remote Desktop Server, add the desired application(s) to the RemoteApp Program list.
The following image shows how to add MSPaint to the allowed application list:
47 In the .rdp or .blaze file, verify that the following parameters are configured:
remoteapplicationmode:i:1
alternate shell:s:mspaint
(optional) shell working directory:s:
Passing Encrypted Passwords using XTEA
Refer to the Blaze manual on using encrypted passwords.
48