One Identity Safeguard for Privileged Sessions 7.4 - Administration Guide

Prerequisites

• SPS version 6.11 or later.

• Windows Server 2016 or later.

• An RDP client.

To configure RemoteApp Launcher-specific settings on the SPS side

1. In SPS, configure a credential store plugin with the get_remote_app_credentials method implemented. This is required for negotiating application credentials with SPS.

   Ensure that you specify the asset parameter. If your SPS is linked to SPP, you must also specify the connection name parameter.

   Example: do_get_remote_app_credentials configuration

   def do_get_remote_app_credentials(self):
       try:
           credential = self._get_credential_for_asset("password", self.remote_app_asset, self.remote_app_account)
           return {"passwords": [credential]}
       except SafeguardException as exc:
           self.logger.error("Error checking out %s for %s@%s: '%s'", "password", self.remote_app_account, self.remote_app_asset, exc)
           return None

   For more information on how to configure a custom credential store plugin, see .

2. Optionally, to enable automatic password handling by the RemoteApp Launcher, configure a custom AA plugin.

   By specifying the asset and account name parameters in an AA plugin, the RemoteApp Launcher will not prompt the user for these credentials and will start the configured application without the user having to know any credentials.

   For more information on how to configure a custom AA plugin, see .

3. Configure RemoteApps in SPS.

   For more information, see Configuring RemoteApps.

4. Configure an RDP connection that uses RemoteApps in RDP Control > Connections and select the created RemoteApps channel policy as the Channel policy of the connection.

To configure RemoteApp Launcher-specific settings on the Windows side

1. Download the RemoteApp Launcher.

2. Install Remote Desktop Services (RDS).

3. Create a RemoteApp program and make the following settings:

   • For the RemoteApp program location, enter the path to your RemoteApp Launcher, for example, C:\Program Files\OneIdentity\RemoteApp Launcher\OI-SG-RemoteApp-Launcher.exe.

   • Specify to always use command-line parameters as shown in the example below: 

     "C:\Program Files\DBeaver\dbeaver.exe" --args "-con user={username}|password={password}|host=localhost|driver=PostgreSQL|database={asset}|name=work|connect=true" --enable-debug

     Table 10: List of parameters

     Parameter	Required?	Description
     help	No	Create the help message.
     cmd	Yes	Specifies the application to launch. Either the path to an executable or command alias.
     args	Yes	Specifies the CLI args to pass to <cmd>. It must contain the {username}, {password} and {asset} template options, which will be expanded with the corresponding information.
     use-path	No	Specifies whether to look up the cmd argument in the $PATH variable. The default setting is false. When this flag is set to false, you need to specify the full path to the executable.
     enable-debug	No	Specifies whether to write debug logs. The default setting is false. The logs are available in the C:\Users\<username>\AppData\Roaming\OneIdentity\OI-SG-RemoteApp-Launcher folder. The logs are rotated daily and the file name format is oi_sg_rci_<yyyymmdd>.

     The process and the arguments template is defined by the --cmd and --args command line arguments. In the arguments template, the RemoteApp Launcher replaces the {username} {password} and {asset} with data read from the dynamic virtual channel.

     Example: RemoteApp Launcher configuration to start the DBeaver application

     C:> C:\Program Files\OneIdentity\RemoteApp Launcher\OI-SG-RemoteApp-Launcher.exe --cmd "C:\Program Files\DBeaver\dbeaver.exe" --args "-con user={username}|password={password}|host=localhost|driver=PostgreSQL|database={asset}|name=work|connect=true" --enable-debug

4. Disable the Use advanced RemoteFX graphics for RemoteApp group policy on the RDP server.

   The policy is available at Computer Configuration > Policies > Administrative Templates > Windows Components > Remote Desktop Services > Remote Desktop Session Host > Remote Session Environment > Use advanced RemoteFX graphics for RemoteApp.

   You must have the Remote Desktop (RD) Licensing role installed.