Skip to content
AuthProxy

Develop AuthProxy

Use this section when you are changing AuthProxy itself rather than embedding or operating an existing deployment.

  • Quick start — build the current checkout and start all services with Docker.
  • Local development — run Go and frontend processes from source, sign into the local UIs, select optional services, and run tests.
  • Codebase layout — understand service boundaries, packages, schemas, SDKs, and deployment assets.
  • CLI — configure and use ap for JWTs, signed API access, UI login, and connection-scoped proxying.
  • Workflow versioning — evolve durable background workflows without breaking replay.
  • Design notes — implementation proposals and known gaps; these are not stable product reference pages.

Before committing, run the repository preflight:

Terminal window
./scripts/preflight.sh

It regenerates Swagger artifacts and checks that the integration-test module is consistent.