docs(ci): record OIDC run 91 forwarder exit and safe cleanup
This commit is contained in:
1 parent
4831165548
commit
5f542a6aa3
20 files changed
+81
-9
No files matched your search
@@ -30,3 +30,6 @@ See `notes/P05-CI-01.md` and `tests/ci/`.
|
||||
|
||||
|
||||
**P05-OIDC-01 final result:** [Gitea Run #90](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/90) on `cbcd60e` **FAILURE**. Manual-only P02 backend 4/4 healthy and host-portless PASS; run-labeled private localhost:8080 TCP forwarder readiness FAILED before any official OIDC client/human provisioning and before Chromium browser/auth callback. `always()` cleanup **PASS** (`ZITPLANE_BACKEND_CLEANUP_VERIFIED_PASS`, `ZITPLANE_OIDC_ALL_RESOURCES_CLEANED_PASS`). No repeat CI cycle. Next narrowly approved P05-OIDC-02 needed to determine whether sidecar exited, failed installing socat or could not bind/forward/rout; no authenticated OIDC E2E proof.
|
||||
|
||||
|
||||
**P05-OIDC-02 final Gitea acceptance:** Manual Run #91, tested `4831165548feabc2c0a0d39d25c40e0d1bc23bb2`, overall **FAILURE**. Four backend services, no host port, private Traefik:80/Host HTTP routing and versioned prebuilt socat entrypoint/digest checks PASS; run-labeled sidecar `exited` with code **1**, so no OIDC client/user/browser request or Auth.js callback was tested. Always-run exact resource cleanup **PASS**, no second CI run. Next P05-OIDC-03 must safely classify the pre-provisioning forwarder process exit, keeping actual user authentication untouched.
|
||||
@@ -14,7 +14,7 @@ Compact, developer-friendly monorepo for a central identity service, a branded l
|
||||
- **P05-SEC-02:** Seven parent-scoped PNPM overrides resolved `glob`/`minimatch` advisories. Gitea Run #88 Login production audit **0 Moderate/High/Critical PASS**, but Login frozen install/build/units **NOT RUN** because a new CI override validator misparsed existing `>=` version ranges; post-run regex correction **not CI-verified**. Full acceptance **BLOCKED** pending a separately approved focused CI run. Account jobs intentionally skipped. See `docs/P05-SEC-02.md`.
|
||||
- **P05-SEC-02-A01:** **Gitea Run #89 SUCCESS** on `ff4c58e`: corrected exact override contract PASS, pinned PNPM frozen install PASS, official Login V2 standalone build PASS, upstream Vitest **1219/1219 PASS**, Login production audit **0 Moderate/High/Critical**; Account jobs skipped. **Dependency security/build unit acceptance complete; real user OIDC/MFA E2E and production integration NOT verified**. See `docs/P05-SEC-02-A01.md`.
|
||||
- **P05-OIDC-01:** Gitea **Run #90 FAILED**: disposable four-service ZITADEL stack healthy and host-portless, but private `localhost:8080` loopback forwarding was not ready. Provisioning aborted before OIDC client/human/browser creation; real callback/session **NOT verified**. Owned database/bootstrap/secret/network cleanup **PASS**. No app/auth source change or deployment. See `docs/P05-OIDC-01.md`.
|
||||
- **P05-OIDC-02:** Approved targeted CI-only forwarder remediation after Run #90: versioned prebuilt socat verified and digest-pinned on runner, private proxy and listener status/HTTP 200 gate, correct provisioner status-only readiness; **real OIDC CI pending**, no app/auth source changes. See `docs/P05-OIDC-02.md`.
|
||||
- **P05-OIDC-02:** **Gitea Run #91 FAILURE**: original four backend services and no-host-port private Traefik Host routing PASS, prebuilt socat version/digest PASS; forwarder immediately **exited with code 1**, so client/user/browser/Auth.js callback NOT EXECUTED. Cleanup PASS. No application/auth/backend edits; real OIDC remains BLOCKED. See `docs/P05-OIDC-02.md`.
|
||||
- **Production / Coolify:** not configured or deployed.
|
||||
|
||||
## Documentation and project knowledge
|
||||
|
||||
@@ -36,3 +36,6 @@ Future feature additions need an evidence-backed status update here, an exact de
|
||||
|
||||
|
||||
**P05-OIDC-02 source prepared:** CI-only prebuilt/digest-pinned socat, isolated proxy/Host and forwarded HTTP readiness gates, and strict status-only provisioner readiness have been added after the Run #90 blocker. **Full browser/OIDC acceptance is still UNVERIFIED until one new terminal Gitea CI**. Backend and previous Login build/unit/security PASS are not real authenticated session proof.
|
||||
|
||||
|
||||
**P05-OIDC-02 terminal status:** Gitea Run #91 on `4831165` overall FAILURE: official backend four-service startup, no host ports and exact private Traefik routing **PASS**; pinned socat image/digest **PASS**, but forwarder process **exited code 1**, so all user/client provisioning and real Chromium Auth.js callback/session/negative tests **NOT EXECUTED**. `always()` cleanup **PASS**. Real authenticated OIDC remains BLOCKED; production TLS/MFA not evaluated.
|
||||
+1
-1
@@ -14,7 +14,7 @@ Every file listed below is a direct child of `docs/`. Add/remove rows whenever t
|
||||
| [P05-SEC-02.md](P05-SEC-02.md) | Seven scoped PNPM parent overrides, patched lock and manual Login-only security CI evidence | P05-SEC-02 / Run #88 partial: security zero, build unverified |
|
||||
| [P05-SEC-02-A01.md](P05-SEC-02-A01.md) | Gitea-only Login V2 full frozen-install/build/units/zero-advisory acceptance and status | P05-SEC-02-A01 / Run #89 SUCCESS |
|
||||
| [P05-OIDC-01.md](P05-OIDC-01.md) | How isolated real OIDC Login V2 browser/session checks work; real CI status/limitations | P05-OIDC-01 / Run #90 BLOCKED before provisioning; cleanup PASS |
|
||||
| [P05-OIDC-02.md](P05-OIDC-02.md) | CI-only pinned prebuilt forwarder, safe private localhost readiness diagnostics and actual real-OIDC acceptance evidence | P05-OIDC-02 / source prepared, CI pending |
|
||||
| [P05-OIDC-02.md](P05-OIDC-02.md) | Pinned prebuilt forwarder, safe private HTTP diagnostics and actual Run #91 evidence | P05-OIDC-02 / real OIDC BLOCKED by forwarder exit 1, cleanup PASS |
|
||||
| [SETUP-GUIDE.md](SETUP-GUIDE.md) | Operator/developer prerequisites, configs, activation and safety | DOCS-01 / active; runtime pending |
|
||||
| [FEATURES-STATUS.md](FEATURES-STATUS.md) | Exact implemented/unavailable/unverified feature matrix | DOCS-01 / active |
|
||||
| [TROUBLESHOOTING.md](TROUBLESHOOTING.md) | Known blockers and safe diagnosis based on source status | DOCS-01 / active |
|
||||
|
||||
+14
-1
@@ -3,7 +3,7 @@
|
||||
**Date:** 2026-11-22
|
||||
**Baseline:** `b78270e9d45c1764c5642024b8147885deaacde3`
|
||||
**Gitea Run #90:** overall **FAILURE** on `cbcd60e76ec909df4f9c5826adf7a3e2a899c73e`: four disposable services healthy, no host ports; private loopback localhost:8080 not ready; no client/user/browser test executed. **Owned cleanup PASS.**
|
||||
**P05-OIDC-02 status:** narrow CI-only source remediation implemented; **actual new Gitea run pending**. No claim of fixed runtime or authenticated OIDC prior to terminal evidence.
|
||||
**P05-OIDC-02 status:** **Run #91 FAILED** — private proxy/Host route PASS and prebuilt image/digest verification PASS, but socat sidecar **exited with code 1** before provisioning; browser OIDC NOT EXECUTED. Owned cleanup PASS. Full acceptance BLOCKED.
|
||||
|
||||
## Source changes
|
||||
|
||||
@@ -22,3 +22,16 @@ In `tests/ci/oidc_e2e/run.sh` only, the runner now distinguishes:
|
||||
The single already-approved manual Gitea workflow `p05-oidc-acceptance.yml` must prove private proxy/forwarder readiness **and then** actual official client/user provisioning, original Login V2 Chromium password flow, genuine Auth.js authorization-code PKCE/state/nonce callback, protected Account session and API user ID, anonymous and invalid callback rejection, local sign-out, and successful mandatory owned cleanup.
|
||||
|
||||
If any check is blocked, document exact job/run/stage and **do not claim PASS for unexecuted steps**. One Gitea cycle only; no repeat or local tests. No screenshots, real accounts, private secrets, production deployment, MFA/passkey or production HTTPS acceptance. Detailed plan/evidence: `notes/P05-OIDC-02.md`. Developer design: `project/OIDC-E2E-ARCHITECTURE.md`.
|
||||
|
||||
|
||||
## Actual Gitea Run #91 — FAILURE / authentication BLOCKED
|
||||
|
||||
The single authorized manual [Gitea Run #91](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/91) tested source SHA `4831165548feabc2c0a0d39d25c40e0d1bc23bb2`, job #198 overall **FAILURE**.
|
||||
|
||||
**PASS:** all four disposable backend services healthy; no published host ports; exact private Traefik:80 / `Host: localhost:8080` returned HTTP 200; versioned prebuilt socat entrypoint and image digest verified.
|
||||
|
||||
**FAIL:** the private socat forwarder container exited immediately with **exit code 1** (`OIDC_CI_FORWARDER_NOT_RUNNING_STATE=exited EXIT_CODE=1`). Its precise internal error is **not yet established**. The private forwarded 8080 readiness, real OIDC client/human creation, Chromium Login V2 and Auth.js authenticated callback/session/positive and negative checks were **NOT EXECUTED**.
|
||||
|
||||
**Safety PASS:** Gitea mandatory `always()` cleanup step #3 passed with `ZITPLANE_BACKEND_CLEANUP_VERIFIED_PASS` and `ZITPLANE_OIDC_ALL_RESOURCES_CLEANED_PASS`; owned database/bootstrap/credentials/containers/volumes/network removed. No real users, local tests or production touched; no CI rerun.
|
||||
|
||||
**Next:** P05-OIDC-03, only after separate approval, to classify the sidecar's safe startup failure and fix the **private CI-only forwarding process** (potential official Python stdlib TCP forwarder) before another single isolated acceptance. Never disable PKCE, change production Auth.js, expose a host port or call metadata/cleanup PASS an authenticated login PASS. Exact full evidence: `notes/P05-OIDC-02.md`.
|
||||
+1
-1
@@ -80,7 +80,7 @@ Implement one explicitly approved phase at a time. Keep out-of-scope files, exis
|
||||
- Baseline `b78270e9d45c1764c5642024b8147885deaacde3`. Run #90 tested `cbcd60e`, four backend services healthy and host portless, but CI-only localhost:8080 sidecar not ready; project/client/user/browser tests **NOT RUN**; owned teardown **PASS**. Root cause not established by previous logs.
|
||||
- Exact Write Scope: `tests/ci/oidc_e2e/run.sh`, justified `provision.py` and optional `cleanup.sh`, optional `.gitea/workflows/p05-oidc-acceptance.yml`, `notes/**`, `project/**`, relevant `docs/**`, associated README/MINIFEST only if required. Original backend/dev Compose, Login V2, Account Portal, manifests/locks, production and unrelated files READ-ONLY. Preserve untracked `AI_INSTRUCTIONS.md`.
|
||||
- Pre-change `notes/P05-OIDC-02.md`: before provisioning probe private 127.0.0.1:80 proxy/Host HTTP 200; replace runtime `apk add` with published versioned `alpine/socat:1.8.1.3`, verify preinstalled entrypoint + digest and run by immutable digest; inspect sidecar state/exit and require private forwarded 127.0.0.1:8080 HTTP 200; fix only the provisioner's status-only readiness without touching official API/secret checks. Existing owned-only cleanup unmodified.
|
||||
- **Exactly ONE manual Gitea CI run** to verify real disposable project/client/human + original Login V2 Chromium → Auth.js PKCE/state/nonce/callback/session/negative checks + mandatory owned cleanup. No local app tests, no production, no unsafe logging or guessed PASS. Actual result must be documented. Operator guide `docs/P05-OIDC-02.md`.
|
||||
- **Actual single Gitea Run #91:** tested `4831165548feabc2c0a0d39d25c40e0d1bc23bb2`, overall **FAILURE**. 4-service backend health, no-host-ports, private Traefik:80 Host-routing HTTP 200, socat version/entrypoint/digest checks **PASS**. socat sidecar **exited (code 1)** before localhost:8080 readiness; no project/client/human or real Chromium/PKCE/callback/session tests executed. **Always-run owned cleanup PASS**. Root cause inside socat process not proven without safe startup stderr diagnostics. NO rerun, local app tests or production changes. Follow-up P05-OIDC-03 requires separate exact approval, not auth bypass. `notes/P05-OIDC-02.md`, `docs/P05-OIDC-02.md`.
|
||||
|
||||
## P05 - Full Integration (proposed, NOT approved)
|
||||
Shared design system, production-safe Compose topology and verified Login/Account OIDC wiring. No live deployment; separate approval.
|
||||
|
||||
+1
-1
@@ -26,4 +26,4 @@
|
||||
Full update policy is in root [AGENTS.md](../AGENTS.md). A list of available docs is in [MINIFEST.md](MINIFEST.md).
|
||||
|
||||
|
||||
For the current P05-OIDC-02 private loopback forwarding acceptance and actual Gitea evidence see [P05-OIDC-02.md](P05-OIDC-02.md). For the previous Run #90 blocker and cleanup see [P05-OIDC-01.md](P05-OIDC-01.md). For Gitea Run #89 final Login frozen build/unit/zero-advisory acceptance see [P05-SEC-02-A01.md](P05-SEC-02-A01.md). For Run #88 historical blocker and corrected helper see [P05-SEC-02.md](P05-SEC-02.md). For Gitea Run #87 findings see [P05-SEC-01.md](P05-SEC-01.md). For backend-only isolated runtime verification see [P05-CI-03.md](P05-CI-03.md); for initial full workflow and its limitations see [P05-CI-01.md](P05-CI-01.md). A green backend discovery smoke is not an authenticated user-login result.
|
||||
For the P05-OIDC-02 [Run #91](P05-OIDC-02.md) exact forwarder exit-code blocker and successful cleanup see the operator report. For the previous Run #90 blocker and cleanup see [P05-OIDC-01.md](P05-OIDC-01.md). For Gitea Run #89 final Login frozen build/unit/zero-advisory acceptance see [P05-SEC-02-A01.md](P05-SEC-02-A01.md). For Run #88 historical blocker and corrected helper see [P05-SEC-02.md](P05-SEC-02.md). For Gitea Run #87 findings see [P05-SEC-01.md](P05-SEC-01.md). For backend-only isolated runtime verification see [P05-CI-03.md](P05-CI-03.md); for initial full workflow and its limitations see [P05-CI-01.md](P05-CI-01.md). A green backend discovery smoke is not an authenticated user-login result.
|
||||
@@ -111,3 +111,6 @@ In Gitea `vibtools/ZitPlane` → Actions → **ZitPlane P05-OIDC-01 Disposable R
|
||||
|
||||
|
||||
**P05-OIDC-02 procedure:** Reuse the existing manual `ZitPlane P05-OIDC-01 Disposable Real Browser Acceptance` Gitea workflow (file `.gitea/workflows/p05-oidc-acceptance.yml`) with the newly patched CI-only forwarder. A good run first validates private proxy Host routing, prebuilt `alpine/socat:1.8.1.3` image digest and forwarded localhost:8080 HTTP 200, then provisions disposable OIDC client/user and tests a real Chromium/Account Portal callback before always-run cleanup. No host ports, no real credentials, no local tests. Actual PASS/BLOCKED will be recorded in `docs/P05-OIDC-02.md` and `notes/P05-OIDC-02.md`.
|
||||
|
||||
|
||||
**P05-OIDC-02 actual Gitea status:** [Run #91](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/91) **FAILED** after original ZITADEL 4-service startup, private proxy Host routing and socat image verification all PASS. The private forwarder container exited with code 1, preventing disposable OIDC client/user and browser login. Every authentication/callback/session assertion remains **NOT EXECUTED**; mandatory cleanup **PASS**. Do not manually add users or open network ports. See `docs/P05-OIDC-02.md`; a separate P05-OIDC-03 approval is required for CI-only forwarder startup diagnostics.
|
||||
@@ -63,3 +63,6 @@ Job #197 in [Run #90](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/90) fai
|
||||
|
||||
|
||||
**P05-OIDC-02 diagnostic separation:** If private Traefik:80 returns a non-200 status with `Host: localhost:8080`, the **proxy/Host route** gate fails before launching the sidecar. If the pinned prebuilt socat container exits or is not running, the CI job records a nonsecret container state and exit code. If the process stays running but localhost:8080 HTTP 200 fails, only the HTTP status or fixed socket marker is printed. None of these is a real login/MFA issue until client/user/browser stages execute. Do not enable host ports, disable PKCE or print secret URLs; require successful owned cleanup on every run. Actual evidence: `notes/P05-OIDC-02.md`.
|
||||
|
||||
|
||||
**P05-OIDC-02 Run #91 verified distinction:** a private `Host: localhost:8080` request to Traefik:80 is healthy, but the **version-pinned prebuilt socat sidecar immediately exited code 1**. Image entrypoint/digest check passed; this is a forwarder-process startup blocker, not evidence of an Auth.js/password/PKCE problem. No full 8080 forwarder response or browser flow was attempted after exit. Its exact stderr cause is unknown. The only approved next action is narrowly scoped safe startup diagnosis/forwarder fix in P05-OIDC-03; no open host port or production change. Owned cleanup **PASS**.
|
||||
+1
-1
@@ -16,6 +16,6 @@ This is the chronological **index**. Phase-specific scope/implementation evidenc
|
||||
| 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 | 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) |
|
||||
| 2026-11-22 | P05-OIDC-02 | Pin prebuilt socat image by verified digest in CI, check private proxy/Host/forwarder state, correct status-only readiness | Pre-change scoped plan and source prepared; [evidence](P05-OIDC-02.md), one Gitea run pending |
|
||||
| 2026-11-22 | P05-OIDC-02 | Prebuilt/digest-verified socat, private proxy/Host/sidecar state probes, status-only readiness | **Run #91 FAILURE**: backend and private Host routing PASS; forwarder exited code 1, no provisioning/browser; owned cleanup PASS. [Evidence](P05-OIDC-02.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
@@ -12,7 +12,7 @@
|
||||
| [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 / Run #90 FAILED at forwarder readiness; cleanup PASS; acceptance BLOCKED |
|
||||
| [P05-OIDC-02.md](P05-OIDC-02.md) | Pre-change exact loopback-forwarder blocker scope, pinned image/diagnostic plan and one real Gitea acceptance run | P05-OIDC-02 / source prepared, CI pending |
|
||||
| [P05-OIDC-02.md](P05-OIDC-02.md) | Pre-change loopback-forwarder scope, pinned digest/preflight fix and one real Gitea acceptance cycle | P05-OIDC-02 / Run #91: private proxy PASS; socat exit 1, OIDC BLOCKED, cleanup PASS |
|
||||
| [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.
|
||||
@@ -37,3 +37,28 @@ No local builds/tests/dev servers/Docker, no real users/accounts or secrets, no
|
||||
**Source review does NOT prove runtime compatibility.** No claim that old Alpine `apk add` was the root cause; Run #90 did not log sidecar state. Confirm only from the next run's safe observations.
|
||||
|
||||
**Expected source-level changes (pre-run):** exactly `run.sh`, `provision.py` plus narrow docs. `cleanup.sh` and workflow kept identical unless a specific justified defect is observed.
|
||||
|
||||
|
||||
## One authorized CI acceptance — actual terminal Gitea Run #91
|
||||
|
||||
**Date:** 2026-11-22, **Run:** [#91](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/91), **job:** #198, tested Gitea **source SHA `4831165548feabc2c0a0d39d25c40e0d1bc23bb2`**. Triggered once with `workflow_dispatch` on `main`, started 17:46:39 UTC, terminal 17:47:44 UTC. **Overall status completed, conclusion FAILURE.** There was **no second Gitea run**.
|
||||
|
||||
| Stage | Evidence | Terminal result |
|
||||
| --- | --- | --- |
|
||||
| Checkout and Git prerequisite, job steps #0/#1 | Both finished success | **PASS** |
|
||||
| Numeric run ownership, Docker daemon | `ZITPLANE_OIDC_DOCKER_PREFLIGHT_PASS` | **PASS** |
|
||||
| Strict no published host ports and IAM_OWNER config | `ZITPLANE_OIDC_NO_PUBLISHED_PORT_AND_OWNER_CONFIG_PASS` | **PASS** |
|
||||
| Four disposable P02 services started and healthy | `ZITPLANE_OIDC_FOUR_SERVICES_READY_PASS` | **PASS** |
|
||||
| Namespace-local direct Traefik:80 `/debug/ready` with exact `Host: localhost:8080` | `ZITPLANE_OIDC_PRIVATE_PROXY_HOST_ROUTE_PASS` | **PASS** — eliminates the previously unverified private proxy/Host routing hypothesis |
|
||||
| Versioned prebuilt socat binary/entrypoint and pulled registry SHA256 digest | `ZITPLANE_OIDC_PINNED_FORWARDER_DIGEST_VERIFIED_PASS` | **PASS** — image identity/entrypoint checked, process still not proven healthy |
|
||||
| Private sidecar startup/lifecycle | `OIDC_CI_FORWARDER_NOT_RUNNING_STATE=exited EXIT_CODE=1` | **FAIL** — the `socat` process exited immediately before the bounded HTTP readiness test. **The precise internal startup error remains unknown because container stderr was not retained in CI output.** Do not claim which socat option, bind error or runtime caused it |
|
||||
| Forwarded localhost:8080 HTTP ready / separate `provision.py` status-only check | Not reached | **NOT EXECUTED** |
|
||||
| Disposable official OIDC project, client, verified human provisioning | Not reached | **NOT EXECUTED**, no client/user created |
|
||||
| Original Login V2 Chromium password/PKCE/state/nonce/Auth.js callback/subject/API/protected page/negative/logout | Not reached | **NOT EXECUTED**, no real user authenticated |
|
||||
| Always-run owned-resource cleanup, job step #3 | `ZITPLANE_BACKEND_CLEANUP_VERIFIED_PASS`; `ZITPLANE_OIDC_ALL_RESOURCES_CLEANED_PASS` | **PASS** — run-owned containers, network, bootstrap/database and disposable credentials removed; cleanup step succeeded |
|
||||
|
||||
**Forensic conclusion:** Run #91 proves the **underlying proxy/Host routing works** and the version-specific `socat` image has a verified prebuilt entrypoint and digest; it isolates failure to the **forwarder process startup** (exited with code 1). It does **not prove** why the process failed. Initial Run #90 package-install hypothesis was not confirmed by this run. The status-only Python readiness code and all subsequent browser/auth/provision tests remain **unexecuted**. **Do not mark real OIDC accepted.**
|
||||
|
||||
**One-run boundary:** P05-OIDC-02 performed one manual Gitea CI run. No local application installs/builds/tests/dev servers, real users, production deployment or another CI run. Original `users/ui/**`, `auth/ui/v2/**`, backend/Compose, package manifests/locks and existing owner-only cleanup were unchanged. The committed result-only documentation is not the tested source commit.
|
||||
|
||||
**Next candidate P05-OIDC-03 (not approved):** a narrowly scoped `tests/ci/oidc_e2e/run.sh` startup remediation should first capture **safe, redacted sidecar startup diagnostics** (only this run-owned process, before any credentials exist, with allowlisted error class/errno and no raw log output), verify socat argument parsing and localhost bind semantics, and if justified replace it with an immutable/digest-pinned official Python stdlib TCP forwarding process. Ensure exact private proxy:80 and forwarded 8080 Host HTTP 200 before provisioning. No extra host ports or secret exposure. Then **one new, separately approved Gitea acceptance** for genuine client/user/browser flow and complete cleanup; actual failures remain BLOCKED.
|
||||
@@ -16,7 +16,7 @@ This is the **developer-focused implementation history**. `notes/CHANGELOG.md` i
|
||||
| 2026-11-22 | P05-SEC-02 | Seven parent-targeted glob/minimatch patched resolutions, PNPM lockfile metadata-only, manual Login-only CI and post-run validator fix | Run #88: strict Login audit 0 findings PASS, Login build job blocked before install by parser false-positive; post-run fix untested. `notes/P05-SEC-02.md` |
|
||||
| 2026-11-22 | P05-SEC-02-A01 | Verify existing corrected helper, exact seven PNPM scoped overrides, frozen Login Nx build and upstream Vitest; no source/lock changes | **Gitea Run #89 SUCCESS** on `ff4c58e`, 84/84 files, 1219/1219 tests, Login audit 0 Moderate/High/Critical; `notes/P05-SEC-02-A01.md` |
|
||||
| 2026-11-22 | P05-OIDC-01 | Added manual disposable IAM_OWNER/client/human/browser OIDC acceptance harness, secret isolation and cleanup | Run #90 FAIL before provisioning: private loopback forwarder unready; 4 backend services healthy, owned cleanup PASS. `notes/P05-OIDC-01.md` |
|
||||
| 2026-11-22 | P05-OIDC-02 | CI-only prebuilt socat tag+immutable digest startup, proxy/private forwarder HTTP readiness/exit diagnostics, status-only "/debug/ready" provisioner | Source prepared, one Gitea acceptance pending; `notes/P05-OIDC-02.md` |
|
||||
| 2026-11-22 | P05-OIDC-02 | CI-only prebuilt socat digest startup, private proxy/Host/readiness/exit checks and status-only provisioner | **Run #91 FAILED**: 4 services + private proxy PASS, sidecar exit code 1; no real user/browser test; cleanup PASS. `notes/P05-OIDC-02.md` |
|
||||
|
||||
## Required entry for each future change
|
||||
|
||||
|
||||
@@ -139,3 +139,6 @@ New manual workflow `.gitea/workflows/p05-oidc-acceptance.yml` executes **one**
|
||||
## P05-OIDC-02 scoped follow-up
|
||||
|
||||
New source in `tests/ci/oidc_e2e/run.sh`: test namespace-local Traefik proxy Host route before creating sidecar, resolve published `alpine/socat:1.8.1.3` to immutable digest, validate prebuilt `socat` entrypoint, create no-host-port loopback sidecar, check running state/exit plus bounded private forwarded HTTP 200. `provision.py` now treats `/debug/ready` as HTTP status-only; official management provisioning and all browser/auth assertions unchanged. Existing manual Gitea workflow and always-run owned cleanup unchanged. One separate Gitea acceptance run needed; never mark a static stage check as an actual real OIDC browser PASS.
|
||||
|
||||
|
||||
**P05-OIDC-02 Gitea Run #91 result:** tested `4831165`, job #198 overall FAIL. All 4 services healthy PASS, no runner host port PASS, private Traefik:80 Host-route HTTP 200 PASS, prebuilt socat/digest verification PASS. The run-owned socat sidecar **exited 1** before forwarded 8080 check, so no project/client/user or Chromium/Auth.js checks executed. Mandatory cleanup PASS, no remaining owned resources. Source-only status readiness fix in `provision.py` **was not exercised**. Root cause inside sidecar unproven without redacted startup error diagnostics. Next separately approved P05-OIDC-03 limited to private CI process/diagnostics.
|
||||
@@ -133,3 +133,6 @@ Existing `tests/ci/security_advisory_gate.py` remains the independent **live reg
|
||||
|
||||
|
||||
**P05-OIDC-02 narrow source audit:** Shell orchestration in `tests/ci/oidc_e2e/run.sh` now probes private Traefik `/debug/ready` with exact `Host: localhost:8080`, verifies prebuilt socat image entrypoint/digest, and stops before credential provisioning when the loopback forwarder state, socket or HTTP response is not ready. Python `provision.py::wait_until_ready()` now checks only `HTTP 200` for `/debug/ready` without interpreting an arbitrary body as JSON. No user API, token, session, IAM policy, Auth.js or official Login V2 code changed.
|
||||
|
||||
|
||||
**P05-OIDC-02 Run #91 actual invocation:** `run.sh` correctly proved the underlying proxy's exact HTTP Host route and pinned image metadata, then observed the forwarder `docker inspect` state `exited`, exit code 1 and **stopped before provisioning**. The updated `provision.py::wait_until_ready()`, official provisioning functions and `browser.cjs` were **not reached** and remain unverified in this phase. Exact owned cleanup completed. Never infer a successful session from source-only logic.
|
||||
@@ -57,3 +57,10 @@ Next P05-OIDC-02 should narrowly instrument/check forwarder startup before provi
|
||||
The previous Gitea Run #90 verified a healthy, portless P02 stack but did not capture the private socat sidecar's exit status or verify the 127.0.0.1:80 proxy independently; the true forwarder failure cause is **unknown**. The new narrow `run.sh` checks the private Traefik:80 `/debug/ready` with `Host: localhost:8080` first, then uses the published version-specific `alpine/socat:1.8.1.3` image (preinstalled `socat`), checks `Entrypoint == ["socat"]`, resolves the pulled tag to its immutable sha256 registry digest and **runs by digest**. There is no `apk add` at runtime. Container state/exit code and bounded local forwarded HTTP 200 readiness are checked **before official OIDC project/user provisioning**. Only safe stage/status markers are printed on failure; no HTTP bodies, cookies, callbacks or passwords.
|
||||
|
||||
`provision.py::wait_until_ready()` now independently verifies HTTP 200 rather than attempting to parse the `/debug/ready` response as JSON; **all official management/client/human creation requests remain strictly parsed JSON and authenticated with the ephemeral IAM_OWNER PAT**. No other protected code, developer Compose, original Login V2 or Account auth source changed. The existing `cleanup.sh` continues to remove only run-labeled/owned resources. **New Gitea real-browser acceptance pending; this is not a verified login yet**. Exact plan/evidence: `notes/P05-OIDC-02.md`.
|
||||
|
||||
|
||||
## P05-OIDC-02 terminal result — exact failure narrower than Run #90
|
||||
|
||||
Gitea [Run #91](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/91) on `4831165548feabc2c0a0d39d25c40e0d1bc23bb2`, job #198, overall **FAILURE**. Four official backend services and portless CI Compose PASS. A **direct** `GET /debug/ready` on Traefik private 127.0.0.1:80 with `Host: localhost:8080` **PASS**; the old "maybe proxy Host routing is down" theory is disproven for this run. The versioned prebuilt `alpine/socat:1.8.1.3` image entrypoint and immutable digest verified **PASS**, but when started in the proxy network namespace the sidecar reported `exited`, **exit code 1**. No startup stderr was retained; the specific binary/runtime/bind/flag error remains **unknown**, so no unsupported cause is asserted. The status-only `provision.py::wait_until_ready()`, project/client/human APIs, real browser password flow, PKCE/state/nonce, Auth.js callback, Account session/positive and negative tests were **NOT EXECUTED**.
|
||||
|
||||
`always()` cleanup PASS: both `ZITPLANE_BACKEND_CLEANUP_VERIFIED_PASS` and `ZITPLANE_OIDC_ALL_RESOURCES_CLEANED_PASS`. Original backend, Compose, Login V2, Auth.js source, manifests and security rules unchanged. Next phase should restrict writes to CI-only startup diagnostics/forwarder, verify the new forwarder HTTP 200 **before** provisioning, preserve private network namespace and ownership checks, then exactly one independently authorized real browser CI acceptance. **No application auth bypass or production deployment**.
|
||||
@@ -87,3 +87,6 @@ CI only: official ZITADEL v4.20.4, official Login V2 v4.20.4, PostgreSQL 17.10/T
|
||||
|
||||
|
||||
**P05-OIDC-02 CI forwarding dependency:** Uses the published, version-selected `alpine/socat:1.8.1.3` image rather than installing packages inside `alpine:3.21` at container startup. The disposable runner checks the image has `["socat"]` entrypoint, resolves `RepoDigests` and launches the immutable pulled sha256 reference; never `latest`. Existing `python:3.12-alpine` probe containers check no-host-port proxy and private forwarding readiness. This is Gitea-only and must not be run on developer PC or production. No package manifests/lockfiles modified.
|
||||
|
||||
|
||||
**P05-OIDC-02 runtime status:** Gitea Run #91 verified `alpine/socat:1.8.1.3` image metadata and immutable digest selection, but the image process **exited code 1** after start. The underlying private proxy:80/Host route was healthy; no OIDC provisioning or browser E2E executed. There was no local application install/build. All CI-owned resources were cleaned. Image metadata verification **does not prove** the forwarding process works or that authenticated OIDC is ready.
|
||||
@@ -1,6 +1,6 @@
|
||||
# ZitPlane ? exact tracked source inventory
|
||||
|
||||
**Snapshot:** 2026-11-22, P05-OIDC-02 focused source candidate on approved baseline `b78270e`. Run #90 backend/cleanup PASS, private loopback FAIL; **new OIDC acceptance CI not yet executed**.
|
||||
**Snapshot:** 2026-11-22, P05-OIDC-02 source tested by Gitea Run #91 at `4831165548feabc2c0a0d39d25c40e0d1bc23bb2`: four services and private proxy PASS, socat sidecar exited 1, OIDC provisioning/browser NOT EXECUTED; owned cleanup PASS. Final docs-only commit is not a new CI-verified source.
|
||||
|
||||
**Git-tracked file paths: 748.** Untracked `AI_INSTRUCTIONS.md` and ignored local secrets excluded.
|
||||
|
||||
|
||||
@@ -28,3 +28,6 @@ Add new CI checks and update `MINIFEST.md`, `project/`, `docs/`, and `notes/` in
|
||||
|
||||
|
||||
**P05-OIDC-01 Run #90 terminal:** new `oidc_e2e/` harness started the original ZITADEL/PG/Login/Traefik services healthy with no host-published port. The private namespace loopback sidecar was **not ready**, so the provisioner timed out before creating a disposable project, OIDC client/user or running any browser checks. **No real OIDC accepted**. Gitea `always()` cleanup fully removed all run-owned volumes/containers/credentials and passed. No second run. P05-OIDC-02 should add safe CI-only startup/health diagnostics and pin the forwarder image before another single acceptance run.
|
||||
|
||||
|
||||
**P05-OIDC-02 Run #91:** Existing manual real-browser workflow with new CI-only forwarder source proved four healthy services, no host-published ports, private Traefik:80 `Host: localhost:8080` HTTP 200 and prebuilt socat version/digest check PASS. But the private forwarding process exited immediately with code **1**; actual client/user setup and browser/callback/session tests **NOT RUN**. `always()` cleanup verified absence of all run-owned state, PASS. No repeated run, no Auth.js or app edits. Preserve this exact evidence for a narrow P05-OIDC-03 startup diagnostic.
|
||||
@@ -18,3 +18,6 @@ The environment is a temporary `zitplane-p05-{GITHUB_RUN_ID}` Compose stack cont
|
||||
## P05-OIDC-02 private forwarder remediation (pending real Gitea CI)
|
||||
|
||||
`run.sh` first verifies private Traefik on 127.0.0.1:80 responds HTTP 200 with `Host: localhost:8080`, then pulls versioned `alpine/socat:1.8.1.3`, verifies prebuilt socat entrypoint, resolves the image's immutable digest and starts by digest in the same private proxy network namespace. No `apk add` inside container and no public host binding. A bounded health probe checks the listener/socket and exact Host/issuer route; on failure it logs only stage/state/exit/HTTP status, not secrets. `provision.py` readiness probes HTTP status-only; official IAM_OWNER project/client/human APIs and Chromium login unchanged. Run #90 never tested client/user/browser flows; **next single Gitea run pending**.
|
||||
|
||||
|
||||
**P05-OIDC-02 single-run evidence:** Gitea Run #91 tested `4831165`: private Traefik:80/Host HTTP 200 and versioned socat/digest verification PASS, then run-owned forwarder process `exited` with code 1. `provision.py` and `browser.cjs` **not run**. Cleanup PASS; no owned containers/network/credentials left. The status-only readiness change exists in source but is not CI-proven because the forwarder failed first. Startup errno/error class requires a new approved CI-only P05-OIDC-03 scope. No reruns under P05-OIDC-02.
|
||||
Reference in new issue
Block a user