Return
-
Title
Why does the ‘Launch’ button on Safeguard’s Web Interface not initiate the session as expected? -
Description
In 2.11 and above, there is a new "Launch" button on the web interface, however when clicked this errors "Session launched. If your session didn't appear to launch, make sure you have an application registered with your browser to handle the session type." and no session is started.
Note: This ‘Session launched. If your session didn’t appear to launch…..’ message occurs regardless of whether the sessions actually started.
-
Cause
The 'launch' button in the SPP Web UI is designed to generate a custom URI with an "rdp://" URI scheme.Browsers use URI scheme handlers to open applications for URI schemes. An example of one such URI scheme is the "file://" scheme. Entering file:///local_path_to_PDF
The browser will download the specified PDF through the browser because that is the behavior defined through a URI scheme handler.
Similarly, the 'launch' button in the SPP Web UI generates a custom URI containing Session connection information with the URI scheme "rdp://". Currently, Microsoft Windows does not have a built-in URI scheme handler to support rdp:// URI schemes.
One Identity has logged an enhancement request with Microsoft to add support for rdp:// URI schemes. One Identity has made similar requests for other RDP solution providers (RoyalTS & FreeRDP) to support URI schemes in a web browser..
SSH sessions use a ssh:// URI scheme. Later versions of WinSCP do install a handler to support ssh:// schemes. Any SSH session initiated from Safeguard’s web interface will initiate Putty if WinSCP is installed.
A custom handler to launch an application can be configured by changing Microsoft Registry settings. Information on doing this can be found at: -
Resolution
RESOLUTION
One Identity works on and maintains a tool named SCALUS to resolve this issue.SCALUS is an open-source desktop application that allows you to launch SPS sessions from SPP without having to manually launch the session.For more information, The tool is available via GitHub by clicking on this link: SCALUSNote: any issues with this tool should be reported via GitHub here
WORKAROUNDIn addition, One Identity Safeguard users can use the original download button to download the file to start a session. -
Change Request
220245 , 256840