Files
proxy/nodejs/migrations/grant_bootstrap.js
T
wmantly 10abd36340 Add OIDC login and per-domain authorization
Authentication previously implied full authorization: any valid token
could manage every host, DNS provider, domain, and user. This adds SSO
login and a per-domain rights model.

OIDC login (authorization_code + PKCE):
- conf.oidc + conf.auth blocks; clientSecret in (gitignored) secrets.js.
- utils/oidc.js (state/PKCE, code exchange, userinfo) using global fetch.
- models/oidc_state.js: short-lived state store, auto-expiring via
  model-redis 1.5 per-key TTL.
- routes/auth.js: GET /auth/oidc/start + /auth/oidc/callback; JIT-provisions
  a local user, mints an AuthToken carrying the SSO groups, hands the token to
  the browser via a URL fragment. "Log in with SSO" button on the login page.

Authorization (groups + app overrides, per-domain, with ownership):
- models/grant.js + utils/roles.js (pure, unit-tested): effective rights from
  conf.auth (admin users/groups, group->role map), Grant records
  (user|group -> global|domain -> viewer|manager|admin), and ownership
  (created_by). Roles rank admin > manager(owner) > viewer.
- AuthToken stores session groups; middleware/auth.js exposes req.groups.
- middleware/authz.js: requireAdmin, requireDomainRole(minRole, resolveDomain),
  filterViewable. Applied across routes: host mutations need manager on the
  host's domain; reads are filtered to visible domains; DNS providers, user
  management, and grant management are global-admin-only; certs need viewer.
- routes/grant.js: admin CRUD for grants. Anti-lockout via conf.auth.adminUsers
  plus migrations/grant_bootstrap.js.

Frontend: /me returns effective rights; nav gates Users/Grants to admins;
grants management page; OIDC token-fragment handling in app-base.js.

Tests: utils/roles and utils/oidc unit-tested (no redis); wired into the test
scripts. Full suite 89 pass. Also verified end-to-end against redis (grant
resolution, middleware allow/deny/403, list filtering) and the OIDC pure flow.

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-07-10 12:17:05 -04:00

41 lines
1.1 KiB
JavaScript

'use strict';
/**
* Bootstrap a global-admin Grant for a user so there is always someone who can
* manage the system after per-domain authorization is enabled.
*
* Usage:
* node migrations/grant_bootstrap.js [username]
*
* Defaults to the first entry in conf.auth.adminUsers (or 'proxyadmin2').
* Note: members of conf.auth.adminUsers / conf.auth.adminGroups are already
* treated as admins without a Grant; this just makes it explicit/visible in the
* grant list and survives config changes.
*/
const conf = require('@simpleworkjs/conf');
require('../models'); // register all models
const {Grant} = require('../models/grant');
(async function(){
try{
let username = process.argv[2]
|| (conf.auth && conf.auth.adminUsers && conf.auth.adminUsers[0])
|| 'proxyadmin2';
let grant = await Grant.create({
subjectType: 'user',
subject: username,
scope: 'global',
role: 'admin',
created_by: username,
});
console.log(`Granted global admin to "${username}":`, grant.id);
}catch(error){
console.error('grant_bootstrap error', error);
}finally{
process.exit(0);
}
})();