Watch
0
0
Fork
You've already forked hyperhive
0

security handbook: say the repo limit in operator terms

This commit is contained in:
atlas 2026-11-16 00:37:43 +01:00 • committed by mara
commit c9604a6708

View file

@ -129,15 +129,16 @@ checkpoints**, not about sandboxing the agent from its own tools:
settings nor merge its own PR. It's **not** set up for external VCS (GitHub settings nor merge its own PR. It's **not** set up for external VCS (GitHub
etc.), though — there, operator-merge is process + accepted risk, not a etc.), though — there, operator-merge is process + accepted risk, not a
technical control. technical control.
- **Repo creation is a per-agent setting, default 0** — the _repositories_ badge - **Repo creation is a per-agent setting, default 0** — an agent's card has a
in an agent's card sets how many repos that agent's forge account may create _repositories_ limit on its permissions panel: how many repos that agent may
(`max_repos` in its permissions record, Forgejo's `max_repo_creation`, 0 to create. The default is 0, so the operator must raise it for an agent before
100). The operator must raise it for that agent before it may create any. Agents never create organizations: the that agent may create any. Agents never create organizations. A repo an agent
controller turns that off on every agent account. A repo an agent creates is creates is its own, so the operator-merge gate doesn't cover it, and the
its own, so the operator-merge gate doesn't cover it, and the agent can add a agent can add a CI workflow to it. CI workflows run unsandboxed on the CI
CI workflow to it. CI workflows run unsandboxed on the CI runner, which is runner, which is arbitrary code on the runner host. Allow repo creation only
arbitrary code on the runner host. Allow repo creation only for agents you for agents you would trust with that. The record field and the forge setting
would trust with that. behind the limit are in the [permissions
conventions](../../5-project/process/conventions.md#permissions).
- **Operator sign-off** — config changes are config PRs an operator merges - **Operator sign-off** — config changes are config PRs an operator merges
on the forge (see on the forge (see
[`persistence.md`](persistence.md#config-changes)), and [`persistence.md`](persistence.md#config-changes)), and