forked from bchanot/claude
job7 step A: MAGIC_API_KEY by reference, not by value (BDR-026 follow-up)
toggle-external.sh's `claude mcp add magic --env API_KEY="$MAGIC_API_KEY"`
materialized the key as plaintext into ~/.claude.json — a copy outside the
~/.claude/.env canonical, invisible to the repo's gitignore/allowlist reach.
Claude Code supports ${VAR} expansion in mcpServers config (docs confirmed),
so the fix is a reference, not a scrub.
- lib/toggle-external.sh: --env 'API_KEY=${MAGIC_API_KEY}' (single-quoted
literal reference, not bash-expanded) so future `enable magic` runs write
the safe form too.
- README: new "Adding an MCP server that needs a secret" section documenting
the --env pitfall and the wrapper pattern.
Out-of-repo companion changes (not in this commit): ~/.bashrc gained a
scoped claude() wrapper that sources ~/.claude/.env into a subshell before
exec'ing the real binary (verified: the var never reaches the ambient
interactive shell, only claude + children) — chosen over a global export to
keep the secret's surface minimal. ~/.claude.json's mcpServers.magic.env.API_KEY
was rewritten to the same "${MAGIC_API_KEY}" reference via a surgical jq
edit (never read directly, so the value never entered this session's
context). The 2 of 5 rotating ~/.claude/backups/.claude.json.backup.* files
still holding the old plaintext were scrubbed the same way.
Residual: this session predates the bashrc wrapper, so `claude mcp list`
currently warns "Missing environment variables: MAGIC_API_KEY" — expected,
resolves on next terminal + Claude Code restart. MAGIC_API_KEY rotation
still pending (user action, after this commit).
This commit is contained in:
+24
-10
@@ -17,16 +17,30 @@ manipuler une valeur de secret — edits sur les mécanismes seulement.
|
||||
Décision utilisateur : wiring `MAGIC_API_KEY` → wrapper `claude()` scopé
|
||||
dans `~/.bashrc` (source `.env` en subshell, jamais exporté globalement)
|
||||
plutôt qu'un export global (surface minimale, cohérent BDR-026).
|
||||
- [ ] `~/.bashrc` : fonction `claude()` wrapper (subshell source ~/.claude/.env)
|
||||
- [ ] `~/.claude.json` mcpServers.magic.env.API_KEY → `"${MAGIC_API_KEY}"`
|
||||
(diff keys-only montré avant écriture)
|
||||
- [ ] `lib/toggle-external.sh:191-192` — `--env API_KEY='${MAGIC_API_KEY}'`
|
||||
(référence littérale, pas expansion bash) pour que les futurs
|
||||
`enable magic` écrivent aussi la forme référence
|
||||
- [ ] Doc README : procédure "ajouter un MCP avec secret" + piège `--env`
|
||||
- [ ] Vérif manuelle : `claude mcp list` / relancer un MCP magic réel si possible
|
||||
- [ ] A.3 Scrub one-shot des 5 backups `.claude.json.backup.*` existants
|
||||
(prefix 78af0e36 hors `.env`) — script ou sed ciblé, vérif grep 0 hors .env
|
||||
- [x] `~/.bashrc` : fonction `claude()` wrapper (subshell source ~/.claude/.env,
|
||||
exec — vérifié : la var n'atteint QUE le subshell/exec, jamais le shell
|
||||
parent). Hors repo (dotfile perso).
|
||||
- [x] `~/.claude.json` mcpServers.magic.env.API_KEY → `"${MAGIC_API_KEY}"`
|
||||
(diff keys-only montré avant écriture ; jq surgical edit, jamais Read
|
||||
direct — la valeur n'a jamais traversé mon contexte). Backup fait
|
||||
pendant l'édition supprimé aussitôt vérifié (aurait été un 6e leak).
|
||||
- [x] `lib/toggle-external.sh:191-192` — `--env 'API_KEY=${MAGIC_API_KEY}'`
|
||||
(référence littérale, single-quoted). `claude mcp add` direct au flag
|
||||
bloqué par le classifieur auto-mode (self-modification non sollicitée,
|
||||
respecté) — non testé live ; `claude mcp list` confirme la syntaxe
|
||||
est bien reconnue ("Missing environment variables: MAGIC_API_KEY" —
|
||||
attendu, cette session a démarré avant le wrapper bashrc).
|
||||
- [x] Doc README : section "Adding an MCP server that needs a secret" +
|
||||
piège `--env` + pattern wrapper à copier
|
||||
- [x] Vérif manuelle : `claude mcp list` (read-only) — magic reconnaît
|
||||
`${MAGIC_API_KEY}`, encore connecté (session pré-existante) ; nécessite
|
||||
un restart terminal (source ~/.bashrc) + Claude Code pour confirmer
|
||||
end-to-end — **résiduel, à faire par l'utilisateur**
|
||||
- [x] A.3 Scrub backups `.claude.json.backup.*` — les 5 originaux (78af0e36 @
|
||||
job7 triage) déjà auto-rotés (ring-buffer natif) ; des 5 COURANTS, 2
|
||||
encore en clair (créés avant le fix, pendant cette session) → scrubbés
|
||||
jq (mode 600 restauré, changé par erreur via mv). grep 78af0e36 : 0 hors
|
||||
`.env` (backups + .claude.json confirmés propres).
|
||||
- [ ] A.4 Signaler à l'utilisateur : rotation MAGIC maintenant (après commit A)
|
||||
- [x] B. Redaction dumps d'env — `hooks/rtk-rewrite.sh` étendu : pipeline simple
|
||||
(pas de `;`/`&`/`||`) + `printenv`/`env` en tête sans `VAR=... cmd` derrière
|
||||
|
||||
Reference in New Issue
Block a user