µPKI-WEB

NOT READY FOR PRODUCTION USE This project has only been tested on few distributions with Python3.6. Due to python usage it SHOULD works on many other configurations, but it has NOT been tested. Known working OS:

• Debian 9 Strech (CA/RA/CLI)
• Debian 10 Buster (CA/RA/CLI)
• Ubuntu 18.04 (CA/RA/CLI)
• MacOS Catalina 10.15 (CLI - without update services)
• MacOS Mojave 10.14 (CLI - without update services)

1. About

µPki [maɪkroʊ ˈpiː-ˈkeɪ-ˈaɪ] is a small PKI in python that should let you make basic tasks without effort. It works in combination with:

• µPKI-CA
• µPKI-RA
• µPKI-CLI

µPki-WEB is the administration webapp that interact with the µPKI-CA Certification Authority.

This sub-repository is for developement purpose ONLY, prefer µPKI-RA instead if you are trying to setup a PKI.

1.1 Dependencies

This project excpect to have Node.js 10 and VueJS installed.

In order to install Node.js 10 LTS on Debian 9

curl -sL https://deb.nodesource.com/setup_10.x | sudo bash
sudo apt update
sudo apt -y install gcc g++ make nodejs git

For detailed instructions see NPM Install and VueJs Install

2. Install

µPki-WEB is based on vuejs 3.x project. You are allowed to modify and enhanced it for any purpose. Please just tell us if you are making something out of it!! ;)

2.1 Project setup

npm install

2.2 Create a socket json file into src/data/socket.json

This file will make the liaison between the client and the upki-ra project. It not created, building or serving project will fail.

Example:

{
  "protocol": "http",
  "host": "certificates.kitchen.io",
  "port": 8000
}

Note: host can be an URL or an ipv4 address.

2.3 Compiles and hot-reloads for development

npm run serve

2.4 Compiles and minifies for production

npm run build

2.5 Run your tests

npm run test

2.6 Lints and fixes files

npm run lint

2.7 Customize configuration

See Configuration Reference. In order to run your development server you will probably need to adjust the public url in vue.config.js