Management Presence Server

Disclaimer: Production viable releases are tagged and listed under 'Releases'. All other check-ins should be considered 'in-development' and should not be used in production

The Management Presence Server (MPS) enables remote edge management of Intel vPro® Platforms featuring Intel® AMT. MPS uses an Intel vPro® feature, Client Initiated Remote Access (CIRA), to maintain a persistent connection with managed devices. As a cloud-agnostic microservice, MPS provides out-of-band manageability features, such as power control or keyboard, video, and mouse (KVM) control.

For detailed documentation about Getting Started or other features of the Device Management Toolkit, see the docs.

Prerequisites

To succesfully deploy MPS, the following software must be installed on your development system:

Deploy the Management Presence Server (MPS) Microservice

To deploy the MPS on a local development system:

Clone the repo and switch to the mps directory.

git clone https://github.com/device-management-toolkit/mps.git && cd mps

Open the .mpsrc file to edit.
Update the following 4 fields. Save and keep track of the values you choose.

| Field Name | Required | Usage | | ------------------ | ---------------------------------- | -------------------------------------------------------- | | common_name | Development IP Address | MPS Server IP Address for Device Connection and API Use | | web_admin_user | Username of your choice | For logging into the Sample Web UI | | web_admin_password | Strong password of your choice | For logging into the Sample Web UI | | jwt_secret | A strong secret of your choice | Used when generating a JSON Web Token for authentication |
This password must meet standard, strong password requirements:
- 8 to 32 characters
- One uppercase, one lowercase, one numerical digit, and one special character.

Save and close the file.
Install the dependencies from the working mps directory.
```
npm install
```
Start the service.
```
npm start
```
The MPS listens on port 4433 by default. Successful installation produces the command line message:
```
MPS Microservice running on localhost:3000.
Intel(R) AMT server running on localhost:4433.
```

Using Kong

If using the Kong* API gateway with MPS, your kong.yaml file must be updated to support JWT Authentication.

The secret provided in kong.yaml must match the jwt_secret from the .mpsrc file.

Example:

jwt_secrets:
  - consumer: admin
    key: 9EmRJTbIiIb4bIeSsmgcWIjrR6HyETqc #sample key
    secret: myStrongSecret

Using devcontainer

If you want debug in vscode devcontainer, try to open the project with devcontainer (Make sure you install the extension of Dev Containers)

Step1: Press Ctrl + Shift+ P in vscode;
Step2: Type Dev Containers: Reopen in Container;
Step3: Click the item which appear in column;
Step4: Open a terminal, build and run app with command;

Additional Resources

For detailed documentation and Getting Started, visit the docs site.
Looking to contribute? Find more information here about contribution guidelines and practices.
Find a bug? Or have ideas for new features? Open a new Issue.
Need additional support or want to get the latest news and events about Open AMT? Connect with the team directly through Discord.

Mps

Install / Use

README