Blogging about Royal TS/X, Royal Server and Royal Passwords

Use a PowerShell Logon Script to Pre-Configure Royal TS Settings

Recently we got an interesting support request where a customer wanted to prepare the application settings, which are usually available in the Royal TS UI through View -> Options,  using a logon script in PowerShell.

I thought it would be a good idea to share this in a blog post because there are one or two caveats to watch out for but first, here’s the script:

# import the powershell module to get access to the cmd lets
Import-Module "C:\Program Files (x86)\code4ward.net\Royal TS V4\RoyalDocument.PowerShell.dll" -Force

# create a store
$store = New-RoyalStore -UserName $Env:USERNAME

# path to the app document
$appDocPath = "$Env:APPDATA\code4ward\code4ward.RoyalTS.UserPreferences.config"

# open the app document
$appDoc = Open-RoyalDocument -Store $store -FileName $appDocPath

# set all the options
$store.Options.DontShowDocumentModifiedNotification = $true
$store.Options.DontShowMaintenanceExtensionNotification = $true
$store.Options.DontShowRestoreConnectionsDialog = $true
$store.Options.DoNotCreateDashboardOnStartup = $true
$store.Options.DoNotShowGettingStartedPageOnStartup = $true
$store.Options.SuperStartPageBehavior = 0
$store.Options.AutoStartDocumentMode = 3

# here we need an array of strings with the full path to all the docs we want to open automatically
$store.Options.AutoStartDocumentList = @( "FullDocumentPath1", "FullDocumentPath2" )

# this saves the document as "*.rtsz"
Out-RoyalDocument -Document $appDoc -FileName $appDocPath
Close-RoyalDocument -Document $appDoc

# now we need to delete the old .config file and rename the .rtsz file
Remove-Item -Path $appDocPath
Rename-Item -Path "$appDocPath.rtsz" -NewName $appDocPath

Now to the two caveats:

  1. The property AutoStartDocumentList must be set using a string array – even if you only set one path.
  2. When you invoke the Out-RoyalDocument cmdlet, the file will be “*.rtsz” but the extension for this particular file must be “*.config”. That’s why we have the last two lines of code (Remove-Item and Rename-Item) in the script.


Royal TSX and macOS 10.14 Developer Preview

Update 4 (2018-07-23):
The first public beta of Royal TSX 4.0 which will offer full Mojave compatibility (including dark mode) is now available. Please give it a try and let us know if you encounter any issues! Thx!

Update 3 (2018-07-16):
A new Royal TSX beta update (V3.3.1.2) is out now which attempts to resolve the scrolling issue. If you give the beta a try and still encounter the issue, please let us know! Thx!

Update 2 (2018-06-20):
Unfortunately, DP2 doesn’t fix the crash when scrolling the navigation panel. We’re still investigating what’s causing this. Unfortunately, Apple hasn’t responded to our bug report yet.

Update 1 (2018-06-15):
The first Royal TSX beta update (V3.3.1.1) is now out which somewhat improves compatibility with macOS 10.14 DP1. Specifically, a bug has been resolved that caused the application to crash when closing Remote Desktop connections. Please note that the problem that causes the app to hang when scrolling the navigation panel is still unresolved.

 

Hello early adopters,

now that the first developer preview of macOS 10.14 Mojave has been released, we wanted to give you a quick update on Royal TSX’ compatibility with the new OS.

Like with every beta OS, we want to remind you that we do NOT generally support beta/developer preview releases and we do NOT recommend to install OS betas if your daily workflow depends on Royal TSX. However, it’s obviously in our own interest that our products are compatible as soon as possible. For more information please see this KB article.

In the case of 10.14 DP1 we unfortunately have to report that Royal TSX is NOT compatible at the moment. Royal TSX randomly hangs/freezes when scrolling the navigation panel (sidebar) as well as other list views. While we’d love to fix whatever is causing this, we haven’t been able to track down the source of the problem yet.

We filed bug reports with Apple and hope that whatever is causing the hangs gets fixed in one of the next developer preview releases of macOS Mojave. If you would like to help us get this resolved, please also file bug reports with Apple. The more reports/dupes they get the more likely it is that the issue gets resolved.

Thx for your understanding,
The Royal Applications Team



Microsoft’s March 13, 2018 updates and Royal TSX

Update March 14, 2018:
A new version of the FreeRDP plugin (V3.3.6) that fixes the issue is now available. You can install the update as usual via “Royal TSX – Check for Updates…”.

 

On March 13, 2018 Microsoft released updates for several Windows versions that include a fix for a security vulnerability in the Credential Security Support Provider protocol (CredSSP, also known as Network Level Authentication or NLA).
You can learn more about the vulnerability and associated patch here.

The respective updates that include this fix are…

Unfortunately, the security update breaks compatibility with 3rd party Remote Desktop clients which use the open source library, FreeRDP. We’re already in touch with the FreeRDP developers and hope to have a fix available soon.
You can follow the developments on the FreeRDP project’s Github page.

In our testing, affected Windows operating systems include Windows 10, Windows Server 2016, Windows 8.1, Windows Server 2012 R2, Windows 7 SP1 and Windows Server 2008 R2.

Workarounds

Until a proper fix is available for FreeRDP, here are some workarounds to keep you connected to your remote systems:

  1. Use Microsoft Remote Desktop
    Microsoft’s own Mac RDP client doesn’t seem to be affected by the problem, so it’s probably your best bet until an update for Royal TSX is available. You can get it on the Mac App Store.
  2. Uninstall the Windows update
    Uninstalling the Windows update (or putting it into the “Absent” state) that contains the security patch will allow you to access the system using Royal TSX again.
  3. Disable NLA
    By disabling the requirement for NLA on the server side and forcing Royal TSX to connect with TLS encryption instead you can also work around the problem.
    Here’s how to:

    1. Connect to the remote host using Microsoft Remote Desktop
    2. Run “SystemPropertiesRemote.exe” (or manually open “System Properties – Remote”)
    3. Disable “Allow connections only from computers running Remote Desktop with Network Level Authentication (recommended)”
    4. In Royal TSX open the properties of your RDP connection and switch to the “Advanced – Authentication” section
    5. Disable “Network Level Authentication (NLA)”
    6. Enable “TLS Encryption”

We’re really sorry for any inconvenience caused by this and will update this article as soon as new information becomes available.



Royal TS 4.2 Release

Today we’re glad to announce that another feature packed release of Royal TS (for Windows) is available! Version 4.2 contains lots of cool new features, various improvements across the board, many bugfixes and even a new object type that’ll help you stay organized.

So lets dive right into what’s new:

To-DoSupport for To-Do items

Since we’re already making your life easier by providing you with the tools to manage all your remote connections, we thought it would only be logical to also help you manage your day to day tasks. So starting with this release, you’ll be able to create To-Do items right in Royal TS, add a title and description for them and when the time has come, mark them as completed.

4-2-Release-01

Double-click a To-Do item to edit the description:

4-2-Release-02

File Transfer ConnectionsFile Transfer Connections

File Transfer connections also received several noteworthy updates in this release. Here are some of the highlights:

  • In SFTP connections you can now edit the permissions of files and folders:

4-2-Release-03

4-2-Release-04

  • Live Edit automatically uploads files when the file is changed locally (double-click a remote file to start editing it).
  • We’ve added support for viewing and changing permissions (right-click and select “Permissions”).
  • It’s now possible to select a different credential when running into authentication errors while connecting to a server.

Other improvements

Other notable new features and improvements include:

  • Restricted Admin mode for RDP connections:

4-2-Release-05

  • Import of mRemoteNG 1.75 documents is now supported (without passwords).
  • We added support for Date and Time replacement tokens in Key Sequence Tasks and Command Tasks.
  • Support for bookmarks in notes.
  • Extension to the “Connect with Options” menu to override a secure gateway or directly connect without a gateway.
  • Ability to specify a template using the command line.
  • Terminal (Rebex based) and File Transfer supports now Elliptic Curve Cryptography (Ed25519, NSTP, Brainpool and Curve25519)
  • PuTTY version 0.70 with support for ChaCha20 cipher.
  • A basic download manager for the Chrome browser plugin.

Of course, this is just a quick peek at some of the highlights in this release. More detailed information and the full changeset (including bugfixes) is available in the release notes.

Also, check out the updated System Requirements page. Royal TS V4.2 and later now requires .NET Framework 4.7.



Royal TSX 3.2 Release

Today we’re glad to announce that another feature packed release of Royal TSX (for macOS) is available now! Version 3.2 contains lots of cool new features, various improvements across the board, many bugfixes and even a new object type that’ll help you stay organized.

So lets dive right into what’s new:

To-DoSupport for To-Do items

Since we’re already making your life easier by providing you with the tools to manage all your remote connections, we thought it would only be logical to also help you manage your day to day tasks. So starting with this release, you’ll be able to create To-Do items right in Royal TSX, add a title and description for them and when the time has come, mark them as completed.

To-Do items

Full Screen improvementsFull Screen improvements

We’ve long supported taking Royal TSX full screen, but full screen mode for individual connections has always been an RDP-only feature. Not anymore! With this release we’re allowing all connection types to be configured to launch straight into full screen mode. To configure a connection to launch in full screen mode, open the “Window Mode” properties of the connection and select “Open connection in – Full Screen”. If you’re a multi-screen user, you can of course also select the display you want to use for the full screen connection.

We’ve also added the much requested setting to remove the tab bar in external windows. You can find this under “Preferences – User Interface – Connection Tabs – Show Tab Bar in External Windows”.

Full Screen improvements

Copy to Clipboard improvements

Copy to Clipboard improvements

The “Copy to Clipboard” menu is a useful tool when automatic logon is not supported on a certain device or you need to copy some data, like a username to another application. In this release we’ve extended the “Copy to Clipboard” menu to allow peeking at the underlying values without having to copy them to the clipboard. To activate this mode, simply hold down the ⌥ (option/alt) key while the menu is open. This is especially useful if you’re using custom properties to store things like credit card information. Websites often don’t allow directly pasting the expiration date into a field so just peeking at the credit card’s data in Royal TSX instead of having to copy it to the clipboard, pasting it in some temporary area then filling it in on the website is a lot easier.

In this release we also added two new toolbar buttons for your convenience: “Copy Username” and “Copy Password”. Those two obviously come in handy if you need to copy login data between applications often.

Copy to Clipboard peeking

File Transfer ConnectionsFile Transfer Connections

File Transfer connections also received several noteworthy updates in this release. Here are some of the highlights:

  • Drag & drop is now supported between the two built-in browser panes as well as to and from Finder.
  • Live Edit automatically uploads files when the file is changed locally (double-click a remote file to start editing it).
  • We’ve added support for viewing and changing permissions (Option-click and select “Get Info…”).
  • It’s now possible to select a different credential when running into authentication errors while connecting to a server.

File Transfer Permissions

Other improvements

Other notable new features and improvements include:

  • Pressing ⌘+Return in the Ad Hoc Computer Name field will now establish an ad hoc connection using the last used protocol.
  • You can now create copies of objects with drag & drop (hold ⌥ option/alt while dragging).
  • We’ve added a keyboard shortcut for the “Documents” toolbar item (⇧⌘D) and also made sure that the search field is automatically selected when the menu is opened.
  • Import of mRemoteNG 1.75 documents is now supported (without passwords).
  • We re-enabled logging to Console.app (Sierra broke this, but the 10.12.4 update brought it back to live).
  • We added support for Date and Time replacement tokens in Key Sequence Tasks and Command Tasks.
  • You can now configure the browser extension authentication timeout.
  • We’ve finally added support for remapping modifier keys in Remote Desktop (RDP) connections. This has been requested time and again and is especially useful if you’re using a non-Apple keyboard.
  • A lot of work went into improving the stability of the RDP clipboard redirection feature. This should be rock solid now.
  • Secure Gateways can now be assigned to web connections. Note that this won’t work in 100% of cases. For instance if a website includes absolute or external links we won’t be able to tunnel them through the gateway. However, in most cases this should be sufficient.

 

Of course, this is just a quick peek at some of the highlights in this release. More detailed information and the full changeset (including bugfixes) is available in the release notes when updating the application and plugins.

For any feedback about Royal TSX 3.2 or our other releases, please don’t hesitate to contact us through our support portal.