Title: platform: a machine identity that can create projects and issue their deploy tokens · Issue #692 · voidzero-dev/void · GitHub
Open Graph Title: platform: a machine identity that can create projects and issue their deploy tokens · Issue #692 · voidzero-dev/void
X Title: platform: a machine identity that can create projects and issue their deploy tokens · Issue #692 · voidzero-dev/void
Description: Motivation We run a self-hosted Void platform behind Cloudflare Access for LumiOS, an internal agent platform (the connected-app client from #631). LumiOS agents build small web apps for our users. Each app needs its own D1, KV, R2, queu...
Open Graph Description: Motivation We run a self-hosted Void platform behind Cloudflare Access for LumiOS, an internal agent platform (the connected-app client from #631). LumiOS agents build small web apps for our users....
X Description: Motivation We run a self-hosted Void platform behind Cloudflare Access for LumiOS, an internal agent platform (the connected-app client from #631). LumiOS agents build small web apps for our users....
Opengraph URL: https://github.com/voidzero-dev/void/issues/692
X: @github
Domain: github.com
{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"platform: a machine identity that can create projects and issue their deploy tokens","articleBody":"### Motivation\n\nWe run a self-hosted Void platform behind Cloudflare Access for LumiOS, an internal agent platform (the connected-app client from #631). LumiOS agents build small web apps for our users. Each app needs its own D1, KV, R2, queues and Durable State, and Void scopes those to a project, so LumiOS needs to create one project per app and deploy to it, unattended, from a server.\n\nDeploying works today: a project credential (`aud: deploy`) plus our Access service token is admitted for that project. Creating the project and minting its first credential is the gap. Only a human login session can do either, and the platform refuses a human session that arrives with an Access service token. The docs say this is deliberate:\n\n- \"machine Access proof cannot turn a human Void token into an automation identity\" ([cli/auth.md](https://github.com/voidzero-dev/void/blob/afeeff6a4d72682f6cfb6c947e9a2c29393c00a6/docs/reference/cli/auth.md#L69-L72))\n- \"Void does not issue permanent service tokens for administrator automation\" ([operations.md](https://github.com/voidzero-dev/void/blob/afeeff6a4d72682f6cfb6c947e9a2c29393c00a6/docs/guide/platform/administration/operations.md#L97))\n\nWe'd like to know whether you'd support a machine identity for this, and in what shape, before we build anything.\n\n### Where it is decided (v1.5.0)\n\n- Access service identities may only reach `/projects/*` with a project-scoped `deploy`/`oauth-deploy`/`oauth-preview` token; everything else gets `access_human_identity_required`: [platform-access.ts#L106-L121](https://github.com/voidzero-dev/void/blob/afeeff6a4d72682f6cfb6c947e9a2c29393c00a6/platform/packages/api/src/middleware/platform-access.ts#L106-L121)\n- `POST /projects` creates the project for the session's user: [projects.ts#L658-L660](https://github.com/voidzero-dev/void/blob/afeeff6a4d72682f6cfb6c947e9a2c29393c00a6/platform/packages/api/src/routes/projects.ts#L658-L660)\n- `POST /projects/:id/tokens` signs the credential for the session's user, at most 90 days: [project-tokens.ts#L125-L143](https://github.com/voidzero-dev/void/blob/afeeff6a4d72682f6cfb6c947e9a2c29393c00a6/platform/packages/api/src/routes/project-tokens.ts#L125-L143), [deploy-token.ts#L22](https://github.com/voidzero-dev/void/blob/afeeff6a4d72682f6cfb6c947e9a2c29393c00a6/platform/packages/api/src/auth/deploy-token.ts#L22)\n- The operator API can list, transfer and delete projects but not create them or issue their credentials.\n\n### What we would do without it\n\nCreate an ordinary user for the service, keep its 30-day Void session and a user Access token in our secret store, and have a person sign in as it about once a month. That works, but it's the pattern the docs above warn against: a human-type account with a password and MFA held by a server, and an outage whenever someone misses the renewal.\n\n### Possible shape (for discussion)\n\nAn operator registers a machine user and binds it to one Access service token:\n\n```\nvoid platform machine create lumios --access-service-token \u003cclient-id>\n```\n\n- The platform-access middleware admits that service token for a small set of routes when it is paired with the machine user's credential: create a project, issue and revoke credentials for projects the machine user owns, and (maybe) write those projects' secrets.\n- The machine credential is revocable and rotatable by an operator, and never works without its bound service token, so leaking one half is not enough.\n- Projects it creates count against its plan like any user's, and can be transferred to a human owner with the existing operator command.\n\n### Questions\n\n1. Is a machine identity something you'd want in Void, or would you rather solve this another way (for example a connected-app grant an administrator approves once, or the GitHub-OIDC executor generalized to other issuers)?\n2. If machine users: should the credential be long-lived and revocable, or short-lived and exchanged from the bound service token on each use?\n3. Should projects belong to the machine user, or be created on behalf of a named human owner or team?\n4. Would you accept a PR once the shape is agreed?\n\n_Prepared with an AI coding agent on behalf of @sglyon; reviewed by @sglyon before posting._\n","author":{"url":"https://github.com/sglyon","@type":"Person","name":"sglyon"},"datePublished":"2026-11-03T17:39:41Z","url":"https://github.com/voidzero-dev/void/issues/692"}
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react-reconciler,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@d5750093facf |
| route-pattern | /_view_fragments/issues/show/:user_id/:repository/:id/issue_layout(.:format) |
| route-controller | voltron_issues_fragments |
| route-action | issue_layout |
| fetch-nonce | v2:abb01d3f-4c82-0b3a-f9ae-7d2de36e5a32 |
| current-catalog-service-hash | 81bb79d38c15960b92d99bca9288a9108c7a47b18f2423d0f6438c5b7bcd2114 |
| request-id | DB96:69163:3B04BE:50E5DE:6AFB9874 |
| html-safe-nonce | f5792a95b8d8d5049bf3d23cd12bb02166ed2b04e0e5b31f459481259bdbe144 |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJEQjk2OjY5MTYzOjNCMDRCRTo1MEU1REU6NkFGQjk4NzQiLCJ2aXNpdG9yX2lkIjoiMjc2ODI3MjgwNjgwNDk1MzIwNCIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | 1c4c3d44fc8db800d9b29a78c0b56d5895b67fefab0d3c20c9e53d77c3e3be4c |
| hovercard-subject-tag | issue:6187984892 |
| github-keyboard-shortcuts | repository,issues,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/_view_fragments/issues/show/voidzero-dev/void/692/issue_layout |
| twitter:image | https://opengraph.githubassets.com/05c263b258e13c83992eba332439529d4b341138a6abdc4dce174aae75e3017c/voidzero-dev/void/issues/692 |
| twitter:card | summary_large_image |
| og:image | https://opengraph.githubassets.com/05c263b258e13c83992eba332439529d4b341138a6abdc4dce174aae75e3017c/voidzero-dev/void/issues/692 |
| og:image:alt | Motivation We run a self-hosted Void platform behind Cloudflare Access for LumiOS, an internal agent platform (the connected-app client from #631). LumiOS agents build small web apps for our users.... |
| og:image:width | 1200 |
| og:image:height | 600 |
| og:site_name | GitHub |
| og:type | object |
| og:author:username | sglyon |
| hostname | github.com |
| expected-hostname | github.com |
| None | 4f01efe06174a5ba6342fd58e42d02295e0675bedbb465d6bef2dbaec8e46556 |
| turbo-cache-control | no-preview |
| go-import | github.com/voidzero-dev/void git https://github.com/voidzero-dev/void.git |
| octolytics-dimension-user_id | 149750581 |
| octolytics-dimension-user_login | voidzero-dev |
| octolytics-dimension-repository_id | 1164437080 |
| octolytics-dimension-repository_nwo | voidzero-dev/void |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 1164437080 |
| octolytics-dimension-repository_network_root_nwo | voidzero-dev/void |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | false |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | a52db8866b6543b4e83730cd6a6b1360f1a9e4dc |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
| react-app-name | issues |
Links:
Viewport: width=device-width