docs(ci): record P05 OIDC run 90 forwarder blocker and verified cleanup

This commit is contained in:
Vib Tools committed 2026-11-22 09:26:24 -08:00
1 parent cbcd60e76e
commit b78270e9d4
17 files changed
+84 -8

No files matched your search

+1 -1
View File
@@ -15,6 +15,6 @@ This is the chronological **index**. Phase-specific scope/implementation evidenc
| 2026-11-22 | P05-SEC-01 | Next.js 16.4.6, compatible OTel instrumentation, frozen locks and strict advisory gates | Run #87: 3 PASS/1 FAIL; 17/19 prior findings no longer reported, 2 Moderate Login blockers. [Evidence](P05-SEC-01.md) |
| 2026-11-22 | P05-SEC-02 | Seven scoped parent overrides for glob/minimatch, pinned PNPM lock; one focused Gitea run | Run #88: Login security 0 findings PASS, build gate FAIL before frozen install on CI helper false-positive. Post-run regex fix unverified; [evidence](P05-SEC-02.md) |
| 2026-11-22 | P05-SEC-02-A01 | One-run final acceptance of corrected CI parser and unchanged Login lockfile/seven overrides | **Run #89 SUCCESS** on `ff4c58e`: frozen install, standalone build and upstream 1219/1219 tests PASS; audit 0 Moderate/High/Critical; Account jobs skipped. [Evidence](P05-SEC-02-A01.md) |
| 2026-11-22 | P05-OIDC-01 | Real disposable ZITADEL OIDC client/user, Chromium original Login V2/Auth.js callback/identity and owned-only cleanup | Source prepared; one focused Gitea run pending; [scope/evidence](P05-OIDC-01.md) |
| 2026-11-22 | P05-OIDC-01 | CI-only official ZITADEL OIDC project/client/user and Chromium original Login V2/Auth.js acceptance harness with owned cleanup | **Run #90 FAILED**: 4 services healthy, no host ports; private localhost:8080 forwarder not ready, no user/client/browser created; cleanup VERIFIED PASS. [Evidence](P05-OIDC-01.md) |
Rules: Append new phases or fixes; never silently rewrite a past result. Separate **implemented**, **verified**, **blocked**, and **proposed**. Never log a user secret or personal data.
+1 -1
View File
@@ -11,7 +11,7 @@
| [P05-SEC-01.md](P05-SEC-01.md) | Pre-change security scope, remediation, exact advisory evidence, one CI run and closure | P05-SEC-01 / Run #87 completed, 2 Moderate open |
| [P05-SEC-02.md](P05-SEC-02.md) | Exact root chain, seven PNPM parent overrides, one focused Gitea CI and closure evidence | P05-SEC-02 / Run #88 security PASS, build blocked; parser post-run patch unverified |
| [P05-SEC-02-A01.md](P05-SEC-02-A01.md) | Single-run Login-only final frozen/build/unit/security acceptance, scope lock and evidence | P05-SEC-02-A01 / Run #89 SUCCESS, accepted |
| [P05-OIDC-01.md](P05-OIDC-01.md) | Pre-change real browser OIDC Scope Lock, provision/redirect/session/negative tests and one CI run evidence | P05-OIDC-01 / implementation prepared, real CI pending |
| [P05-OIDC-01.md](P05-OIDC-01.md) | Pre-change real browser OIDC Scope Lock, provision/redirect/session/negative tests and one CI run evidence | P05-OIDC-01 / Run #90 FAILED at forwarder readiness; cleanup PASS; acceptance BLOCKED |
| [CHANGELOG.md](CHANGELOG.md) | Short append-only chronological phase log and links to detailed reports | DOCS-01 / active |
Update this manifest whenever any direct child file or directory changes. Use **actual source state**; a planned file must be labeled planned, not present.
+27 -1
View File
@@ -2,7 +2,7 @@
**Date:** 2026-11-22
**User-approved baseline:** `f423c696544f28a42d6a5d1ad0acfd88a3b6f56d` on Gitea `vibtools/ZitPlane/main`.
**Pre-implementation state:** APPROVED / SCOPE LOCKED — this planning record is written before any CI implementation edits.
**Phase status:** IMPLEMENTED IN SOURCE / ONE GITEA RUN #90 COMPLETED **FAILURE**. Real OIDC client/user/browser acceptance **BLOCKED** by private localhost:8080 forwarder readiness. Mandatory cleanup PASS. This plan was written before source edits.
**Prior verified evidence:** Run #86 disposable backend/JWKS/DB persistence/teardown PASS; Run #87 Account build/security and negative authorization PASS; Run #89 Login V2 frozen standalone build/1219 tests and zero Moderate+ audit PASS. None proved a real authorization callback with a human user.
## Exact approved write scope and hard boundaries
@@ -41,3 +41,29 @@ No local application installs/builds/tests/dev servers/Docker. No production dep
- `GET /api/account/me` returns actual newly created user ID with private/no-store; protected Account page accessible with session, anonymous denied; malicious callback/session/issuer state rejected.
- **Always-run** owned container/volume/network/credential cleanup verified.
- No unauthorized repo changes, local builds/tests, fake PASS or production deployment. MFA/passkeys and production TLS **out of scope** unless actually verified with real flows; must remain deferred.
## One focused Gitea CI cycle — actual terminal result, 2026-11-22
**Single authorized run:** [Gitea Run #90](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/90), job **#197**, tested **source SHA `cbcd60e76ec909df4f9c5826adf7a3e2a899c73e`**. `workflow_dispatch` on `main`. Created 2026-11-22 17:17:37 UTC; terminal 17:20:07 UTC. **Overall status completed, conclusion FAILURE.** No second CI run. Last commit after this run, if present, contains **only result documentation**, not a new verified source candidate.
| Job step | Result | Source-backed exact evidence |
| --- | --- | --- |
| Install Git before checkout and actions/checkout@v4 | **PASS** | Gitea job #197 steps #0/#1 both success |
| Docker daemon + numeric run-owned preflight | **PASS** | `ZITPLANE_OIDC_DOCKER_PREFLIGHT_PASS` |
| Portless Compose/CI IAM_OWNER configuration | **PASS** | `ZITPLANE_OIDC_NO_PUBLISHED_PORT_AND_OWNER_CONFIG_PASS`; no runner host port |
| Disposable PostgreSQL, ZITADEL API, official Login V2 and Traefik health | **PASS** | Four containers healthy, `ZITPLANE_OIDC_FOUR_SERVICES_READY_PASS` |
| CI-only private namespace localhost:8080 loopback forwarder readiness | **FAIL / BLOCKER** | `ZITPLANE_OIDC_PROVISION_BLOCKED: Disposable localhost issuer port forwarding was not ready` (~17:19:54 UTC) |
| Real OIDC project/client/user API provisioning | **NOT EXECUTED** | `provision.py::wait_until_ready()` timed out first, before any API create request |
| Real Chromium/Login V2/PKCE/state/nonce/authorization-code/Account session/negative browser checks | **NOT EXECUTED** | No project, client or human created; browser never started |
| `always()` owned Docker cleanup job step #3 | **PASS** | `ZITPLANE_BACKEND_CLEANUP_VERIFIED_PASS`; `ZITPLANE_OIDC_ALL_RESOURCES_CLEANED_PASS` (~17:19:59 UTC); job cleanup step final success |
### Exact blocker, boundaries and remediation candidate
The CI code used a run-owned detached `alpine:3.21` sidecar sharing the proxy container network namespace and attempted `apk add --no-cache socat` (stdout/stderr suppressed) before starting a loopback listener from `127.0.0.1:8080` to proxy:80. The helper saw no working local endpoint within its bounded 70-second readiness poll. **The actual root cause is not yet proven**: the sidecar might have exited (e.g. package installation) or its listener/Traefik forwarding/Host routing could have failed. Because the sidecar's installation output was suppressed, **there is no diagnostic evidence proving which one**. This cannot be attributed to Auth.js, PKCE, user credentials or OIDC endpoints; none was exercised.
**Proposed P05-OIDC-02:** explicitly approve narrow CI-only `tests/ci/oidc_e2e/run.sh`, `provision.py` and, only if necessary, `cleanup.sh` changes to diagnose the run-owned sidecar's actual exit/running/listening state, prefer an immutable/pinned prebuilt socat image rather than first-installing a package after container start, verify local loopback readiness and exact issuer/Host routing before provisioning. Keep no host port, no leaked credentials or sensitive URLs, unchanged app/backend/Compose/PNPM source, and owned-only cleanup. Perform a **new separately approved single Gitea cycle** to test genuine provisioning and browser login; do not bypass authentication to satisfy it.
### Phase closure
**P05-OIDC-01 CI harness source IMPLEMENTED; interactive OIDC acceptance BLOCKED** on isolated network forwarding. **Safe CI-owned cleanup VERIFIED**, no resources left from run #90. All positive authenticated user/client/browser tests **UNVERIFIED**; MFA/passkey and production HTTPS/Console remain outside scope. Zero local app installs/builds/tests, no real identities/production deployment or source edits after Run #90. Unrelated untracked `AI_INSTRUCTIONS.md` untouched.