docs(oidc): record Run 95 private proxy readiness failure and verified cleanup
This commit is contained in:
1 parent
79dac4f5bb
commit
52b2169104
15 files changed
+117
-6
No files matched your search
@@ -16,6 +16,7 @@ Compact, developer-friendly monorepo for a central identity service, a branded l
|
||||
- **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:** **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\`.
|
||||
- **Production / Coolify:** not configured or deployed.
|
||||
|
||||
## Documentation and project knowledge
|
||||
|
||||
@@ -51,3 +51,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).
|
||||
@@ -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.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 |
|
||||
| [TROUBLESHOOTING.md](TROUBLESHOOTING.md) | Known blockers and safe diagnosis based on source status | DOCS-01 / active |
|
||||
|
||||
@@ -0,0 +1,30 @@
|
||||
# P05-OIDC-04 — Private OIDC Forwarder Isolation and Run #95 Acceptance
|
||||
|
||||
**Approved baseline:** `89bc3f21af53e481c68ee06c8eb120e30b855038`
|
||||
**Tested source:** `79dac4f5bb76e1cee4dfaf61657c6e84268b3dfb` (single CI-only source commit, not the later documentation SHA).
|
||||
**Evidence:** [Gitea Run #95](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/95), job **#209**, 2026-11-22 19:40:58–19:46:22 UTC, **COMPLETED / FAILURE**.
|
||||
|
||||
## What was implemented
|
||||
|
||||
A source-only, disposable CI change first audits proxy-namespace TCP port 8080 from `/proc/net/tcp{,6}` and PID/socket mappings, printing only safe process name/PID/inode classifications. A run-labeled forwarder is then intended to own a separate private Docker network namespace with IPv4 loopback `localhost:8080`, forwarding bytes to Docker-private `proxy:80`. Provisioning and original Chromium Account acceptance join that same forwarder namespace. The issuer `http://localhost:8080`, exact Host, login/auth logic, original Compose and cleanup guardrails are unchanged. Nothing publishes a host port.
|
||||
|
||||
## What Gitea actually verified
|
||||
|
||||
| Gate | Run #95 |
|
||||
| --- | --- |
|
||||
| Runner, checkout and Docker/Compose | **PASS** |
|
||||
| No public host ports and disposable ownership preflight | **PASS** |
|
||||
| Four official backend services healthy | **PASS** |
|
||||
| Direct private Traefik Host HTTP readiness | **FAIL**: `OIDC_CI_PRIVATE_PROXY_SOCKET_OR_HTTP_BLOCKED` |
|
||||
| New 8080 PID/socket inspector | **NOT EXECUTED** |
|
||||
| Isolated Socat/Python forwarder and forwarded HTTP 200 | **NOT EXECUTED** |
|
||||
| Real disposable project, client and human | **NOT EXECUTED** |
|
||||
| Chromium Login V2, PKCE/state/nonce, Auth.js callback/session and protected API/pages | **NOT EXECUTED** |
|
||||
| Anonymous/invalid callback rejection and logout | **NOT EXECUTED** |
|
||||
| Mandatory owned-only cleanup | **PASS**: both backend and OIDC cleanup markers |
|
||||
|
||||
**Important:** The exact listener owner from earlier Run #93 is still UNKNOWN. Run #95 failed before the inspector, so the new forwarder design has **not** been runtime-proven. Do not claim production login, real authenticated OIDC or MFA support.
|
||||
|
||||
## Next narrow action
|
||||
|
||||
A separately approved P05-OIDC-04-A01 should classify the **direct private proxy:80 HTTP/socket readiness failure** safely *before* the 8080 inspection. Only after evidence justifies a minimal adjustment should one fresh disposable CI cycle verify real login, negative gates and always cleanup. Never disable PKCE/state/nonce, publicize test ports or use real human accounts. Full ledger and next exact Scope Lock: [notes/P05-OIDC-04.md](../notes/P05-OIDC-04.md).
|
||||
@@ -120,3 +120,9 @@ Coolify, HTTPS, secrets, backups, durable storage and focused production readine
|
||||
- **PASS:** checkout and Docker preflight, no host ports, four healthy backend/Postgres/Login V2/Traefik services, direct private proxy Host HTTP 200, pinned image/digests and mandatory owned-only cleanup.
|
||||
- **FAIL:** socat process exited 1, `SOCKET_BIND_ERROR`; same-run Python forwarder exited 1, `ADDRESS_IN_USE` on private TCP `127.0.0.1:8080`. Exact listener identity/port owner **not yet established**. **NOT EXECUTED:** real client/project/human, Chromium original Login V2, PKCE/state/nonce/Auth.js callback/session, protected identity, negatives and logout. Full authenticated OIDC **BLOCKED**.
|
||||
- **Exact A02 write scope only** `notes/**`, `project/**`, relevant `docs/**`, associated README/MINIFEST; all CI/auth/backend/Compose/workflow/runner/source/locks/production strictly **read-only**. No local app tests, second run, tags/releases, real users or production. Evidence `notes/P05-OIDC-03-A02.md`, operator guide `docs/P05-OIDC-03-A02.md`. Next proposed `P05-OIDC-04`: disposable namespace-local port-8080 listener RCA, separately approved narrow CI-only remediation and one fresh isolated full OIDC acceptance.
|
||||
|
||||
## P05-OIDC-04 — Private socket forensics and isolated forwarder (terminal 2026-11-23)
|
||||
|
||||
- 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`.
|
||||
+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 **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.
|
||||
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.
|
||||
@@ -120,3 +120,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).
|
||||
@@ -79,3 +79,7 @@ Existing Gitea Run #93/job #206 has not been assigned a running job at the inspe
|
||||
## P05-OIDC-03-A02 — Run #93 real terminal blocker, not a runner-queue outage
|
||||
|
||||
Previously queued Run #93 eventually ran: job #206 started and failed after healthy backend/proxy. Socat and Python fallback both could **not bind private 127.0.0.1:8080**. Socat classified `SOCKET_BIND_ERROR`; Python explicitly `ADDRESS_IN_USE`. That is strong evidence of a **port collision**, but there is **no verified socket inode/process owner yet**; do not attribute it to Traefik, ZITADEL or another process by guess. Do not disable issuer/PKCE checks, expose host 8080, reuse production secrets, or edit original backend/Account code. Safe next step requires separate approved CI-only private listener inspection before forwarding. Existing `always()` cleanup PASS; no residual run-owned containers/network/secrets. Full evidence: `docs/P05-OIDC-03-A02.md`.
|
||||
|
||||
## 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).
|
||||
@@ -21,4 +21,6 @@ This is the chronological **index**. Phase-specific scope/implementation evidenc
|
||||
| 2026-11-23 | P05-OIDC-03-A01 | Historical read-only Run #93 queue snapshot (prior to execution) | At A01 inspection QUEUED, job not started; **superseded by A02 terminal evidence**. [Evidence](P05-OIDC-03-A01.md) |
|
||||
| 2026-11-23 | P05-OIDC-03-A02 | Read-only Run #93 terminal job #206 RCA, safe private forwarding diagnosis and scope closure | Run #93 **FAILURE**: 4 services/proxy PASS, socat SOCKET_BIND_ERROR, Python ADDRESS_IN_USE, real OIDC NOT EXECUTED, mandatory cleanup PASS. [Evidence](P05-OIDC-03-A02.md) |
|
||||
|
||||
| 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) |
|
||||
|
||||
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.
|
||||
@@ -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.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 |
|
||||
|
||||
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,3 +27,49 @@ The CI-only run script starts both its socat and fallback sidecars with `--netwo
|
||||
5. Final docs-only synchronization and Git main/remote SHA verification without new CI. If blocked, distinguish the exact failure and downstream unexecuted gates; do not claim authenticated acceptance or a listener owner absent reliable evidence.
|
||||
|
||||
**Pre-run disposition:** Not yet executed in P05-OIDC-04; real authenticated OIDC remains BLOCKED pending one terminal disposable CI result.
|
||||
|
||||
## Terminal Gitea CI acceptance — ONE authorized Run #95
|
||||
|
||||
**Evidence:** [Gitea Run #95](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/95), **job #209**, manual `workflow_dispatch` on `main`; tested **exact source SHA `79dac4f5bb76e1cee4dfaf61657c6e84268b3dfb`**, distinct from the later documentation commit. Started `2026-11-22T19:40:58Z`; completed `2026-11-22T19:46:22Z`. Run status `completed`, conclusion **`failure`**.
|
||||
|
||||
The approved source preparation was one documentation Scope Lock commit `1cf6d65f041137ba6c2ec1c6f452397db133be46` followed by one focused commit `79dac4f5bb76e1cee4dfaf61657c6e84268b3dfb` modifying ONLY `tests/ci/oidc_e2e/run.sh` and `forwarder.py`. Focused diff verified the isolated network strategy, never-opened host ports, private loopback-only binding, absent credentials/log payloads and unchanged original backend/Compose/Login/Account/lockfiles. No other CI dispatch, rerun, local app test/build or deployment.
|
||||
|
||||
Job #209 steps: #0 Git install **SUCCESS**; #1 checkout **SUCCESS**; #2 real disposable OIDC execution **FAILURE**; #3 mandatory owned-only cleanup **SUCCESS**.
|
||||
|
||||
| Exact acceptance gate | Result / safe evidence |
|
||||
| --- | --- |
|
||||
| Runner accepted job and exact source checkout | **PASS**; job #209 ran at `79dac4f5bb76e1cee4dfaf61657c6e84268b3dfb` |
|
||||
| Docker/Compose and ownership preflight | **PASS**; `ZITPLANE_OIDC_DOCKER_PREFLIGHT_PASS` |
|
||||
| No published host ports; isolated first-instance IAM_OWNER configuration | **PASS**; `ZITPLANE_OIDC_NO_PUBLISHED_PORT_AND_OWNER_CONFIG_PASS` |
|
||||
| Four healthy disposable Postgres/ZITADEL API/official Login V2/Traefik services | **PASS**; `ZITPLANE_OIDC_FOUR_SERVICES_READY_PASS` |
|
||||
| Direct private Traefik:80 readiness with exact Host `localhost:8080` | **FAIL**; `OIDC_CI_PRIVATE_PROXY_SOCKET_OR_HTTP_BLOCKED`; no returned status or precise failure errno/class |
|
||||
| Proxy namespace port-8080 listener inode/PID/process forensics | **NOT EXECUTED**; guarded behind failing direct readiness |
|
||||
| Socat immutable image validation and dedicated forwarder startup | **NOT EXECUTED** |
|
||||
| Python immutable-image fallback and private port-8080 forwarding | **NOT EXECUTED** |
|
||||
| Forwarded private localhost:8080 exact-Host HTTP 200 and issuer/discovery | **NOT EXECUTED** |
|
||||
| Official ZITADEL disposable project and OIDC app/client creation | **NOT EXECUTED** |
|
||||
| Official disposable verified test human creation | **NOT EXECUTED** |
|
||||
| Real Chromium original Login V2 username/password | **NOT EXECUTED** |
|
||||
| Authorization code, PKCE S256, state, nonce | **NOT EXECUTED** |
|
||||
| Genuine Auth.js callback and authenticated Account session | **NOT EXECUTED** |
|
||||
| Protected Account page and identity API | **NOT EXECUTED** |
|
||||
| Anonymous and tampered callback rejection | **NOT EXECUTED** |
|
||||
| Local logout and authenticated session invalidation | **NOT EXECUTED** |
|
||||
| Mandatory owned-only cleanup | **PASS**; `ZITPLANE_BACKEND_CLEANUP_VERIFIED_PASS` and `ZITPLANE_OIDC_ALL_RESOURCES_CLEANED_PASS` |
|
||||
|
||||
### RCA boundary
|
||||
|
||||
Run #95 stopped **before** executing the new pre-bind listener inspection. Therefore the exact process owning proxy-local TCP 8080 remains **UNKNOWN**; the historical Run #93 `ADDRESS_IN_USE` evidence is not disproved, but **Run #95 did not reproduce or attribute it**. The run demonstrates that Compose healthy status is not equivalent to the separate network-namespace exact-Host HTTP probe. The observed probe error is intentionally generic (connection/socket/HTTP); neither Traefik failure nor runner outage nor authentication regression can be inferred from it. The remediation candidate in `79dac4f5bb76e1cee4dfaf61657c6e84268b3dfb` is **committed but unverified at runtime**, since socat/Python never started.
|
||||
|
||||
### Final P05-OIDC-04 acceptance and next exact proposal
|
||||
|
||||
**Phase source/Scope Lock audit:** COMPLETE. **Run #95:** TERMINAL FAILURE; **cleanup:** PASS. **Real authenticated OIDC acceptance:** BLOCKED/NOT EXECUTED. **Production readiness and MFA:** NOT VERIFIED. Preserve this distinction and no more CI dispatch in this phase.
|
||||
|
||||
**Next phase proposed, requires separate approval — P05-OIDC-04-A01 / direct private proxy readiness diagnostics:**
|
||||
|
||||
- **Write:** create `notes/P05-OIDC-04-A01.md` before any source changes; `tests/ci/oidc_e2e/run.sh` only for bounded, secret-safe direct `proxy:80` localhost Host readiness failure classification and conditionally justified finite retry; at most one strictly focused diagnostics helper under `tests/ci/oidc_e2e/` if absolutely needed; relevant `notes/**`, `project/**`, `docs/**` and manifests.
|
||||
- **Strict read-only:** `tests/ci/oidc_e2e/forwarder.py`, all other CI harness files, `.gitea/workflows/**`, original backend/Compose/Login/Auth.js/Account, package manifests/locks, runner configuration, secrets, production and unrelated files.
|
||||
- Inspect independent proxy container state, namespace-local TCP connection class (refused/timeout), exact Host readiness HTTP status **without response body or sensitive URLs**. Differentiate actual startup race from route/policy failure *before* changing timeouts. Preserve one-run labels, no public ports, issuer, negative tests and always-owned cleanup.
|
||||
- Focused source audit, one independently approved disposable Gitea CI run with exact tested SHA, full OIDC gates if reachable, terminal cleanup, final docs commit and remote SHA verification. No repeated runs, local builds, real people, production, tags or releases.
|
||||
|
||||
No claim of successful socket attribution or authenticated login is permitted from Run #95.
|
||||
@@ -21,6 +21,8 @@ This is the **developer-focused implementation history**. `notes/CHANGELOG.md` i
|
||||
| 2026-11-23 | P05-OIDC-03-A01 | Historical read-only Run #93 queue snapshot before runner pickup, no source edit | Queued then; **superseded by A02 terminal result**. `notes/P05-OIDC-03-A01.md` |
|
||||
| 2026-11-23 | P05-OIDC-03-A02 | Read-only terminal Run #93 job #206 scheduling completion, private socket collision and verified cleanup | Run FAILURE; socat bind error, Python EADDRINUSE, no authenticated flow; cleanup PASS. `notes/P05-OIDC-03-A02.md` |
|
||||
|
||||
| 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\` |
|
||||
|
||||
## 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.
|
||||
@@ -160,3 +160,7 @@ Historical Run #91 used this workflow and reached a terminal job, but that only
|
||||
## P05-OIDC-03-A02 — terminal existing Run #93 (supersedes queued snapshot)
|
||||
|
||||
[Run #93](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/93) tested `7b80f411b2981e2274d171c12596301ed757b768`, job #206 **started 2026-11-22T18:36:26Z and completed 18:37:47Z with FAILURE**. The manual workflow/runner job was scheduled and checkout/Docker executed; current runner availability outside this historical run cannot be established through available Gitea read actions. Four-service backend startup, no published host ports, exact private Traefik Host routing and pinned/digest image metadata passed. Socat exited 1 with `SOCKET_BIND_ERROR`, Python stdlib fallback image/digest/start attempt passed but its private IPv4 listener exited 1 with `ADDRESS_IN_USE`. **Exact process holding namespace-local TCP port 8080 was not identified**; the source Compose Traefik service is configured to listen on :80, while ZITADEL API listens in its own container namespace on :8080, so neither is proved to own the collided private socket. No official client/user provisioning, original Chromium Login V2 authorization, PKCE/state/nonce/Auth.js callback, protected Account session, negative auth or logout tests executed. Mandatory exact run-owned cleanup **PASS** on both expected markers. No workflow rerun/source change under A02. Full evidence: `notes/P05-OIDC-03-A02.md`, `docs/P05-OIDC-03-A02.md`.
|
||||
|
||||
## 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.
|
||||
@@ -78,3 +78,9 @@ Run #91 established an isolated private Traefik:80/Host HTTP 200 and a socat sid
|
||||
## P05-OIDC-03-A02 — verified private port-8080 startup collision, no authenticated session
|
||||
|
||||
The original Run #93 `7b80f41`, job #206, did start after the A01 queued snapshot; overall **FAILURE**. Its source-approved socat and optional Python forwarder each failed binding private **127.0.0.1:8080**: socat diagnostic `SOCKET_BIND_ERROR`, Python diagnostic `ADDRESS_IN_USE`. The private Traefik:80 Host route and four ZITADEL/backend services were healthy; the image/digest/optional fallback startup commands themselves were invoked. The precise listener process holding port 8080 has **not** been identified with a namespace-local socket/process audit, and no source auth defect was exercised. Client/user provisioning and all genuine Chromium/PKCE/Auth.js/session tests **NOT EXECUTED**. The always-run exact-owned cleanup verified removal of its ephemeral credentials, data, volumes and network. Future separately approved CI-only phase should inspect the actual private listener/inode and avoid port collision without exposing ports or changing the original P02 developer Compose, Login V2 or Account Auth.js.
|
||||
|
||||
## P05-OIDC-04 — dedicated private forwarder namespace (CI candidate; not runtime accepted)
|
||||
|
||||
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`.
|
||||
@@ -2,7 +2,7 @@
|
||||
|
||||
**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.
|
||||
|
||||
**Git-tracked paths: 755.** Untracked `AI_INSTRUCTIONS.md` and local secrets excluded.
|
||||
**Git-tracked paths: 757.** 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` | 23 | User and operator docs |
|
||||
| `notes` | 15 | Phase plans and CI evidence |
|
||||
| `docs` | 24 | User and operator docs |
|
||||
| `notes` | 16 | 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 ? 23 files
|
||||
### docs ? 24 files
|
||||
|
||||
- `docs/ARCHITECTURE.md`
|
||||
- `docs/DEVELOPMENT.md`
|
||||
@@ -712,6 +712,7 @@ This list reflects actual tracked Git files, not proof of authenticated OIDC. Se
|
||||
- `docs/P05-OIDC-03.md`
|
||||
- `docs/P05-OIDC-03-A01.md`
|
||||
- `docs/P05-OIDC-03-A02.md`
|
||||
- `docs/P05-OIDC-04.md`
|
||||
- `docs/P05-SEC-01.md`
|
||||
- `docs/P05-SEC-02-A01.md`
|
||||
- `docs/P05-SEC-02.md`
|
||||
@@ -721,7 +722,7 @@ This list reflects actual tracked Git files, not proof of authenticated OIDC. Se
|
||||
- `docs/TROUBLESHOOTING.md`
|
||||
- `docs/USER-GUIDE.md`
|
||||
|
||||
### notes ? 15 files
|
||||
### notes ? 16 files
|
||||
|
||||
- `notes/CHANGELOG.md`
|
||||
- `notes/DOCS-01.md`
|
||||
@@ -734,6 +735,7 @@ This list reflects actual tracked Git files, not proof of authenticated OIDC. Se
|
||||
- `notes/P05-OIDC-03.md`
|
||||
- `notes/P05-OIDC-03-A01.md`
|
||||
- `notes/P05-OIDC-03-A02.md`
|
||||
- `notes/P05-OIDC-04.md`
|
||||
- `notes/P05-SEC-01.md`
|
||||
- `notes/P05-SEC-02-A01.md`
|
||||
- `notes/P05-SEC-02.md`
|
||||
@@ -813,3 +815,5 @@ This list reflects actual tracked Git files, not proof of authenticated OIDC. Se
|
||||
- `users/ui/src/styles/globals.css`
|
||||
- `users/ui/src/types/next-auth.d.ts`
|
||||
- `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.
|
||||
Reference in new issue
Block a user