Back to top

Knox Remote Support Viewer

Last updated February 2nd, 2024

If device users need additional troubleshooting and support from you, they may request a remote support session. During this session, you can connect directly to their device from your computer and run diagnostics or fix issues remotely.

Access the Knox Remote Support Viewer from the Knox Admin Portal

There are two ways to access the Knox Remote Support Viewer from the Knox Admin Portal:

  • In the navigation menu, click Knox Remote Support.
  • On the Device information screen that shows after you search for a device, click KNOX REMOTE SUPPORT.

Start a remote session with device user permission

Make sure you complete the appropriate steps under Install and enable the Knox Remote Support agent before you follow these steps.

To ask a device user to start a remote support session:

  1. In the Knox Admin Portal navigation menu, click Knox Remote Support.
  2. In the navigation menu, click Devices.
  3. Select the device to provide remote support to.
  4. Click Ask Users to Start.

The device user is then notified that you want to start a remote support session. If they accept, you can control the device with the Viewer in Remote Support.

Automatically start a remote session

Important

This feature only applies to Samsung devices that support the Knox platform.

Make sure you complete the appropriate steps under Install and enable the Knox Remote Support agent before you follow these steps.

To automatically start a remote support session on a device:

  1. In the Knox Admin Portal navigation menu, click Knox Remote Support.
  2. In the navigation menu, click Devices.
  3. Select the device to provide remote support to.
  4. Click Automatically Start.

The remote support session then starts, and you can control the device with the Viewer in Remote Support.

Start a remote session through SMS

You can request a remote session on any device associated with your Knox Suite license, even if it’s not enrolled in an EMM. To do so, you can send an SMS to the device user with instructions on how to start the session.

  1. In the Knox Remote Support navigation menu, click Knox Remote Support.

  2. Click Connect.

    The Connect button on the Knox Remote Support page

  3. Choose a method to send the access code to the device user:

    • Instruct the device user to enter the access code in the agent on the device.

    • Click Send SMS to send an SMS to the device user containing a link to install the Knox Remote Support Agent and an access code they need to enter to start the remote session.

After the device user enters the access code, you can then control the target device using the Knox Remote Support Viewer.

Access the Knox Remote Support Viewer from Knox Manage

Knox Manage supports several ways to start a remote session on a device. You can Automatically start or Ask users to start a remote session, or start a remote session through an access code.

Once you initiate a session on a device, you can access its remote support history and a log of all Knox Remote Support events from the navigation pane.

Automatically start or ask users to start a remote session

If the device is fully managed, or fully managed with a work profile, you can start a remote session without an access code. Make sure you complete the appropriate steps under Install and enable the Knox Remote Support agent before you follow these steps.

  1. On the Knox Manage console, go to the Device menu.

  2. Select a device.

  3. Click Remote Support.

  4. A dialog shows the available run type options depending on the device’s status and manufacturer. Select an option, then click Run. The following behavior occurs based on the option you choose.

    The fully managed dialog options

    Run type Description
    Automatically start This option is only available for Samsung devices that support Knox. After you click Run, the Viewer launches and the remote session starts immediately.
    Ask users to start After you click Run, the Viewer launches and the device user is prompted to accept the connection request. Once they accept, the remote session starts.

Start a remote session through an access code

You can request a remote session on any device in your Knox Manage console, including devices managed by the Android Management API, even if it’s not currently enrolled. The device user either needs to install the Knox Remote Support agent or, if it’s already installed, enter a six-digit access code in the agent.

To start a remote session with an access code:

  1. On the Knox Manage console, go to the Device menu.

  2. Select a device.

  3. Click Remote Support.

  4. In the Knox Remote Support dialog, choose a method to send the access code to the device user:

    • Without entering the device’s mobile number, click Run. If you choose this option, you need to share the access code with the device user directly.

    • Enter the device’s mobile number, then click Send SMS > Run to send an SMS to the device user containing a link to install the Knox Remote Support Agent and the access code they need to enter to start the remote session.

    The SMS dialog options

  5. The Viewer launches and a six-digit access code displays. If you didn’t enter a mobile number in the previous step, instruct the device user to enter the access code in the Knox Remote Support agent on the device.

Control devices with the Knox Remote Support Viewer

To remotely control a device with the Knox Remote Support Viewer:

  1. Instruct the device user to install the latest version of the Knox Remote Support Agent and enter the access code.

  2. Connect to the device. Upon successfully connecting, you can see the connected device’s information and set the transfer quality.

    Tab Description
    Knox Remote Support See a history of device activities for the device that’s currently connected, such as connection times, recordings, screen captures, and file transfer processes.
    Information See detailed device information, such as the device model name, IMEI, serial number, and OS version.
    Settings Set the transfer quality. By default, the transfer quality value is set to Automatic. You can also select 30%, 50%, or 100% for this value. If you select Automatic, dynamically-sized data can be transferred using the Quality of Service (QoS) method according to the network conditions, which improves the network’s data transfer quality. The response time may slow down as the transfer quality improves.
  3. Perform IT service or support activities to the device using this viewer. For more information about the functions of the Knox Remote Support Viewer, see Use the functions of the Knox Remote Support Viewer.

    Note

    By default, there’s a 30-minute time limit for each Knox Remote Support session. You can reset the time limit by clicking the clock icon. Five minutes before you reach the time limit, a pop up opens to ask whether you want to extend the session. If you choose to extend it, your session’s timer is restarted. Otherwise, your session ends after five minutes.

  4. To end the session and cease remote support, instruct the device user to tap Stop on the screen, or click Disconnect in the Knox Remote Support Viewer on your computer.

Use the functions of the Knox Remote Support Viewer

When the Knox Remote Support Viewer successfully connects to the Knox Remote Support Agent, a live view of the device’s screen shows on the Knox Remote Support Viewer.

Note

If the device screen is locked, then the viewer shows the following error message:

The screen is turned off. Press the Power button to start.

In this case, limited functions are supported, those being Record, File browser, Home, and the Power button.

The Knox Remote Support service provides the following functions:

  • Control device buttons
  • Record the device screen
  • Capture the device screen
  • Transfer files

Control device buttons

The Menu, Home, Back, Power, Volume Down / Up and Rotate buttons at the bottom behave like the softkeys and hardkeys on the device. Click the buttons to trigger the associated action on the device. For example, clicking the Back button in the viewer returns the device to the previous screen. If the device screen is locked, you can click the Home button to unlock the screen.

Record the device screen

You can record the device’s screen to find out if errors are occurring on the device. Recorded videos are saved in WEBM format, with a file name that contains an administrator ID, tenant ID, device name, and the date and time of the recording. For example, admin@stage.com_Ara S21 (SM-G991N)_20220523155102.webm.

You can record up to ten minutes of video. Network QoS isn’t available while recording is in progress. If the maximum recording time is exceeded, a notification shows and the recording stops.

To record the device screen:

  1. At the bottom of the screen, click Record.
  2. Click Rec to start recording a video. The recording time shows on the Record card on the left side of the screen, and the user is notified that the screen is being recorded on their device.
  3. Click Pause to pause the recording or click End to finish the recording. If you click Pause the Restart and End controls become available. Click Restart to discard the recording and start over.

Capture the device screen

Click Capture Screen to take a snapshot of the device screen. Captured files are saved in JPG format, with a file name that contains information and identifiers about the admin, tenant, device name, and the date and time of the capture. For example, admin@stage.com_Tomek_Android_1_20220523154804.jpg.

  • When providing remote support from the Knox Admin Portal, the file name includes information about the Samsung Account information.
  • When providing remote support from the Knox Manage console, the file name includes the admin ID and tenant ID.

Note

Knox Remote Support can’t capture the screen of apps that make use of the FLAG_SECURE flag in the Android window manager.

Transfer files

You can transfer files, such as log files, from a device to your computer to check the condition of the device. Files can also be transferred from your file system to the device. Up to 200 MB of files can be transferred at a time. Files transferred to the device are saved to the Downloads directory in its internal storage, and files transferred to your computer are saved according to the web browser’s download manager.

To transfer files from the device to your computer:

  1. In the toolbar of the Knox Remote Support Viewer, click File Browser.
  2. On the device, instruct the device user to accept the request to run the file browser.
  3. Click a file to transfer it immediately. If you want to transfer multiple files at once, click and hold each file to select them for transfer, then click Select.

To transfer files from your computer to the device, drag the files from your desktop or file explorer onto the live view.

To view a log of transferred files for the remote session, in the Transfer File card, click Detail. A list of file names and sizes opens.

Rotate the device screen

To change the orientation of the device’s screen to landscape or portrait mode, click Rotate at the bottom of the screen. The device’s screen won’t rotate if the Home screen or the focused app doesn’t support screen rotation.

Support session history

To view a log of all support sessions, click History in the left navigation pane. A session’s device information is tracked, including the model name, device ID, and phone number.

In the Details column for a session, click View to see detailed session data, like the duration, the version of the device’s OS, and the version of the Knox Remote Support agent installed on the device. You can filter the history by date, or search for a specific session. Click Download History as CSV to save the log data for your query as a spreadsheet file.

You can also adjust the time zone of Knox Remote Support to vary from your computer’s local time zone. To adjust the time zone, click your account name, select Time Zone, then select a region.

See also

Is this page helpful?