Skip to content

open-leash/dashboard-api

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

8 Commits
 
 
 
 
 
 
 
 

Repository files navigation

🛡 Policy, identity, deployment, and audit for teams.


✨ What this app is

dashboard-api is the public admin API surface for OpenLeash dashboards.

It is built from the same core service as client-api, but runs with OPENLEASH_API_SURFACE=dashboard so admin workflows stay separate from client enforcement routes.


🔥 What it powers

  • Organization onboarding
  • Identity provider setup
  • User and group sync
  • Policy management
  • Organization plugin policy: mandatory/default state, employee catalog freedom, configuration locks, and per-agent profiles
  • Deployment tokens
  • Agent, MCP, skills, trigger, and audit views
  • BYOK evaluation key management
  • Managed self-hosted admin workflows

🛠 Run locally

npm install
docker compose up -d postgres
python3 migrate.py --target local --scope core --apply --yes
npm run dev:dashboard-api

Health:

curl http://localhost:9319/health

Recommended full-mode runner:

python3 run.py

Choose Private Cloud.


🗄 Database

dashboard-api uses the same public Postgres schema as client-api. Run the core migration job once per target database before starting or upgrading either API:

python3 migrate.py --target custom --database-url 'postgres://...' --scope core --backup-apply --yes

For a fresh database, --apply is enough. For production upgrades, prefer --backup-apply.


🏢 Identity providers

Managed private-cloud/self-hosted customers can configure:

  • Google Workspace
  • Okta
  • Ping Identity
  • Microsoft Entra ID / Azure AD
  • LDAP / Active Directory-style sync

☁️ Cloud relationship

cloud-dashboard-api wraps this surface for OpenLeash-hosted multi-tenant cloud. Shared admin behavior belongs here; hosted-only tenancy and operator behavior belongs in the cloud wrapper.

Plugin administration follows the same public contract in Private Cloud and organization OpenLeash Cloud. Controls are independent: requiring a plugin does not automatically lock its settings or close the catalog. Profiles may apply organization-wide, to an agent kind, or to an exact authenticated/enrolled agent runtime; employee overrides are honored only when organization policy permits them.

The dashboard should feel boringly reliable. That is the point.

About

Dashboard/admin API surface for OpenLeash.

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors