Skip to content

range42/range42-backend-api

Table of Contents


Project Overview

RANGE42 is a modular cyber range platform designed for real-world readiness. We build, deploy, and document offensive, defensive, and hybrid cyber training environments using reproducible, infrastructure-as-code methodologies.

What we build

  • Proxmox-based cyber ranges with dynamic catalog
  • Ansible roles for automated deployments (Wazuh, Kong, Docker, etc.)
  • Private APIs for range orchestration and telemetry
  • Developer and testing toolkits and JSON transformers for automation pipelines
  • ...

Repository Overview

  • RANGE42 deployer UI : A web interface to visually design infrastructure schemas and trigger deployments.
  • RANGE42 deployer backend API : Orchestrates deployments by executing playbooks and bundles from the catalog.
  • RANGE42 catalog : A collection of Ansible roles and Docker/Docker Compose stacks, forming deployable bundles.
  • RANGE42 playbooks : Centralized playbooks that can be invoked by the backend or CLI.
  • RANGE42 proxmox role : An Ansible role for controlling Proxmox nodes via the Proxmox API.
  • RANGE42 devkit : Helper scripts for testing, debugging, and development workflows.
  • RANGE42 kong API gateway : A network service in front of the backend API, handling authentication, ACLs, and access control policies.
  • RANGE42 swagger API spec : OpenAPI/Swagger JSON definition of the backend API.

Putting it all together

These repositories provide a modular and extensible platform to design, manage and deploy infrastructures automatically either from the UI (coming soon) or from the CLI through the playbooks repository.


Repository Content

This repository contains the backend API built with FastAPI which orchestrates deployments by calling the Proxmox Ansible role to provision either reusable bundles (unit actions or infrastructure parts) or complete infrastructure scenarios (full infrastructures).

Contributing

This is a collaborative initiative, developed for applied security training, community integration, and internal capability building. We use centralized community health files in Range42 community health.

License

  • GPL-3.0 license

About

RANGE42 - Backend API orchestrator running Ansible catalog playbooks on requests from the front-end deployer UI.

Topics

Resources

License

Code of conduct

Contributing

Security policy

Stars

Watchers

Forks

Contributors 2

  •  
  •