From 5b50d26aa1d621123b578b90cb4c8d1d097cff3f Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 26 Mar 2026 12:55:36 +0000 Subject: [PATCH 1/2] Initial plan From a3fff9741b245acb949b4fce2f096f2727a4795b Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Thu, 26 Mar 2026 12:57:29 +0000 Subject: [PATCH 2/2] docs: restore login/JWT guidance in QUICKSTART.md Co-authored-by: aknot242 <4582399+aknot242@users.noreply.github.com> Agent-Logs-Url: https://github.com/f5devcentral/NGINX-Declarative-API/sessions/fa212666-3989-4a10-9b0b-f13c448e9afd --- webui/QUICKSTART.md | 23 ++++++++++++++++++++++- 1 file changed, 22 insertions(+), 1 deletion(-) diff --git a/webui/QUICKSTART.md b/webui/QUICKSTART.md index 3455ef46..5cab6c7e 100644 --- a/webui/QUICKSTART.md +++ b/webui/QUICKSTART.md @@ -44,7 +44,17 @@ Expected output: Open browser: -### Step 4: Create Your First Configuration +### Step 4: Login + +For development/testing, use any JWT token format: + +```text +eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIiwibmFtZSI6IkpvaG4gRG9lIiwiaWF0IjoxNTE2MjM5MDIyfQ.SflKxwRJSMeKKF2QT4fwpMeJf36POk6yJV_adQssw5c +``` + +*Note: For production, configure proper JWT validation on the backend.* + +### Step 5: Create Your First Configuration 1. Click "Create Config" in navigation 2. Edit the JSON declaration @@ -148,6 +158,16 @@ lsof -i :3000 ./nginx-dapi.sh -c start ``` +### Authentication Fails + +**Issue:** "Authentication failed" on login + +**Check:** + +1. Ensure JWT token is not empty +2. For testing, any valid JWT format works +3. For production, backend must validate the token + ## 📱 Development Setup Want to modify the Web UI? @@ -181,6 +201,7 @@ Dev server runs at with auto-reload. ## 💡 Tips +- **JWT Token:** For development, you can generate tokens at - **API Docs:** Visit for interactive API documentation - **Templates:** Look in `webui/src/pages/CreateConfigPage.tsx` for example configurations - **Docker Compose:** See `contrib/docker-compose/docker-compose.yaml` for service configuration