ziti-console
ziti-console copied to clipboard

OpenZiti is a free and open source project focused on bringing zero trust to any application.
The project provides all the pieces required to implement or integrate zero trust into your solutions.
@openziti/ziti-console
This repo hosts the Ziti Admin Console, and is designed to provide a user interface to help you administrate an OpenZiti Network via the Ziti Edge API
Part of the OpenZiti ecosystem
Interested in knowing how to easily embed programmable, high performance, zero trust networking into your application without VPNs?
Learn more about OpenZiti project.
Also, checkout core project on github
Please star us!
OpenZiti Console
The OpenZiti Console is an administrative web interface for an OpenZiti network.
Deployments
Read the production deployment guides for the console as well as the controller, router, etc.
Requirements
To build and run the application from source, you'll also need to make sure you have the following developer tools installed and available on your command line.
| Tool | Version |
|---|---|
| Node.js | >=18 |
| npm | >=8.1 |
| ng | =16 |
Install Angular CLI
This provides the ng command.
npm install -g @angular/cli@16
Projects
This repository houses two projects.
- ziti-console-lib - Angular library used by the console UI.
- app-ziti-console - console UI with two deployment modes.
- Single page application mode (recommended)
- Node.js server mode (
server.js, deprecated)
Build
From the project root:
-
Install both projects' dependencies and build the library.
npm install
Build the Single Page Application
-
Build the console project with Angular.
ng build ziti-console -
The single-page application assets are rendered in the
./dist/app-ziti-consoledirectory. -
use the Node server to preview changes.
Build the Standalone Node Server
Do not use this in production: deployment guides. This is a deprecated build and run mode temporarily preserved here for previewing local changes during development.
-
Build the console project with Angular.
ng build ziti-console-node -
If developing the standalone Node server, run it.
node server.js -
Access the console at http://localhost:1408
-
Configure the server with the URL of the controller's edge-management API, e.g. https://localhost:1280
Developing with Angular
There are two elements to the Angular app.
From the project directory:
-
Install dependencies and build the library.
npm install -
Continually build the library in ./dist/ziti-console-lib by running the npm script watch:lib.
ng build ziti-console-lib --watchNote: The NPM library is referenced/linked in
package.jsonas"ziti-console-lib": "file:dist/ziti-console-lib". This library includes the javascript code shared with the console application and the Angular code shared with other applications. -
Continually build the deprecated Node server in app-ziti-console-node to preview changes.
ng build ziti-console-node --watch