docs(security): document the S11 kill-switch refusal codes and operator recovery
I maintainer di solito rispondono entro 1 giorno
Nessuno ha ancora preso questa issue.
Valutazione
- Difficoltà
- 2/5
- Tempo stimato
- 1-3 ore
- Idoneità per principianti
- 70/100
- Tipo di issue
- Documentazione
- Chiarezza
- Specificata chiaramente
- Stato di attività
- Attiva
- Ambito
- cli, documentation, security
Direzione di ricerca
Inizia da §10.2 (Kill switch) in docs/security/agent-principals.md, poi leggi il codice unito nella PR #9220 (commit 2373ec835) per confermare i percorsi di rifiuto PERSIST_UNCONFIRMED e TOO_MANY_LABELS e la lettura di principals-disabled.json all'avvio. Confronta il testo di aiuto di chroxy agent con il documento. È completato quando §10.2 nomina entrambi i codici con le relative azioni dell'operatore, indica il limite di 256 label, descrive la lettura fail-closed all'avvio e il ripristino con chroxy agent enable --all, e il testo di aiuto è coerente.
Scritto dal modello di indicizzazione a partire dal testo della issue.
Descrizione
Context
Identified during review of PR #9220 (S11 of #9112, merged as 2373ec835).
Location: docs/security/agent-principals.md §10.2 (Kill switch)
Description
The kill switch that PR #9220 added returns two refusal codes the operator contract does not name yet. The doc also does not describe how to recover from a bad flag file found at boot.
PERSIST_UNCONFIRMED(fromprincipal_admin_enable/chroxy agent enable): the enable was written, but the write was not confirmed durable (for example, the directory fsync failed).- The daemon stays disabled.
- Because the flag file may already read "enabled", a restart could apply it.
- Operator action: run
enableagain once the disk is healthy, or rundisableto make the disabled state durable.
TOO_MANY_LABELS(fromprincipal_admin_disable --label): the label set would exceed the 256-label bound that the writer and the boot reader share. Nothing is written.- Operator action: use
--all.
- Operator action: use
- Boot recovery: an unreadable, corrupt, untrusted (mode, owner or symlink) or oversized
principals-disabled.jsonfails closed to "disabled for all".- The documented recovery is
chroxy agent enable --all.
- The documented recovery is
Acceptance Criteria
- §10.2 names
PERSIST_UNCONFIRMEDandTOO_MANY_LABELS, each with its operator action. - §10.2 states the 256-label bound.
- §10.2 describes the fail-closed boot read and the
chroxy agent enable --allrecovery path. - The
chroxy agenthelp text and the doc agree. - Docs only, with no behaviour change.
- Lingua principale
- JavaScript
- Stelle
- 7
- Fork
- 1
- Merge medio
- 2h 19m
- PR unite (30g)
- 263
Preparare l'ambiente
- Include un Dockerfile o un file Docker Compose
- Nessun modello di pull request
- Leggi la guida per i contributori
Come iniziare
- Leggi tutta la issue e poi la guida ai contributi del progetto.
- Commenta sulla issue per dire che te ne occupi tu — evita che due persone facciano lo stesso lavoro.
- Fai un fork del repository e lavora su un branch.
- Apri una pull request che faccia riferimento al numero della issue.
Altre issue di blamechris/chroxy
-
priority: low server testing
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 88/100
blamechris/chroxy#9277 ·
I maintainer di solito rispondono entro 1 giorno
-
bug
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
blamechris/chroxy#9272 ·
I maintainer di solito rispondono entro 1 giorno
-
complexity: low dashboard enhancement from-review
Difficoltà 2/5 1-3 ore Idoneità per principianti 60/100
blamechris/chroxy#9271 ·
I maintainer di solito rispondono entro 1 giorno
-
bug server
Difficoltà 2/5 1-3 ore Idoneità per principianti 78/100
blamechris/chroxy#9248 ·
I maintainer di solito rispondono entro 1 giorno
-
enhancement from-review
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
blamechris/chroxy#9232 ·
I maintainer di solito rispondono entro 1 giorno
Tutte le issue di blamechris/chroxy
Issue simili
-
Difficoltà 2/5 1-3 ore Idoneità per principianti 72/100
cytoscape/cytoscape.js#3597 ·
I maintainer di solito rispondono entro 5 giorni
-
Difficoltà 1/5 Meno di un'ora Idoneità per principianti 72/100
sunososobro-hub/cloudball#191 ·
I maintainer di solito rispondono entro 1 giorno
-
[MCP]: page snapshots in .playwright-mcp/ are not git-ignored (.playwright-cli/ is, since #42318)Aperta
Difficoltà 2/5 1-3 ore Idoneità per principianti 62/100
microsoft/playwright#44289 ·
I maintainer di solito rispondono entro 1 giorno
-
Wire ISO post: has() accepts text values such as an empty string, true or 0x1A for wire numbersApertaarea:post effort:low enhancement P7 source:agent
Difficoltà 2/5 1-3 ore Idoneità per principianti 68/100
I maintainer di solito rispondono entro 1 giorno
-
marketing
Difficoltà 2/5 Mezza giornata Idoneità per principianti 78/100
I maintainer di solito rispondono entro 1 giorno