deltascope-server

command
v0.22.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 11, 2026 License: Apache-2.0 Imports: 13 Imported by: 0

README

DeltaScope Server Command

HTTP service entrypoint exposes DeltaScope audit and metadata-aware review over JSON APIs.

Files

File Responsibility
main.go Parses process flags and starts the HTTP service
main_e2e_test.go Runs Docker-backed metadata-aware HTTP e2e coverage against the real server binary

Notes

  • This command is intentionally thin and delegates HTTP wiring to internal/interfaces/http.
  • POST /v1/audit accepts offline requests and direct metadata-aware connection inputs.
  • GET /v1/rules, GET /v1/rules/{rule_id}, and GET /v1/capabilities expose rule discovery and HTTP contract metadata.
  • -auth-enabled, -auth-keys, and -auth-allow-paths configure optional X-API-Key protection.
  • -rate-limit-enabled, -rate-limit-rps, -rate-limit-burst, and -rate-limit-key configure optional request throttling.
  • -trusted-proxies controls which proxy CIDRs are trusted for client IP extraction (empty means trust none).
  • -metrics-enabled controls whether /metrics is exposed in Prometheus text format.
  • -version prints only the semantic version string and defaults to the repository DefaultVersion in source builds.

Update Rule

  • If members/interfaces/dependencies change, update this file in same change.

Documentation

Overview

Package main starts the DeltaScope HTTP service. input: process flags for listen address, optional config path, shutdown timeout, and version printing output: a long-running JSON HTTP server process over the offline audit engine pos: HTTP service entrypoint above the internal HTTP adapter note: if this file changes, update this header and module README.md.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL