Skip to content

Latest commit

 

History

History
47 lines (31 loc) · 2.14 KB

README.md

File metadata and controls

47 lines (31 loc) · 2.14 KB
Raw

Tornjak

WARNING: This project is still in early development and should not be used in production

The project aims to provide a management plane and capabilities for SPIFFE identities managed by SPIRE. The goals are to provide global visibility, auditability, and configuration and policy management for identities. This can be thought about as a central management plane for identities across SPIRE servers, with the aim for use by an administrator or CISO to govern an organization's workload identities.

The architecture consists of 2 main components, the agent and the manager.

  • The manager provides a management control plane for SPIRE servers, and a central point of data collection. It interacts with the agents, SPIRE servers, and corresponding components to achieve this.
  • The agent provides a way for the management plane to communicate with the SPIRE servers and provide introspection and configuration of identities.

For more details of the components and execution plan, please refer to these documents

Get Started

The following are guides on how to try out Tornjak:

Development: Building and pushing

The binary and container can be built with the following command, replacing the container tag with the desired container tag of choice.

This makes the tornjak agent + spire server container:

CONTAINER_TAG=lumjjb/tornjak-spire-server:latest make container-agent

The container is run with the same arguments as the SPIRE server image, and usage is transparent. It runs a server hosted on port 10000 accessed via http.

Testing and validating the Tornjak front-end

To start a local version of the Tornjak front-end server point at the running Tornjak APIs:

cd tornjak-frontend
REACT_APP_API_SERVER_URI=http://<tornjak_API>/  npm start

Assuming npm is installed, this will start a server on http://localhost:3000 Please be patient, as it might take a few minutes to compile and start the server.