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):

    Can't find the KB

    Unable to find the KB to address your issue ?  

      • Recent Articles

      • Change Reset Password Button Text

        Change the text of the "Reset Password" button on the UW Login Page How to change the text of the Reset Password button on the Login Page. Login to webNetwork and open webAdmin on your Relay Central Server Expand Customization Center Expand Tenants ...

      • Remove Reset Password Button From Login Page

        Remove the Reset Password Button from the Login Page How to remove the Reset Password button from the Unified Workspace login page. Login to webNetwork and open webAdmin on your Relay Central Server Expand Customization Center Expand Tenants Expand ...

      • Lenovo Unified Workspace End-of-Life Questions and Answers

        As of January 31st 2024, Lenovo Unified Workspace (formerly Stoneware WebNetwork) is no longer supported. This means that we no longer provide licenses, downloads, updates, patches, or technical assistance for this product. If you have any questions ...

      • How do I determine my Unified Workspace license expiration date?

        The best method for determining the licensing information including the expiration date of your Unified Workspace license: Login to your 8090 management console on each server This may take remoting into each LUW server and relay, opening a browser, ...

      • Lenovo Unified Workspace 7.0.2.13 Released

        Highlights of Unified Workspace 7.0.2.13 Before you install: Please view the installation notes here. 7.0.2.13 requires a 7.0 license file. Below is a list of enhancements and fixes released in Unified Workspace 7.0.2.13 Fixed external storage ...

      • Related Articles

      • Install wnSSOClient on Windows Server 2003/2008/2012

        How do I install the wnssoclient on windows server 2003, 2008/2012? For windows 2003: Copy the wnssoclient.exe and swssolibrary.dll files the c:\windows\system32\ directory on the windows 2003 terminal server. On the stoneware relay: Edit the ...

      • wnSSOClient.exe can not be started.

        The customer is getting an error that the system cannot find the file specified, wnSSOClient cannot be started error launching TS application. Full error: The system cannot find the file specified. This initial program cannot be started: ...

      • How to setup CIFS/webDav drive using wnSSOclient

        Problem:  You are using an RDS application or Live Edit feature and would like to map a Unified Workspace file node for that session.  Use cases could be that you want a cloud storage provider, like Google Drive, mapped to a drive letter so you can ...

      • InvalidOperationException with wnSSOClient

        The customer sees an error when wnssoclient launches. An unexpected error occurred System.InvalidOperationException : Client found response content type of 'text/html;charset=ISO-8859-1", but expected 'text/xml' Problem accessing ...

      • Launching multiple applications using wnSSOclient

        A user launches a MS Word RDP webApp that uses the wnSSOclient and then closes that terminal server window incorrectly.  The user then launches a MS Excel RDP webApp which also uses wnSSOclient, the previous winword session comes back up. Customer ...