Merge branch 'master' into v2
This commit is contained in:
4
.github/workflows/build_all.yml
vendored
4
.github/workflows/build_all.yml
vendored
@@ -24,7 +24,7 @@ jobs:
|
|||||||
- name: Create Build Dir
|
- name: Create Build Dir
|
||||||
run: mkdir build
|
run: mkdir build
|
||||||
- name: Clone
|
- name: Clone
|
||||||
run: git clone --branch 2020.11-1 https://github.com/microsoft/vcpkg.git
|
run: git clone https://github.com/microsoft/vcpkg.git && cd vcpkg && git checkout 772d435ba18bf2f342458e0187ab7b48b84fe3f0
|
||||||
- name: Build VCPKG
|
- name: Build VCPKG
|
||||||
run: cd vcpkg && bootstrap-vcpkg.bat
|
run: cd vcpkg && bootstrap-vcpkg.bat
|
||||||
shell: cmd
|
shell: cmd
|
||||||
@@ -71,7 +71,7 @@ jobs:
|
|||||||
- name: Create Build Dir
|
- name: Create Build Dir
|
||||||
run: mkdir build
|
run: mkdir build
|
||||||
- name: Clone
|
- name: Clone
|
||||||
run: git clone --branch 2020.11-1 https://github.com/microsoft/vcpkg.git
|
run: git clone https://github.com/microsoft/vcpkg.git && cd vcpkg && git checkout 772d435ba18bf2f342458e0187ab7b48b84fe3f0
|
||||||
- name: Build VCPKG
|
- name: Build VCPKG
|
||||||
run: cd vcpkg && ./bootstrap-vcpkg.sh
|
run: cd vcpkg && ./bootstrap-vcpkg.sh
|
||||||
shell: bash
|
shell: bash
|
||||||
|
20
.github/workflows/changelog.yml
vendored
Normal file
20
.github/workflows/changelog.yml
vendored
Normal file
@@ -0,0 +1,20 @@
|
|||||||
|
name: Changelog Generator
|
||||||
|
|
||||||
|
on:
|
||||||
|
pull_request:
|
||||||
|
branches: [ master ]
|
||||||
|
workflow_dispatch:
|
||||||
|
jobs:
|
||||||
|
build:
|
||||||
|
runs-on: ubuntu-latest
|
||||||
|
steps:
|
||||||
|
- uses: actions/checkout@v2
|
||||||
|
with:
|
||||||
|
fetch-depth: 0
|
||||||
|
- run: docker run -v $PWD:/workdir quay.io/git-chglog/git-chglog --next-tag vNext --output CHANGELOG-new.md vNext..
|
||||||
|
- name: GitHub Upload Release Artifacts
|
||||||
|
uses: actions/upload-artifact@v2
|
||||||
|
with:
|
||||||
|
name: CHANGELOG-new.md
|
||||||
|
path: |
|
||||||
|
./CHANGELOG-new.md
|
4
.github/workflows/ci.yml
vendored
4
.github/workflows/ci.yml
vendored
@@ -21,7 +21,7 @@ jobs:
|
|||||||
- name: Create Build Dir
|
- name: Create Build Dir
|
||||||
run: mkdir build
|
run: mkdir build
|
||||||
- name: Clone
|
- name: Clone
|
||||||
run: git clone --branch 2020.11-1 https://github.com/microsoft/vcpkg.git
|
run: git clone https://github.com/microsoft/vcpkg.git && cd vcpkg && git checkout 772d435ba18bf2f342458e0187ab7b48b84fe3f0
|
||||||
- name: Build VCPKG
|
- name: Build VCPKG
|
||||||
run: cd vcpkg && bootstrap-vcpkg.bat
|
run: cd vcpkg && bootstrap-vcpkg.bat
|
||||||
shell: cmd
|
shell: cmd
|
||||||
@@ -54,7 +54,7 @@ jobs:
|
|||||||
- name: Create Build Dir
|
- name: Create Build Dir
|
||||||
run: mkdir build
|
run: mkdir build
|
||||||
- name: Clone
|
- name: Clone
|
||||||
run: git clone --branch 2020.11-1 https://github.com/microsoft/vcpkg.git
|
run: git clone https://github.com/microsoft/vcpkg.git && cd vcpkg && git checkout 772d435ba18bf2f342458e0187ab7b48b84fe3f0
|
||||||
- name: Build VCPKG
|
- name: Build VCPKG
|
||||||
run: cd vcpkg && ./bootstrap-vcpkg.sh
|
run: cd vcpkg && ./bootstrap-vcpkg.sh
|
||||||
shell: bash
|
shell: bash
|
||||||
|
6
Build.md
6
Build.md
@@ -25,8 +25,9 @@ sudo apt install git cmake build-essential curl zip unzip tar pkg-config
|
|||||||
Open a Terminal window.
|
Open a Terminal window.
|
||||||
|
|
||||||
```
|
```
|
||||||
git clone -b 2020.11-1 https://github.com/microsoft/vcpkg.git
|
git clone https://github.com/microsoft/vcpkg.git
|
||||||
cd vcpkg
|
cd vcpkg
|
||||||
|
git checkout 772d435ba18bf2f342458e0187ab7b48b84fe3f0
|
||||||
./bootstrap-vcpkg.sh
|
./bootstrap-vcpkg.sh
|
||||||
./vcpkg install cpprestsdk[websockets]
|
./vcpkg install cpprestsdk[websockets]
|
||||||
```
|
```
|
||||||
@@ -68,8 +69,9 @@ Steps below are for Windows 10 and Visual Studio 2019 Professional.
|
|||||||
Open an x64 Native Tools Command Prompt for Visual Studio 2019.
|
Open an x64 Native Tools Command Prompt for Visual Studio 2019.
|
||||||
|
|
||||||
```
|
```
|
||||||
git clone -b 2020.11-1 https://github.com/microsoft/vcpkg.git
|
git clone https://github.com/microsoft/vcpkg.git
|
||||||
cd vcpkg
|
cd vcpkg
|
||||||
|
git checkout 772d435ba18bf2f342458e0187ab7b48b84fe3f0
|
||||||
bootstrap-vcpkg.bat
|
bootstrap-vcpkg.bat
|
||||||
vcpkg install cpprestsdk[websockets]:x64-windows-static
|
vcpkg install cpprestsdk[websockets]:x64-windows-static
|
||||||
```
|
```
|
||||||
|
18
CHANGELOG.md
18
CHANGELOG.md
@@ -7,8 +7,6 @@
|
|||||||
|
|
||||||
### Ci
|
### Ci
|
||||||
- update scanning
|
- update scanning
|
||||||
- remove Jenkins chron
|
|
||||||
- **changelog:** add automation for changelog generation
|
|
||||||
|
|
||||||
### Docs
|
### Docs
|
||||||
- **readme:** wording
|
- **readme:** wording
|
||||||
@@ -25,9 +23,23 @@
|
|||||||
|
|
||||||
### Fix
|
### Fix
|
||||||
- klockwork reported success / failure check fix
|
- klockwork reported success / failure check fix
|
||||||
- update examples text and version
|
|
||||||
- **spelling:** lan inteface -> lan interface in amtinfo
|
- **spelling:** lan inteface -> lan interface in amtinfo
|
||||||
|
|
||||||
|
<a name="v1.2.2"></a>
|
||||||
|
## [v1.2.2] - 2021-06-22
|
||||||
|
### Ci
|
||||||
|
- remove Jenkins chron
|
||||||
|
- **changelog:** add automation for changelog generation
|
||||||
|
|
||||||
|
### Fix
|
||||||
|
- update examples text and version
|
||||||
|
|
||||||
|
<a name="v1.2.1"></a>
|
||||||
|
## [v1.2.1] - 2021-05-06
|
||||||
|
|
||||||
|
### Fix
|
||||||
|
**docker:** add missing ca-certs
|
||||||
|
|
||||||
<a name="v1.2.0"></a>
|
<a name="v1.2.0"></a>
|
||||||
## v1.2.0
|
## v1.2.0
|
||||||
|
|
||||||
|
@@ -1,6 +1,6 @@
|
|||||||
cmake_minimum_required (VERSION 3.1)
|
cmake_minimum_required (VERSION 3.1)
|
||||||
|
|
||||||
project (rpc VERSION 1.2.0)
|
project (rpc VERSION 2.0.0)
|
||||||
|
|
||||||
set (CMAKE_CXX_STANDARD 11)
|
set (CMAKE_CXX_STANDARD 11)
|
||||||
|
|
||||||
|
@@ -50,8 +50,9 @@ export PATH=/home/user/Downloads/git:$PATH
|
|||||||
Using a Terminal window with the PATH and devtoolset enabled per the Dependencies.
|
Using a Terminal window with the PATH and devtoolset enabled per the Dependencies.
|
||||||
|
|
||||||
```
|
```
|
||||||
git clone -b 2020.11-1 https://github.com/microsoft/vcpkg.git
|
git clone https://github.com/microsoft/vcpkg.git
|
||||||
cd vcpkg
|
cd vcpkg
|
||||||
|
git checkout 772d435ba18bf2f342458e0187ab7b48b84fe3f0
|
||||||
./bootstrap-vcpkg.sh
|
./bootstrap-vcpkg.sh
|
||||||
./vcpkg install cpprestsdk[websockets]
|
./vcpkg install cpprestsdk[websockets]
|
||||||
```
|
```
|
||||||
|
@@ -28,8 +28,9 @@ sudo yum install cmake
|
|||||||
Using a Terminal window with the PATH and devtoolset enabled per the Dependencies.
|
Using a Terminal window with the PATH and devtoolset enabled per the Dependencies.
|
||||||
|
|
||||||
```
|
```
|
||||||
git clone -b 2020.11-1 https://github.com/microsoft/vcpkg.git
|
git clone https://github.com/microsoft/vcpkg.git
|
||||||
cd vcpkg
|
cd vcpkg
|
||||||
|
git checkout 772d435ba18bf2f342458e0187ab7b48b84fe3f0
|
||||||
./bootstrap-vcpkg.sh
|
./bootstrap-vcpkg.sh
|
||||||
./vcpkg install cpprestsdk[websockets]
|
./vcpkg install cpprestsdk[websockets]
|
||||||
```
|
```
|
||||||
|
@@ -15,7 +15,7 @@ RUN \
|
|||||||
RUN git clone https://github.com/open-amt-cloud-toolkit/rpc.git
|
RUN git clone https://github.com/open-amt-cloud-toolkit/rpc.git
|
||||||
WORKDIR /rpc
|
WORKDIR /rpc
|
||||||
RUN mkdir -p build
|
RUN mkdir -p build
|
||||||
RUN git clone --branch 2020.11-1 https://github.com/microsoft/vcpkg.git
|
RUN git clone https://github.com/microsoft/vcpkg.git && cd vcpkg && git checkout 772d435ba18bf2f342458e0187ab7b48b84fe3f0
|
||||||
RUN cd vcpkg && ./bootstrap-vcpkg.sh
|
RUN cd vcpkg && ./bootstrap-vcpkg.sh
|
||||||
RUN ./vcpkg/vcpkg install cpprestsdk[websockets]
|
RUN ./vcpkg/vcpkg install cpprestsdk[websockets]
|
||||||
|
|
||||||
|
190
Jenkinsfile
vendored
190
Jenkinsfile
vendored
@@ -1,62 +1,33 @@
|
|||||||
pipeline {
|
pipeline {
|
||||||
agent none
|
agent {
|
||||||
triggers {cron '@daily'}
|
label 'docker-amt'
|
||||||
|
}
|
||||||
options {
|
options {
|
||||||
buildDiscarder(logRotator(numToKeepStr: '5', daysToKeepStr: '30'))
|
buildDiscarder(logRotator(numToKeepStr: '5', daysToKeepStr: '30'))
|
||||||
timestamps()
|
timestamps()
|
||||||
timeout(unit: 'HOURS', time: 2)
|
timeout(unit: 'HOURS', time: 2)
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|
||||||
stages {
|
stages {
|
||||||
stage ('Parallel') {
|
stage ('Cloning Repository') {
|
||||||
parallel {
|
|
||||||
stage ('Linux') {
|
|
||||||
agent { label 'docker-amt' }
|
|
||||||
stages {
|
|
||||||
stage ('Cloning Repository') {
|
|
||||||
steps {
|
|
||||||
script {
|
|
||||||
scmCheckout {
|
|
||||||
clean = true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
stage ('Windows') {
|
|
||||||
agent { label 'openamt-win' }
|
|
||||||
stages {
|
|
||||||
stage ('Cloning Repository') {
|
|
||||||
steps {
|
|
||||||
script {
|
|
||||||
scmCheckout {
|
|
||||||
clean = true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
stage ('Static Code Scan - Protex') {
|
|
||||||
agent { label 'docker-amt' }
|
|
||||||
steps {
|
steps {
|
||||||
script {
|
script {
|
||||||
staticCodeScan {
|
scmCheckout {
|
||||||
// generic
|
clean = true
|
||||||
scanners = ['protex']
|
|
||||||
scannerType = ['c','c++']
|
|
||||||
|
|
||||||
protexProjectName = 'OpenAMT - RPC'
|
|
||||||
// internal, do not change
|
|
||||||
protexBuildName = 'rrs-generic-protex-build'
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
stage('Static Code Scan - Protex') {
|
||||||
|
environment{
|
||||||
|
PROJECT_NAME = 'OpenAMT - RPC'
|
||||||
|
SCANNERS = 'protex'
|
||||||
|
}
|
||||||
|
steps {
|
||||||
|
rbheStaticCodeScan()
|
||||||
|
}
|
||||||
|
}
|
||||||
stage ('Parallel Builds') {
|
stage ('Parallel Builds') {
|
||||||
parallel {
|
parallel {
|
||||||
stage ('Linux') {
|
stage ('Linux') {
|
||||||
@@ -72,6 +43,7 @@ pipeline {
|
|||||||
steps {
|
steps {
|
||||||
sh './scripts/jenkins-pre-build.sh'
|
sh './scripts/jenkins-pre-build.sh'
|
||||||
sh './scripts/jenkins-build.sh'
|
sh './scripts/jenkins-build.sh'
|
||||||
|
stash includes: 'build/rpc', name: 'linux-rpc-app'
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
stage ('Archive') {
|
stage ('Archive') {
|
||||||
@@ -79,7 +51,6 @@ pipeline {
|
|||||||
archiveArtifacts allowEmptyArchive: true, artifacts: 'build/rpc', caseSensitive: false, onlyIfSuccessful: true
|
archiveArtifacts allowEmptyArchive: true, artifacts: 'build/rpc', caseSensitive: false, onlyIfSuccessful: true
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
stage ('Windows') {
|
stage ('Windows') {
|
||||||
@@ -90,7 +61,7 @@ pipeline {
|
|||||||
bat 'scripts\\jenkins-pre-build.cmd'
|
bat 'scripts\\jenkins-pre-build.cmd'
|
||||||
bat 'scripts\\jenkins-build.cmd'
|
bat 'scripts\\jenkins-build.cmd'
|
||||||
// prepare stash for the binary scan
|
// prepare stash for the binary scan
|
||||||
stash includes: "**/*.exe", name: 'rpc-app'
|
stash includes: '**/*.exe', name: 'win-rpc-app'
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
stage ('Archive') {
|
stage ('Archive') {
|
||||||
@@ -102,71 +73,82 @@ pipeline {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
stage ('Parallel Scans') {
|
|
||||||
parallel {
|
|
||||||
stage ('Static Code Scan Linux') {
|
|
||||||
agent { label 'docker-amt' }
|
|
||||||
steps {
|
|
||||||
script {
|
|
||||||
staticCodeScan {
|
|
||||||
// generic
|
|
||||||
scanners = ['bdba','klocwork']
|
|
||||||
scannerType = 'c++'
|
|
||||||
|
|
||||||
protecodeGroup = '25'
|
stage('Prep Binary') {
|
||||||
protecodeScanName = 'rpc-zip'
|
steps {
|
||||||
protecodeDirectory = './build/rpc'
|
sh 'mkdir -p ./bin'
|
||||||
|
dir('./bin') {
|
||||||
klockworkPreBuildScript = './scripts/jenkins-pre-build.sh'
|
unstash 'linux-rpc-app'
|
||||||
klockworkBuildCommand = './scripts/jenkins-build.sh'
|
unstash 'win-rpc-app'
|
||||||
klockworkProjectName = 'Panther Point Creek'
|
|
||||||
klockworkIgnoreCompileErrors = true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
}
|
||||||
stage ('Static Code Scan Windows') {
|
}
|
||||||
stages {
|
}
|
||||||
stage ('Static Code Scan Windows - Klockwork') {
|
stage('Linux Scans') {
|
||||||
agent { label 'openamt-win' }
|
environment{
|
||||||
steps {
|
PROJECT_NAME = 'OpenAMT - RPC - Linux'
|
||||||
script {
|
SCANNERS = 'bdba,klocwork'
|
||||||
staticCodeScan {
|
|
||||||
// generic
|
|
||||||
scanners = ['klocwork']
|
|
||||||
scannerType = 'c++'
|
|
||||||
|
|
||||||
klockworkPreBuildScript = 'scripts\\jenkins-pre-build.cmd'
|
// protecode details
|
||||||
klockworkBuildCommand = 'scripts\\jenkins-build.cmd'
|
PROTECODE_BIN_DIR = './bin'
|
||||||
klockworkProjectName = 'Panther Point Creek'
|
PROTECODE_INCLUDE_SUB_DIRS = true
|
||||||
klockworkIgnoreCompileErrors = true
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
}
|
|
||||||
stage ('Static Code Scan Windows - BDBA') {
|
|
||||||
agent { label 'docker-amt' }
|
|
||||||
steps {
|
|
||||||
script {
|
|
||||||
sh "mkdir -p bdbaScanDir"
|
|
||||||
dir("bdbaScanDir") {
|
|
||||||
unstash 'rpc-app'
|
|
||||||
}
|
|
||||||
staticCodeScan {
|
|
||||||
// generic
|
|
||||||
scanners = ['bdba']
|
|
||||||
scannerType = 'c++'
|
|
||||||
|
|
||||||
protecodeGroup = '25'
|
// klocwork details
|
||||||
protecodeScanName = 'rpc-zip'
|
KLOCWORK_SCAN_TYPE = 'c++'
|
||||||
protecodeDirectory = 'bdbaScanDir'
|
KLOCWORK_PRE_BUILD_SCRIPT = './scripts/jenkins-pre-build.sh'
|
||||||
}
|
KLOCWORK_BUILD_COMMAND = './scripts/jenkins-build.sh'
|
||||||
}
|
KLOCWORK_IGNORE_COMPILE_ERRORS = true
|
||||||
}
|
|
||||||
|
// publishArtifacts details
|
||||||
|
PUBLISH_TO_ARTIFACTORY = true
|
||||||
|
}
|
||||||
|
steps {
|
||||||
|
rbheStaticCodeScan()
|
||||||
|
dir('artifacts/Klockwork'){
|
||||||
|
sh 'cp kw_report.html kw_report_linux.html'
|
||||||
|
sh 'cp kw_report.csv kw_report_linux.csv'
|
||||||
|
archiveArtifacts allowEmptyArchive: true, artifacts: 'kw_report_linux.html'
|
||||||
|
archiveArtifacts allowEmptyArchive: true, artifacts: 'kw_report_linux.csv'
|
||||||
|
}
|
||||||
|
|
||||||
|
}
|
||||||
|
}
|
||||||
|
stage('Windows Scans'){
|
||||||
|
agent { label 'openamt-win' }
|
||||||
|
stages{
|
||||||
|
stage ('Windows Scans - klocwork') {
|
||||||
|
environment {
|
||||||
|
PROJECT_NAME = 'OpenAMT - RPC - Windows'
|
||||||
|
SCANNERS = 'klocwork'
|
||||||
|
|
||||||
|
// klocwork details
|
||||||
|
KLOCWORK_SCAN_TYPE = 'c++'
|
||||||
|
KLOCWORK_PRE_BUILD_SCRIPT = 'scripts\\jenkins-pre-build.cmd'
|
||||||
|
KLOCWORK_BUILD_COMMAND = 'scripts\\jenkins-build.cmd'
|
||||||
|
KLOCWORK_IGNORE_COMPILE_ERRORS = true
|
||||||
|
|
||||||
|
// publishArtifacts details
|
||||||
|
PUBLISH_TO_ARTIFACTORY = true
|
||||||
|
}
|
||||||
|
steps {
|
||||||
|
rbheStaticCodeScan()
|
||||||
|
dir('artifacts\\Klockwork'){
|
||||||
|
bat 'copy kw_report.html kw_report_windows.html'
|
||||||
|
bat 'copy kw_report.csv kw_report_windows.csv'
|
||||||
|
stash includes: 'kw_report_windows.*', name: 'win-kwreports'
|
||||||
|
archiveArtifacts allowEmptyArchive: true, artifacts: 'kw_report_windows.html'
|
||||||
|
archiveArtifacts allowEmptyArchive: true, artifacts: 'kw_report_windows.csv'
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
stage('Publish Artifacts'){
|
||||||
|
steps{
|
||||||
|
dir('artifacts/Klockwork'){
|
||||||
|
unstash 'win-kwreports'
|
||||||
|
}
|
||||||
|
publishArtifacts()
|
||||||
|
}
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
29
README.md
29
README.md
@@ -4,26 +4,43 @@
|
|||||||
|
|
||||||
The Remote Provisioning Client (RPC) is an application that enables remote capabilities for Intel® AMT, such as as device activation and configuration. To accomplish this, RPC communicates with the Remote Provisioning Server (RPS) to activate and connect the edge device.
|
The Remote Provisioning Client (RPC) is an application that enables remote capabilities for Intel® AMT, such as as device activation and configuration. To accomplish this, RPC communicates with the Remote Provisioning Server (RPS) to activate and connect the edge device.
|
||||||
|
|
||||||
|
<br><br>
|
||||||
|
|
||||||
**For detailed documentation** about RPC or other features of the Open AMT Cloud Toolkit, see the [docs](https://open-amt-cloud-toolkit.github.io/docs/).
|
**For detailed documentation** about RPC or other features of the Open AMT Cloud Toolkit, see the [docs](https://open-amt-cloud-toolkit.github.io/docs/).
|
||||||
|
|
||||||
|
<br>
|
||||||
|
|
||||||
## Prerequisites
|
## Prerequisites
|
||||||
|
|
||||||
We leverage GitHub Actions as a means to build RPC automatically leveraging Github's CI/CD Infrastructure. This avoids having to deal with the challenges of getting your build environment just right on your local machine and allows you to get up and running much faster. Read more about GitHub Actions [here](https://github.blog/2019-08-08-github-actions-now-supports-ci-cd/#:~:text=GitHub%20Actions%20is%20an%20API,every%20step%20along%20the%20way.)
|
We leverage GitHub Actions as a means to build RPC automatically leveraging Github's CI/CD Infrastructure. This avoids having to deal with the challenges of getting your build environment just right on your local machine and allows you to get up and running much faster. Read more about GitHub Actions [here](https://github.blog/2019-08-08-github-actions-now-supports-ci-cd/#:~:text=GitHub%20Actions%20is%20an%20API,every%20step%20along%20the%20way.)
|
||||||
|
|
||||||
## Build the Remote Provisioning Client (RPC)
|
|
||||||
|
|
||||||
<p align="center">
|
<p align="center">
|
||||||
<img src="assets/animations/forkandbuild.gif" width="650" />
|
<img src="assets/animations/forkandbuild.gif" width="650" />
|
||||||
</p>
|
</p>
|
||||||
|
|
||||||
1. Create a fork of the rpc repository [here](https://github.com/open-amt-cloud-toolkit/rpc/fork) or via the Fork button in the top-right corner of the rpc repository.
|
## Build the Remote Provisioning Client (RPC)
|
||||||
|
|
||||||
2. Click on "Actions" and Select "Build RPC (Native)" Workflow.
|
1. <a href="https://github.com/open-amt-cloud-toolkit/rpc/fork" target="_blank">Create a fork of rpc on GitHub.</a>
|
||||||
|
|
||||||
3. Click "Run Workflow", select branch "master", and click "Run Workflow".
|
2. Click on the **Actions** tab at the top and select **Build RPC (Native) Debug/Release**.
|
||||||
|
|
||||||
4. Grab a coffee. The build for Windows will take approximately 30 minutes and the build for Linux will take approximately 5 minutes.
|
3. Click the **Run Workflow** dropdown.
|
||||||
|
|
||||||
5. Once complete, click the completed job, and download the appropriate RPC for your OS under the "Artifacts" section.
|
4. Select the **Branch: master**, or a preferred version, from the **Use workflow from** dropdown.
|
||||||
|
|
||||||
|
5. By default, the Build Type should be **release**.
|
||||||
|
|
||||||
|
6. Click the **Run Workflow** button. Grab a coffee and take a break! The build time ranges from 15 to 20 minutes.
|
||||||
|
|
||||||
|
8. Once the download is complete, click the completed job which will feature a green checkmark.
|
||||||
|
|
||||||
|
9. Download the appropriate RPC for your managed device's OS under the **Artifacts** section.
|
||||||
|
|
||||||
|
### To Delete your workflow run
|
||||||
|
|
||||||
|
1. Click the ellipsis ( **...** ) menu for the workflow.
|
||||||
|
|
||||||
|
2. Choose the **Delete workflow run** option.
|
||||||
|
|
||||||
For detailed documentation about RPC and using it to activate a device, see the [docs](https://open-amt-cloud-toolkit.github.io/docs/)
|
For detailed documentation about RPC and using it to activate a device, see the [docs](https://open-amt-cloud-toolkit.github.io/docs/)
|
5
SECURITY.md
Normal file
5
SECURITY.md
Normal file
@@ -0,0 +1,5 @@
|
|||||||
|
# Security Policy
|
||||||
|
Intel is committed to rapidly addressing security vulnerabilities affecting our customers and providing clear guidance on the solution, impact, severity and mitigation.
|
||||||
|
|
||||||
|
## Reporting a Vulnerability
|
||||||
|
Please report any security vulnerabilities in this project utilizing the guidelines [here](https://www.intel.com/content/www/us/en/security-center/vulnerability-handling-guidelines.html).
|
89
commands.cpp
89
commands.cpp
@@ -282,51 +282,54 @@ bool cmd_get_certificate_hashes(std::vector<cert_hash_entry>& hash_entries)
|
|||||||
for (int i = 0; i < (int) amt_hash_handles.Length; i++)
|
for (int i = 0; i < (int) amt_hash_handles.Length; i++)
|
||||||
{
|
{
|
||||||
// get each entry
|
// get each entry
|
||||||
AMT_STATUS status = pthi_GetCertificateHashEntry(amt_hash_handles.Handles[i], &certhash_entry);
|
AMT_STATUS amt_status = pthi_GetCertificateHashEntry(amt_hash_handles.Handles[i], &certhash_entry);
|
||||||
|
|
||||||
int hashSize;
|
if (amt_status == 0)
|
||||||
cert_hash_entry tmp;
|
|
||||||
switch (certhash_entry.HashAlgorithm) {
|
|
||||||
case 0: // MD5
|
|
||||||
hashSize = 16;
|
|
||||||
tmp.algorithm = "MD5";
|
|
||||||
break;
|
|
||||||
case 1: // SHA1
|
|
||||||
hashSize = 20;
|
|
||||||
tmp.algorithm = "SHA1";
|
|
||||||
break;
|
|
||||||
case 2: // SHA256
|
|
||||||
hashSize = 32;
|
|
||||||
tmp.algorithm = "SHA256";
|
|
||||||
break;
|
|
||||||
case 3: // SHA512
|
|
||||||
hashSize = 64;
|
|
||||||
tmp.algorithm = "SHA512";
|
|
||||||
break;
|
|
||||||
default:
|
|
||||||
hashSize = 0;
|
|
||||||
tmp.algorithm = "UNKNOWN";
|
|
||||||
break;
|
|
||||||
}
|
|
||||||
|
|
||||||
if (certhash_entry.IsActive == 1)
|
|
||||||
{
|
{
|
||||||
std::string cert_name(certhash_entry.Name.Buffer, certhash_entry.Name.Length);
|
int hashSize;
|
||||||
tmp.name = cert_name;
|
cert_hash_entry tmp;
|
||||||
tmp.is_default = certhash_entry.IsDefault;
|
switch (certhash_entry.HashAlgorithm) {
|
||||||
tmp.is_active = certhash_entry.IsActive;
|
case 0: // MD5
|
||||||
|
hashSize = 16;
|
||||||
std::string hashString;
|
tmp.algorithm = "MD5";
|
||||||
for (int i = 0; i < hashSize; i++)
|
break;
|
||||||
{
|
case 1: // SHA1
|
||||||
char hex[10];
|
hashSize = 20;
|
||||||
snprintf(hex, 10, "%02x", certhash_entry.CertificateHash[i]);
|
tmp.algorithm = "SHA1";
|
||||||
hashString += hex;
|
break;
|
||||||
|
case 2: // SHA256
|
||||||
|
hashSize = 32;
|
||||||
|
tmp.algorithm = "SHA256";
|
||||||
|
break;
|
||||||
|
case 3: // SHA512
|
||||||
|
hashSize = 64;
|
||||||
|
tmp.algorithm = "SHA512";
|
||||||
|
break;
|
||||||
|
default:
|
||||||
|
hashSize = 0;
|
||||||
|
tmp.algorithm = "UNKNOWN";
|
||||||
|
break;
|
||||||
}
|
}
|
||||||
|
|
||||||
tmp.hash = hashString;
|
if (certhash_entry.IsActive == 1)
|
||||||
|
{
|
||||||
|
std::string cert_name(certhash_entry.Name.Buffer, certhash_entry.Name.Length);
|
||||||
|
tmp.name = cert_name;
|
||||||
|
tmp.is_default = certhash_entry.IsDefault;
|
||||||
|
tmp.is_active = certhash_entry.IsActive;
|
||||||
|
|
||||||
hash_entries.push_back(tmp);
|
std::string hashString;
|
||||||
|
for (int i = 0; i < hashSize; i++)
|
||||||
|
{
|
||||||
|
char hex[10];
|
||||||
|
snprintf(hex, 10, "%02x", certhash_entry.CertificateHash[i]);
|
||||||
|
hashString += hex;
|
||||||
|
}
|
||||||
|
|
||||||
|
tmp.hash = hashString;
|
||||||
|
|
||||||
|
hash_entries.push_back(tmp);
|
||||||
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -377,14 +380,14 @@ bool cmd_get_remote_access_connection_status(int& network_status, int& remote_st
|
|||||||
return false;
|
return false;
|
||||||
}
|
}
|
||||||
|
|
||||||
bool cmd_get_lan_interface_settings(lan_interface_settings& lan_interface_settings)
|
bool cmd_get_lan_interface_settings(lan_interface_settings& lan_interface_settings, bool wired_interface)
|
||||||
{
|
{
|
||||||
// initialize HECI interface
|
// initialize HECI interface
|
||||||
if (heci_Init(NULL, PTHI_CLIENT) == 0) return false;
|
if (heci_Init(NULL, PTHI_CLIENT) == 0) return false;
|
||||||
|
|
||||||
// get wired interface
|
// get wired interface
|
||||||
LAN_SETTINGS lan_settings;
|
LAN_SETTINGS lan_settings;
|
||||||
UINT32 interface_settings = 0; // wired=0, wireless=1
|
UINT32 interface_settings = (wired_interface) ? 0 : 1; // wired=0, wireless=1
|
||||||
AMT_STATUS amt_status = pthi_GetLanInterfaceSettings(interface_settings, &lan_settings);
|
AMT_STATUS amt_status = pthi_GetLanInterfaceSettings(interface_settings, &lan_settings);
|
||||||
if (amt_status == 0)
|
if (amt_status == 0)
|
||||||
{
|
{
|
||||||
@@ -393,11 +396,13 @@ bool cmd_get_lan_interface_settings(lan_interface_settings& lan_interface_settin
|
|||||||
lan_interface_settings.dhcp_enabled = lan_settings.DhcpEnabled;
|
lan_interface_settings.dhcp_enabled = lan_settings.DhcpEnabled;
|
||||||
lan_interface_settings.link_status = lan_settings.LinkStatus;
|
lan_interface_settings.link_status = lan_settings.LinkStatus;
|
||||||
|
|
||||||
|
lan_interface_settings.ip_address.clear();
|
||||||
lan_interface_settings.ip_address.push_back((lan_settings.Ipv4Address >> 24) & 0xff);
|
lan_interface_settings.ip_address.push_back((lan_settings.Ipv4Address >> 24) & 0xff);
|
||||||
lan_interface_settings.ip_address.push_back((lan_settings.Ipv4Address >> 16) & 0xff);
|
lan_interface_settings.ip_address.push_back((lan_settings.Ipv4Address >> 16) & 0xff);
|
||||||
lan_interface_settings.ip_address.push_back((lan_settings.Ipv4Address >> 8) & 0xff);
|
lan_interface_settings.ip_address.push_back((lan_settings.Ipv4Address >> 8) & 0xff);
|
||||||
lan_interface_settings.ip_address.push_back((lan_settings.Ipv4Address) & 0xff);
|
lan_interface_settings.ip_address.push_back((lan_settings.Ipv4Address) & 0xff);
|
||||||
|
|
||||||
|
lan_interface_settings.mac_address.clear();
|
||||||
lan_interface_settings.mac_address.push_back(lan_settings.MacAddress[0]);
|
lan_interface_settings.mac_address.push_back(lan_settings.MacAddress[0]);
|
||||||
lan_interface_settings.mac_address.push_back(lan_settings.MacAddress[1]);
|
lan_interface_settings.mac_address.push_back(lan_settings.MacAddress[1]);
|
||||||
lan_interface_settings.mac_address.push_back(lan_settings.MacAddress[2]);
|
lan_interface_settings.mac_address.push_back(lan_settings.MacAddress[2]);
|
||||||
|
@@ -49,6 +49,6 @@ bool cmd_get_dns_suffix(std::string& suffix);
|
|||||||
bool cmd_get_wired_mac_address(std::vector<unsigned char>& address);
|
bool cmd_get_wired_mac_address(std::vector<unsigned char>& address);
|
||||||
bool cmd_get_certificate_hashes(std::vector<cert_hash_entry>& hash_entries);
|
bool cmd_get_certificate_hashes(std::vector<cert_hash_entry>& hash_entries);
|
||||||
bool cmd_get_remote_access_connection_status(int& network_status, int& remote_status, int& remote_trigger, std::string& mps_hostname);
|
bool cmd_get_remote_access_connection_status(int& network_status, int& remote_status, int& remote_trigger, std::string& mps_hostname);
|
||||||
bool cmd_get_lan_interface_settings(lan_interface_settings& lan_interface_settings);
|
bool cmd_get_lan_interface_settings(lan_interface_settings& lan_interface_settings, bool wired_interface = true);
|
||||||
|
|
||||||
#endif
|
#endif
|
42
info.cpp
42
info.cpp
@@ -20,7 +20,7 @@ void out_text(const std::string name, const std::vector<unsigned char> value, co
|
|||||||
for (unsigned char tmp : value)
|
for (unsigned char tmp : value)
|
||||||
{
|
{
|
||||||
(hex) ? std::cout << std::setfill('0') << std::setw(2) << std::hex << (unsigned int)tmp
|
(hex) ? std::cout << std::setfill('0') << std::setw(2) << std::hex << (unsigned int)tmp
|
||||||
: std::cout << (unsigned int)tmp;
|
: std::cout << std::dec << (unsigned int)tmp;
|
||||||
|
|
||||||
if (char_count++ < value.size())
|
if (char_count++ < value.size())
|
||||||
{
|
{
|
||||||
@@ -270,15 +270,41 @@ bool info_get_lan_interface_settings()
|
|||||||
tmp.ip_address.clear();
|
tmp.ip_address.clear();
|
||||||
tmp.mac_address.clear();
|
tmp.mac_address.clear();
|
||||||
|
|
||||||
if (!cmd_get_lan_interface_settings(tmp)) return false;
|
bool hasWired = cmd_get_lan_interface_settings(tmp);
|
||||||
|
if (hasWired)
|
||||||
|
{
|
||||||
|
out_text("LAN Interface", "wired");
|
||||||
|
out_text("DHCP Enabled", (tmp.dhcp_enabled) ? "true" : "false");
|
||||||
|
out_text("DHCP Mode", (tmp.dhcp_mode == 1) ? "active" : "passive");
|
||||||
|
out_text("Link Status", (tmp.link_status) ? "up" : "down");
|
||||||
|
out_text("IP Address", tmp.ip_address, '.', false);
|
||||||
|
out_text("MAC Address", tmp.mac_address, ':');
|
||||||
|
}
|
||||||
|
|
||||||
out_text("DHCP Enabled", (tmp.dhcp_enabled) ? "true" : "false");
|
tmp.is_enabled = false;
|
||||||
out_text("DHCP Mode", (tmp.dhcp_mode == 1) ? "active" : "passive");
|
tmp.link_status = false;
|
||||||
out_text("Link Status", (tmp.link_status) ? "up" : "down");
|
tmp.dhcp_enabled = false;
|
||||||
out_text("IP Address", tmp.ip_address, '.', false);
|
tmp.dhcp_mode = 0;
|
||||||
out_text("MAC Address", tmp.mac_address, ':');
|
tmp.ip_address.clear();
|
||||||
|
tmp.mac_address.clear();
|
||||||
|
|
||||||
return true;
|
bool hasWireless = cmd_get_lan_interface_settings(tmp, false);
|
||||||
|
if (hasWireless)
|
||||||
|
{
|
||||||
|
out_text("LAN Interface", "wireless");
|
||||||
|
out_text("DHCP Enabled", (tmp.dhcp_enabled) ? "true" : "false");
|
||||||
|
out_text("DHCP Mode", (tmp.dhcp_mode == 1) ? "active" : "passive");
|
||||||
|
out_text("Link Status", (tmp.link_status) ? "up" : "down");
|
||||||
|
out_text("IP Address", tmp.ip_address, '.', false);
|
||||||
|
out_text("MAC Address", tmp.mac_address, ':');
|
||||||
|
}
|
||||||
|
|
||||||
|
if (hasWired || hasWireless)
|
||||||
|
{
|
||||||
|
return true;
|
||||||
|
}
|
||||||
|
|
||||||
|
return false;
|
||||||
}
|
}
|
||||||
|
|
||||||
bool info_get(const std::string info)
|
bool info_get(const std::string info)
|
||||||
|
35
main.cpp
35
main.cpp
@@ -7,6 +7,7 @@
|
|||||||
#include <thread>
|
#include <thread>
|
||||||
#include <cpprest/ws_client.h>
|
#include <cpprest/ws_client.h>
|
||||||
#include <cpprest/json.h>
|
#include <cpprest/json.h>
|
||||||
|
#include <algorithm>
|
||||||
#include "port.h"
|
#include "port.h"
|
||||||
#include "lms.h"
|
#include "lms.h"
|
||||||
#include "commands.h"
|
#include "commands.h"
|
||||||
@@ -271,7 +272,22 @@ int main(int argc, char* argv[])
|
|||||||
g_timeout_val = 0;
|
g_timeout_val = 0;
|
||||||
|
|
||||||
// exit
|
// exit
|
||||||
std::cout << std::endl << msgMessage << std::endl;
|
try {
|
||||||
|
std::cout << std::endl;
|
||||||
|
utility::string_t tmp = utility::conversions::convertstring(msgMessage);
|
||||||
|
web::json::value parsed = web::json::value::parse(tmp);
|
||||||
|
for (const auto& obj : parsed.as_object()) {
|
||||||
|
std::string key = utility::conversions::to_utf8string(obj.first);
|
||||||
|
std::string value = utility::conversions::to_utf8string(obj.second.serialize());
|
||||||
|
value.erase(std::remove(value.begin(), value.end(), '"'), value.end());
|
||||||
|
std::cout << key << ": " << value << std::endl;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
catch (...)
|
||||||
|
{
|
||||||
|
std::cout << std::endl << msgMessage << std::endl;
|
||||||
|
}
|
||||||
|
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
else if (msgStatus.compare("failed")==0)
|
else if (msgStatus.compare("failed")==0)
|
||||||
@@ -280,7 +296,22 @@ int main(int argc, char* argv[])
|
|||||||
g_timeout_val = 0;
|
g_timeout_val = 0;
|
||||||
|
|
||||||
// exit
|
// exit
|
||||||
std::cout << std::endl << msgMessage << std::endl;
|
try {
|
||||||
|
std::cout << std::endl;
|
||||||
|
utility::string_t tmp = utility::conversions::convertstring(msgMessage);
|
||||||
|
web::json::value parsed = web::json::value::parse(tmp);
|
||||||
|
for (const auto& obj : parsed.as_object()) {
|
||||||
|
std::string key = utility::conversions::to_utf8string(obj.first);
|
||||||
|
std::string value = utility::conversions::to_utf8string(obj.second.serialize());
|
||||||
|
value.erase(std::remove(value.begin(), value.end(), '"'), value.end());
|
||||||
|
std::cout << key << ": " << value << std::endl;
|
||||||
|
}
|
||||||
|
}
|
||||||
|
catch (...)
|
||||||
|
{
|
||||||
|
std::cout << std::endl << msgMessage << std::endl;
|
||||||
|
}
|
||||||
|
|
||||||
return;
|
return;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
@@ -15,8 +15,9 @@ set VCPKG_DIR=C:\opt\vcpkg-source
|
|||||||
cd %VCPKG_DIR%
|
cd %VCPKG_DIR%
|
||||||
|
|
||||||
REM build vcpkg
|
REM build vcpkg
|
||||||
git clone --branch 2020.11-1 https://github.com/microsoft/vcpkg.git
|
git clone https://github.com/microsoft/vcpkg.git
|
||||||
cd vcpkg
|
cd vcpkg
|
||||||
|
git checkout 772d435ba18bf2f342458e0187ab7b48b84fe3f0
|
||||||
cmd /c bootstrap-vcpkg.bat
|
cmd /c bootstrap-vcpkg.bat
|
||||||
|
|
||||||
REM install CPPRestSDK
|
REM install CPPRestSDK
|
||||||
|
@@ -12,8 +12,9 @@ apt install git cmake build-essential curl zip unzip tar pkg-config -y
|
|||||||
|
|
||||||
#cd "$BASE_DIR"/rpc
|
#cd "$BASE_DIR"/rpc
|
||||||
## build vcpkg
|
## build vcpkg
|
||||||
git -C vcpkg pull || git clone --branch 2020.11-1 https://github.com/microsoft/vcpkg.git vcpkg
|
git -C vcpkg pull || git clone https://github.com/microsoft/vcpkg.git vcpkg
|
||||||
cd vcpkg
|
cd vcpkg
|
||||||
|
git checkout 772d435ba18bf2f342458e0187ab7b48b84fe3f0
|
||||||
./bootstrap-vcpkg.sh
|
./bootstrap-vcpkg.sh
|
||||||
|
|
||||||
## install CPPRestSDK
|
## install CPPRestSDK
|
||||||
|
@@ -49,15 +49,15 @@ void usage_show_help()
|
|||||||
std::cout << "Examples:" << std::endl;
|
std::cout << "Examples:" << std::endl;
|
||||||
std::cout << " # Activate platform using profile1" << std::endl;
|
std::cout << " # Activate platform using profile1" << std::endl;
|
||||||
std::cout << " " << PROJECT_NAME << \
|
std::cout << " " << PROJECT_NAME << \
|
||||||
" --url wss://localhost:8080 --cmd \"-t activate --profile profile1\"" << std::endl;
|
" --url wss://192.168.86.100/activate --cmd \"-t activate --profile profile1\"" << std::endl;
|
||||||
std::cout << std::endl;
|
std::cout << std::endl;
|
||||||
std::cout << " # Activate platform using profile1 and override DNS detection" << std::endl;
|
std::cout << " # Activate platform using profile1 and override DNS detection" << std::endl;
|
||||||
std::cout << " " << PROJECT_NAME << \
|
std::cout << " " << PROJECT_NAME << \
|
||||||
" --url wss://localhost:8080 --cmd \"-t activate --profile profile1\" --dns corp.com" << std::endl;
|
" --url wss://mycloud.com/activate --cmd \"-t activate --profile profile1\" --dns corp.com" << std::endl;
|
||||||
std::cout << std::endl;
|
std::cout << std::endl;
|
||||||
std::cout << " # Deactivate platform and connect through a proxy" << std::endl;
|
std::cout << " # Deactivate platform and connect through a proxy" << std::endl;
|
||||||
std::cout << " " << PROJECT_NAME << \
|
std::cout << " " << PROJECT_NAME << \
|
||||||
" -u wss://localhost:8080 -c \"-t deactivate --password P@ssw0rd\" -p http://proxy.com:1000" << std::endl;
|
" -u wss://mycloud.com/activate -c \"-t deactivate --password P@ssw0rd\" -p http://proxy.com:1000" << std::endl;
|
||||||
std::cout << std::endl;
|
std::cout << std::endl;
|
||||||
std::cout << " # Show all informational items" << std::endl;
|
std::cout << " # Show all informational items" << std::endl;
|
||||||
std::cout << " " << PROJECT_NAME << " --amtinfo all" << std::endl;
|
std::cout << " " << PROJECT_NAME << " --amtinfo all" << std::endl;
|
||||||
|
Reference in New Issue
Block a user