Chat now with support
Chat mit Support

Safeguard Remote Access Hosted - Administration Guide

Introduction Prerequisites Limitations Getting started Administrator-side use cases User-side use cases Appendix Glossary

Connecting to the target server

To connect to the target server

  1. Navigate to the Connections tab.

  2. Use the Search for connections field to search for a connection. Alternatively, use the Protocol and Group fields to narrow down your search options.

  3. Select the connection you want to use and click Connect.

    Figure 30: Connecting to the target server

    NOTE: Different users may see different sets of available connections. The availability of the listed connections depends on the Azure Active Directory (AAD) group membership of the user.

  4. When the connection is established to the target server, a new window will open in your browser.

Session window

Once the connection to the target server has been established, your session window will open. In the browser header of Chrome, the user name, server name and domain name for that specific session will be visible.

A pop-up window may prompt you to provide your server-side credentials.

On the left hand side of the session window, you will see a minimized control panel with a :

Click once to display the icons-only view of the control panel, and click twice to display the full view.

  • (Minimize control panel)

    Open up or minimize the control panel on the left side.

  • (Copy to clipboard)

  • (Paste)

  • (Enter fullscreen mode)

    To exit the fullscreen mode, press Esc.

  • (End session)

    To disconnect from the target server, click . Alternatively, clicking (One Identity Safeguard Remote Access) in the upper left corner will also disconnect the session.

    NOTE: Disconnecting from the session does not automatically take you back to the Connections page.

Copy-pasting text in an active remote session

When it comes to copy-pasting text with keyboard shortcuts, difficulties may arise from differences between possible shortcuts on the given computer.

Possible keyword shortcuts for copy-pasting:

Windows Linux Apple

Ctrl+C

Ctrl+C

Ctrl+Shift+C

Ctrl+V

Ctrl+V

Ctrl+Shift+V

Ctrl+Shift+C

Ctrl+Shift+C

 

Ctrl+Shift+V

Ctrl+Shift+V

 

NOTE: For Apple users, copy-pasting text in an active remote session with Cmd+C and Cmd+V keyboard shortcuts does not work.

NOTE: The copy-paste functionality works only for text. The length of the copied text is limited to 10000 characters.

Use the copy-paste functionality of the control panel to copy-paste text to/from an active remote session.

To copy-paste text in an active remote session

  1. Click to display the control panel.

  2. Select the text you want to copy, and click (Copy to clipboard).

  3. Insert the copied text into the browser of the remote server.

  4. Click (Paste).

Figure 31: Using Copy to clipboard

Managing sessions on touch devices

One Identity Safeguard Remote Access (SRA) supports the management of remote sessions in most mobile browsers via touch devices, for example iPad or iPhone. Users can configure connections and open new session windows by touch or by using a stylus.

For the mobile version, the page login works without using any special URI.

NOTE: On the first visit to the webpage as a SRA Administrator, if the URL does not directly lead to a session window, you will be redirected to the SRA Settings page.

To open a new sessions window, select a connection card and touch Connect. On the session tab, the screen is automatically fitted to the window size.

The resolution of the stream can be selected in User Preferences. The default resolution is 1024*768.

The control panel of the session window is similar to the desktop version with two notable differences:

  • There is a keyboard icon (), which can be used to display the built-in on-screen keyboard. If you want to enter information in the target device's input field, you must engage the keyboard manually.

  • The Enter fullscreen mode () functionality of the control panel cannot be applied to the session window, if the session was opened on a touch device.

The use of filters on smaller screens is highly recommended, because finding the targeted connection card may take extensive scrolling.

NOTE: Touch device support was only tested using the Safari browser on iPad and iPhone.

Next generation SSH client

One Identity Safeguard Remote Access (SRA) comes with two SSH client configurations to choose from - default and next generation. The next generation SSH client was developed with a set of functionalities in mind to improve user experience. These improvements entail the following:

  • Adaptive GUI applications, for example, Midnight Commander - a visual file manager -, which adapts the font size, theme, and resolution of the SSH client automatically, providing a seamless visual experience between applications.

  • Native clipboard support for copy-paste operations.

  • Adaptive resolution. When resizing the terminal window, the displayed event information follows suit.

  • Screen-reader support for people with visual impairment to help access information on computer screens.

  • Web links highlighting.

To enable this functionality, go to Safeguard Remote Access Settings > Features > Next generation SSH client.

CAUTION: The next generation SSH client is a technology preview which means, that you can test its current functionalities, note however, that it is under development and may not function properly.

Once the connection to the target server has been established, your session window will open. A pop-up window may prompt you to provide your server-side credentials.

In the header of the session window, you will see a control panel with the following icon:

  • (Enter fullscreen mode)

    To exit the fullscreen mode, press Esc.

To end a session, you have a number of options to choose from, for example, you can close the session window itself, use Ctrl + D, or type exit into the terminal.

NOTE: Disconnecting from the session does not automatically take you back to the Connections page.

Figure 32: Session view with the next generation SSH client

You can customize the appearance of your session window by clicking and setting your Preferences.

Figure 33: Configuring your display preferences

You can choose from various pre-set themes for your application, set the color scheme for your terminal, and change the font to a size that is more preferable to you. Your settings will be visible in the preview window dynamically. All of your preferences will be saved and applied after you click Save changes.

NOTE: The next generation SSH client is supported only for the desktop version.

Transferring files in active remote sessions

Downloading files in an active remote session

To download files in an active remote session, complete the following steps:

  1. Navigate to the SRA Connections page and find the connection tile you want to work with.

  2. In the top-right corner of the session window, select Files from the menu bar.

    Above the file tree, there is a folder path for easy navigation. By default, you are directed to your Home folder.

  3. In the file tree, navigate to the file(s) you want to download. You can download your file(s) in the following two ways:

    • Click on the file(s). With this, the files are added to a download queue and start downloading immediately.

    • Hover over the file and mark the checkbox next to the file when it becomes visible. Do this for each file you want to download and click Download selected.

    Figure 34: Connections > name-of-the-server > Files — Downloading files from a remote client

    Selected files are added to a queue and are downloaded in the order of selection.

    NOTE: If you want to download multiple files which are located in different folders, select and add the files to the download queue before moving to another folder. Otherwise, the files that you have previously selected, will not be downloaded.

    If you do not have permission to view a folder, a Permission denied for selected folder message will notify you of that.

  4. (Optional) If you want your files to download in the background while you keep working, check Start file transfers in the background above the file tree.

  5. Check the downloaded files in your target folder.

To stop a file from being downloaded, select one of the following two ways:

  • Open the Downloads queue to select the file you do not want to download, and click X.

  • If you are using Google Chrome as a browser (recommended), navigate to the downloaded files lane at the bottom of the page to select the file you do not want to download, and click Cancel. You can also Pause and Resume downloads. This feature is applicable only to Google Chrome.

Uploading files in an active remote session

To upload files in an active remote session, complete the following steps:

  1. Navigate to the SRA Connections page and find the connection tile you want to work with.

  2. In the top-right corner of the session window, select Files from the menu bar.

    Above the file tree, there is a folder path for easy navigation. By default, you are directed to your Home folder.

  3. Upload your file(s) by selecting one of the following two ways:

    • Click Upload here and find the file(s) on your computer that you want to upload.

    • Drag & Drop files from your computer to upload them.

    The number of files being uploaded is visible in the Uploads(X) counter. If a version of the file already exists on the remote client, you can decide whether you want to override the file, or change the file name to keep the previous file version as well. The folder you have uploaded your file into is refreshed automatically.

  4. (Optional) Check Start file transfers in the background, to have it run in the background.

  5. (Optional) Click Uploads to check the progress of the upload.

  6. Check the uploaded files in your target folder.

You can upload and download files in an active remote session simultaneously. All downloads and uploads can be managed individually within the queue. The Downloads | Uploads buttons disappear if all files have been processed.

NOTE: During file transfer, the All files are processed status can refer to the following scenarios:

  • The file is uploaded | downloaded.

  • The user started the file transfer, but the server declined the request and the file was deleted from the file transfer queue.

  • The user started the file transfer, but decided to cancel it before the upload | download is completed.

NOTE: There is no copy-paste operation support for touch devices.

SRA uses the JEDEC standard for file size calculation, where a kilobyte is considered as 1024 bytes, instead of 1000 bytes. This could lead to scenarios where you can observe differences between the file sizes of the transferred files, for example, the file size might be 13.34 MB during download and 14 MB after download.

Verwandte Dokumente

The document was helpful.

Bewertung auswählen

I easily found the information I needed.

Bewertung auswählen