Skip to content

Commit ff6dcb3

Browse files
committed
feat(auth): add SPIFFE supervisor authentication
Signed-off-by: Taylor Mutch <taylormutch@gmail.com>
1 parent f4daea6 commit ff6dcb3

35 files changed

Lines changed: 1085 additions & 237 deletions

File tree

‎.agents/skills/debug-openshell-cluster/SKILL.md‎

Lines changed: 16 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -126,6 +126,22 @@ If the gateway exits with `failed to read sandbox JWT signing key from
126126
`sandbox-jwt` secret at `/etc/openshell-jwt`. The sandbox JWT mount is required
127127
even when local Helm values disable TLS.
128128

129+
If `server.spiffe.enabled=true`, the sandbox JWT ConfigMap block and
130+
`sandbox-jwt` StatefulSet mount are intentionally omitted. Instead verify that
131+
SPIRE is installed, the CSI driver is available, and the gateway pod mounts the
132+
SPIFFE Workload API socket:
133+
134+
```bash
135+
helm -n openshell get values openshell | grep -E 'spiffe|trustDomain|workloadApiSocketPath'
136+
kubectl get pods -A | grep -E 'spire|spiffe'
137+
kubectl -n openshell get statefulset openshell -o yaml | grep -E 'spiffe-workload-api|csi.spiffe.io'
138+
```
139+
140+
Sandbox pods in SPIFFE mode should have `openshell.io/sandbox-id` and
141+
`openshell.io/spiffe-id` annotations, an `openshell.ai/managed-by=openshell`
142+
label, and supervisor env vars `OPENSHELL_SPIFFE_WORKLOAD_API_SOCKET`,
143+
`OPENSHELL_SPIFFE_AUDIENCE`, and `OPENSHELL_SPIFFE_ID`.
144+
129145
Check the image references currently used by the gateway deployment:
130146

131147
```bash

‎.agents/skills/helm-dev-environment/SKILL.md‎

Lines changed: 17 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -169,6 +169,21 @@ To remove Keycloak:
169169
mise run keycloak:k8s:teardown
170170
```
171171

172+
### SPIRE / SPIFFE Sandbox Identity
173+
174+
Skaffold can install SPIRE with the SPIFFE hardened Helm charts. To activate
175+
SPIFFE JWT-SVID supervisor authentication:
176+
177+
1. Uncomment the `spire-crds` and `spire` releases in `deploy/helm/openshell/skaffold.yaml`
178+
2. Uncomment `#- ci/values-spire.yaml` in the OpenShell release values files
179+
3. Redeploy: `mise run helm:skaffold:run`
180+
181+
`ci/values-spire-stack.yaml` configures the local SPIRE trust domain as
182+
`openshell.local` and adds a `ClusterSPIFFEID` that maps sandbox pod
183+
annotations to `spiffe://openshell.local/openshell/sandbox/<sandbox-id>`.
184+
OpenShell mounts the SPIFFE CSI Workload API socket at
185+
`/spiffe-workload-api/spire-agent.sock`.
186+
172187
---
173188

174189
## Cluster Lifecycle (suspend/resume)
@@ -196,6 +211,8 @@ mise run helm:k3s:status
196211
| `deploy/helm/openshell/ci/values-cert-manager.yaml` | cert-manager PKI overlay (opt-in; disables pkiInitJob) |
197212
| `deploy/helm/openshell/ci/values-gateway.yaml` | Envoy Gateway GRPCRoute + Gateway overlay |
198213
| `deploy/helm/openshell/ci/values-keycloak.yaml` | Keycloak OIDC overlay |
214+
| `deploy/helm/openshell/ci/values-spire.yaml` | SPIFFE/SPIRE sandbox supervisor auth overlay |
215+
| `deploy/helm/openshell/ci/values-spire-stack.yaml` | SPIRE hardened chart values for local dev |
199216
| `deploy/helm/openshell/ci/values-tls-disabled.yaml` | Lint-only: TLS + auth disabled (reverse-proxy edge termination) |
200217
| `deploy/kube/manifests/envoy-gateway-openshell.yaml` | GatewayClass for Envoy Gateway (`mise run helm:gateway:apply`) |
201218
| `tasks/scripts/helm-k3s-local.sh` | k3d cluster create/delete/start/stop/status |

‎.markdownlint-cli2.jsonc‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -16,6 +16,7 @@
1616
".claude/**",
1717
".opencode/**",
1818
".github/**",
19+
"architecture/plans/**",
1920
"**/node_modules/**",
2021
"target/**",
2122
".pytest_cache/**",

0 commit comments

Comments
 (0)