docs(oidc): accept Run 96 real browser Login V2 Auth.js and owned cleanup

This commit is contained in:
victorsteele428 committed 2026-11-22 20:19:36 +00:00
1 parent 670e225db4
commit b3841d8c05
17 files changed
+125 -7

No files matched your search

+1
View File
@@ -17,6 +17,7 @@ Compact, developer-friendly monorepo for a central identity service, a branded l
- **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`.
- **P05-OIDC-03 / A02 final:** Gitea **Run #93 COMPLETED FAILURE**, source `7b80f41`. Job #206 executed (runner queue resolved). Four backend services and private Traefik routing PASS; socat `SOCKET_BIND_ERROR`, digest-pinned Python fallback `ADDRESS_IN_USE` on private TCP `127.0.0.1:8080`. No OIDC client/human or real Chromium/Auth.js callback/session reached. Mandatory cleanup PASS. Actual 8080 listener identity still UNKNOWN; no production/secret changes. See `docs/P05-OIDC-03-A02.md`.
- **P05-OIDC-04:** Single Gitea **Run #95 FAILURE** on `79dac4f5bb76e1cee4dfaf61657c6e84268b3dfb`, job #209. Source adds private socket owner forensics and isolated loopback forwarder, but CI stopped **before these executed**: 4 healthy backend services PASS, direct private proxy Host HTTP readiness `OIDC_CI_PRIVATE_PROXY_SOCKET_OR_HTTP_BLOCKED` FAIL. Real ZITADEL client/human/Chromium/PKCE/Auth.js session NOT EXECUTED; owned cleanup PASS. Real OIDC remains BLOCKED; listener owner UNKNOWN. See `docs/P05-OIDC-04.md`.
- **P05-OIDC-04-A01:** Gitea **Run #96 SUCCESS** on `670e225db477f180ff14ffa62e6654860a166f17`, job #210. Real disposable ZITADEL project/client/verified test-human, original Login V2 Chromium password+PKCE/state/nonce/Auth.js callback, authenticated Account session/API/page, negative access, local logout and mandatory cleanup **PASS**. Proxy TCP6:8080 listener **Traefik PID1** identified; separate private Socat forwarding verified. **Production HTTPS/MFA/passkeys/custom imported Login V2/multi-app SSO/deployment remain unverified.** See [A01 acceptance](docs/P05-OIDC-04-A01.md).
- **Production / Coolify:** not configured or deployed.
## Documentation and project knowledge
+2
View File
@@ -53,3 +53,5 @@ Future feature additions need an evidence-backed status update here, an exact de
**P05-OIDC-03-A02 terminal update:** Gitea [Run #93](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/93) **COMPLETED FAILURE** (job #206 executed) after prior queued status. Four healthy services, portless networking, private Traefik Host route PASS. Socat `SOCKET_BIND_ERROR` and Python fallback `ADDRESS_IN_USE` on private `127.0.0.1:8080` **BLOCKED** further steps; actual listener not identified. Real client/user creation, Chromium Login V2, Auth.js callback/session, negative access and logout **NOT EXECUTED**. Mandatory owned-only cleanup **PASS**. Full authenticated OIDC and production/MFA remain UNVERIFIED.
**P05-OIDC-04 terminal:** [Gitea Run #95](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/95), job #209, source `79dac4f5bb76e1cee4dfaf61657c6e84268b3dfb` **COMPLETED FAILURE**. Docker/ownership/portless configuration PASS, four backend containers healthy PASS; direct private Traefik Host HTTP probe **FAIL** (`OIDC_CI_PRIVATE_PROXY_SOCKET_OR_HTTP_BLOCKED`). The 8080 PID/socket audit, new isolated forwarder and every real project/client/user/Chromium/Login V2/PKCE/Auth.js/session/negative/logout check were **NOT EXECUTED**. Owned-only cleanup **PASS**; authenticated OIDC remains BLOCKED, production/MFA NOT VERIFIED. See [P05-OIDC-04.md](P05-OIDC-04.md).
**P05-OIDC-04-A01 accepted real browser OIDC (disposable only):** Gitea [Run #96](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/96), job #210, source `670e225db477f180ff14ffa62e6654860a166f17` **COMPLETED SUCCESS**. 4/4 healthy services/portless network, actual Traefik PID 1 TCP6:8080 listener, separate private Socat forwarder, issuer discovery, official project/client/test-human, Chromium original Login V2, PKCE S256/state/nonce, genuine Auth.js callback/subject/session/protected identity API/page, anonymous/invalid-callback rejection, local logout and mandatory owned-only cleanup all **PASS**. Python fallback and transient-error retry **NOT EXECUTED** (not needed). **Production HTTPS/custom imported Login V2 integration/MFA/passkeys/multi-app SSO/live deployment NOT VERIFIED**. [Full guide](P05-OIDC-04-A01.md).
+1
View File
@@ -18,6 +18,7 @@ Every file listed below is a direct child of `docs/`. Add/remove rows whenever t
| [P05-OIDC-03.md](P05-OIDC-03.md) | Same-run socat classification, private Python fallback and exact Gitea status | P05-OIDC-03 / Run #93 QUEUED, no terminal result |
| [P05-OIDC-03-A01.md](P05-OIDC-03-A01.md) | Historical queue snapshot before Run #93 started; see A02 for terminal state | P05-OIDC-03-A01 / superseded status |
| [P05-OIDC-03-A02.md](P05-OIDC-03-A02.md) | Actual terminal Gitea Run #93 port-bind blocker, authentic OIDC test limits, cleanup and next steps | P05-OIDC-03-A02 / completed failure, cleanup PASS |
| [P05-OIDC-04-A01.md](P05-OIDC-04-A01.md) | Verified Run #96 real Login V2/Auth.js browser acceptance, privacy boundaries and limitations | P05-OIDC-04-A01 / Run #96 SUCCESS |
| [P05-OIDC-04.md](P05-OIDC-04.md) | Private namespace forwarder design, actual Run #95 status and real-browser acceptance limitations | P05-OIDC-04 / direct proxy readiness FAIL, 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 |
+34
View File
@@ -0,0 +1,34 @@
# P05-OIDC-04-A01 — Real ZITADEL Browser OIDC Acceptance (Gitea Run #96)
**Approved baseline:** `443dfcf5d1ecb6f6f5c04cada32aafa17d7d823e`
**Verified source:** `670e225db477f180ff14ffa62e6654860a166f17` (exact CI tested SHA, not the later documentation commit).
**Gitea result:** [Run #96](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/96), Job #210, **COMPLETED SUCCESS**, on 2026-11-22 20:17:40 UTC.
## What this verifies
A **temporary, isolated Gitea environment** booted four healthy official ZITADEL/Traefik/PostgreSQL/Login V2 services without host-published ports, created a disposable ZITADEL project and real OIDC client/test human using official APIs, then used **real Chromium** to authenticate through original Login V2. The browser verified OIDC authorization code with PKCE S256/state/nonce, genuine Auth.js callback, matching authenticated subject and protected Account API/page, anonymous/invalid-callback rejection and local sign-out. Both mandatory cleanup verification markers succeeded, so disposable resources and credentials were destroyed.
The proxy namespace's port-8080 listener was actually identified as **Traefik PID 1 (TCP6)**. The CI-only dedicated private forwarding namespace avoided that collision. The direct Traefik readiness HTTP 200 and forwarded issuer readiness both PASSED.
| Gate | Run #96 |
| --- | --- |
| Git checkout, Docker preflight, portless owned Compose and 4 healthy backend services | **PASS** |
| Direct private Host-route HTTP readiness, listener identity and Socat forwarder | **PASS** |
| Forwarded HTTP 200 and matching issuer/OIDC discovery | **PASS** |
| Official disposable project, OIDC client and verified test human | **PASS** |
| Real Chromium authorization code / S256 PKCE / state / nonce | **PASS** |
| Original Login V2 password, real Auth.js callback | **PASS** |
| Authenticated Account identity/session/HttpOnly cookie/protected page and API | **PASS** |
| Anonymous and tampered callback rejection | **PASS** |
| Local portal logout and session invalidation | **PASS** |
| Always-run run-owned credential/database/container/network cleanup | **PASS** |
| Optional Python fallback (not needed after Socat succeeded) | **NOT EXECUTED** |
| Private readiness transient-error retry branch (first attempt succeeded) | **NOT EXECUTED** |
## What it does NOT mean
This is **development-origin disposable CI authentication acceptance**, not a live production website or production-grade identity-provider deployment. Custom imported Login V2 source is not thereby proved wired in place of the original official prebuilt Login V2 image. Production HTTPS, real domains, MFA, passkeys, Admin Console interactive flows, multi-app SSO, live user data and production deployment were **not tested**. Nothing here authorizes a production rollout.
## Next recommended phase
`P05-OIDC-05` should be a **read-only production-context integration readiness forensic audit** identifying the exact remaining requirements and separately approving any future implementation. Do not repeat Run #96 or manually create real users. The detailed chronological gate ledger, confirmed Traefik socket evidence, Scope Lock and source SHA are in [notes/P05-OIDC-04-A01.md](../notes/P05-OIDC-04-A01.md).
+6
View File
@@ -126,3 +126,9 @@ Coolify, HTTPS, secrets, backups, durable storage and focused production readine
- Baseline `89bc3f2`; scoped pre-source note and CI-only source `79dac4f5bb76e1cee4dfaf61657c6e84268b3dfb` in `tests/ci/oidc_e2e/{run.sh,forwarder.py}` were pushed. No original backend/Compose/Login/Auth.js/workflow/dependency modifications, no public host port.
- Single authorized [Gitea Run #95](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/95) / job #209 **FAILURE** after checkout, portless config and four healthy backend services PASS. Direct proxy:80 Host readiness failed with `OIDC_CI_PRIVATE_PROXY_SOCKET_OR_HTTP_BLOCKED` **before** the 8080 listener inspector or new forwarder ran. Real project/client/human/browser/Auth.js/negatives/logout **NOT EXECUTED**. Mandatory owned-only teardown **PASS**.
- The exact Run #93 8080 listener owner remains UNKNOWN. No retry. Next proposed `P05-OIDC-04-A01` strictly diagnoses direct private proxy socket/HTTP readiness first in another separately approved disposable cycle. Evidence: `notes/P05-OIDC-04.md`, operator guide: `docs/P05-OIDC-04.md`.
## P05-OIDC-04-A01 — Real Browser OIDC Final Acceptance (COMPLETE; 2026-11-23)
- Approved baseline `443dfcf5d1ecb6f6f5c04cada32aafa17d7d823e`; pre-source `notes/P05-OIDC-04-A01.md` committed, then **only** `tests/ci/oidc_e2e/run.sh` modified on source SHA `670e225db477f180ff14ffa62e6654860a166f17`. Direct private proxy readiness now records bounded allowlisted socket/HTTP failure classes, with conditional transient-only retry (untested branch; first attempt passed).
- Exactly one Gitea [Run #96](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/96), job #210 **SUCCESS**. Four healthy portless services; direct and forwarded private 200; **TCP6:8080 actual owner Traefik PID1**; isolated Socat forwarder, official disposable project/client/human, real Chromium original Login V2 password+PKCE S256/state/nonce/Auth.js callback, protected session/API/pages, negative access and logout all PASS. Mandatory owned-only cleanup PASS. Optional Python fallback NOT EXECUTED because Socat passed.
- Scope unchanged: production HTTPS, multi-app SSO, custom imported Login V2 integration, Admin Console human flow, MFA/passkeys and production data/deployment NOT VERIFIED. No new CI/reruns/local apps/deploy/tags. Next proposed `P05-OIDC-05` **read-only production integration readiness audit**, subject to separate approval. Source/terminal evidence: `notes/P05-OIDC-04-A01.md`, `docs/P05-OIDC-04-A01.md`.
+1 -1
View File
@@ -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 latest **Run #95 private proxy readiness failure** and scoped CI-only forwarder design, see [P05-OIDC-04.md](P05-OIDC-04.md); real OIDC still NOT EXECUTED. For the **terminal Run #93 failure** and verified private port-8080 bind conflict, see [P05-OIDC-03-A02.md](P05-OIDC-03-A02.md). The former [queue audit](P05-OIDC-03-A01.md) is historical: the runner subsequently started job #206. The [P05-OIDC-03 CI implementation](P05-OIDC-03.md) remains unaccepted for real OIDC. Historical Run #91 exit-code blocker and safe cleanup are in [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.
The latest **Run #96 full disposable real browser OIDC SUCCESS**, verified Traefik socket ownership and mandatory teardown are documented in [P05-OIDC-04-A01.md](P05-OIDC-04-A01.md). Production HTTPS/MFA/custom source wiring remain NOT VERIFIED. For the historical **Run #95 private proxy readiness failure** and scoped CI-only forwarder design, see [P05-OIDC-04.md](P05-OIDC-04.md); real OIDC still NOT EXECUTED. For the **terminal Run #93 failure** and verified private port-8080 bind conflict, see [P05-OIDC-03-A02.md](P05-OIDC-03-A02.md). The former [queue audit](P05-OIDC-03-A01.md) is historical: the runner subsequently started job #206. The [P05-OIDC-03 CI implementation](P05-OIDC-03.md) remains unaccepted for real OIDC. Historical Run #91 exit-code blocker and safe cleanup are in [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.
+2
View File
@@ -122,3 +122,5 @@ In Gitea `vibtools/ZitPlane` → Actions → **ZitPlane P05-OIDC-01 Disposable R
**P05-OIDC-03-A02 terminal result:** [Run #93](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/93) **started and FAILED**, so the previous “runner queued” blocker is no longer current. Four-service portless ZITADEL stack and private Traefik routing worked; socat and Python fallback both failed binding private TCP port 8080 (`SOCKET_BIND_ERROR` / `ADDRESS_IN_USE`). Neither official test OIDC client/user nor actual Chromium Login V2/Auth.js session was exercised; mandatory cleanup PASS. No changes to this setup or production. Inspect verified socket ownership only in a **separately approved disposable CI** before selecting a network/port remedy. See `docs/P05-OIDC-03-A02.md`.
**P05-OIDC-04 terminal guidance:** [Run #95](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/95) used a scoped separate run-owned private forwarder namespace candidate without publishing host ports or modifying original Compose. However it **FAILED before forwarder startup** at the direct Traefik private Host socket/HTTP check despite four healthy containers. Socket-owner diagnostics, official client/user provisioning and real Login V2/Auth.js authentication **NOT EXECUTED**; mandatory owned-only cleanup PASS. Do not change local/production configs or manually create test accounts. Next action requires a new, narrowly approved direct-proxy-readiness RCA. See [P05-OIDC-04.md](P05-OIDC-04.md).
**P05-OIDC-04-A01 acceptance:** Gitea [Run #96](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/96) **SUCCESS**, **not a production installation**. In disposable CI, private Host/forwarder and full original Login V2 → Auth.js → Account protected session/identity API → negative cases → portal logout passed; owned credentials/database/containers/network cleanup verified. Traefik PID1 was actually listening on proxy-local TCP6:8080; the isolated forwarder avoids binding in that shared namespace. Do **not** expose port 8080, use real test humans, modify production secrets or infer that custom imported Login V2, MFA/passkeys or HTTPS has been accepted. See [P05-OIDC-04-A01.md](P05-OIDC-04-A01.md).
+4
View File
@@ -83,3 +83,7 @@ Previously queued Run #93 eventually ran: job #206 started and failed after heal
## P05-OIDC-04 — Failed private readiness is not an authentication regression
[Gitea Run #95](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/95) passed isolated Docker startup and four healthy backend services, then the separate no-secret private Traefik `GET /debug/ready` with `Host: localhost:8080` **FAILED** with `OIDC_CI_PRIVATE_PROXY_SOCKET_OR_HTTP_BLOCKED`. This marker does not distinguish refused, timeout or unexpected HTTP response. The planned pre-bind 8080 socket/PID collector and both forwarders did not execute; therefore an earlier `ADDRESS_IN_USE` owner was not determined. Do not blame a service or Auth.js, open a host port, disable OIDC checks or repeat CI without separate approval. Always-run cleanup PASS. Next: P05-OIDC-04-A01, narrowly classify direct private socket/HTTP readiness while redacting all payloads. [Exact evidence](P05-OIDC-04.md).
## P05-OIDC-04-A01 — previous socket failure resolved in disposable CI
Earlier Run #95 did not classify its private proxy HTTP exception and failed before diagnostics. In [Run #96](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/96) the direct proxy probe returned HTTP 200 on its first attempt; safe error classification and conditional bounded retry remain **unexercised**, not a separately verified negative test. The pre-forwarder socket inspector identified **Traefik PID1 TCP6:8080** as the existing listener. In a separate run-owned private namespace, Socat forwarded localhost:8080 to proxy:80 and the genuine Chromium/OIDC/Account protected session/negative/logout tests all **PASSED**. Always-run exact-owned cleanup PASS. Do not diagnose past port errors as invalid identity credentials or change production ports. [Evidence](P05-OIDC-04-A01.md).
+2
View File
@@ -23,4 +23,6 @@ This is the chronological **index**. Phase-specific scope/implementation evidenc
| 2026-11-23 | P05-OIDC-04 | Pre-source scope lock, CI-only safe port inode/PID forensic probe and separate private namespace forwarder | Source `79dac4f5bb76e1cee4dfaf61657c6e84268b3dfb`; one Gitea Run #95 job #209 FAILURE at direct private proxy HTTP readiness, inspector/forwarder/real OIDC NOT EXECUTED; owned cleanup PASS. [Evidence](P05-OIDC-04.md) |
| 2026-11-23 | P05-OIDC-04-A01 | Pre-source Scope Lock, allowlisted direct private HTTP/socket classification and bounded transient-only probe retry | **Run #96 / Job #210 SUCCESS** on `670e225db477f180ff14ffa62e6654860a166f17`: proxy Traefik PID 1 port 8080 identified; isolated Socat/issuer/client/human/Chromium Login V2/PKCE/Auth.js session/negatives/logout **PASS**; owned cleanup **PASS**. [Evidence](P05-OIDC-04-A01.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
View File
@@ -16,6 +16,7 @@
| [P05-OIDC-03.md](P05-OIDC-03.md) | Pre-edit socat diagnosis, Python fallback and one focused Gitea Run #93 evidence | P05-OIDC-03 / Run #93 QUEUED, no steps executed, acceptance UNVERIFIED |
| [P05-OIDC-03-A01.md](P05-OIDC-03-A01.md) | Historical read-only queue snapshot before Run #93 was scheduled; superseded by A02 terminal evidence | P05-OIDC-03-A01 / historical queue snapshot |
| [P05-OIDC-03-A02.md](P05-OIDC-03-A02.md) | Read-only terminal Run #93 job #206 evidence, private port 8080 conflict and verified cleanup | P05-OIDC-03-A02 / run FAILED, real OIDC blocked, cleanup PASS |
| [P05-OIDC-04-A01.md](P05-OIDC-04-A01.md) | Pre-source scope, classified readiness probe, one Gitea Run #96 real browser OIDC SUCCESS, listener RCA and cleanup | P05-OIDC-04-A01 / accepted real disposable OIDC |
| [P05-OIDC-04.md](P05-OIDC-04.md) | Pre-source Scope Lock, isolated forwarder source diff, terminal Run #95 job #209 failure/cleanup and next exact RCA | P05-OIDC-04 / Run #95 failure, cleanup PASS; OIDC blocked |
| [CHANGELOG.md](CHANGELOG.md) | Short append-only chronological phase log and links to detailed reports | DOCS-01 / active |
+45
View File
@@ -28,3 +28,48 @@ The direct pre-forwarder probe in `run.sh` currently executes `python:3.12-alpin
5. Final documentation-only update in `notes/**`, `project/**`, `docs/**` and manifests/navigation, a focused git diff/safety/inventory audit, documentation commit and exact remote main SHA verification. No second run even if the first fails. Supply next narrow exact scope and copyable approval text based on actual evidence.
**Initial A01 acceptance:** NOT EXECUTED. Real authenticated OIDC remains BLOCKED pending the one new real terminal Gitea result.
## Run #96 / Job #210 — VERIFIED terminal acceptance (A01)
**Source preparation:** Scope Lock first committed as `53b258d57146fe70745faa1879b3ab44aa57b4d7`; exactly one source file, `tests/ci/oidc_e2e/run.sh`, changed in tested source commit `670e225db477f180ff14ffa62e6654860a166f17`. The focused diff introduced allowlisted direct private socket/HTTP classification and **at most 3 attempts only after recognized transient socket failures**; unchanged exact `Host: localhost:8080`, isolated ports/network, issuer, original Auth.js/Login V2 and owned-only cleanup. The retry and negative error-class branches **were not exercised** because the first private proxy probe PASSED. No source, workflow or runner re-edits after dispatch.
**Single authorized Gitea run:** [Run #96](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/96) / **Job #210**; event `workflow_dispatch`, source SHA `670e225db477f180ff14ffa62e6654860a166f17` on `main`. Started **2026-11-22T20:13:22Z**; completed **2026-11-22T20:17:40Z**. Both Gitea run and job `completed / success`; every job step (#0 Git, #1 checkout, #2 disposable OIDC acceptance, #3 `always()` cleanup) `success`.
| Required CI gate | Actual status / exact log marker |
| --- | --- |
| Runner pickup, Git installation, exact source checkout | **PASS** — Job #210, SHA `670e225db477f180ff14ffa62e6654860a166f17` |
| Docker/Compose preflight | **PASS** — `ZITPLANE_OIDC_DOCKER_PREFLIGHT_PASS` |
| Portless Compose + run-owned IAM_OWNER config | **PASS** — `ZITPLANE_OIDC_NO_PUBLISHED_PORT_AND_OWNER_CONFIG_PASS` |
| Four healthy official backend services | **PASS** — `ZITPLANE_OIDC_FOUR_SERVICES_READY_PASS` |
| Direct private Traefik:80 HTTP 200 with exact Host | **PASS** — `ZITPLANE_OIDC_PRIVATE_PROXY_HOST_ROUTE_PASS` |
| Proxy netns port-8080 socket/PID attribution *before* forwarder | **PASS** — `OIDC_CI_PROXY_PORT8080_LISTENER=TCP6 INODE=6286327 PID=1 COMM=traefik`; `ZITPLANE_OIDC_PROXY_PREBIND_SOCKET_FORENSICS_PASS` |
| Socat immutable image digest | **PASS** — `ZITPLANE_OIDC_PINNED_FORWARDER_DIGEST_VERIFIED_PASS` |
| Separate private Socat forwarder and exact Host forwarded HTTP 200 | **PASS** — `ZITPLANE_OIDC_SOCAT_FORWARDER_READY_PASS`; `ZITPLANE_OIDC_PRIVATE_LOOPBACK_FORWARDER_READY_PASS` |
| Python forwarder fallback | **NOT EXECUTED / NOT REQUIRED** — socat ready; no fallback |
| Private issuer and discovery | **PASS** — `ZITPLANE_OIDC_LOCAL_ORIGIN_READY_PASS`, `ZITPLANE_OIDC_ISSUER_DISCOVERY_PASS` |
| Official disposable ZITADEL project | **PASS** — `ZITPLANE_OIDC_PROJECT_CREATED_PASS` |
| Official real OIDC client/app creation | **PASS** — `ZITPLANE_OIDC_REAL_CLIENT_CREATED_PASS` |
| Disposable verified test human | **PASS** — `ZITPLANE_OIDC_REAL_TEST_HUMAN_CREATED_PASS` |
| Test-credential isolation and provisioning | **PASS** — `ZITPLANE_OIDC_TEST_CREDENTIALS_ISOLATED_PASS`, `ZITPLANE_OIDC_DISPOSABLE_PROVISIONING_PASS` |
| Disposable Account portal dependencies + server readiness | **PASS** — `ZITPLANE_OIDC_DISPOSABLE_ACCOUNT_DEPENDENCIES_READY_PASS`, `ZITPLANE_OIDC_DISPOSABLE_ACCOUNT_HTTP_READY_PASS` |
| Anonymous API/protected-page rejection | **PASS** — `ZITPLANE_OIDC_ANONYMOUS_API_AND_PAGE_REJECTED_PASS` |
| Tampered/invalid callback rejection | **PASS** — `ZITPLANE_OIDC_INVALID_CALLBACK_FAIL_CLOSED_PASS` |
| Real Chromium authorization code, PKCE S256, state, nonce | **PASS** — `ZITPLANE_OIDC_REAL_AUTHORIZE_PKCE_STATE_NONCE_PASS` |
| Original Login V2 username/password, real code/Auth.js callback | **PASS** — `ZITPLANE_OIDC_REAL_PASSWORD_AND_CALLBACK_PASS` |
| Authenticated subject/session, HttpOnly cookie, protected API/page | **PASS** — `ZITPLANE_OIDC_REAL_SESSION_PROTECTED_PAGE_AND_API_PASS` |
| Portal-local logout and API session revocation | **PASS** — `ZITPLANE_OIDC_PORTAL_LOGOUT_SESSION_REVOKED_PASS` |
| Real browser run completion | **PASS** — `ZITPLANE_OIDC_REAL_BROWSER_COMPLETE_PASS`, `ZITPLANE_OIDC_REAL_BROWSER_ACCEPTANCE_PASS` |
| Mandatory run-owned database/bootstrap/secrets/containers/volumes/network cleanup | **PASS** — `ZITPLANE_BACKEND_CLEANUP_VERIFIED_PASS`, `ZITPLANE_OIDC_ALL_RESOURCES_CLEANED_PASS` |
| Overall isolated real authenticated OIDC E2E | **PASS** — Gitea Run #96 / Job #210 terminal SUCCESS |
### Evidence-grounded root cause and safety boundary
The actual pre-bind TCP6 LISTEN socket belonged to **`traefik` PID 1**, inode `6286327`, inside the disposable proxy namespace. This directly explains why attempts to bind private `8080` in that **same** namespace were conflicting in earlier runs; the separately isolated forwarder namespace is now verified with a real successful issuer and browser flow. The *precise Traefik feature/configuration responsible for exposing 8080* was not independently attributed and must not be guessed. Source-only classifications for refused/timeout/etc were NOT runtime exercised because the first readiness attempt passed; this is not a separate diagnostic-class negative-test PASS.
All IAM_OWNER PAT, client secret, generated password and test-human state belonged **only to disposable CI volumes and backend**, not to a real human or production environment. Run #96 cleanup markers confirm owned resources removed. No public host ports, auth bypass, original backend/Login/Auth.js edits, local application builds/tests, production deployment, tags, releases, reruns or duplicate CI dispatch.
### A01 close-out and proposed next Scope Lock
**P05-OIDC-04-A01 isolated real browser OIDC acceptance: COMPLETE / PASS.** Documentation-only closure commit is **not** a new tested source SHA. Production HTTPS, custom imported Login V2 source integration, full Admin Console interactive login, MFA/passkeys, multi-app SSO, production storage/deployment and real-user operation remain **outside this acceptance** and **NOT VERIFIED**.
**Next proposal, pending new approval: `P05-OIDC-05` — Production-Context Integration Readiness Forensic Audit (read-only):** baseline = final A01 documentation SHA; WRITE only `notes/P05-OIDC-05.md`, relevant `project/**`, `docs/**`, associated README/MINIFEST if required. READ-ONLY all `tests/**`, `.gitea/workflows/**`, `core/**`, `deployment/**`, `auth/**`, `users/**`, package manifests/locks, runners, secrets and production infra. Inspect current documented source configuration, original-vs-imported Login V2 wiring, HTTPS/OIDC callback and domain/security policy, MFA/passkey and SSO coverage; distinguish verified disposable CI from untested production. Deliver a prioritized minimal separate future phase Scope Lock; **no source edit, new CI, login to real accounts, local build, deployment, tag or release** without another approval.
+2
View File
@@ -23,6 +23,8 @@ This is the **developer-focused implementation history**. `notes/CHANGELOG.md` i
| 2026-11-23 | P05-OIDC-04 | Scope-locked private socket forensics and isolated run-owned forwarder network, no original backend/Login/Account edits | Source `79dac4f5bb76e1cee4dfaf61657c6e84268b3dfb`; Run #95 failure before inspector due direct private proxy socket/HTTP, four healthy services, owned cleanup PASS; real OIDC blocked. `notes/P05-OIDC-04.md` |
| 2026-11-23 | P05-OIDC-04-A01 | Safe classified proxy readiness in `tests/ci/oidc_e2e/run.sh`; no backend/Login/Account/auth changes | Gitea [Run #96](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/96) job #210 **SUCCESS** on source `670e225db477f180ff14ffa62e6654860a166f17`: isolated real browser OIDC with protected session/negative/logout PASS, actual Traefik PID1 TCP6 8080 identified, owned cleanup PASS. See `notes/P05-OIDC-04-A01.md` |
## Required entry for each future change
Date, phase, approval/scope, baseline SHA, source files changed, reason/functional effect, interface/security impacts, migration/config steps, test/CI evidence, docs updated, commit SHA, verified/unverified limitations. Append one record for every approved change/fix, including documentation-only changes. Never overwrite old conclusions without noting correction.
+4
View File
@@ -164,3 +164,7 @@ Historical Run #91 used this workflow and reached a terminal job, but that only
## P05-OIDC-04 — one-run CI evidence (not authenticated OIDC acceptance)
Manual Gitea [Run #95](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/95) job #209 checked out exact source `79dac4f5bb76e1cee4dfaf61657c6e84268b3dfb`: Docker/portless Compose PASS, 4/4 backend services healthy PASS, private Traefik Host/socket probe FAIL (`OIDC_CI_PRIVATE_PROXY_SOCKET_OR_HTTP_BLOCKED`), listener forensics and isolated forwarder NOT EXECUTED, official OIDC project/client/human/browser/Auth.js/negative/logout NOT EXECUTED, always-owned cleanup PASS. This is a new narrower/earlier blocker, not verification or regression of the authentication implementation. See `notes/P05-OIDC-04.md` and `docs/P05-OIDC-04.md`. No new workflow, auto trigger, runner change or repeated CI.
## P05-OIDC-04-A01 — terminal single-run acceptance
Gitea [Run #96](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/96) on source `670e225db477f180ff14ffa62e6654860a166f17`, job #210 **COMPLETED SUCCESS**, all four workflow job steps SUCCESS. Four backend/portless services, private Host HTTP, socket PID1 Traefik on TCP6 8080, dedicated Socat/issuer, official ephemeral project/client/human, browser real password/PKCE/state/nonce/Auth.js/subject/protected API/page, anonymous and callback negatives, local logout and mandatory exact-owned cleanup **PASS**. `tests/ci/oidc_e2e/run.sh` alone changed in A01: bounded/no-secret classified readiness failures and conditional transient retry; retry not exercised. No workflow, auth backend, package, deployment or runner edits. The source-tested SHA is distinct from the later documentation-only commit; production integration remains outside Run #96.
+2
View File
@@ -174,3 +174,5 @@ Official Login V2 user/auth source, user Account Portal, backend Compose and pro
**P05-OIDC-03:** `tests/ci/oidc_e2e/forwarder.py` new CI-only asyncio stdlib opaque TCP localhost relay. `tests/ci/oidc_e2e/run.sh` now first classifies existing socat startup stderr into fixed safe error classes and, on unhealthy socat, switches only once to immutable-digest official Python within the same run-owned container name/network namespace. `cleanup.sh` and `provision.py` untouched; `browser.cjs`, `users/ui/**`, `auth/ui/v2/**` and the original P02 Compose untouched.
**P05-OIDC-04-A01 source map update:** The *only* source change is `tests/ci/oidc_e2e/run.sh` at `670e225db477f180ff14ffa62e6654860a166f17`: its pre-forwarder direct private proxy:80 readiness block classifies safely bounded socket/HTTP error codes and limits retry to transient classes only, preserving exact Host/issuer/network/isolation. Existing pre-bind namespace socket inspector identified Traefik PID 1 TCP6:8080 in actual Gitea Run #96; the already-existing isolated Socat forwarder plus unchanged original provisioning/browser/cleanup verified full disposable real OIDC SUCCESS. See `notes/P05-OIDC-04-A01.md`.
+2
View File
@@ -139,3 +139,5 @@ Existing `tests/ci/security_advisory_gate.py` remains the independent **live reg
**P05-OIDC-03 narrow new functions:** `run.sh::forwarder_http_ready` makes an actual status-only HTTP probe through private `127.0.0.1:8080` to the original proxy with `Host: localhost:8080`. The socat fallback branch reads *only* its pre-credential startup stderr into an allowlisted Python error classifier, verifies run-owner label before replacement, then resolves official Python by digest. `forwarder.py::copy_bytes` relays opaque 64 KiB TCP chunks without logging payload; `forwarder.py::serve_client` connects only to localhost:80 and transparently relays both directions; `forwarder.py::main` binds IPv4 loopback :8080 and emits fixed safe errno classes. Original IAM/user/PKCE/Auth.js functions unchanged.
**P05-OIDC-04-A01 function audit:** The inline Python private Traefik readiness probe in `tests/ci/oidc_e2e/run.sh` now prints only enumerated socket error classes or numeric HTTP status, closes its HTTP socket and conditionally retries known transient errors (3 attempts max), before any OIDC client/user exists. On successful first attempt, control continues to the already-present safe port-8080 inode/PID inspector, private Socat, official provisioning and real browser acceptance. Run #96 verified all positive/negative browser/session/logout and cleanup gates, but **did not exercise retry or Python fallback**. No protected Account/Auth.js/Login V2 functions were changed.
+6
View File
@@ -84,3 +84,9 @@ The original Run #93 `7b80f41`, job #206, did start after the A01 queued snapsho
The source `79dac4f5bb76e1cee4dfaf61657c6e84268b3dfb` adds a pre-bind proxy PID/netns `/proc/net/tcp{,6}` listener-inode inspection, maps to `/proc/*/fd` and sanitized comm, and changes only run-owned socat/Python forwarder networking from `container:$proxy_id` to the existing disposable Compose network, forwarding to private `proxy:80`. One-off provisioning/Chromium containers join `container:$forwarder`, so issuer remains `http://localhost:8080` without publishing host ports. Auth.js, original Login V2, negative cases, credentials and owned cleanup contracts remain untouched.
In the ONLY new Run #95, the original 4 services were healthy but the **earlier** direct Traefik:80 readiness probe emitted `OIDC_CI_PRIVATE_PROXY_SOCKET_OR_HTTP_BLOCKED`. Thus the new socket diagnostic, forwarder and real OIDC pipeline **were not executed**; actual listener owner remains UNKNOWN. Mandatory cleanup PASS. Next minimal separately approved diagnostic must classify the direct private Host/socket failure before further forwarder remediation; see `notes/P05-OIDC-04.md`.
## P05-OIDC-04-A01 — verified real user E2E in disposable CI (SUCCESS)
Gitea [Run #96](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/96), job #210, source `670e225db477f180ff14ffa62e6654860a166f17`, confirmed the expected network split and full end-to-end identity acceptance. `run.sh` now classifies private pre-forwarder probe socket/HTTP failures with allowlisted markers and at most 3 attempts conditional on transient socket classes; **this first actual check passed** (so retries and failure classifications were not triggered). The existing pre-bind `/proc/net/tcp{,6}` inspector identified a real TCP6 LISTEN inode `6286327` at port 8080 owned by `traefik` PID 1 in the disposable proxy namespace. The separate Socat namespace (private Docker network) used its own loopback :8080 and Docker-private proxy:80 to preserve `http://localhost:8080` issuer/Host without public host ports. Both private ready and issuer discovery returned verified PASS.
Official ZITADEL API created disposable project/client/verified test human, isolated secrets in run-owned volumes; original Login V2 + Chromium + Auth.js completed real authorization code PKCE S256/state/nonce, password callback, subject/cookie/protected Account API/page, anonymous/tampered-callback failures and local logout. `always()` cleanup verified original backend/bootstrap/secret volumes, network and labeled containers removed. `forwarder.py` unchanged and Python fallback not needed. **Only isolated development-origin E2E is accepted**; production TLS, custom imported Login V2 wiring, MFA/passkeys, Admin Console human flow, multi-app SSO and deployment are separate.
+10 -6
View File
@@ -1,8 +1,8 @@
# ZitPlane ? exact tracked source inventory
**Snapshot:** 2026-11-23, P05-OIDC-03-A02 terminal Gitea Run #93 job #206 at tested source `7b80f411b2981e2274d171c12596301ed757b768`: job STARTED/COMPLETED FAILURE; backend/private proxy PASS, socat SOCKET_BIND_ERROR and Python ADDRESS_IN_USE on 127.0.0.1:8080, real OIDC NOT EXECUTED, exact owned cleanup PASS. Actual listener owner UNKNOWN. Final docs-only commit is not a new tested source.
**Snapshot:** 2026-11-23, P05-OIDC-04-A01 terminal Gitea [Run #96](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/96), job #210, immutable tested source `670e225db477f180ff14ffa62e6654860a166f17`: **SUCCESS**, private 8080 socket owner Traefik PID1, real disposable Chromium/Login V2/Auth.js authenticated Account session/negative/logout **PASS**, exact run-owned cleanup **PASS**. Production HTTPS/MFA/custom Login integration NOT VERIFIED. Documentation-only closure SHA is not the CI-tested source.
**Git-tracked paths: 757.** Untracked `AI_INSTRUCTIONS.md` and local secrets excluded.
**Git-tracked paths: 759.** Untracked `AI_INSTRUCTIONS.md` and local secrets excluded.
This list reflects actual tracked Git files, not proof of authenticated OIDC. See `notes/P05-OIDC-03.md` and `project/OIDC-E2E-ARCHITECTURE.md`.
@@ -13,8 +13,8 @@ This list reflects actual tracked Git files, not proof of authenticated OIDC. Se
| `auth` | 639 | Pinned official Login V2 source, unmodified |
| `core` | 2 | Backend dev helper, unmodified |
| `deployment` | 2 | P02 dev Compose, unmodified |
| `docs` | 24 | User and operator docs |
| `notes` | 16 | Phase plans and CI evidence |
| `docs` | 25 | User and operator docs |
| `notes` | 17 | Phase plans and CI evidence |
| `packages` | 1 | Repository root |
| `project` | 12 | Source, functions and architecture inventory |
| `scripts` | 1 | Repository root |
@@ -695,7 +695,7 @@ This list reflects actual tracked Git files, not proof of authenticated OIDC. Se
- `deployment/README.md`
- `deployment/docker/compose.backend.dev.yaml`
### docs ? 24 files
### docs ? 25 files
- `docs/ARCHITECTURE.md`
- `docs/DEVELOPMENT.md`
@@ -713,6 +713,7 @@ This list reflects actual tracked Git files, not proof of authenticated OIDC. Se
- `docs/P05-OIDC-03-A01.md`
- `docs/P05-OIDC-03-A02.md`
- `docs/P05-OIDC-04.md`
- `docs/P05-OIDC-04-A01.md`
- `docs/P05-SEC-01.md`
- `docs/P05-SEC-02-A01.md`
- `docs/P05-SEC-02.md`
@@ -722,7 +723,7 @@ This list reflects actual tracked Git files, not proof of authenticated OIDC. Se
- `docs/TROUBLESHOOTING.md`
- `docs/USER-GUIDE.md`
### notes ? 16 files
### notes ? 17 files
- `notes/CHANGELOG.md`
- `notes/DOCS-01.md`
@@ -736,6 +737,7 @@ This list reflects actual tracked Git files, not proof of authenticated OIDC. Se
- `notes/P05-OIDC-03-A01.md`
- `notes/P05-OIDC-03-A02.md`
- `notes/P05-OIDC-04.md`
- `notes/P05-OIDC-04-A01.md`
- `notes/P05-SEC-01.md`
- `notes/P05-SEC-02-A01.md`
- `notes/P05-SEC-02.md`
@@ -817,3 +819,5 @@ This list reflects actual tracked Git files, not proof of authenticated OIDC. Se
- `users/ui/tsconfig.json`
**P05-OIDC-04 inventory update (2026-11-23):** From the prior snapshot, one tracked `notes/P05-OIDC-04.md` and one tracked `docs/P05-OIDC-04.md` were added (755 → 757), with only two existing CI source files modified. Source `79dac4f5bb76e1cee4dfaf61657c6e84268b3dfb` was the one tested in Gitea Run #95, which FAILED before socket inspector/forwarder. The final docs commit is not a newly tested source. Excluded/untracked root `AI_INSTRUCTIONS.md` remains untouched.
**A01 inventory verification note:** At tested source `670e225db477f180ff14ffa62e6654860a166f17`, Gitea recursive tree had 758 tracked blobs (one A01 pre-source note added to prior 757). The subsequent documentation-only addition `docs/P05-OIDC-04-A01.md` makes **759 tracked blobs**; all other A01 changes were modifications to existing allowed source/docs. No untracked root `AI_INSTRUCTIONS.md` touched or represented as Git-tracked.