console

# ThunderID Console Navigation with playwright-cli ## Resolving the Console Base URL Before running any commands, determine the console base URL. Do NOT hardcode a URL — resolve it from project configuration: 1. **Check `deployment.yaml`** at `backend/cmd/server/deployment.yaml` for the `server.hostname` and `server.port`. If the backend is serving the console (production mode), the URL is `https://{hostname}:{port}/console`. 2. **Check `vite.config.ts`** at `frontend/apps/console/vite.config.ts` for the development server `PORT` (default `5191`) and `HOST` (default `localhost`). If the frontend development server is running separately, the URL is `https://{HOST}:{PORT}/console`. 3. **Check environment variables**: `PORT`, `HOST`, or `BASE_URL` may override the defaults. 4. **If unable to resolve**, ask the user for the ThunderID Console URL. Use the resolved URL as `{CONSOLE_URL}` in all commands below (e.g., `{CONSOLE_URL}`). ## Quick Start Use this path after accepting any certificate warnings for the origins used by the deployment. For a fresh browser profile, follow First-Time Login below. ```bash # Open Console (redirects to sign-in gate) playwright-cli open {CONSOLE_URL} -s=thunderid # After authenticating (see below), navigate directly playwright-cli goto {CONSOLE_URL}/users -s=thunderid # Snapshot the page to see element refs playwright-cli snapshot -s=thunderid # Interact with elements using refs from snapshot playwright-cli click e15 -s=thunderid # Take a screenshot playwright-cli screenshot -s=thunderid # Close the browser playwright-cli close -s=thunderid ``` ## Prerequisites If `playwright-cli` is not installed: ```bash npm install -g @playwright/cli@latest ``` All commands use the named session `-s=thunderid` so the browser persists across commands. ## Authentication ThunderID Console requires authentication. The sign-in form is dynamically rendered by the ThunderID SDK, so always use `snapshot` to get element refs before interacting. Username is `admin`. For `make run`, the password defaults to `admin` unless overridden via `ADMIN_PASSWORD` (source-only local dev path). For `./setup.sh`/`./setup.ps1`, the password is randomly generated and printed to the console/log output unless explicitly supplied via `ADMIN_PASSWORD` — check there for the current value rather than assuming a fixed one. ### First-Time Login ```bash # 0. Accept self-signed certs first (see Troubleshooting for details) # Open blank session, navigate to each origin, click through cert warnings playwright-cli open -s=thunderid # Accept backend cert, then console cert, then gate cert (see Troubleshooting) # 1. Navigate to the console (auto-redirects to /gate/signin) playwright-cli goto {CONSOLE_URL} -s=thunderid # 2. Snapshot to see the login form elements playwright-cli snapshot -s=thunderid # 3. Fill username (use the ref from snapshot for the username input) playwright-cli fill <username-ref> "admin" -s=thunderid # 4. Fill password (use the ref from snapshot and the password for this startup; # make run defaults to admin, while setup scripts may print a generated value) playwright-cli fill <password-ref> "<actual-password>" -s=thunderid # 5. Click Sign In (use the ref from snapshot for the submit button) playwright-cli click <submit-ref> -s=thunderid # 6. Verify the Console loads. A first sign-in may open /console/welcome; # close Welcome to reach /console/home. playwright-cli snapshot -s=thunderid ``` ### Optional Session Reuse Keep the named browser session open when continuing the same test. Saving browser state to disk is optional and creates reusable admin session material. If a test needs a saved state, follow the environment's rules for storing it, keep it out of tracked files with restricted access, and delete it when the test is done. ## Routes Routes change often, so they are not duplicated here — a copied table goes stale. Derive routes from these source files, relative to the repository root: - Route definitions: `frontend/apps/console/src/App.tsx` - Sidebar navigation and categories: `frontend/apps/console/src/layouts/DashboardLayout.tsx` The Console base path is `/console`; append a route from `App.tsx` to the resolved `{CONSOLE_URL}` (e.g. `{CONSOLE_URL}/users`). ## Common Patterns Almost every interaction is the same loop: `goto` (or `click` a sidebar/button ref) → `snapshot` to get fresh refs → `fill`/`click` by ref → `snapshot` to confirm. Always re-snapshot after a navigation or action, since refs change. Examples — navigating, creating a resource, and searching: ```bash # Navigate / create / search all follow the goto → snapshot → act → snapshot loop playwright-cli goto {CONSOLE_URL}/users -s=thunderid playwright-cli snapshot -s=thunderid # get current refs playwright-cli click <create-button-ref> -s=thunderid playwright-cli snapshot -s=thunderid playwright-cli fill <field-ref> "value" -s=thunderid # or <search-input-ref> "john" playwright-cli click <submit-ref> -s=thunderid playwright-cli snapshot -s=thunderid ``` Inspect an element, or capture a screenshot: ```bash playwright-cli eval "el => el.getAttribute('data-testid')" <ref> -s=thunderid playwright-cli screenshot --filename=console-users.png -s=thunderid ``` ## Troubleshooting - **Redirected to `/gate/signin`**: Auth expired. Sign in again, or load an existing saved state if the environment permits its use. - **Elements not found in snapshot**: Page may still be loading. Wait a moment and run `playwright-cli snapshot -s=thunderid` again. - **HTTPS certificate errors**: ThunderID uses self-signed certificates on multiple origins (gate, console, backend). The browser will block navigation with `ERR_CERT_AUTHORITY_INVALID`. To bypass, open a blank session first, then navigate via JS `eval` to trigger Chrome's interstitial error page, and click through it: ```bash # 1. Open a blank browser session playwright-cli open -s=thunderid # 2. Navigate to the target URL (triggers cert error page) playwright-cli eval "window.location.assign('{CONSOLE_URL}')" -s=thunderid # 3. Click through the cert warning playwright-cli snapshot -s=thunderid # find the "Advanced" button ref playwright-cli click <advanced-ref> -s=thunderid playwright-cli snapshot -s=thunderid # find the "Proceed to localhost (unsafe)" link ref playwright-cli click <proceed-ref> -s=thunderid ``` **Important**: You must accept certs for **each origin** the console talks to. The console redirects to the gate for auth, which calls the backend. If the backend cert is not accepted in the same browser session, API calls will silently fail. Resolve the backend port from `deployment.yaml` (`server.port`) and the gate port from the console's runtime config. Accept certs for each origin before proceeding. - **Login form not visible**: The ThunderID SDK renders the form dynamically. Take a snapshot after a brief wait. If you see a loading spinner, snapshot again after a few seconds. - **Session lost**: Run `playwright-cli list` to check active sessions. Start a new one with `playwright-cli open -s=thunderid`.