docs(ci): close OIDC run 93 terminal bind RCA and safe cleanup
This commit is contained in:
1 parent
88911c5d68
commit
89bc3f21af
17 files changed
+143
-12
No files matched your search
@@ -15,7 +15,7 @@ Compact, developer-friendly monorepo for a central identity service, a branded l
|
||||
- **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:** **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:** CI-only socat startup diagnosis and immutable Python stdlib private fallback committed at `7b80f41`; **single Gitea Run #93 QUEUED**, job #206 not started/logs unavailable; all OIDC/browser/cleanup checks **NOT EXECUTED**. Read-only scheduling audit P05-OIDC-03-A01 cannot establish current runner online state. See `docs/P05-OIDC-03-A01.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`.
|
||||
- **Production / Coolify:** not configured or deployed.
|
||||
|
||||
## Documentation and project knowledge
|
||||
|
||||
@@ -48,3 +48,6 @@ Future feature additions need an evidence-backed status update here, an exact de
|
||||
|
||||
|
||||
**P05-OIDC-03-A01 queue audit:** Existing manual [Run #93](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/93), job #206 was **QUEUED** (no start, steps or conclusion). Gitea job log returned `404 job not started`; workflow active with `ubuntu-latest` label, but current runner availability cannot be confirmed. Every real OIDC project/client/user, browser callback/session, negative and mandatory cleanup gate **NOT EXECUTED**; Login security/build acceptance from earlier separate phases remains valid. See `docs/P05-OIDC-03-A01.md`.
|
||||
|
||||
|
||||
**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.
|
||||
+2
-1
@@ -16,7 +16,8 @@ Every file listed below is a direct child of `docs/`. Add/remove rows whenever t
|
||||
| [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) | Pinned prebuilt forwarder, safe private HTTP diagnostics and actual Run #91 evidence | P05-OIDC-02 / real OIDC BLOCKED by forwarder exit 1, cleanup PASS |
|
||||
| [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) | Existing Gitea Run #93 read-only scheduling evidence, actual unexecuted checks and safe next steps | P05-OIDC-03-A01 / queue audit, no terminal OIDC acceptance |
|
||||
| [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 |
|
||||
| [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 |
|
||||
|
||||
@@ -24,3 +24,6 @@ Continue inspecting **the existing Run #93**, not dispatching another run. A Git
|
||||
If job #206 begins/completes, inspect its genuine terminal logs and confirm each OIDC, negative-auth and mandatory cleanup marker before declaring acceptance. If it remains queued, record the exact status and missing runner visibility as a **scheduling/availability investigation**, not a proven outage.
|
||||
|
||||
Development evidence and exact phase scope: `notes/P05-OIDC-03-A01.md`. CI source remains at tested candidate `7b80f411b2981e2274d171c12596301ed757b768`; final documentation commit is not a new tested SHA.
|
||||
|
||||
|
||||
**Later terminal correction (P05-OIDC-03-A02):** Run #93 subsequently started and completed **FAILURE**. This A01 file preserves a historical earlier queued snapshot, not the current outcome. The actual job proved backend/private proxy PASS, socat bind error, Python forwarder `ADDRESS_IN_USE`, real OIDC not executed, and complete cleanup PASS. See [P05-OIDC-03-A02.md](P05-OIDC-03-A02.md). No new run was dispatched.
|
||||
@@ -0,0 +1,33 @@
|
||||
# P05-OIDC-03-A02 — Existing Run #93 Final CI Result & Runner Audit
|
||||
|
||||
**Baseline:** `88911c5d685ed4d068e6361d5e920108c217046f`.
|
||||
**Existing [Gitea Run #93](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/93)**, job **#206**, tested source `7b80f411b2981e2274d171c12596301ed757b768`.
|
||||
**Final status:** **COMPLETED / FAILURE**. The previous “queued” report was accurate at that snapshot but is now superseded by this **later terminal run**.
|
||||
|
||||
## What happened
|
||||
|
||||
The Gitea runner began job #206 at **2026-11-22 18:36:26 UTC** and completed at **18:37:47 UTC**. This proves the runner accepted and executed the job; the exact earlier queue delay is not established. The manual workflow is still **active**, with `runs-on: ubuntu-latest`. Current runner online/busy/label details were not available from the connected Gitea read tool; the actual job did run, so the original “queued” state is **no longer the blocking issue**.
|
||||
|
||||
| Actual Run #93 test | Verified result |
|
||||
| --- | --- |
|
||||
| Git checkout/Docker and Compose | **PASS** |
|
||||
| All 4 disposable ZITADEL/Postgres/Login V2/Traefik services healthy | **PASS** |
|
||||
| No host ports and correct private Traefik Host routing | **PASS** |
|
||||
| Socat prebuilt image/digest | **PASS** |
|
||||
| Socat TCP forwarder | **FAIL** — exited 1; classified `SOCKET_BIND_ERROR` |
|
||||
| Python immutable-image fallback | Image verified and fallback started; TCP bind **FAIL**: `ADDRESS_IN_USE` |
|
||||
| Actual private forwarded 8080 HTTP readiness | **NOT VERIFIED** |
|
||||
| Real OIDC project/client/user creation | **NOT EXECUTED** |
|
||||
| Real Chromium original Login V2 and PKCE/state/nonce/callback | **NOT EXECUTED** |
|
||||
| Auth.js authenticated session, protected page/API, negative cases, logout | **NOT EXECUTED** |
|
||||
| Mandatory owned-only cleanup | **PASS** — verified no run-owned resources left |
|
||||
|
||||
**Root-cause evidence:** In the private proxy network namespace, both forwarders failed to bind TCP port 8080. Python explicitly reported `ADDRESS_IN_USE`. **The exact process occupying port 8080 is not known**; do not assume it is the ZITADEL API, Traefik or another named service without actual listener/process evidence. The original developer Compose and auth source remain unchanged.
|
||||
|
||||
**Safety:** The run-owned container/volume/database/bootstrap/credentials cleanup succeeded: `ZITPLANE_BACKEND_CLEANUP_VERIFIED_PASS` and `ZITPLANE_OIDC_ALL_RESOURCES_CLEANED_PASS`. No additional run was dispatched and no production secrets or human accounts were used.
|
||||
|
||||
## Next action
|
||||
|
||||
The appropriate next phase is narrowly scoped CI-only **private port-8080 listener diagnostics and remediation**. On an approved new disposable run, inspect the *actual* listener before binding the forwarder (without logging credentials or network payloads), fix the confirmed collision without exposing host ports or weakening Auth.js, and verify full real client/user/browser/callback/session/negative/cleanup gates. There is **no basis to call real authenticated OIDC PASS today**.
|
||||
|
||||
Exact forensic ledger, scope and source/runner evidence: `notes/P05-OIDC-03-A02.md`. The tested Run #93 source SHA above remains distinct from the later documentation-only Git SHA.
|
||||
@@ -112,3 +112,11 @@ Coolify, HTTPS, secrets, backups, durable storage and focused production readine
|
||||
- **Only existing Run #93** may be checked; no additional dispatch, rerun, cancellation, runner config updates, workflow/backend/Login/Auth.js/CI source edits, local builds or production/real accounts. Exact write scope only `notes/**`, `project/**`, relevant `docs/**`, associated README/MINIFEST and navigation when necessary.
|
||||
- Every Run #93 gate is **NOT EXECUTED**: Git checkout, disposable backend/forwarder/provisioning, browser PKCE/state/nonce/Auth.js callback/session, positive/negative authorization, logout and mandatory owned cleanup. The only correct acceptance statement is **PENDING / NOT VERIFIED**, not test FAILURE or PASS.
|
||||
- Next narrow task: read-only check whether **this same Run #93** is scheduled/completed and inspect authorized Gitea runner online/label/capacity state, without modifying runners or dispatching more jobs. Terminal evidence, if it becomes available, must be documented before claiming positive OIDC acceptance. Evidence: `notes/P05-OIDC-03-A01.md`, operator guidance: `docs/P05-OIDC-03-A01.md`.
|
||||
|
||||
|
||||
## P05-OIDC-03-A02 — Existing Run #93 terminal RCA (APPROVED; 2026-11-23)
|
||||
|
||||
- **Baseline** `88911c5d685ed4d068e6361d5e920108c217046f`. **One existing Run #93**, immutable tested SHA `7b80f411b2981e2274d171c12596301ed757b768`, job #206 eventually scheduled/executed, **overall FAILURE** at 18:37:47 UTC on 2026-11-22. Earlier A01 `queued` snapshot was true then, but is **superseded** by this terminal result. Workflow requests `ubuntu-latest`; current runner online/labels/capacity details still unavailable through connector, but job pickup proved for this run.
|
||||
- **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.
|
||||
+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 read-only [Run #93 queue audit](P05-OIDC-03-A01.md) and no-executed-step limitations see P05-OIDC-03-A01. The underlying [P05-OIDC-03 CI implementation](P05-OIDC-03.md) remains awaiting the same run. 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 **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.
|
||||
@@ -117,3 +117,6 @@ In Gitea `vibtools/ZitPlane` → Actions → **ZitPlane P05-OIDC-01 Disposable R
|
||||
|
||||
|
||||
**P05-OIDC-03 acceptance:** The existing manual `p05-oidc-acceptance.yml` on a dedicated Gitea Docker runner will first classify the disposable socat startup and, if unhealthy, start a digest-verified official Python-only `127.0.0.1:8080` loopback forwarder within the same private proxy namespace. It then must prove the original official OIDC client/user + real Chromium Login V2/Account callback/session/negative contracts and owned-resource teardown. This changes no production secrets, identity settings, Login/Auth.js code or published host ports. Actual PASS/BLOCKED status is in `notes/P05-OIDC-03.md`.
|
||||
|
||||
|
||||
**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`.
|
||||
@@ -74,3 +74,8 @@ Job #197 in [Run #90](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/90) fai
|
||||
## P05-OIDC-03-A01 — Gitea Run #93 queued, job not started
|
||||
|
||||
Existing Gitea Run #93/job #206 has not been assigned a running job at the inspected snapshot: no steps, no actual start timestamp and job log API returns `404 job not started`. Workflow `p05-oidc-acceptance.yml` is active and requests `ubuntu-latest`. This **does not prove** the runner is offline, that labels mismatch, or that the Python/socat forwarder failed. To investigate, have a suitably authorized Gitea administrator inspect runner online status, matching labels and capacity **without changing settings**. Do not manually dispatch another run or open production ports. No Run #93 teardown occurred because no resources were created. Details: `notes/P05-OIDC-03-A01.md`.
|
||||
|
||||
|
||||
## 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`.
|
||||
+2
-1
@@ -18,6 +18,7 @@ This is the chronological **index**. Phase-specific scope/implementation evidenc
|
||||
| 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 | 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) |
|
||||
| 2026-11-23 | P05-OIDC-03 | Safe socat exit diagnostics and one digest-pinned Python stdlib private TCP fallback within same disposable Gitea cycle | Source pushed; single Gitea Run #93 dispatched on `7b80f41`, **QUEUED**, no steps/cleanup executed; [evidence](P05-OIDC-03.md), acceptance pending |
|
||||
| 2026-11-23 | P05-OIDC-03-A01 | Read-only Gitea Run #93, job #206 and workflow queue/label audit; zero CI reruns or source edits | Run #93 **QUEUED**; job not started, logs 404, workflow active, current runner status not exposed; acceptance unverified. [Evidence](P05-OIDC-03-A01.md) |
|
||||
| 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) |
|
||||
|
||||
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.
|
||||
+2
-1
@@ -14,7 +14,8 @@
|
||||
| [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 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 |
|
||||
| [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) | Read-only Run #93/Job #206 queue status, available runner evidence and exact unexecuted OIDC gate ledger | P05-OIDC-03-A01 / no terminal test, runner queue under investigation |
|
||||
| [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 |
|
||||
| [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.
|
||||
@@ -44,3 +44,8 @@
|
||||
4. **Next action if still queued:** read-only terminal-status check for **Run #93**, plus runner online/label/capacity review through an *authorized* server admin UI where possible, without changing any runner config. Any subsequent config modification, new run or CI code change requires fresh Scope Lock and approval.
|
||||
|
||||
**No passing test claims are authorized without actual Run #93 output.** This is a queue/scheduling evidence phase, not a new OIDC implementation phase.
|
||||
|
||||
|
||||
## Historical queued snapshot superseded by A02 terminal evidence
|
||||
|
||||
**This A01 report captured a true earlier queue-only state.** Gitea Run #93/job #206 **later started at 2026-11-22 18:36:26 UTC and completed FAILURE at 18:37:47 UTC**. Subsequent read-only P05-OIDC-03-A02 verified four healthy services and private proxy Host route PASS; socat `SOCKET_BIND_ERROR`, Python fallback `ADDRESS_IN_USE` on private port 8080; no OIDC client/user/browser/callback executed; mandatory owned-only cleanup PASS. Do not use A01's queued status as current. See `notes/P05-OIDC-03-A02.md` and `docs/P05-OIDC-03-A02.md` for complete terminal evidence.
|
||||
@@ -0,0 +1,55 @@
|
||||
# P05-OIDC-03-A02 — Runner Availability RCA & Existing Run #93 Terminal Acceptance
|
||||
|
||||
**Date:** 2026-11-23 (Asia/Dhaka)
|
||||
**Approved baseline:** `88911c5d685ed4d068e6361d5e920108c217046f`
|
||||
**Existing Run:** [Gitea Run #93](https://dev.ivib.cc/vibtools/ZitPlane/actions/runs/93), **job #206**; tested (immutable) source SHA `7b80f411b2981e2274d171c12596301ed757b768`.
|
||||
**Pre-change scope:** This file was written **before A02 documentation modifications**. Only read existing run, job, logs, workflow and authorized runner scheduling evidence; no CI dispatch/rerun/cancellation and no source, workflow, runner or production writes.
|
||||
|
||||
## Exact A02 Scope Lock
|
||||
|
||||
**Permitted writes:** `notes/**`, `project/**`, relevant `docs/**`, associated README/MINIFEST/root navigation only when necessary. Update historical A01 queued status with new terminal evidence **without rewriting the historical event**. Add this report to source inventory/notes manifest, record exact Gitea acceptance evidence and remaining blocker.
|
||||
|
||||
**Strict read-only:** `tests/ci/**`, `.gitea/workflows/**`, original backend/Compose/Login V2/Account Portal/auth, all package manifests and lockfiles, runner configs, secrets, production, unrelated files and root untracked `AI_INSTRUCTIONS.md`. No local app builds/tests/dev servers, no real human, no production deploy, release, tag, or new workflow dispatch.
|
||||
|
||||
## Focused read-only audit — actual terminal results
|
||||
|
||||
At the A02 read-only inspection, Gitea `get_run(93)` returned **status=`completed`, conclusion=`failure`**, created `2026-11-22T18:08:45Z` and last updated `2026-11-22T18:37:47Z`; original test SHA confirmed exact. `get_job(206)` returned started `2026-11-22T18:36:26Z`, completed `2026-11-22T18:37:47Z`, **failure**. This proves an eligible Gitea runner eventually accepted the job and executed checkout; it does **not** prove the precise earlier queue delay or current runner availability. Workflow remained **active**, requesting `ubuntu-latest`. Connected Gitea tools cannot expose current runner registration/label/capacity data; those are not needed to explain this terminal test's failure, which occurred **after checkout and Docker startup**.
|
||||
|
||||
Job step evidence:
|
||||
- #0 Install Git before checkout: **SUCCESS**
|
||||
- #1 `actions/checkout@v4`: **SUCCESS**, exact SHA `7b80f411b2981e2274d171c12596301ed757b768`
|
||||
- #2 Disposable real OIDC acceptance: **FAILURE**
|
||||
- #3 Mandatory always-run owned Docker cleanup: **SUCCESS**
|
||||
|
||||
| Run #93 gate | Actual outcome / exact safe marker |
|
||||
| --- | --- |
|
||||
| Runner pickup, checkout, Docker CLI/Compose preflight | **PASS**; `ZITPLANE_OIDC_DOCKER_PREFLIGHT_PASS`; Docker 29.9.3, Compose 5.7.2 |
|
||||
| Strict no-host-port Compose and ephemeral IAM_OWNER configuration | **PASS**; `ZITPLANE_OIDC_NO_PUBLISHED_PORT_AND_OWNER_CONFIG_PASS` |
|
||||
| Disposable PostgreSQL, ZITADEL API, original Login V2 and Traefik healthy | **PASS**; `ZITPLANE_OIDC_FOUR_SERVICES_READY_PASS` |
|
||||
| Private proxy at :80 with exact localhost Host route | **PASS**; `ZITPLANE_OIDC_PRIVATE_PROXY_HOST_ROUTE_PASS` |
|
||||
| Versioned prebuilt socat image/immutable digest | **PASS**; `ZITPLANE_OIDC_PINNED_FORWARDER_DIGEST_VERIFIED_PASS` |
|
||||
| Socat process startup and its safe diagnostic | **FAIL**; `OIDC_CI_SOCAT_DIAGNOSTIC_STATE=exited EXIT_CODE=1`; `OIDC_CI_SOCAT_STARTUP_ERROR_CLASS=SOCKET_BIND_ERROR` |
|
||||
| Official Python 3.12 image digest and same-run fallback container start | **PASS for image validation and invocation ONLY**; `ZITPLANE_OIDC_PYTHON_FORWARDER_IMAGE_DIGEST_VERIFIED_PASS`; `ZITPLANE_OIDC_PYTHON_FORWARDER_FALLBACK_STARTED` |
|
||||
| Python fallback TCP listener on private 127.0.0.1:8080 | **FAIL**; `OIDC_CI_FORWARDER_NOT_RUNNING_STATE=exited EXIT_CODE=1`; `OIDC_CI_PYTHON_FORWARDER_STARTUP_ADDRESS_IN_USE` |
|
||||
| Forwarded localhost:8080 HTTP 200, issuer/discovery | **NOT EXECUTED/NOT VERIFIED** (both candidates exited before readiness) |
|
||||
| Official real disposable OIDC project, app/client and human | **NOT EXECUTED** |
|
||||
| Real Chromium original Login V2 username/password, auth code + S256 PKCE/state/nonce | **NOT EXECUTED** |
|
||||
| Genuine Auth.js callback, authenticated subject/session, protected Account API/page | **NOT EXECUTED** |
|
||||
| Anonymous and tampered callback rejection, portal sign out | **NOT EXECUTED** |
|
||||
| Always-run owned database/bootstrap/client-secret/container/volume/network cleanup | **PASS**; `ZITPLANE_BACKEND_CLEANUP_VERIFIED_PASS`; `ZITPLANE_OIDC_ALL_RESOURCES_CLEANED_PASS` |
|
||||
| Overall real-user authenticated OIDC acceptance | **BLOCKED / CI FAILURE**, **not** PASS |
|
||||
|
||||
## RCA confidence, root-cause boundary
|
||||
|
||||
**Confirmed:** Both independent forwarders tried to bind private IPv4 loopback `127.0.0.1:8080` and exited; the Python stdlib code explicitly categorized its listener failure as `ADDRESS_IN_USE` (EADDRINUSE), and socat's bounded/redacted startup classifier reported `SOCKET_BIND_ERROR`. This strongly identifies a **private network-namespace port-8080 listener collision**. This is **not evidence** of a bad user/password, Auth.js callback or PKCE defect because none executed.
|
||||
|
||||
**Not established:** Which exact process owns the private TCP 8080 listener, when it bound, or whether a network/container interaction produced the collision. The original Traefik developer Compose (read-only inspected) configures `--entrypoints.web.address=:80`; ZITADEL API's `ZITADEL_PORT=8080` is in a **different service container/network namespace**, and cannot automatically be blamed. Do not claim that Traefik or ZITADEL is the listener without a run-owned socket/process inspection. No private test data remains after the verified cleanup.
|
||||
|
||||
## A02 implementation/verification plan
|
||||
|
||||
1. Preserve exact Run #93 terminal status and job markers in `notes/P05-OIDC-03-A02.md`, `docs/P05-OIDC-03-A02.md`, relevant project developer maps, user docs, manifests, changelogs and inventory.
|
||||
2. Verify all edits are documentation-only, no untracked `AI_INSTRUCTIONS.md`, secrets or unrelated paths; exact inventory/manifests/relative links.
|
||||
3. Make one documentation-only commit, push Gitea main and verify remote/local SHA and published evidence. **No new CI run.**
|
||||
4. **Next phase only after fresh approval:** `P05-OIDC-04` run-scoped private port-listener forensics: enumerate 8080 TCP listener inode/address **before forwarder bind** in the disposable namespace, attribute process safely without credentials, then make a justified CI-only network/port fix. Verify private exact issuer/Host HTTP 200, real project/client/user/browser and mandatory cleanup in **one new separately approved CI cycle**. Do not edit original backend/Compose/Login/Auth.js or open public ports.
|
||||
|
||||
**Acceptance status:** A02 read-only terminal forensic audit completed; **P05-OIDC-03 real authenticated acceptance BLOCKED by confirmed Python private TCP EADDRINUSE**. No second dispatch/repeated CI in A02. Result-only documentation commit is not a newly tested CI source SHA.
|
||||
@@ -18,7 +18,8 @@ This is the **developer-focused implementation history**. `notes/CHANGELOG.md` i
|
||||
| 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 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` |
|
||||
| 2026-11-23 | P05-OIDC-03 | Allowlisted socat startup diagnostics and strictly private digest-pinned official Python stdlib fallback | Source `7b80f41` on Gitea; Run #93 QUEUED, no CI steps or terminal result. `notes/P05-OIDC-03.md` |
|
||||
| 2026-11-23 | P05-OIDC-03-A01 | Read-only investigation of active manual workflow and Run #93 Job #206 scheduling, no source change | Queued / no steps; Gitea log 404 job not started; current runner availability cannot be established. `notes/P05-OIDC-03-A01.md` |
|
||||
| 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` |
|
||||
|
||||
## Required entry for each future change
|
||||
|
||||
|
||||
@@ -155,3 +155,8 @@ New source in `tests/ci/oidc_e2e/run.sh`: test namespace-local Traefik proxy Hos
|
||||
The existing `p05-oidc-acceptance.yml` manual workflow is **active** and declares one `runs-on: ubuntu-latest` job. Run #93 requested on 2026-11-22T18:08:45Z at tested SHA `7b80f411b2981e2274d171c12596301ed757b768` is still **queued** at the A01 read-only inspection. Job #206 is also `queued` with no actual start/completion times or steps; Gitea returned HTTP 404 `job not started` for its log. This is a **scheduling/queue dependency, not a proved technical error** in the new socat diagnostic, Python TCP fallback, IAM_OWNER API or browser/PKCE/session checks. **No Run #93 authentication or cleanup gates executed.**
|
||||
|
||||
Historical Run #91 used this workflow and reached a terminal job, but that only proves prior runner availability. The connected Gitea read tools contain no online runner/registration/label-capacity read endpoint; current `ubuntu-latest` runner availability is therefore **unknown**, and offline/mismatched/saturated runner or scheduler failure cannot be distinguished. No runner config, workflow, source, credentials or live system touched; no second dispatch. Full read-only ledger: `notes/P05-OIDC-03-A01.md`. Operator guide: `docs/P05-OIDC-03-A01.md`.
|
||||
|
||||
|
||||
## 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`.
|
||||
@@ -73,3 +73,8 @@ Run #91 established an isolated private Traefik:80/Host HTTP 200 and a socat sid
|
||||
`tests/ci/oidc_e2e/forwarder.py` uses Python stdlib `asyncio.start_server`, binds only IPv4 `127.0.0.1:8080`, proxies to namespace-local `127.0.0.1:80`, relays opaque bounded byte chunks and emits only fixed safe startup/relay status markers. No HTTP inspection, cookie extraction, IdP simulation or login bypass. Original provisioning APIs, Account Portal Auth.js, Chromium tests and owner-labeled `cleanup.sh` unchanged.
|
||||
|
||||
**Only terminal Gitea evidence can confirm** socat failure class and Python fallback compatibility, full real ZITADEL client/user creation, original Login V2 browser callback/subject, negative authorization and teardown. Production TLS/MFA still separate.
|
||||
|
||||
|
||||
## 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.
|
||||
@@ -1,8 +1,8 @@
|
||||
# ZitPlane ? exact tracked source inventory
|
||||
|
||||
**Snapshot:** 2026-11-23, P05-OIDC-03-A01 read-only Run #93/job #206 queue audit on test candidate SHA `7b80f411b2981e2274d171c12596301ed757b768`. Workflow ACTIVE, runner label `ubuntu-latest`; run QUEUED, job NOT STARTED, no terminal result or cleanup. Runner online/capacity UNKNOWN; authentication NOT VERIFIED. Final documentation-only commit does not alter tested CI source.
|
||||
**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: 753.** Untracked `AI_INSTRUCTIONS.md` and local secrets excluded.
|
||||
**Git-tracked paths: 755.** 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` | 22 | User and operator docs |
|
||||
| `notes` | 14 | Phase plans and CI evidence |
|
||||
| `docs` | 23 | User and operator docs |
|
||||
| `notes` | 15 | 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 ? 22 files
|
||||
### docs ? 23 files
|
||||
|
||||
- `docs/ARCHITECTURE.md`
|
||||
- `docs/DEVELOPMENT.md`
|
||||
@@ -711,6 +711,7 @@ This list reflects actual tracked Git files, not proof of authenticated OIDC. Se
|
||||
- `docs/P05-OIDC-02.md`
|
||||
- `docs/P05-OIDC-03.md`
|
||||
- `docs/P05-OIDC-03-A01.md`
|
||||
- `docs/P05-OIDC-03-A02.md`
|
||||
- `docs/P05-SEC-01.md`
|
||||
- `docs/P05-SEC-02-A01.md`
|
||||
- `docs/P05-SEC-02.md`
|
||||
@@ -720,7 +721,7 @@ This list reflects actual tracked Git files, not proof of authenticated OIDC. Se
|
||||
- `docs/TROUBLESHOOTING.md`
|
||||
- `docs/USER-GUIDE.md`
|
||||
|
||||
### notes ? 14 files
|
||||
### notes ? 15 files
|
||||
|
||||
- `notes/CHANGELOG.md`
|
||||
- `notes/DOCS-01.md`
|
||||
@@ -732,6 +733,7 @@ This list reflects actual tracked Git files, not proof of authenticated OIDC. Se
|
||||
- `notes/P05-OIDC-02.md`
|
||||
- `notes/P05-OIDC-03.md`
|
||||
- `notes/P05-OIDC-03-A01.md`
|
||||
- `notes/P05-OIDC-03-A02.md`
|
||||
- `notes/P05-SEC-01.md`
|
||||
- `notes/P05-SEC-02-A01.md`
|
||||
- `notes/P05-SEC-02.md`
|
||||
|
||||
Reference in new issue
Block a user