How to install wnSSOClient

How to install wnSSOClient

Problem:  Installation of the wnSSOClient for single sign-on (SSO) for RDS apps or for Live Edit integration.



Cause:  To perform the SSO on the RDS server or Live Edit feature, we require an agent be present on the RDS server.  You'll also need to edit allowHosts file on Unified Workspace servers so agent on RDS servers is allowed to get instructions from Unified Workspace server.  For full features of wnSSOClient agent, please check documentation.



Prerequisite(s):
  • Remote Desktop Services for Windows 2008/2012
  • Unified Workspace 6.3.0.232 or above


Solution(s):  The agent needs to be placed on RDS server and the allowhosts file needs to be modified. 

wnSSOClient installation Windows 2008/2012:
  1. Browse to \stoneware\agents\ClientSideSSOForWindows on Unified Workspace server
  2. Copy ClientSideSSOForWindows.zip to RDS server
  3. Create a new directory C:\util\wnssoclient
  4. Extract files from zip into C:\util\wnssoclient directory
    (end result should be 2 files, wnSSOClient6.exe and swSSOLibrary.dll,  in wnssoclient folder)
  5. Repeat steps for any additional RDS servers


Allow wnSSOClient to run remotely Windows 2008:
  1. Go to RemoteApp Manager under Administrative Tools
  2. Add wnSSOClient6.exe to the allowed list of programs to run (must browse to find)
  3. Go to properties and allow to run with any command-line arguments (accept security warning)
  4. Repeat steps for additional RDS servers


Allow wnSSOClient to run remotely Windows 2012:
  • Go to Server Manager
  • Select Remote Desktop Services from left pane
  • Select the Session Collection
  • Select the "Publish RemoteApp programs to this collection" or select "Publish RemoteApp programs" from the TASKS dropdown menu
  • Go through wizard and browse and add wnSSOClient6.exe
  • Go to parameters and make sure to allow any command-line arguments
  • Repeats steps for additional RDS servers



Edit allowHosts file
  1. Go to Unified Workspace server
  2. Go to \stoneware\config directory
  3. Open the allowHosts file with Notepad 
  4. Add a new entry at bottom (make sure there is no # sign in front of entry)
  5. Enter IP of RDS server
  6. Enter DNS of RDS server (on a separate line)
  7. Repeat for any additional RDS servers
  8. Save file 
  9. Verify it does not have .sample file extension - (if it does, simply remove file extension)
  10. Copy allowHosts file to all other Unified Workspace servers


Reference(s):
wnSSOclient deployment documentation