From 0504df49b08cefd05c23b50bd1f35bc5d05a0bdc Mon Sep 17 00:00:00 2001 From: Hermes Date: Wed, 14 Oct 2026 10:13:54 +0000 Subject: [PATCH] feat: external session API + magic login (merge from open-refboard 02750ba) - POST /api/external/session: bridge auth via X-API-Key, JIT user provisioning - GET /api/external/health: capability report - /magic frontend route: consumes ?token= JWT, redirects - docs/EXTERNAL-API.md: bridge contract spec --- backend/package-lock.json | 79 ++++++------ backend/package.json | 8 +- backend/routes/external.js | 204 ++++++++++++++++++++++++++++++ backend/server.js | 2 + docs/EXTERNAL-API.md | 99 +++++++++++++++ frontend/src/App.tsx | 2 + frontend/src/pages/MagicLogin.tsx | 77 +++++++++++ 7 files changed, 428 insertions(+), 43 deletions(-) create mode 100644 backend/routes/external.js create mode 100644 docs/EXTERNAL-API.md create mode 100644 frontend/src/pages/MagicLogin.tsx diff --git a/backend/package-lock.json b/backend/package-lock.json index 4194d7c..43791cf 100644 --- a/backend/package-lock.json +++ b/backend/package-lock.json @@ -9,15 +9,15 @@ "version": "1.0.0", "dependencies": { "bcryptjs": "^2.4.3", - "better-sqlite3": "^11.7.0", + "better-sqlite3": "^11.10.0", "cors": "^2.8.5", - "express": "^4.21.1", - "jsonwebtoken": "^9.0.2", + "express": "^4.22.3", + "jsonwebtoken": "^9.0.3", "minio": "^8.0.2", "multer": "^1.4.5-lts.1", "sharp": "^0.33.2", "socket.io": "^4.8.1", - "uuid": "^11.0.3" + "uuid": "^11.1.1" } }, "node_modules/@emnapi/runtime": { @@ -522,9 +522,9 @@ } }, "node_modules/body-parser": { - "version": "1.20.4", - "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.4.tgz", - "integrity": "sha512-ZTgYYLMOXY9qKU/57FAo8F+HA2dGX7bqGc71txDRC1rS4frdFI5R7NhluHxH6M0YItAP0sHB4uqAOcYKxO6uGA==", + "version": "1.20.8", + "resolved": "https://registry.npmjs.org/body-parser/-/body-parser-1.20.8.tgz", + "integrity": "sha512-JNcyFQ64OiijEkPzUBTCe+hyPXUD/3LEldGQ6iF5LR1w00mx9o7xtDWHXBY2iItjdCFGoilOLNQbH943ut7pHA==", "license": "MIT", "dependencies": { "bytes": "~3.1.2", @@ -535,7 +535,7 @@ "http-errors": "~2.0.1", "iconv-lite": "~0.4.24", "on-finished": "~2.4.1", - "qs": "~6.14.0", + "qs": "~6.16.0", "raw-body": "~2.5.3", "type-is": "~1.6.18", "unpipe": "~1.0.0" @@ -984,9 +984,9 @@ } }, "node_modules/es-object-atoms": { - "version": "1.1.1", - "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz", - "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==", + "version": "1.1.2", + "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.2.tgz", + "integrity": "sha512-HWcBoN6NileqtSydK2FqHbS/LoDd2pqrnQHLyJzBj4kOp/ky2MWMN694xOfkK8/SnUsW2DH7EfyVlydKCsm1Zw==", "license": "MIT", "dependencies": { "es-errors": "^1.3.0" @@ -1026,14 +1026,14 @@ } }, "node_modules/express": { - "version": "4.22.1", - "resolved": "https://registry.npmjs.org/express/-/express-4.22.1.tgz", - "integrity": "sha512-F2X8g9P1X7uCPZMA3MVf9wcTqlyNp7IhH5qPCI0izhaOIYXaW9L535tGA3qmjRzpH+bZczqq7hVKxTR4NWnu+g==", + "version": "4.22.3", + "resolved": "https://registry.npmjs.org/express/-/express-4.22.3.tgz", + "integrity": "sha512-Bdcs4+3qlpVlx2NRn6fgX2Ue2/gGRaPeawebgclM0ERSCqDpA+owF1fdPwjJUTAJWMTuAaxjDf+hzb0/4eKvvw==", "license": "MIT", "dependencies": { "accepts": "~1.3.8", "array-flatten": "1.1.1", - "body-parser": "~1.20.3", + "body-parser": "~1.20.5", "content-disposition": "~0.5.4", "content-type": "~1.0.4", "cookie": "~0.7.1", @@ -1050,9 +1050,9 @@ "methods": "~1.1.2", "on-finished": "~2.4.1", "parseurl": "~1.3.3", - "path-to-regexp": "~0.1.12", + "path-to-regexp": "~0.1.13", "proxy-addr": "~2.0.7", - "qs": "~6.14.0", + "qs": "~6.16.0", "range-parser": "~1.2.1", "safe-buffer": "5.2.1", "send": "~0.19.0", @@ -1236,9 +1236,9 @@ } }, "node_modules/hasown": { - "version": "2.0.2", - "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz", - "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==", + "version": "2.0.4", + "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.4.tgz", + "integrity": "sha512-T2UbfbBEF32wiepXIsMlTW9+dDYC6wMh/t/vYA4tuOMKqWz/n3vr1NFSxQiyP+zk2mXsoMA/i/7qV6LKut1t1A==", "license": "MIT", "dependencies": { "function-bind": "^1.1.2" @@ -1665,9 +1665,9 @@ } }, "node_modules/path-to-regexp": { - "version": "0.1.12", - "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.12.tgz", - "integrity": "sha512-RA1GjUVMnvYFxuqovrEqZoxxW5NUZqbwKtYz/Tt7nXerk0LbLblQmrsgdeOxV5SFHf0UDggjS/bSeOZwt1pmEQ==", + "version": "0.1.13", + "resolved": "https://registry.npmjs.org/path-to-regexp/-/path-to-regexp-0.1.13.tgz", + "integrity": "sha512-A/AGNMFN3c8bOlvV9RreMdrv7jsmF9XIfDeCd87+I8RNg6s78BhJxMu69NEMHBSJFxKidViTEdruRwEk/WIKqA==", "license": "MIT" }, "node_modules/prebuild-install": { @@ -1736,12 +1736,13 @@ } }, "node_modules/qs": { - "version": "6.14.2", - "resolved": "https://registry.npmjs.org/qs/-/qs-6.14.2.tgz", - "integrity": "sha512-V/yCWTTF7VJ9hIh18Ugr2zhJMP01MY7c5kh4J870L7imm6/DIzBsNLTXzMwUA3yZ5b/KBqLx8Kp3uRvd7xSe3Q==", + "version": "6.16.0", + "resolved": "https://registry.npmjs.org/qs/-/qs-6.16.0.tgz", + "integrity": "sha512-h6fhOIaRrID2CbEY2fqs+7t+UXZo+MLAnU5gRIq85uFtdiUPCdsApMlHhXogKVM4HM2DVbIjGNTTYH2OcmP1vA==", "license": "BSD-3-Clause", "dependencies": { - "side-channel": "^1.1.0" + "es-define-property": "^1.0.1", + "side-channel": "^1.1.1" }, "engines": { "node": ">=0.6" @@ -1959,14 +1960,14 @@ } }, "node_modules/side-channel": { - "version": "1.1.0", - "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.0.tgz", - "integrity": "sha512-ZX99e6tRweoUXqR+VBrslhda51Nh5MTQwou5tnUDgbtyM0dBgmhEDtWGP/xbKn6hqfPRHujUNwz5fy/wbbhnpw==", + "version": "1.1.1", + "resolved": "https://registry.npmjs.org/side-channel/-/side-channel-1.1.1.tgz", + "integrity": "sha512-6x6dK6zJdpTzF4sQeNYxwtvBzf6Eg4GtlesS94HOvTudUeyK2WXAaIfmDgsyslYrRBeFIlsi54AYsFGUuhmvrQ==", "license": "MIT", "dependencies": { "es-errors": "^1.3.0", - "object-inspect": "^1.13.3", - "side-channel-list": "^1.0.0", + "object-inspect": "^1.13.4", + "side-channel-list": "^1.0.1", "side-channel-map": "^1.0.1", "side-channel-weakmap": "^1.0.2" }, @@ -1978,13 +1979,13 @@ } }, "node_modules/side-channel-list": { - "version": "1.0.0", - "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.0.tgz", - "integrity": "sha512-FCLHtRD/gnpCiCHEiJLOwdmFP+wzCmDEkc9y7NsYxeF4u7Btsn1ZuwgwJGxImImHicJArLP4R0yX4c2KCrMrTA==", + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/side-channel-list/-/side-channel-list-1.0.1.tgz", + "integrity": "sha512-mjn/0bi/oUURjc5Xl7IaWi/OJJJumuoJFQJfDDyO46+hBWsfaVM65TBHq2eoZBhzl9EchxOijpkbRC8SVBQU0w==", "license": "MIT", "dependencies": { "es-errors": "^1.3.0", - "object-inspect": "^1.13.3" + "object-inspect": "^1.13.4" }, "engines": { "node": ">= 0.4" @@ -2389,9 +2390,9 @@ } }, "node_modules/uuid": { - "version": "11.1.0", - "resolved": "https://registry.npmjs.org/uuid/-/uuid-11.1.0.tgz", - "integrity": "sha512-0/A9rDy9P7cJ+8w1c9WD9V//9Wj15Ce2MPz8Ri6032usz+NfePxx5AcN3bN+r6ZL6jEo066/yNYB3tn4pQEx+A==", + "version": "11.1.1", + "resolved": "https://registry.npmjs.org/uuid/-/uuid-11.1.1.tgz", + "integrity": "sha512-vIYxrBCC/N/K+Js3qSN88go7kIfNPssr/hHCesKCQNAjmgvYS2oqr69kIufEG+O4+PfezOH4EbIeHCfFov8ZgQ==", "funding": [ "https://github.com/sponsors/broofa", "https://github.com/sponsors/ctavan" diff --git a/backend/package.json b/backend/package.json index b0e965f..dadb8dd 100644 --- a/backend/package.json +++ b/backend/package.json @@ -8,14 +8,14 @@ }, "dependencies": { "bcryptjs": "^2.4.3", - "better-sqlite3": "^11.7.0", + "better-sqlite3": "^11.10.0", "cors": "^2.8.5", - "express": "^4.21.1", - "jsonwebtoken": "^9.0.2", + "express": "^4.22.3", + "jsonwebtoken": "^9.0.3", "minio": "^8.0.2", "multer": "^1.4.5-lts.1", "sharp": "^0.33.2", "socket.io": "^4.8.1", - "uuid": "^11.0.3" + "uuid": "^11.1.1" } } diff --git a/backend/routes/external.js b/backend/routes/external.js new file mode 100644 index 0000000..58deea2 --- /dev/null +++ b/backend/routes/external.js @@ -0,0 +1,204 @@ +/** + * Open RefBoard — External Session API + * + * Generic integration endpoint for external systems ("bridges": AYON, + * Nextcloud, scripts, ...). A bridge authenticates with the shared + * REFBOARD_API_KEY (X-API-Key header), identifies a user, and receives + * a JWT it can embed in a magic-login URL. + * + * Contract: + * POST /api/external/session + * Headers: X-API-Key: + * Body: { user_name: string (required, source of username+display_name), + * user_email?: string (defaults to @bridges.local), + * board_id?: string (board to land on; or board_name+collection_id / collection_name) + * role?: 'member' | 'admin' for NEW users (default 'member') } + * Returns: { user: {...}, token, expires_in, board?: {id, name, url} } + * + * Auto-provisioning: users are created on first use (user_name is mandatory), + * matching existing users by username. Provisioned accounts get a random + * unusable password — they can only log in via bridge sessions or admin + * password reset. + */ +const { Router } = require('express'); +const { v4: uuidv4 } = require('uuid'); +const crypto = require('crypto'); +const { apiKeyMiddleware } = require('../auth'); +const { + getUserByUsername, + getUserByEmail, + getUserById, + createUser, + getBoard, + getCollection, + getCollectionMember, + addCollectionMember, + createCollection, + createBoard, +} = require('../db'); +const { generateToken } = require('../auth'); + +const router = Router(); + +const JWT_EXPIRES_IN = process.env.JWT_EXPIRES_IN || '7d'; +const BRIDGE_EMAIL_DOMAIN = process.env.EXTERNAL_BRIDGE_EMAIL_DOMAIN || 'bridges.local'; + +function expiresInSeconds() { + // Mirror common jwt lib shorthand strings we care about; default 7d. + const m = /^(\d+)([smhdwy])$/.exec(JWT_EXPIRES_IN.trim()); + if (!m) return 7 * 24 * 3600; + const mult = { s: 1, m: 60, h: 3600, d: 86400, w: 604800, y: 31536000 }; + return parseInt(m[1], 10) * (mult[m[2]] || 1); +} + +function boardUrl(req, board) { + const proto = req.headers['x-forwarded-proto'] || req.protocol || 'http'; + const host = req.headers['x-forwarded-host'] || req.headers.host || ''; + const base = process.env.PUBLIC_URL || `${proto}://${host}`; + return `${base}/board/${board.id}`; +} + +function sanitizeUsername(raw) { + let name = String(raw).trim().toLowerCase().replace(/[^a-z0-9_-]/g, '-'); + if (!name) name = 'bridge-user'; + return name.slice(0, 40); +} + +router.use(apiKeyMiddleware); + +/** + * POST /api/external/session + * Ensure user exists (auto-provision) and mint a login JWT. + */ +router.post('/session', async (req, res) => { + try { + const { user_name, user_email, board_id, board_name, collection_id, collection_name, role } = req.body || {}; + + if (!user_name || typeof user_name !== 'string') { + return res.status(400).json({ error: 'user_name is required' }); + } + + const username = sanitizeUsername(user_name); + + // --- resolve or provision user --- + let user = getUserByUsername(username); + if (!user) { + const email = (user_email && typeof user_email === 'string' && user_email.includes('@')) + ? user_email.trim().toLowerCase() + : `${username}@${BRIDGE_EMAIL_DOMAIN}`; + + if (getUserByEmail(email)) { + return res.status(409).json({ + error: `Email conflict: ${email} already registered but username "${username}" does not match a user`, + }); + } + + // Random unusable password — provisioned users authenticate via bridges only + const randomPassword = crypto.randomBytes(24).toString('hex'); + const bcrypt = require('bcryptjs'); + const passwordHash = await bcrypt.hash(randomPassword, 12); + + user = createUser({ + id: uuidv4(), + email, + username, + passwordHash, + displayName: String(user_name).trim().slice(0, 80), + role: role === 'admin' ? 'admin' : 'member', + }); + console.log(`[external] provisioned user: ${username} (${email})`); + } else if (!user.is_active) { + return res.status(403).json({ error: `User ${username} is deactivated` }); + } + + // --- resolve or create target board (optional) --- + let board = null; + if (board_id) { + board = getBoard(board_id); + if (!board) return res.status(404).json({ error: 'Board not found' }); + } + + if (!board && (collection_id || collection_name)) { + let collection = collection_id + ? getCollection(collection_id) + : require('../db').db + .prepare('SELECT * FROM collections WHERE name = ? ORDER BY created_at LIMIT 1') + .get(String(collection_name).trim()); + + if (!collection) { + if (collection_id) return res.status(404).json({ error: 'Collection not found' }); + // create-on-demand for collection_name + collection = createCollection({ + id: uuidv4(), + name: String(collection_name).trim(), + description: `Created via external bridge (${req.headers['x-bridge'] || 'unknown'})`, + createdBy: user.id, + }); + addCollectionMember(collection.id, user.id, 'owner'); + } + + if (!getCollectionMember(collection.id, user.id)) { + addCollectionMember(collection.id, user.id, 'editor'); + } + + const boardName = board_name ? String(board_name).trim() : 'Main'; + const existing = require('../db').db + .prepare('SELECT * FROM boards WHERE collection_id = ? AND name = ? ORDER BY created_at LIMIT 1') + .get(collection.id, boardName); + board = existing || createBoard({ + id: uuidv4(), + collectionId: collection.id, + name: boardName, + description: '', + createdBy: user.id, + }); + } + + const token = generateToken({ + id: user.id, + email: user.email, + role: user.role, + username: user.username, + display_name: user.display_name, + }); + + return res.json({ + user: { + id: user.id, + username: user.username, + display_name: user.display_name, + email: user.email, + role: user.role, + }, + token, + token_type: 'Bearer', + expires_in: expiresInSeconds(), + board: board ? { id: board.id, name: board.name, collection_id: board.collection_id, url: boardUrl(req, board) } : null, + }); + } catch (err) { + console.error('[external] session error:', err); + return res.status(500).json({ error: 'Internal server error' }); + } +}); + +/** + * GET /api/external/health + * Bridge-facing liveness + capability report. + */ +router.get('/health', (_req, res) => { + try { + const { getUserCount } = require('../db'); + return res.json({ + status: 'ok', + service: 'refboard', + open_refboard: true, + api_version: 1, + users: getUserCount(), + }); + } catch (err) { + console.error('[external] health error:', err); + return res.status(500).json({ error: 'Internal server error' }); + } +}); + +module.exports = router; diff --git a/backend/server.js b/backend/server.js index 0e0fb6a..0f80d63 100644 --- a/backend/server.js +++ b/backend/server.js @@ -99,6 +99,7 @@ const collectionRoutes = require('./routes/collections'); const boardRoutes = require('./routes/boards'); const uploadRoutes = require('./routes/upload'); const adminRoutes = require('./routes/admin'); +const externalRoutes = require('./routes/external'); const threadRoutes = require('./routes/threads'); const pdfRoutes = require('./routes/pdf'); const activityRoutes = require('./routes/activity'); @@ -108,6 +109,7 @@ app.use('/api/collections', collectionRoutes); app.use('/api/boards', boardRoutes); app.use('/api/upload', uploadRoutes); app.use('/api/admin', adminRoutes); +app.use('/api/external', externalRoutes); app.use('/api/boards', threadRoutes); app.use('/api/boards', pdfRoutes); app.use('/api/boards', activityRoutes); diff --git a/docs/EXTERNAL-API.md b/docs/EXTERNAL-API.md new file mode 100644 index 0000000..b1f0e42 --- /dev/null +++ b/docs/EXTERNAL-API.md @@ -0,0 +1,99 @@ +# Open RefBoard — External Integration API (v1) + +Generische Schnittstelle für Bridges: externe Systeme (AYON, Nextcloud, Skripte, …) +authentifizieren sich per API-Key und melden Nutzer zu RefBoard-Sessions an. +RefBoard ist dabei bridge-agnostisch — jede Bridge ist ein dünner Client dieser Spec. + +## Voraussetzung + +`REFBOARD_API_KEY` muss in der RefBoard-`.env` gesetzt sein (Header `X-API-Key`). +Ohne Key antwortet die API mit `503 API key not configured on server`. + +## Endpoints + +### `GET /api/external/health` + +Liveness + Capability-Report. Kein Auth nötig? Doch: API-Key (Konsistenz). + +```json +{ "status": "ok", "service": "refboard", "open_refboard": true, "api_version": 1, "users": 12 } +``` + +### `POST /api/external/session` + +Stellt sicher, dass der Nutzer existiert (Auto-Provisionierung), und stellt ein +Login-JWT aus. + +**Request:** + +| Feld | Typ | Pflicht | Bedeutung | +|---|---|---|---| +| `user_name` | string | ✅ | Identität aus dem Quellsystem. Wird zu Username sanitisiert (`a-z0-9_-`), auch Display-Name. **Pflicht.** | +| `user_email` | string | – | Externe E-Mail. Default: `@bridges.local` (konfigurierbar via `EXTERNAL_BRIDGE_EMAIL_DOMAIN`). | +| `board_id` | string | – | Direkt auf dieses Board landen. | +| `collection_name` | string | – | Collection per Name suchen; wird bei Bedarf **erzeugt** (User wird Owner). | +| `collection_id` | string | – | Collection per ID (keine Auto-Erzeugung; 404 wenn fehlend). | +| `board_name` | string | – | Board-Name innerhalb der Collection (Default `"Main"`; wird bei Bedarf erzeugt). | +| `role` | `"member"` \| `"admin"` | – | Rolle **nur für neu angelegte** Nutzer (Default `member`). | + +**Antwort 200:** + +```json +{ + "user": { "id": "…", "username": "niklas", "display_name": "Niklas", "email": "…", "role": "member" }, + "token": "", + "token_type": "Bearer", + "expires_in": 604800, + "board": { "id": "…", "name": "Main", "collection_id": "…", "url": "https://…/board/" } +} +``` + +**Fehler:** `400` (user_name fehlt), `401` (API-Key), `403` (User deaktiviert), +`404` (board_id/collection_id unbekannt), `409` (E-Mail-Konflikt bei Provisionierung), +`503` (API-Key nicht konfiguriert). + +### Magic-Login (Browser) + +Bridge schickt den Nutzer an: + +``` +https:///magic?token=&redirect=/board/ +``` + +- `/magic` validiert den Token via `/api/auth/me`, speichert ihn und leitet weiter. +- `redirect` optional (Default `/`). +- Token läuft nach `JWT_EXPIRES_IN` ab (Default 7d). + +## Provisionierungs-Regeln + +- Neuer `user_name` → Konto wird automatisch angelegt (Zufalls-Passwort, damit kein + direkter Passwort-Login möglich ist; Reset nur via Admin). +- Wiedererkennung anhand **Username** (sanitisierter `user_name`). +- E-Mail-Kollision (`user_email` existiert, aber anderer Username) → `409`, keine + stillen Zusammenführungen. +- Existierende Nutzer: keine Rollen-Änderung durch Bridges (mindestens `role` + nur bei Neuanlage). + +## Bridge-Minimalbeispiel + +```bash +curl -X POST https:///api/external/session \ + -H "X-API-Key: $REFBOARD_API_KEY" \ + -H "Content-Type: application/json" \ + -d '{"user_name": "niklas", "collection_name": "amberflash", "board_name": "Refs"}' +# → { token, board.url } → Browser öffnen: board.url + "?token=" … eigentlich: /magic?token=… +``` + +Login-URL bauen: + +```javascript +const loginUrl = `${session.board.url.replace(/\/board\/(.+)$/, '/magic')}?token=${session.token}&redirect=/board/${session.board.id}`; +``` + +## Konventionen für Bridges + +1. Bridge kennt nur: RefBoard-URL + `REFBOARD_API_KEY`. Kein User-Passwort-Handling. +2. Bridge mappt ihre Identität auf `user_name` (stabil & eindeutig pro Quelle, + z.B. AYON-Username bzw. Nextcloud-UserId). +3. Board-Auswahl: `collection_name` pro Quellprojekt (AYON: Projektname, + Nextcloud: Ordnername) — RefBoard erzeugt sie on-demand. diff --git a/frontend/src/App.tsx b/frontend/src/App.tsx index 3bb17a9..db050cd 100644 --- a/frontend/src/App.tsx +++ b/frontend/src/App.tsx @@ -2,6 +2,7 @@ import React from 'react'; import { BrowserRouter, Routes, Route, Navigate } from 'react-router-dom'; import { AuthProvider, useAuth } from './auth'; import Login from './pages/Login'; +import MagicLogin from './pages/MagicLogin'; import CollectionList from './pages/CollectionList'; import CollectionDetail from './pages/CollectionDetail'; import Editor from './pages/Editor'; @@ -34,6 +35,7 @@ function AppRoutes() { } /> } /> + } /> } /> } /> } /> diff --git a/frontend/src/pages/MagicLogin.tsx b/frontend/src/pages/MagicLogin.tsx new file mode 100644 index 0000000..2b71eaf --- /dev/null +++ b/frontend/src/pages/MagicLogin.tsx @@ -0,0 +1,77 @@ +/** + * MagicLogin — consumes `?token=` on ANY route. + * + * Bridges (AYON addon, Nextcloud app, ...) send users to: + * https:///?token= + * + * This component validates the token against /api/auth/me, stores it, + * and redirects to the destination path (also given via `redirect` query + * param, default `/`). + */ +import React, { useEffect, useState } from 'react'; +import { useNavigate, useSearchParams, useLocation } from 'react-router-dom'; +import { useAuth } from '../auth'; +import { getMe } from '../api'; + +export default function MagicLogin() { + const [params] = useSearchParams(); + const location = useLocation(); + const navigate = useNavigate(); + const { login } = useAuth(); + const [error, setError] = useState(null); + + useEffect(() => { + const token = params.get('token'); + if (!token) { + setError('No token provided'); + return; + } + + // Temporarily store so getMe() picks it up (it reads localStorage) + localStorage.setItem('refboard_token', token); + getMe() + .then((res) => { + const user = res.data.user || res.data; + login(token, user); + const redirect = params.get('redirect') || '/'; + navigate(redirect, { replace: true }); + }) + .catch(() => { + localStorage.removeItem('refboard_token'); + setError('Invalid or expired token'); + }); + // eslint-disable-next-line react-hooks/exhaustive-deps + }, []); + + // If we're mounted on a /board/:id path, keep that path as redirect target + const redirectPath = location.pathname !== '/magic' ? location.pathname : params.get('redirect') || '/'; + + if (error) { + return ( +
+
Magic-Login fehlgeschlagen: {error}
+ +
+ ); + } + + return ( +
+ Anmelden... +
+ ); +}