Add MPS UI Toolkit Controls to a WebUI

The UI Toolkit allows developers to add manageability features to a console with prebuilt React components. The code snippets simplify the task of adding complex manageability UI controls, such as the Keyboard, Video, Mouse (KVM). A sample web application, based on React.js, is provided for test and development.

The tutorial outlines how to add various controls to the sample React web application provided. Developers can use the sample code below as a springboard for developing their own consoles.

What You'll Need

Hardware

Configure a network that includes:

• A development system running Windows® 10 or Ubuntu* 18.04 or newer
• At least one Intel vPro® Platform to manage

Software

• MPS, the Management Presence Server
• RPS, the Remote Provisioning Server
• Intel® vPro device, configured and connected to MPS

Note

For instructions to setup the MPS and RPS servers to connect a managed device, see the Get Started Guide

• The development system requires the following software:
  • git
  • Visual Studio Code or any other IDE
  • Node.js

What You'll Do

Follow the steps in these sections sequentially:

• Create a new React app
• Add UI controls to the React app

Figure 1: UI toolkit

Create a New React App

The React app can be created in any preferred development directory. The MPS can continue to run while creating and running the app.

1. In a Terminal or Command Prompt, go to your preferred development directory.

2. Run the following commands to create sample React app named my-app.

   npx create-react-app my-app
   

3. Change to the my-app directory:

   cd my-app
   

Add UI Toolkit

1. Run the following command to add the UI Toolkit and install the required dependencies:

   npm install @open-amt-cloud-toolkit/ui-toolkit-react@3.0.2
   

2. Run the following commands to start the web UI locally:

   npm start
   

   By default, React apps run on port 3000. If port 3000 is already used by the MPS server or any other application, you'll be prompted to use another port. If this happens, enter 'Y'.

   Success

   

   Figure 2: React reports successful deployment

   Note - Using Chromium Browser and Refreshing

   By default, React launches in your machine's default browser. However for best experience, navigate to the page using a Chromium based web browser. When you make changes, you do not need to stop the application and restart. It will update and refresh automatically as you make code changes.

Add a Sample Control

The following sections outline how to add controls. Refresh the web browser after adding a control if it does not update automatically after a few seconds.

Add Keyboard, Video, Mouse (KVM) Redirection

The code snippet below adds KVM control to the React application.

1. Open ./my-app/src/App.js in a text editor or IDE of choice, such as Visual Studio Code or Notepad.

2. Delete the existing code and replace it with the code snippet below.

3. Change the following values:

   Field	Value
   deviceId	Replace the example deviceId value with the GUID of the Intel® AMT device. See How to Find GUIDs in Intel® AMT.
   mpsServer	Replace the localhost with the IP Address or FQDN of your MPS Server. When using Kong, /mps/ws/relay must be appended to the IP or FQDN.
   authToken	Provide valid JWT. Redirection requires a redirection-specific authentication token. See the /authorize/redirection/{guid} GET API in the Auth section. For a general example on how to make an API call and how to get a auth token from /authorize to pass to /authorize/redirection/{guid}, see Generating a JWT by using an Authorize API call.

   import React from "react";
   import "./App.css";
   import { KVM } from "@open-amt-cloud-toolkit/ui-toolkit-react/reactjs/src/kvm.bundle";
   
   function App() {
       return (
           <div className="App">
               <KVM deviceId="038d0240-045c-05f4-7706-980700080009" //Replace with AMT Device GUID
               mpsServer="https://localhost/mps/ws/relay" //Replace 'localhost' with MPS Server IP Address or FQDN
               mouseDebounceTime="200"
               authToken="" // Replace with a valid JWT token from 'Authorize Redirection' GET API Method
               canvasHeight="100%"
               canvasWidth="100%"></KVM>
           </div>
       );
   }
   
   export default App;
   

4. Save and close the file.

5. If the React app hasn't updated automatically, refresh the page.

   You are now able to remotely control your Intel® AMT device using Keyboard, Video, Mouse control.

   Success

   

   Figure 3: Successful KVM Connection

You will see the errors in the following scenarios:

• If your browser is IE/Edge, there might be compatibility issues.
• Compilation errors if the ui-toolkit was not downloaded and installed to your react app.
• MPS/RPS server not running, appropriate controls will fail to work.
• MPS server running and device not connected.

• Incorrect or invalid JWT for authToken, see instructions on Generating a JWT by using an Authorize API call.

  Example authToken Format from API Call

  {
      "token":"eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiI5RW1SSlRiSWlJYjRiSWVTc21nY1dJanJSNkh5RVRxYyIsImV4cCI6MTYyMDE2OTg2NH0.GUib9sq0RWRLqJ7JpNNlj2AluuROLICCfdZaQzyWy90"
  }
  

Next Steps

Try Other Controls

Try out other React controls such as Serial Over LAN.

Customize and Create Bundles

Try out creating and customizing React bundles for things such as Serial Over LAN or KVM here.

License Note

If you are distributing the FortAwesome Icons, please provide attribution to the source per the CC-by 4.0 license obligations.