Compare commits

...

8 Commits

Author SHA1 Message Date
Chris Farhood 11cbe6d7e0 docs: migrate Headlamp install namespace from kube-system to headlamp
Doc-only: redirect all references to Headlamp's own install
namespace from kube-system to headlamp, except:
- Driver namespace (CLAUDE.md) stays kube-system (upstream)
- CSI controller API paths (docs/architecture/overview.md) stay
  kube-system (upstream workload)

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-05-06 14:09:48 +00:00
Chris Farhood 40949dd3b5 fix: drop bogus direct lodash devDependency that conflicted with override
The rebase added "lodash": "4.18.1" as a direct devDependency alongside
the >=4.18.0 override, which npm rejects with EOVERRIDE during the
headlamp-plugin build step. The plugin source does not import lodash;
the override alone is sufficient to patch the transitive CVE.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-05-04 02:57:31 +00:00
Chris Farhood f3401bbea3 Regenerate lockfile for lodash override
- Explicitly add lodash@4.18.1 to ensure override is respected
- Regenerated pnpm-lock.yaml with resolved lodash@4.18.1 (CVE fix)

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-05-04 02:57:31 +00:00
privilegedescalation-engineer[bot] 0af2f24a27 fix: update vite to >=6.4.2 to patch arbitrary file read vulnerability (#28)
Vite versions >=6.0.0 <=6.4.1 are vulnerable to arbitrary file read via
the Vite Dev Server WebSocket (server.fs.deny bypass with queries).

CVE: GHSA-p9ff-h696-f583

Co-authored-by: Gandalf the Greybeard <gandalf@privilegedescalation.dev>
Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-03 17:44:12 +00:00
privilegedescalation-engineer[bot] 409efe84d5 fix: pass pr_number to dual-approval-check workflow (#27)
Companion PR to privilegedescalation/.github#81

Co-authored-by: Hugh Hackman <hugh@paperclip.ing>
Co-authored-by: Paperclip <noreply@paperclip.ing>
2026-04-15 03:33:22 +00:00
privilegedescalation-ceo[bot] a5032b23d1 Merge pull request #25 from privilegedescalation/fix/add-package-manager-field
fix: add packageManager field to package.json
2026-03-24 22:45:34 +00:00
privilegedescalation-engineer[bot] c241b8d9d5 release: v1.0.0 (#24)
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>
2026-03-24 22:31:55 +00:00
Gandalf the Greybeard 7ae5efda73 fix: add packageManager field to package.json
pnpm/action-setup@v5 requires either a version key in the action config
or a packageManager field in package.json. Add the field to unblock the
release workflow.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-03-24 22:12:38 +00:00
14 changed files with 873 additions and 786 deletions
+2
View File
@@ -16,3 +16,5 @@ jobs:
dual-approval: dual-approval:
uses: privilegedescalation/.github/.github/workflows/dual-approval-check.yaml@main uses: privilegedescalation/.github/.github/workflows/dual-approval-check.yaml@main
secrets: inherit secrets: inherit
with:
pr_number: ${{ github.event.pull_request.number }}
+3 -3
View File
@@ -91,7 +91,7 @@ metadata:
subjects: subjects:
- kind: ServiceAccount - kind: ServiceAccount
name: headlamp name: headlamp
namespace: kube-system # adjust to your Headlamp namespace namespace: headlamp # adjust to your Headlamp namespace
roleRef: roleRef:
kind: ClusterRole kind: ClusterRole
name: headlamp-tns-csi-reader name: headlamp-tns-csi-reader
@@ -143,7 +143,7 @@ The Kubernetes API server performs the pod proxy hop, so policies should permit
### Service Account (Default) ### Service Account (Default)
Headlamp runs with a dedicated service account (`headlamp` in `kube-system`). All users share the same RBAC permissions. Headlamp runs with a dedicated service account (`headlamp` in `headlamp`). All users share the same RBAC permissions.
**Security Considerations:** **Security Considerations:**
- All users have identical access to plugin functionality including Benchmark - All users have identical access to plugin functionality including Benchmark
@@ -223,7 +223,7 @@ All API requests are logged in Kubernetes API audit logs (if enabled). Pod proxy
"verb": "get", "verb": "get",
"requestURI": "/api/v1/namespaces/kube-system/pods/<controller-pod>/proxy/metrics", "requestURI": "/api/v1/namespaces/kube-system/pods/<controller-pod>/proxy/metrics",
"user": { "user": {
"username": "system:serviceaccount:kube-system:headlamp" "username": "system:serviceaccount:headlamp:headlamp"
} }
} }
``` ```
+2 -2
View File
@@ -13,7 +13,7 @@ license: Apache-2.0
category: storage category: storage
homeURL: https://github.com/privilegedescalation/headlamp-tns-csi-plugin homeURL: https://github.com/privilegedescalation/headlamp-tns-csi-plugin
appVersion: "0.17.3" appVersion: "0.17.4"
keywords: keywords:
- headlamp - headlamp
@@ -64,6 +64,6 @@ changes:
annotations: annotations:
headlamp/plugin/archive-url: "https://github.com/privilegedescalation/headlamp-tns-csi-plugin/releases/download/v1.0.0/tns-csi-1.0.0.tar.gz" headlamp/plugin/archive-url: "https://github.com/privilegedescalation/headlamp-tns-csi-plugin/releases/download/v1.0.0/tns-csi-1.0.0.tar.gz"
headlamp/plugin/archive-checksum: sha256:TBD-set-by-release-workflow headlamp/plugin/archive-checksum: sha256:e38846ceb17a79438f8aecc50f22920b0efa7456f3ebb3e628d89856af83ad01
headlamp/plugin/version-compat: ">=0.20.0" headlamp/plugin/version-compat: ">=0.20.0"
headlamp/plugin/distro-compat: "in-cluster,web,app" headlamp/plugin/distro-compat: "in-cluster,web,app"
+1 -1
View File
@@ -28,7 +28,7 @@ The TNS-CSI plugin is a single-page React application bundled as a Headlamp plug
│ HTTPS │ HTTPS
┌─────────────────────────────────────────────────────┐ ┌─────────────────────────────────────────────────────┐
│ Headlamp Pod (kube-system) │ │ Headlamp Pod (headlamp) │
│ │ │ │
│ Headlamp UI server + API proxy │ │ Headlamp UI server + API proxy │
│ (forwards requests using service account token │ │ (forwards requests using service account token │
+5 -5
View File
@@ -9,7 +9,7 @@ helm repo add headlamp https://headlamp-k8s.github.io/headlamp/
helm repo update helm repo update
helm install headlamp headlamp/headlamp \ helm install headlamp headlamp/headlamp \
--namespace kube-system \ --namespace headlamp \
--create-namespace \ --create-namespace \
--set config.pluginsDir=/headlamp/plugins \ --set config.pluginsDir=/headlamp/plugins \
--set pluginsManager.sources[0].name=tns-csi \ --set pluginsManager.sources[0].name=tns-csi \
@@ -44,7 +44,7 @@ Apply:
```bash ```bash
helm install headlamp headlamp/headlamp \ helm install headlamp headlamp/headlamp \
--namespace kube-system \ --namespace headlamp \
-f headlamp-values.yaml -f headlamp-values.yaml
``` ```
@@ -64,7 +64,7 @@ apiVersion: helm.toolkit.fluxcd.io/v2
kind: HelmRelease kind: HelmRelease
metadata: metadata:
name: headlamp name: headlamp
namespace: kube-system namespace: headlamp
spec: spec:
interval: 1h interval: 1h
chart: chart:
@@ -122,7 +122,7 @@ metadata:
subjects: subjects:
- kind: ServiceAccount - kind: ServiceAccount
name: headlamp name: headlamp
namespace: kube-system namespace: headlamp
roleRef: roleRef:
kind: ClusterRole kind: ClusterRole
name: headlamp-tns-csi-reader name: headlamp-tns-csi-reader
@@ -136,7 +136,7 @@ To upgrade to a new plugin version, update the `url` in your values and apply:
```bash ```bash
helm upgrade headlamp headlamp/headlamp \ helm upgrade headlamp headlamp/headlamp \
--namespace kube-system \ --namespace headlamp \
-f headlamp-values.yaml -f headlamp-values.yaml
``` ```
+1 -1
View File
@@ -32,7 +32,7 @@ apiVersion: helm.toolkit.fluxcd.io/v2
kind: HelmRelease kind: HelmRelease
metadata: metadata:
name: headlamp name: headlamp
namespace: kube-system namespace: headlamp
spec: spec:
chart: chart:
spec: spec:
+3 -3
View File
@@ -34,7 +34,7 @@ pluginsManager:
Then upgrade your Headlamp release: Then upgrade your Headlamp release:
```bash ```bash
helm upgrade headlamp headlamp/headlamp -f values.yaml -n kube-system helm upgrade headlamp headlamp/headlamp -f values.yaml -n headlamp
``` ```
## Step 2: Configure RBAC ## Step 2: Configure RBAC
@@ -70,7 +70,7 @@ metadata:
subjects: subjects:
- kind: ServiceAccount - kind: ServiceAccount
name: headlamp name: headlamp
namespace: kube-system namespace: headlamp
roleRef: roleRef:
kind: ClusterRole kind: ClusterRole
name: headlamp-tns-csi-reader name: headlamp-tns-csi-reader
@@ -78,7 +78,7 @@ roleRef:
EOF EOF
``` ```
Adjust `name: headlamp` and `namespace: kube-system` to match your Headlamp service account. Adjust `name: headlamp` and `namespace: headlamp` to match your Headlamp service account.
## Step 3: Verify ## Step 3: Verify
+2 -2
View File
@@ -77,7 +77,7 @@ If a page shows a loading spinner indefinitely:
1. **Check browser console** for errors (F12 → Console) 1. **Check browser console** for errors (F12 → Console)
2. **Check network tab** for failed API requests (look for 403, 404, 500) 2. **Check network tab** for failed API requests (look for 403, 404, 500)
3. **Check Headlamp pod logs**: `kubectl logs -n kube-system -l app.kubernetes.io/name=headlamp` 3. **Check Headlamp pod logs**: `kubectl logs -n headlamp -l app.kubernetes.io/name=headlamp`
4. **Try refreshing** — the watch connection may have been interrupted 4. **Try refreshing** — the watch connection may have been interrupted
## Common API Errors ## Common API Errors
@@ -102,7 +102,7 @@ Look for errors related to `tns-csi`, `headlamp-plugin`, or Kubernetes API paths
**Headlamp pod logs:** **Headlamp pod logs:**
```bash ```bash
kubectl logs -n kube-system -l app.kubernetes.io/name=headlamp --tail=100 kubectl logs -n headlamp -l app.kubernetes.io/name=headlamp --tail=100
``` ```
**tns-csi controller logs:** **tns-csi controller logs:**
+2 -2
View File
@@ -8,10 +8,10 @@ The Benchmark page requires permissions to create and delete Jobs and PVCs:
```bash ```bash
kubectl auth can-i create jobs -n <benchmark-namespace> \ kubectl auth can-i create jobs -n <benchmark-namespace> \
--as=system:serviceaccount:kube-system:headlamp --as=system:serviceaccount:headlamp:headlamp
kubectl auth can-i create persistentvolumeclaims -n <benchmark-namespace> \ kubectl auth can-i create persistentvolumeclaims -n <benchmark-namespace> \
--as=system:serviceaccount:kube-system:headlamp --as=system:serviceaccount:headlamp:headlamp
``` ```
Apply the additional permissions if missing — see [RBAC Issues](rbac.md) or [SECURITY.md](../../SECURITY.md). Apply the additional permissions if missing — see [RBAC Issues](rbac.md) or [SECURITY.md](../../SECURITY.md).
+1 -1
View File
@@ -47,7 +47,7 @@ This requires `get` on `pods/proxy` in `kube-system`:
```bash ```bash
kubectl auth can-i get pods/proxy \ kubectl auth can-i get pods/proxy \
-n kube-system \ -n kube-system \
--as=system:serviceaccount:kube-system:headlamp --as=system:serviceaccount:headlamp:headlamp
``` ```
### 5. Network Policies ### 5. Network Policies
+3 -3
View File
@@ -11,16 +11,16 @@ Use `kubectl auth can-i` to check specific permissions:
```bash ```bash
# Check if the Headlamp service account can list StorageClasses # Check if the Headlamp service account can list StorageClasses
kubectl auth can-i list storageclasses \ kubectl auth can-i list storageclasses \
--as=system:serviceaccount:kube-system:headlamp --as=system:serviceaccount:headlamp:headlamp
# Check pod proxy access (for metrics) # Check pod proxy access (for metrics)
kubectl auth can-i get pods/proxy \ kubectl auth can-i get pods/proxy \
-n kube-system \ -n kube-system \
--as=system:serviceaccount:kube-system:headlamp --as=system:serviceaccount:headlamp:headlamp
# Check snapshot access # Check snapshot access
kubectl auth can-i list volumesnapshots \ kubectl auth can-i list volumesnapshots \
--as=system:serviceaccount:kube-system:headlamp --as=system:serviceaccount:headlamp:headlamp
``` ```
### Applying the Required RBAC ### Applying the Required RBAC
+2 -2
View File
@@ -47,7 +47,7 @@ metadata:
subjects: subjects:
- kind: ServiceAccount - kind: ServiceAccount
name: headlamp # adjust to your Headlamp service account name name: headlamp # adjust to your Headlamp service account name
namespace: kube-system # adjust to your Headlamp namespace namespace: headlamp # adjust to your Headlamp namespace
roleRef: roleRef:
kind: ClusterRole kind: ClusterRole
name: headlamp-tns-csi-reader name: headlamp-tns-csi-reader
@@ -99,7 +99,7 @@ metadata:
subjects: subjects:
- kind: ServiceAccount - kind: ServiceAccount
name: headlamp name: headlamp
namespace: kube-system namespace: headlamp
roleRef: roleRef:
kind: Role kind: Role
name: headlamp-tns-csi-benchmark name: headlamp-tns-csi-benchmark
+3 -1
View File
@@ -12,6 +12,7 @@
"homepage": "https://github.com/privilegedescalation/headlamp-tns-csi-plugin#readme", "homepage": "https://github.com/privilegedescalation/headlamp-tns-csi-plugin#readme",
"author": "privilegedescalation", "author": "privilegedescalation",
"license": "Apache-2.0", "license": "Apache-2.0",
"packageManager": "pnpm@10.32.1",
"scripts": { "scripts": {
"start": "headlamp-plugin start", "start": "headlamp-plugin start",
"build": "headlamp-plugin build", "build": "headlamp-plugin build",
@@ -49,6 +50,7 @@
}, },
"overrides": { "overrides": {
"tar": "^7.5.11", "tar": "^7.5.11",
"undici": "^7.24.3" "undici": "^7.24.3",
"vite": ">=6.4.2"
} }
} }
+843 -760
View File
File diff suppressed because it is too large Load Diff