From 3ded446699fff8667580b5622e9d53a9c2d9ad43 Mon Sep 17 00:00:00 2001 From: Gustavo Caetano Date: Fri, 13 Nov 2026 17:42:38 -0300 Subject: [PATCH 1/2] feat(corp): add VPS workspaces and corporate email invitations --- .agents/skills/release-validation/SKILL.md | 6 + .dockerignore | 19 +++ .github/workflows/ci.yml | 24 ++++ .gitignore | 1 + GLOSSARY.md | 13 ++ corp/.env.example | 6 + corp/README.md | 34 +----- corp/public/admin-app.js | 24 +++- corp/public/app.css | 3 + corp/public/login.js | 64 ++++++++-- corp/public/onboarding.css | 7 ++ corp/server.mjs | 67 +++++++++-- corp/workspace.mjs | 111 +++++++++++++++++ deploy/corp/.env.example | 10 ++ deploy/corp/Caddyfile | 10 ++ deploy/corp/Dockerfile | 24 ++++ deploy/corp/compose.yml | 33 ++++++ docs/CORP-SERVER.md | 77 ++++++++++++ package-lock.json | 43 +++++++ package.json | 2 + scripts/corp-container-smoke.mjs | 38 ++++++ scripts/corp-workspace-smoke.mjs | 95 +++++++++++++++ scripts/crm-smoke.mjs | 2 + tests/corp-workspace.test.ts | 131 +++++++++++++++++++++ 24 files changed, 791 insertions(+), 53 deletions(-) create mode 100644 .dockerignore create mode 100644 GLOSSARY.md create mode 100644 corp/workspace.mjs create mode 100644 deploy/corp/.env.example create mode 100644 deploy/corp/Caddyfile create mode 100644 deploy/corp/Dockerfile create mode 100644 deploy/corp/compose.yml create mode 100644 docs/CORP-SERVER.md create mode 100644 scripts/corp-container-smoke.mjs create mode 100644 scripts/corp-workspace-smoke.mjs create mode 100644 tests/corp-workspace.test.ts diff --git a/.agents/skills/release-validation/SKILL.md b/.agents/skills/release-validation/SKILL.md index 4f2b3ec..0024907 100644 --- a/.agents/skills/release-validation/SKILL.md +++ b/.agents/skills/release-validation/SKILL.md @@ -30,3 +30,9 @@ viewport, including keyboard focus, error/retry and both motion preferences. Do not replace visual judgment with a green report or claim real AI behavior from synthetic bridge data. Preserve the user's app/profile; never enter real credentials or private content in preview fixtures. + +## Corp server/workspace changes + +Use `npm run test:crm-browser` for the real-server workspace journeys too; its existing aggregate now includes a local SMTP STARTTLS sink, administrator creation, invite acceptance and subsequent login. No real email recipients or production volumes. On macOS use `TMPDIR=/private/tmp`. Review the generated workspace screenshots alongside error/focus and reduced-motion checks. + +For deployment changes, build `deploy/corp/Dockerfile` and run `node scripts/corp-container-smoke.mjs IMAGE` (explicit prebuilt image required). The batch creates/removes only its random temporary Docker container/volume, rejects no-op execution, and writes `artifacts/corp-container/report.json`. If Docker is unavailable locally, verify the actual `corp-server-image` CI job before claiming the image passed. Never deploy a VPS or publish an image just to validate it. See `docs/CORP-SERVER.md` for the one-workspace/single-writer boundary. diff --git a/.dockerignore b/.dockerignore new file mode 100644 index 0000000..1944cda --- /dev/null +++ b/.dockerignore @@ -0,0 +1,19 @@ +# Send only application/build inputs; never upload local profiles, env files or keys. +** +!package.json +!package-lock.json +!vite.corp.config.mts +!tsconfig.web.json +!src/ +!src/renderer/ +!src/renderer/** +!corp/ +!corp/*.mjs +!corp/public/ +!corp/public/** +!tools/ +!tools/lib/ +!tools/lib/** +!deploy/ +!deploy/corp/ +!deploy/corp/Dockerfile diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml index d09833c..fe73c70 100644 --- a/.github/workflows/ci.yml +++ b/.github/workflows/ci.yml @@ -42,3 +42,27 @@ jobs: artifacts/crm-smoke/ if-no-files-found: warn retention-days: 14 + + corp-server-image: + runs-on: ubuntu-latest + timeout-minutes: 20 + steps: + - uses: actions/checkout@v4 + - uses: actions/setup-node@v4 + with: + node-version: 22 + - name: Validate Compose configuration + run: | + cp deploy/corp/.env.example deploy/corp/.env + docker compose --env-file deploy/corp/.env -f deploy/corp/compose.yml config --quiet + - name: Build VPS image (no publication) + run: docker build -f deploy/corp/Dockerfile -t keepmind-corp:test . + - name: Validate server startup and persistent workspace + run: node scripts/corp-container-smoke.mjs keepmind-corp:test + - name: Preserve container evidence + if: always() + uses: actions/upload-artifact@v4 + with: + name: corp-container-validation + path: artifacts/corp-container/ + if-no-files-found: warn diff --git a/.gitignore b/.gitignore index 384e63b..e64c614 100644 --- a/.gitignore +++ b/.gitignore @@ -12,3 +12,4 @@ corp/brain-dist/ .ssh-corp-push/ artifacts/experience-smoke/ artifacts/crm-smoke/ +artifacts/corp-container/ diff --git a/GLOSSARY.md b/GLOSSARY.md new file mode 100644 index 0000000..7a4eef8 --- /dev/null +++ b/GLOSSARY.md @@ -0,0 +1,13 @@ +# KeepMind + +KeepMind SB organiza o conhecimento pessoal. KeepMind Corp acrescenta colaboração e governança da empresa. + +## Linguagem + +**Workspace**: Espaço da organização no KeepMind Corp, com pessoas, conteúdo compartilhado e regras de acesso próprias. “Organização” é o nome usado pelo código legado para o mesmo conceito. + +**Administrador principal**: Responsável inicial pelo workspace, autorizado a conceder administração a outras pessoas. Corresponde ao papel `owner`. + +**Administrador**: Pessoa que gerencia membros, convites e políticas dentro do workspace. + +**Convite**: Autorização para um destinatário específico ingressar no workspace com um papel definido. Pertencer ao domínio de e-mail da empresa não substitui o convite. diff --git a/corp/.env.example b/corp/.env.example index 68e4c0a..13526e3 100644 --- a/corp/.env.example +++ b/corp/.env.example @@ -6,3 +6,9 @@ KEEPMIND_CORP_OIDC_CLIENT_ID= KEEPMIND_CORP_OIDC_CLIENT_SECRET= KEEPMIND_CORP_OIDC_REDIRECT_URI=http://127.0.0.1:8787/api/oidc/callback KEEPMIND_CORP_OIDC_ADMIN_GROUP=keepmind-admins + +# Servidor/VPS compartilhado: veja deploy/corp/.env.example e docs/CORP-SERVER.md +# KEEPMIND_CORP_MODE=server +# KEEPMIND_CORP_PUBLIC_URL=https://brain.empresa.com +# KEEPMIND_CORP_EMAIL_DOMAINS=empresa.com +# KEEPMIND_CORP_SETUP_TOKEN= diff --git a/corp/README.md b/corp/README.md index fb3b8a5..2bb63a5 100644 --- a/corp/README.md +++ b/corp/README.md @@ -2,37 +2,13 @@ **KeepMind corporativo = o mesmo second brain (Today, Brain, Chat, Skills, Security) + governança da empresa.** -O app de desktop **gratuito** (KeepMind pessoal) continua o produto individual. A edição **Corp** entrega o mesmo cérebro e as regras da empresa num **aplicativo de desktop instalável** (Windows, macOS, Linux): o servidor local sobe automaticamente — usuários finais e TI **não** precisam instalar Node, npm nem Docker. +O caminho corporativo recomendado é **uma instância no servidor/VPS da empresa**, acessada por URL no navegador. O administrador cria o workspace e convida colegas por e-mail corporativo. Dados e governança ficam nessa instância compartilhada; a memória pessoal mantém suas permissões. -Desenho completo: [`docs/ENTERPRISE.md`](../docs/ENTERPRISE.md). Roadmap: [`docs/CORP-ROADMAP.md`](../docs/CORP-ROADMAP.md). +## Instalação no servidor -## Por que instalar? +Siga [Corp em servidor/VPS](../docs/CORP-SERVER.md): Docker Compose, HTTPS, volume persistente, configuração inicial protegida e SMTP. Uma instância corresponde a um workspace. -KeepMind Corp **não** é a versão gratuita para uso pessoal. É o **mesmo KeepMind** que você já conhece (memória em Markdown, chat, skills, segurança), mais **política da organização**: quem pode ver o quê, provedores de IA, autonomia dos agentes, SSO e auditoria. - -Em vez de pedir que cada pessoa configure servidor ou container, o **app Corp** embute o servidor corporativo. Na primeira execução, um assistente cria a organização e a conta **owner**; depois disso, a equipe usa o cérebro em `/brain/` e a TI gere tudo em `/admin/` — tudo na máquina ou no ambiente que vocês escolherem, sem “subir um Docker” como caminho principal. - -## Como instalar (usuários finais e TI) - -1. Obtenha o instalador para o seu sistema (gerado pela equipe que mantém o repositório): - - **macOS:** `.dmg` ou `.zip` - - **Windows:** instalador `.exe` (NSIS) - - **Linux:** `.AppImage` -2. Abra o app **KeepMind Corp**. -3. Na **primeira vez**, conclua o onboarding (nome da org, conta owner, senha). -4. Use o **KeepMind** em `/brain/`; donos e admins abrem **governança** em `/admin/`. - -Dados locais ficam na pasta de dados do app (por exemplo `userData/keepmind-corp/` no Electron). - -### Quem gera os instaladores - -Quem desenvolve ou empacota o produto, a partir deste repositório: - -```bash -npm run dist:corp:mac # ou dist:corp:win / dist:corp:linux / dist:corp -``` - -Saída em `dist-corp/`. Configuração: [`electron-builder.corp.yml`](../electron-builder.corp.yml). +O KeepMind SB continua o aplicativo pessoal. Os instaladores Corp existentes ainda iniciam uma instância local independente; não os distribua como forma de entrar automaticamente no workspace do VPS. Para colaboração, distribua a URL do servidor. ## O que você vê depois do login @@ -45,7 +21,7 @@ Membros não configuram chave de provedor na interface: a empresa traz BYOK no a ## Primeira execução (onboarding) -Não há usuário embutido. Na **primeira vez**, o portal abre um assistente em 4 passos: +Não há usuário embutido. No servidor, a chave de instalação autoriza o primeiro administrador. Na **primeira vez**, o portal abre um assistente em 4 passos: 1. Explica o que é Corp (brain + governança). 2. Nome da organização. diff --git a/corp/public/admin-app.js b/corp/public/admin-app.js index 19d789b..513ab79 100644 --- a/corp/public/admin-app.js +++ b/corp/public/admin-app.js @@ -93,7 +93,7 @@ async function load() { state.data = { ok: true, ...meter.body, byok: byok.body.report } } if (state.section === 'github') state.data = (await api('/api/github-sync')).body - if (state.section === 'members') state.data = (await api('/api/members')).body + if (state.section === 'members') { const [members, invites] = await Promise.all([api('/api/members'), api('/api/invitations')]); state.data = { ...members.body, invitations: invites.body.invitations || [] } } if (state.section === 'agents') { const agents = await api('/api/agents') state.data = agents.body @@ -141,7 +141,7 @@ function shell() {

${esc(SECTIONS.find(item => item[0] === state.section)?.[1] || '')}

${esc(state.meta?.version || '')}
-

${esc(state.toast)}

+

${esc(state.toast)}

${esc(state.error)}

${section()}
@@ -322,7 +322,10 @@ function members(data) { ${esc(member.teamId)} ${member.disabled ? 'inativa' : 'ativa'} `).join('') - return `
+ const inviteStatus = { pending: 'Enviado · aguardando aceite', sending: 'Enviando', failed: 'Falha no envio', expired: 'Expirado', revoked: 'Revogado', accepted: 'Aceito' } + const invitations = `

Convide sua equipe

Envie para um e-mail corporativo autorizado. A pessoa define a própria senha. O convite expira em 48 horas.

Convites

${(data.invitations || []).map(i => `
${esc(i.email)}${esc(inviteStatus[i.status] || i.status)} · ${esc({member:'membro',admin:'administrador',auditor:'auditor'}[i.role] || i.role)}Expira: ${esc(new Date(i.expiresAt).toLocaleString('pt-BR'))}${['pending','sending'].includes(i.status) && (i.role !== 'admin' || state.me.role === 'owner') ? `` : ''}
`).join('') || '

Nenhum convite enviado ainda.

'}
` + if (state.meta?.serverMode) return `${invitations}

Pessoas no workspace

${rows}
PessoaPapelTimeEstado
` + return `${invitations}
@@ -572,6 +575,21 @@ function bind() { if (res.body.ok) state.data = res.body render() }) + document.querySelector('#invite-member')?.addEventListener('submit', async event => { + event.preventDefault() + const form = new FormData(event.target), button = event.target.querySelector('button') + button.disabled = true; button.textContent = 'Enviando convite…' + let res + try { res = await api('/api/invitations', { method: 'POST', body: JSON.stringify({ email: form.get('email'), role: form.get('role') }) }) } + catch { res = { body: { ok: false, message: 'Sem conexão. Tente novamente.' } } } + if (res.body.ok) { state.toast = 'Convite enviado por e-mail.'; await load(); render() } + else { const feedback = document.querySelector('#invite-feedback'); feedback.textContent = res.body.message || 'Não foi possível enviar.'; feedback.focus(); button.disabled = false; button.textContent = 'Enviar convite' } + }) + document.querySelectorAll('[data-revoke-invite]').forEach(button => button.addEventListener('click', async () => { + button.disabled = true + try { const res = await api(`/api/invitations/${encodeURIComponent(button.dataset.revokeInvite)}`, { method: 'DELETE' }); state.toast = res.body.ok ? 'Convite revogado.' : (res.body.message || 'Não foi possível revogar.'); await load(); render() } + catch { button.disabled = false; state.toast = 'Sem conexão. Tente novamente.'; render() } + })) document.querySelector('#member')?.addEventListener('submit', async event => { event.preventDefault() const form = new FormData(event.target) diff --git a/corp/public/app.css b/corp/public/app.css index ba40ec4..ab4d9fc 100644 --- a/corp/public/app.css +++ b/corp/public/app.css @@ -86,3 +86,6 @@ th, td { text-align: left; padding: 8px 6px; border-bottom: 1px solid var(--line .shell, .split { grid-template-columns: 1fr; } nav { border-right: 0; border-bottom: 1px solid var(--line); } } + +.invite-row { display: flex; gap: 8px; flex-direction: column; padding: 16px 0; border-top: 1px solid var(--line); overflow-wrap: anywhere; } +#invite-member { max-width: 520px; } diff --git a/corp/public/login.js b/corp/public/login.js index 3349592..a753434 100644 --- a/corp/public/login.js +++ b/corp/public/login.js @@ -1,3 +1,4 @@ +const roleLabel = role => ({ member: 'membro', admin: 'administrador', auditor: 'auditor' }[role] || role) const app = document.querySelector('#app') const COPY = { @@ -14,17 +15,20 @@ function esc(value) { } async function api(pathname, options = {}) { + try { const res = await fetch(pathname, { ...options, headers: { 'content-type': 'application/json', 'x-keepmind-corp': '1', ...(options.headers || {}) } }) const body = await res.json().catch(() => ({})) return { status: res.status, body } + } catch { return { status: 0, body: { ok: false, message: 'Sem conexão com o servidor. Tente novamente.' } } } } let wizardStep = 0 let wizardMeta = null let wizardForm = { + setupToken: '', orgName: '', name: '', email: '', @@ -33,6 +37,8 @@ let wizardForm = { } async function boot() { + const token = new URLSearchParams(location.hash.slice(1)).get('invite') + if (token) { history.replaceState(null, '', '/'); return showInvitation(token) } const session = await api('/api/session') if (session.body?.user) { window.location.replace('/brain/') @@ -55,17 +61,17 @@ function renderWizard(error) { let inner = '' if (wizardStep === 0) { inner = `${stepDots(0)} -

O que é o KeepMind Corp?

-

É o KeepMind (memória, Brain, Skills, Chat) rodando com governança da empresa — não é só um cofre.

+

Crie o workspace da sua empresa

+

Um lugar para a equipe recuperar conhecimento, conferir fontes e trabalhar com as regras da empresa.

Você ganha
    -
  • /brain/ — seu second brain, igual ao app desktop, com limites da org.
  • -
  • /admin/ — times, política de IA, agentes e auditoria (dono/admin).
  • -
  • Partição por pessoa — sua memória fica em people/<você>/ + pastas compartilhadas.
  • +
  • Conhecimento com contexto — encontre o que sua equipe precisa para continuar.
  • +
  • Controle da empresa — administradores gerenciam pessoas, IA e auditoria.
  • +
  • Privacidade — memórias pessoais e conteúdo compartilhado têm permissões próprias.
-
` + ${wizardMeta?.serverMode ? `

Peça esta chave ao responsável pelo servidor. Ela protege a criação do primeiro administrador.

` : ''}
` } else if (wizardStep === 1) { inner = `${stepDots(1)}

Sua empresa no Corp

@@ -78,8 +84,8 @@ function renderWizard(error) {
` } else if (wizardStep === 2) { inner = `${stepDots(2)} -

Conta de dono (owner)

-

Quem cria a org hoje vira owner: pode convidar pessoas e mudar política. Depois você adiciona admins.

+

Administrador principal

+

Você será responsável pelo workspace: poderá convidar colegas e definir as regras da empresa.

@@ -96,7 +102,7 @@ function renderWizard(error) { -

${esc(error)}

+
@@ -106,9 +112,12 @@ function renderWizard(error) { app.innerHTML = `
KeepMind Corp
+ ${inner}
` + document.querySelector('#wizard')?.addEventListener('submit', e => { e.preventDefault(); document.querySelector('#next, #finish')?.click() }) + if (error) document.querySelector('#form-error').focus(); else { const heading = document.querySelector('h1'); heading.tabIndex = -1; heading.focus() } document.querySelector('#back')?.addEventListener('click', () => { syncWizardFields() wizardStep = Math.max(0, wizardStep - 1) @@ -116,6 +125,7 @@ function renderWizard(error) { }) document.querySelector('#next')?.addEventListener('click', () => { syncWizardFields() + if (wizardStep === 0 && wizardMeta?.serverMode && !wizardForm.setupToken.trim()) return renderWizard('Informe a chave de instalação fornecida pelo responsável pelo servidor.') if (wizardStep === 1 && !wizardForm.orgName.trim()) { renderWizard('Informe o nome da organização.') return @@ -129,12 +139,16 @@ function renderWizard(error) { }) document.querySelector('#finish')?.addEventListener('click', async () => { syncWizardFields() + const finish = document.querySelector('#finish'); finish.disabled = true; finish.textContent = 'Criando workspace…' const res = await api('/api/setup', { method: 'POST', body: JSON.stringify(wizardForm) }) if (!res.body.ok) { const msg = res.body.message || COPY[res.body.error] || 'Não foi possível concluir o setup.' + if (res.body.error === 'setup_token') wizardStep = 0 + if (res.body.error === 'bad_email') wizardStep = 2 + if (res.body.error === 'bad_org') wizardStep = 1 renderWizard(msg) return } @@ -143,6 +157,7 @@ function renderWizard(error) { } function syncWizardFields() { + const setup = document.querySelector('#setupToken'); if (setup) wizardForm.setupToken = setup.value const org = document.querySelector('#orgName') const name = document.querySelector('#name') const email = document.querySelector('#email') @@ -159,8 +174,8 @@ function renderLogin(meta, error) { const sso = meta?.oidc ? 'Entrar com SSO' : '' app.innerHTML = `` + if (error) document.querySelector('.err').focus() document.querySelector('#login')?.addEventListener('submit', async event => { event.preventDefault() const form = new FormData(event.target) + event.target.querySelector('button').disabled = true const res = await api('/api/login', { method: 'POST', body: JSON.stringify({ email: form.get('email'), password: form.get('password') }) }) if (!res.body.ok) { - renderLogin(meta, COPY[res.body.error] || 'Não foi possível entrar.') + renderLogin(meta, COPY[res.body.error] || res.body.message || 'Não foi possível entrar.') return } window.location.replace('/brain/') }) } +async function showInvitation(token) { + app.innerHTML = '' + const res = await api('/api/invitations/inspect', { method: 'POST', body: JSON.stringify({ token }) }) + if (!res.body.ok) { + app.innerHTML = `` + return + } + const invite = res.body.invitation + app.innerHTML = `` + document.querySelector('#invite-name').focus() + document.querySelector('#accept-invite').addEventListener('submit', async e => { + e.preventDefault() + const button = e.target.querySelector('button'), fields = new FormData(e.target) + button.disabled = true; button.textContent = 'Entrando…' + const result = await api('/api/invitations/accept', { method: 'POST', body: JSON.stringify({ token, email: invite.email, name: fields.get('name'), password: fields.get('password'), confirm: fields.get('confirm') }) }) + if (result.body.ok) return location.replace('/brain/') + const error = document.querySelector('#invite-error'); error.textContent = result.body.message || 'Não foi possível aceitar. Tente novamente.'; error.focus() + button.disabled = false; button.textContent = 'Aceitar convite e entrar' + }) +} void boot() diff --git a/corp/public/onboarding.css b/corp/public/onboarding.css index f96a9a1..74f71f2 100644 --- a/corp/public/onboarding.css +++ b/corp/public/onboarding.css @@ -9,3 +9,10 @@ .ob-actions { display: flex; gap: 10px; justify-content: flex-end; margin-top: 18px; flex-wrap: wrap; } .ob-grid-2 { display: grid; grid-template-columns: 1fr 1fr; gap: 12px; } @media (max-width: 540px) { .ob-grid-2 { grid-template-columns: 1fr; } } + +.ob-card, .login .card { animation: workspace-enter 180ms ease-out; } +@keyframes workspace-enter { from { opacity: 0; transform: translateY(6px); } to { opacity: 1; transform: none; } } +button:disabled { cursor: wait; opacity: .65; } +:focus-visible { outline: 2px solid var(--cyan); outline-offset: 3px; } +.err:empty { display: none; } +@media (prefers-reduced-motion: reduce) { .ob-card, .login .card { animation: none; } } diff --git a/corp/server.mjs b/corp/server.mjs index 17276bb..3910329 100644 --- a/corp/server.mjs +++ b/corp/server.mjs @@ -1,6 +1,7 @@ // KeepMind Corp — corporate second brain (web) + organization governance. // Same KeepMind UI at /brain/ with policy enforcement; admins use /admin/. +import { workspaceConfig, createWorkspace, smtpMailer, secretMatches } from './workspace.mjs' import { createServer } from 'node:http' import { randomBytes } from 'node:crypto' import { existsSync, mkdirSync, readFileSync, writeFileSync, statSync } from 'node:fs' @@ -53,6 +54,7 @@ const STATIC = { export function createCorp(opts = {}) { const env = opts.env ?? process.env + const workspaceSettings = workspaceConfig(env) const dataDir = opts.dataDir ?? env.KEEPMIND_CORP_DATA ?? path.join(process.cwd(), 'corp', 'data') const vault = opts.vault ?? env.KEEPMIND_VAULT ?? path.join(dataDir, 'vault') mkdirSync(dataDir, { recursive: true }) @@ -62,6 +64,7 @@ export function createCorp(opts = {}) { const org = loadOrg(orgFile, env.KEEPMIND_CORP_ORG_NAME || 'KeepMind Corp') const sessions = new Map(Object.entries(readJson(sessionFile, {}))) const failures = new Map() + const publicAttempts = new Map() const fetchImpl = opts.fetchImpl ?? globalThis.fetch let oidc = null function refreshOidc() { @@ -74,7 +77,12 @@ export function createCorp(opts = {}) { return oidc } refreshOidc() - const secureCookie = env.KEEPMIND_CORP_SECURE === '1' + const secureCookie = workspaceSettings.secure + const sameOriginMutation = req => { + if (!workspaceSettings.server) return legacySameOriginMutation(req) + if (['GET', 'HEAD'].includes(req.method)) return true + return req.headers.origin === workspaceSettings.origin + } const brainApi = mountBrainApi({ vault, @@ -92,7 +100,9 @@ export function createCorp(opts = {}) { }) if (!org.crmNamespace) org.crmNamespace = randomBytes(16).toString('hex') + const workspace = createWorkspace({ org, config: workspaceSettings, persist: persistOrg, addUser, audit, mailer: opts.mailer ?? smtpMailer(env), now: opts.now }) ensureOwner(env) + if (workspaceSettings.server && !org.users.some(u => u.role === 'owner') && String(env.KEEPMIND_CORP_SETUP_TOKEN || '').length < 32) throw Error('Initial server setup requires a random KEEPMIND_CORP_SETUP_TOKEN of at least 32 characters.') persistOrg() if (!opts.disableCrmScheduler) startCrmScheduler(vault, () => org) if (!opts.disableGithubScheduler) { @@ -129,7 +139,7 @@ export function createCorp(opts = {}) { const email = String(source.KEEPMIND_CORP_OWNER_EMAIL || '').trim().toLowerCase() const password = String(source.KEEPMIND_CORP_OWNER_PASSWORD || '') if (!email || !password) return - if (!validEmail(email) || password.length < 12) { + if (!validEmail(email) || password.length < 12 || (workspaceSettings.server && !workspace.allowed(email))) { console.error('KeepMind Corp owner bootstrap needs a valid email and a password of at least 12 characters.') return } @@ -204,6 +214,17 @@ export function createCorp(opts = {}) { async function handle(req, res) { try { const url = new URL(req.url || '/', 'http://corp.local') + res.setHeader('Referrer-Policy', 'no-referrer') + res.setHeader('X-Content-Type-Options', 'nosniff') + if (workspaceSettings.server && req.headers.host !== new URL(workspaceSettings.origin).host) return send(res, 400, { ok: false, error: 'invalid_host' }) + if (workspaceSettings.server && req.method === 'POST' && ['/api/setup','/api/login','/api/invitations/inspect','/api/invitations/accept'].includes(url.pathname)) { + const key = `${clientIp(req)}|${url.pathname}`, now = Date.now() + const entry = publicAttempts.get(key) + const recent = entry && entry.until > now ? entry : { count: 0, until: now + 600000 } + if (++recent.count > 60) return send(res, 429, { ok: false, error: 'rate_limited', message: 'Muitas tentativas. Aguarde alguns minutos.' }) + if (publicAttempts.size >= 10000) publicAttempts.delete(publicAttempts.keys().next().value) + publicAttempts.set(key, recent) + } if (STATIC[url.pathname] && (req.method === 'GET' || req.method === 'HEAD')) { return sendFile(res, STATIC[url.pathname], req.method === 'HEAD') } @@ -234,6 +255,8 @@ export function createCorp(opts = {}) { edition: 'keepmind-corp', version: CORP_VERSION, org: org.name, + serverMode: workspaceSettings.server, + invitationDomains: workspaceSettings.domains, oidc: !!oidc, setupRequired: !org.users.some(user => user.role === 'owner'), providers: PROVIDERS, @@ -258,6 +281,16 @@ export function createCorp(opts = {}) { if (url.pathname === '/api/session' && req.method === 'GET') { return send(res, 200, { ok: true, user: user ? publicUser(user) : null, orgNamespace: org.crmNamespace }) } + if (url.pathname === '/api/invitations/inspect' && req.method === 'POST') { + if (!sameOriginMutation(req)) return send(res, 403, { ok: false, error: 'forbidden' }) + return send(res, 200, { ok: true, invitation: workspace.inspect((await readBody(req)).token) }) + } + if (url.pathname === '/api/invitations/accept' && req.method === 'POST') { + if (!sameOriginMutation(req)) return send(res, 403, { ok: false, error: 'forbidden' }) + const accepted = workspace.accept(await readBody(req)) + res.setHeader('Set-Cookie', cookie(openSession(accepted))) + return send(res, 201, { ok: true, user: publicUser(accepted) }) + } if (url.pathname === '/api/setup' && req.method === 'POST') return await firstSetup(req, res) if (url.pathname === '/api/login' && req.method === 'POST') return await login(req, res) if (url.pathname === '/api/logout' && req.method === 'POST') return logout(req, token, res) @@ -274,7 +307,7 @@ export function createCorp(opts = {}) { return await authed(req, res, url, user) } catch (err) { const code = err.code || 'server_error' - const status = STATUS[code] ?? 500 + const status = err.status ?? STATUS[code] ?? 500 if (status === 500) console.error(err) return send(res, status, { ok: false, error: code, message: status === 500 ? 'Something went wrong.' : err.message }) } @@ -286,6 +319,9 @@ export function createCorp(opts = {}) { return send(res, 409, { ok: false, error: 'setup_done', message: 'A conta de dono já existe.' }) } const body = await readBody(req) + // Recheck after reading the body: two concurrent setup requests cannot create two owners. + if (org.users.some(user => user.role === 'owner')) return send(res, 409, { ok: false, error: 'setup_done' }) + if (workspaceSettings.server && !secretMatches(body.setupToken || '', env.KEEPMIND_CORP_SETUP_TOKEN || '')) return send(res, 403, { ok: false, error: 'setup_token', message: 'Chave de instalação inválida. Consulte o responsável pelo servidor.' }) const orgName = String(body.orgName || '').trim().slice(0, 80) const name = String(body.name || '').trim().slice(0, 80) const email = String(body.email || '').trim().toLowerCase() @@ -293,8 +329,8 @@ export function createCorp(opts = {}) { const confirm = String(body.confirm || '') if (!orgName) return send(res, 400, { ok: false, error: 'bad_org', message: 'Informe o nome da empresa.' }) if (!name) return send(res, 400, { ok: false, error: 'bad_name', message: 'Informe seu nome.' }) - if (!validEmail(email)) return send(res, 400, { ok: false, error: 'bad_email', message: 'Email inválido.' }) - if (password.length < 12) { + if (!validEmail(email) || (workspaceSettings.server && !workspace.allowed(email))) return send(res, 400, { ok: false, error: 'bad_email', message: 'Use um e-mail do domínio corporativo configurado no servidor.' }) + if (password.length < 12 || password.length > 1024) { return send(res, 400, { ok: false, error: 'weak_password', message: 'Use uma senha com pelo menos 12 caracteres.' }) } if (password !== confirm) { @@ -310,6 +346,7 @@ export function createCorp(opts = {}) { } async function login(req, res) { + if (workspaceSettings.server && !sameOriginMutation(req)) return send(res, 403, { ok: false, error: 'forbidden' }) const body = await readBody(req) const email = String(body.email || '').trim().toLowerCase() const password = String(body.password || '') @@ -362,9 +399,11 @@ export function createCorp(opts = {}) { }) const email = String(payload.email || '').trim().toLowerCase() if (!validEmail(email)) return send(res, 400, { ok: false, error: 'bad_user', message: 'The identity token has no email.' }) + if (workspaceSettings.server && (payload.email_verified !== true || !workspace.allowed(email) || !org.users.some(u => u.email === email && !u.disabled))) return send(res, 403, { ok: false, error: 'invitation_required', message: 'Aceite um convite do workspace antes de usar SSO.' }) const groups = Array.isArray(payload.groups) ? payload.groups.map(String) : [] const ssoAdmin = groups.includes(oidc.config.adminGroup) - let user = org.users.find(item => item.oidcSub === payload.sub || item.email === email) + let user = org.users.find(item => workspaceSettings.server ? item.email === email : (item.oidcSub === payload.sub || item.email === email)) + if (workspaceSettings.server && user?.oidcSub && user.oidcSub !== payload.sub) return send(res, 403, { ok: false, error: 'forbidden' }) if (!user) { user = addUser({ email, @@ -390,6 +429,15 @@ export function createCorp(opts = {}) { } async function authed(req, res, url, user) { + if (url.pathname === '/api/invitations' && ['GET', 'POST'].includes(req.method)) { + if (!can(user.role, 'members.write')) return send(res, 403, { ok: false, error: 'forbidden' }) + if (req.method === 'GET') return send(res, 200, { ok: true, invitations: workspace.list() }) + return send(res, 201, { ok: true, invitation: await workspace.invite(user, await readBody(req)) }) + } + if (url.pathname.startsWith('/api/invitations/') && req.method === 'DELETE') { + workspace.revoke(user, url.pathname.slice('/api/invitations/'.length)) + return send(res, 200, { ok: true }) + } if (url.pathname === '/api/me' && req.method === 'GET') { return send(res, 200, { ok: true, user: publicUser(user), org: org.name }) } @@ -699,6 +747,7 @@ export function createCorp(opts = {}) { } async function createMember(req, res, user) { + if (workspaceSettings.server) return send(res, 409, { ok: false, error: 'invitation_required', message: 'Envie um convite; cada pessoa define a própria senha.' }) if (!can(user.role, 'members.write')) return send(res, 403, { ok: false, error: 'forbidden' }) const body = await readBody(req) const email = String(body.email || '').trim().toLowerCase() @@ -717,7 +766,7 @@ export function createCorp(opts = {}) { if (role === 'owner' && !can(user.role, 'owner.grant')) { return send(res, 403, { ok: false, error: 'forbidden' }) } - if (password.length < 12) { + if (password.length < 12 || password.length > 1024) { const err = new Error('Passwords need at least 12 characters.') err.code = 'bad_user' throw err @@ -741,6 +790,7 @@ export function createCorp(opts = {}) { if (!target) return send(res, 404, { ok: false, error: 'not_found' }) const body = await readBody(req) if (body.role && body.role !== target.role) { + if (workspaceSettings.server && body.role === 'admin' && user.role !== 'owner') return send(res, 403, { ok: false, error: 'forbidden' }) if (!ROLES.includes(body.role)) { const err = new Error('Unknown role.') err.code = 'bad_user' @@ -909,7 +959,7 @@ function readCookie(req, name) { return '' } -function sameOriginMutation(req) { +function legacySameOriginMutation(req) { if (req.method === 'GET' || req.method === 'HEAD') return true if (req.headers['x-keepmind-corp'] === '1') return true const origin = req.headers.origin @@ -1010,6 +1060,7 @@ function readBody(req) { export function startFromEnv() { const env = process.env const host = env.KEEPMIND_CORP_HOST || '127.0.0.1' + if (!['127.0.0.1', 'localhost', '::1'].includes(host) && env.KEEPMIND_CORP_MODE !== 'server') throw Error('Non-loopback binding requires KEEPMIND_CORP_MODE=server and its public URL/domain configuration.') const port = Number(env.KEEPMIND_CORP_PORT || 8787) const corp = createCorp({ env }) const server = createServer((req, res) => { diff --git a/corp/workspace.mjs b/corp/workspace.mjs new file mode 100644 index 0000000..7ba1fd8 --- /dev/null +++ b/corp/workspace.mjs @@ -0,0 +1,111 @@ +// One organization/workspace per server and data directory. No shared tenant store. +import { createHash, randomBytes, timingSafeEqual } from 'node:crypto' + +const digest = value => createHash('sha256').update(String(value)).digest() +export const secretMatches = (a, b) => timingSafeEqual(digest(a), digest(b)) +export const emailDomain = email => String(email).length <= 254 ? /^[a-z0-9][a-z0-9._%+-]{0,63}@([a-z0-9](?:[a-z0-9.-]*[a-z0-9])?)$/i.exec(String(email))?.[1].toLowerCase() : undefined +const fail = (code, message, status = 400) => { throw Object.assign(new Error(message), { code, status }) } + +export function workspaceConfig(env) { + const server = env.KEEPMIND_CORP_MODE === 'server' + let origin = '' + if (env.KEEPMIND_CORP_PUBLIC_URL) { + const url = new URL(env.KEEPMIND_CORP_PUBLIC_URL) + const loopback = ['127.0.0.1', 'localhost', '[::1]'].includes(url.hostname) + if ((url.protocol !== 'https:' && !(loopback && url.protocol === 'http:')) || url.username || url.password || url.pathname !== '/' || url.search || url.hash) throw Error('KEEPMIND_CORP_PUBLIC_URL must be an HTTPS origin (HTTP only on loopback).') + origin = url.origin + } + const domains = String(env.KEEPMIND_CORP_EMAIL_DOMAINS || '').split(',').map(s => s.trim().toLowerCase()).filter(Boolean) + if (domains.some(d => !/^[a-z0-9](?:[a-z0-9-]*[a-z0-9])?(?:\.[a-z0-9](?:[a-z0-9-]*[a-z0-9])?)+$/.test(d))) throw Error('Invalid corporate email domain.') + if (server && (!origin || !domains.length)) throw Error('Server mode requires KEEPMIND_CORP_PUBLIC_URL and KEEPMIND_CORP_EMAIL_DOMAINS.') + return { server, origin, domains, secure: origin.startsWith('https:') || env.KEEPMIND_CORP_SECURE === '1' } +} + +export function smtpMailer(env, testTls) { + if (!env.KEEPMIND_SMTP_HOST || !env.KEEPMIND_SMTP_FROM) return null + const port = Number(env.KEEPMIND_SMTP_PORT || 587) + if (!Number.isInteger(port) || port < 1 || port > 65535) throw Error('Invalid SMTP port.') + let transport + const options = { + host: env.KEEPMIND_SMTP_HOST, port, secure: port === 465, + tls: testTls, + requireTLS: true, // Never downgrade production SMTP to plaintext. + auth: env.KEEPMIND_SMTP_USER ? { user: env.KEEPMIND_SMTP_USER, pass: env.KEEPMIND_SMTP_PASSWORD } : undefined, + connectionTimeout: 10000, greetingTimeout: 10000, socketTimeout: 15000, + disableFileAccess: true, disableUrlAccess: true + } + return async message => { + transport ??= (await import('nodemailer')).default.createTransport(options) + const result = await transport.sendMail({ from: env.KEEPMIND_SMTP_FROM, ...message }) + if (!result.accepted?.length || result.rejected?.length) throw Error('SMTP did not accept recipient.') + } +} + +export function createWorkspace({ org, config, persist, addUser, audit, mailer, now = Date.now }) { + org.invitations ??= [] + // Delivery may have completed before a crash; invalidate uncertain links and allow a fresh invite. + for (const row of org.invitations) if (row.status === 'sending') row.status = 'failed' + const allowed = email => { + const domain = emailDomain(email) + const domains = config.domains.length ? config.domains : [emailDomain(org.users.find(u => u.role === 'owner')?.email)] + return !!domain && domains.includes(domain) + } + const status = row => row.status === 'pending' && row.expiresAt <= now() ? 'expired' : row.status + const list = () => org.invitations.map(({ tokenHash, ...row }) => ({ ...row, status: status(row) })) + const find = token => { + if (!/^[a-f0-9]{64}$/.test(String(token))) fail('invalid_invitation', 'Convite inválido, expirado ou já utilizado.', 410) + const hash = digest(token).toString('hex') + const row = org.invitations.find(r => r.tokenHash === hash && status(r) === 'pending') + const inviter = row && org.users.find(u => u.id === row.invitedBy && !u.disabled) + if (!row || !allowed(row.email) || !inviter || !['owner','admin'].includes(inviter.role) || (row.role === 'admin' && inviter.role !== 'owner')) fail('invalid_invitation', 'Convite inválido, expirado ou já utilizado. Peça um novo convite ao administrador.', 410) + return row + } + return { + allowed, list, + inspect(token) { const r = find(token); return { email: r.email, role: r.role, workspace: org.name, expiresAt: r.expiresAt } }, + async invite(actor, body) { + if (!['owner', 'admin'].includes(actor.role)) fail('forbidden', 'Somente administradores podem convidar.', 403) + if (!mailer || !config.origin) fail('mail_unavailable', 'O administrador do servidor precisa configurar SMTP e a URL pública.', 503) + const email = String(body.email || '').trim().toLowerCase(), role = body.role || 'member' + if (!allowed(email)) fail('email_domain', 'Use um e-mail do domínio corporativo autorizado.') + if (!['member', 'auditor', 'admin'].includes(role) || (role === 'admin' && actor.role !== 'owner')) fail('forbidden', 'Apenas o administrador principal pode convidar outros administradores.', 403) + if (org.users.some(u => u.email === email)) fail('member_exists', 'Essa pessoa já possui uma conta neste workspace.', 409) + if (org.invitations.some(r => r.email === email && ['pending', 'sending'].includes(status(r)))) fail('invitation_pending', 'Já existe um convite pendente. Revogue-o antes de enviar outro.', 409) + if (org.invitations.filter(r => r.createdAt > now() - 3600000).length >= 50) fail('rate_limited', 'Limite de convites atingido. Tente novamente em uma hora.', 429) + const token = randomBytes(32).toString('hex') + const row = { id: randomBytes(16).toString('hex'), email, role, createdAt: now(), expiresAt: now() + 48 * 3600000, status: 'sending', tokenHash: digest(token).toString('hex'), invitedBy: actor.id } + org.invitations.push(row); persist() + try { + await mailer({ to: email, subject: `Convite para ${org.name} — KeepMind Corp`, text: `Você foi convidado para o workspace ${org.name}, com papel ${role}.\n\nAbra o link para confirmar seu e-mail e definir sua própria senha:\n${config.origin}/#invite=${token}\n\nVálido por 48 horas e para um único uso. Se não esperava este convite, ignore a mensagem.` }) + } catch { + row.status = 'failed'; persist(); audit(actor, 'invitation_failed', { email }); + fail('mail_failed', 'O e-mail não pôde ser enviado. Confira o SMTP e tente novamente.', 502) + } + // A revoke during SMTP delivery must remain revoked. + if (row.status === 'sending') row.status = 'pending' + persist(); audit(actor, 'invitation_sent', { email, role }) + return list().find(r => r.id === row.id) + }, + revoke(actor, id) { + const row = org.invitations.find(r => r.id === id) + if (!row) fail('not_found', 'Convite não encontrado.', 404) + if (!['owner', 'admin'].includes(actor.role) || (row.role === 'admin' && actor.role !== 'owner')) fail('forbidden', 'Sem permissão para revogar este convite.', 403) + if (['pending', 'sending'].includes(row.status)) { row.status = 'revoked'; persist(); audit(actor, 'invitation_revoked', { email: row.email }) } + }, + accept(body) { + const row = find(body.token) + if (String(body.email || '').trim().toLowerCase() !== row.email) fail('email_mismatch', 'Use o mesmo e-mail que recebeu o convite.') + if (org.users.some(u => u.email === row.email)) fail('member_exists', 'Esta conta já existe. Entre com sua senha.', 409) + const name = String(body.name || '').trim(), password = String(body.password || '') + if (!name || name.length > 80) fail('bad_name', 'Informe seu nome (até 80 caracteres).') + if (password.length < 12 || password.length > 1024) fail('weak_password', 'Use uma senha entre 12 e 1024 caracteres.') + if (password !== body.confirm) fail('mismatch', 'As senhas não conferem.') + // No await between checking, consuming and persisting: single process/volume. + const user = addUser({ email: row.email, name, password, role: row.role, teamId: 'everyone' }) + user.emailVerifiedAt = new Date(now()).toISOString() + row.status = 'accepted'; row.acceptedAt = now(); persist() + audit(user, 'invitation_accepted', { invitationId: row.id }) + return user + } + } +} diff --git a/deploy/corp/.env.example b/deploy/corp/.env.example new file mode 100644 index 0000000..d77aa1d --- /dev/null +++ b/deploy/corp/.env.example @@ -0,0 +1,10 @@ +CORP_DOMAIN=brain.empresa.com +KEEPMIND_CORP_PUBLIC_URL=https://brain.empresa.com +KEEPMIND_CORP_EMAIL_DOMAINS=empresa.com +# Generate once: openssl rand -hex 32. Remove after workspace creation. +KEEPMIND_CORP_SETUP_TOKEN= +KEEPMIND_SMTP_HOST=smtp.empresa.com +KEEPMIND_SMTP_PORT=587 +KEEPMIND_SMTP_FROM=keepmind@empresa.com +KEEPMIND_SMTP_USER= +KEEPMIND_SMTP_PASSWORD= diff --git a/deploy/corp/Caddyfile b/deploy/corp/Caddyfile new file mode 100644 index 0000000..0592e7d --- /dev/null +++ b/deploy/corp/Caddyfile @@ -0,0 +1,10 @@ +{$CORP_DOMAIN} { + encode gzip + reverse_proxy corp:8787 + header { + Strict-Transport-Security "max-age=31536000" + Referrer-Policy "no-referrer" + X-Content-Type-Options "nosniff" + X-Frame-Options "DENY" + } +} diff --git a/deploy/corp/Dockerfile b/deploy/corp/Dockerfile new file mode 100644 index 0000000..6607b6d --- /dev/null +++ b/deploy/corp/Dockerfile @@ -0,0 +1,24 @@ +FROM node:22-bookworm-slim AS build +WORKDIR /app +ENV ELECTRON_SKIP_BINARY_DOWNLOAD=1 +COPY package.json package-lock.json ./ +RUN npm ci --ignore-scripts +COPY vite.corp.config.mts tsconfig.web.json ./ +COPY src/renderer ./src/renderer +COPY corp ./corp +COPY tools/lib ./tools/lib +RUN npm run corp:build-brain && npm prune --omit=dev --ignore-scripts + +FROM node:22-bookworm-slim +ENV NODE_ENV=production KEEPMIND_CORP_MODE=server KEEPMIND_CORP_HOST=0.0.0.0 KEEPMIND_CORP_PORT=8787 KEEPMIND_CORP_DATA=/data +WORKDIR /app +COPY --from=build --chown=node:node /app/node_modules ./node_modules +COPY --from=build --chown=node:node /app/corp ./corp +COPY --from=build --chown=node:node /app/tools/lib ./tools/lib +COPY --from=build --chown=node:node /app/package.json ./package.json +RUN mkdir /data && chown node:node /data +USER node +VOLUME /data +EXPOSE 8787 +HEALTHCHECK --interval=30s --timeout=5s --start-period=20s CMD node -e "const u=new URL(process.env.KEEPMIND_CORP_PUBLIC_URL);fetch('http://127.0.0.1:8787/api/health',{headers:{Host:u.host}}).then(r=>{if(!r.ok)process.exit(1)}).catch(()=>process.exit(1))" +CMD ["node", "corp/server.mjs"] diff --git a/deploy/corp/compose.yml b/deploy/corp/compose.yml new file mode 100644 index 0000000..3429bad --- /dev/null +++ b/deploy/corp/compose.yml @@ -0,0 +1,33 @@ +services: + corp: + build: + context: ../.. + dockerfile: deploy/corp/Dockerfile + restart: unless-stopped + init: true + env_file: .env + volumes: + - corp-data:/data + expose: + - "8787" + security_opt: + - no-new-privileges:true + proxy: + image: caddy:2-alpine + restart: unless-stopped + environment: + CORP_DOMAIN: ${CORP_DOMAIN:?Set CORP_DOMAIN in .env} + ports: + - "80:80" + - "443:443" + volumes: + - ./Caddyfile:/etc/caddy/Caddyfile:ro + - caddy-data:/data + - caddy-config:/config + depends_on: + corp: + condition: service_healthy +volumes: + corp-data: + caddy-data: + caddy-config: diff --git a/docs/CORP-SERVER.md b/docs/CORP-SERVER.md new file mode 100644 index 0000000..73529b0 --- /dev/null +++ b/docs/CORP-SERVER.md @@ -0,0 +1,77 @@ +# Corp em servidor/VPS + +O Corp funciona como uma aplicação web compartilhada: instale uma vez no servidor da empresa e distribua a URL. Cada instância possui **um workspace**, com memórias pessoais isoladas e conteúdo compartilhado segundo a política existente. Não é necessário instalar o desktop em cada computador. + +## Instalar com Docker Compose + +Pré-requisitos: Docker Engine + Compose v2 no servidor Linux, domínio apontando para o VPS, portas 80/443 disponíveis e conta SMTP autorizada a enviar e-mails. A URL deve usar a raiz do domínio, sem subcaminho. A conta SMTP deve suportar TLS (465) ou STARTTLS (587). + +Na cópia do repositório: + +```sh +cp deploy/corp/.env.example deploy/corp/.env +openssl rand -hex 32 +``` + +Edite `deploy/corp/.env`: informe domínio público, URL HTTPS, domínios corporativos permitidos (separados por vírgula), a chave aleatória de instalação e os dados SMTP. Proteja esse arquivo (`chmod 600 deploy/corp/.env`); não o versione. O endereço remetente deve estar autorizado no provedor SMTP. Configure SPF/DKIM/DMARC com o provedor para entregabilidade. + +```sh +docker compose --env-file deploy/corp/.env -f deploy/corp/compose.yml up -d --build +``` + +O Caddy obtém/renova o certificado HTTPS. Só o proxy expõe portas públicas; o processo Node fica na rede interna e roda sem root. O volume `corp-data` preserva organização, usuários, sessões, convites, memórias e chaves locais. Não execute múltiplas réplicas usando o mesmo volume: o armazenamento atual exige um único processo gravador. + +1. Abra a URL e informe a chave de instalação entregue pelo operador do VPS. +2. Defina nome do workspace, seu nome, e-mail corporativo e senha (12+ caracteres). +3. Você entra como administrador principal. A chave prova autorização do operador para criar o primeiro administrador; **não é verificação da caixa postal do administrador**. +4. Remova `KEEPMIND_CORP_SETUP_TOKEN` do `.env` após criar o workspace e recrie o container. O workspace persistido continua funcionando sem a chave. +5. Abra Governança → Pessoas. Convide colegas e escolha membro, auditor ou administrador. Só o administrador principal pode convidar administradores. +6. O destinatário abre o link recebido, confirma o endereço vinculado e define a própria senha. Em acessos posteriores usa a URL, e-mail e senha. SSO exige e-mail verificado pelo IdP e uma conta já admitida no workspace. + +Domínios são correspondências exatas: `empresa.com` não permite automaticamente `sub.empresa.com` nem domínios parecidos. O endereço completo do convite deve corresponder ao destinatário. Não existe entrada automática apenas por pertencer à empresa. Convites não concedem o papel de administrador principal. + +## Convites e recuperação + +Convites expiram após 48 horas e só podem ser aceitos uma vez. O servidor guarda apenas o hash do segredo; o link contém o segredo no fragmento, removido da barra de endereço ao abrir a página. Recarregou antes de aceitar? Abra novamente o e-mail. Não encaminhe o link: ele prova acesso ao destinatário. + +A tela distingue enviado, aceito, revogado, expirado e falha. Revogue um convite pendente antes de reenviar. SMTP indisponível retorna erro, sem criar uma conta. Após interrupção durante o envio, o convite incerto é invalidado; envie um novo. A aceitação também exige que quem convidou ainda esteja ativo e autorizado. + +A confirmação SMTP significa que o servidor de e-mail aceitou a mensagem, não que ela chegou à caixa de entrada. Não há fluxo de redefinição de senha por e-mail neste incremento; mantenha uma conta administrativa de contingência ou use o SSO configurado. Não apague o volume para recuperar acesso. + +## Operação e dados existentes + +Faça backup do **volume completo**, não apenas do vault: as chaves locais precisam acompanhar os dados cifrados. Pare o serviço para uma cópia consistente. Guarde os backups cifrados e teste restauração em uma instância isolada. Nunca use `down -v` ao atualizar. + +```sh +docker compose --env-file deploy/corp/.env -f deploy/corp/compose.yml stop corp +# Copie o volume corp-data com a ferramenta de backup da sua infraestrutura. +docker compose --env-file deploy/corp/.env -f deploy/corp/compose.yml up -d --build +``` + +Para migrar uma instalação existente, pare a origem e faça uma cópia integral de seu diretório de dados para o novo volume, preservando permissões (UID/GID 1000 no container). Não misture diretórios de organizações diferentes. Contas existentes continuam preservadas; os domínios configurados controlam novos convites. A migração explícita de CRM antigo continua descrita em [CORP-CRM-STORAGE.md](CORP-CRM-STORAGE.md). + +Para execução sem Docker, compile `npm ci && npm run corp:build-brain`, configure as mesmas variáveis mais `KEEPMIND_CORP_MODE=server`, `KEEPMIND_CORP_DATA` e o endereço de bind e execute `npm run corp` com Node 22 sob seu gerenciador de serviços. Use um proxy HTTPS que preserve o cabeçalho Host. Não exponha o backend HTTP diretamente. A origem pública configurada controla cookies Secure, links e proteção contra requisições de outra origem; cabeçalhos forwarded não são usados para confiar em origens. + +## Validação reproduzível + +```sh +npm run corp:build-brain +TMPDIR=/private/tmp npm test # no macOS +TMPDIR=/private/tmp npm run test:crm-browser # inclui workspace + SMTP TLS +npm run corp:check +# Com Docker disponível: +docker build -f deploy/corp/Dockerfile -t keepmind-corp:test . +node scripts/corp-container-smoke.mjs keepmind-corp:test +``` + +O batch existente de navegador inclui criação protegida, erro/foco, convite entregue por SMTP STARTTLS local, aceite, senha divergente, login, rejeição de reutilização e layout compacto/movimento reduzido. Tudo usa dados temporários e destinatários `.test`. O job `corp-server-image` verifica Compose, constrói a imagem, cria um workspace, reinicia o container e confirma persistência/login. Relatórios em `artifacts/crm-smoke/` e `artifacts/corp-container/`. + +Referência de transporte e TLS: [documentação oficial Nodemailer](https://nodemailer.com/smtp). + +## Evidência desta implementação (2026-11-13) + +Validação local: instalação limpa por `npm ci`; 303 testes passaram, 2 skips preexistentes; typecheck e builds SB/Corp passaram; selfcheck Corp passou; 11 smokes de experiência e 10 smokes de CRM/workspace passaram; gates de publicação e relatórios passaram. O novo fluxo teve envio SMTP STARTTLS real contra um servidor de teste local, sem destinatários externos. Foram inspecionadas as capturas de Pessoas/convites (1024 px) e aceite (390 px); a entrada e o foco no erro também foram conferidos no navegador interativo. + +Jev foi usado como revisão auxiliar do desenho de acesso e apontou recuperação de envio interrompido (probabilidade 0,90, modelo `jev-1.14.0`, 575 tokens de entrada/47 de saída). O caso foi tratado e coberto por regressão; essa análise não substitui testes de autorização. + +Docker não está instalado no ambiente local. A evidência do container é produzida pelo job `corp-server-image` no PR; nenhum VPS de produção foi implantado, nenhum domínio real foi configurado e nenhuma entrega para caixa postal externa foi testada. O teste de SMTP comprova transporte e conteúdo; a entrega final depende do provedor e do DNS da empresa. diff --git a/package-lock.json b/package-lock.json index 1dc777c..1b964f7 100644 --- a/package-lock.json +++ b/package-lock.json @@ -15,6 +15,7 @@ "electron-updater": "^6.8.11", "libsodium-wrappers": "^0.8.4", "libsodium-wrappers-sumo": "^0.8.4", + "nodemailer": "10.5.0", "onnxruntime-node": "^1.31.1", "open-bot-avatar": "0.2.1", "qrcode": "^1.5.4", @@ -39,6 +40,7 @@ "playwright": "1.65.0", "react": "^18.3.1", "react-dom": "^18.3.1", + "smtp-server": "3.21.4", "typescript": "^5.7.2", "vite": "^5.4.11", "vitest": "^2.1.9" @@ -6443,6 +6445,13 @@ "node": ">= 12" } }, + "node_modules/ipv6-normalize": { + "version": "1.0.1", + "resolved": "https://registry.npmjs.org/ipv6-normalize/-/ipv6-normalize-1.0.1.tgz", + "integrity": "sha512-Bm6H79i01DjgGTCWjUuCjJ6QDo1HB96PT/xCYuyJUP9WFbVDrLSbG4EZCvOCun2rNswZb0c3e4Jt/ws795esHA==", + "dev": true, + "license": "MIT" + }, "node_modules/is-ci": { "version": "3.0.1", "resolved": "https://registry.npmjs.org/is-ci/-/is-ci-3.0.1.tgz", @@ -7469,6 +7478,15 @@ "node": ">=18" } }, + "node_modules/nodemailer": { + "version": "10.5.0", + "resolved": "https://registry.npmjs.org/nodemailer/-/nodemailer-10.5.0.tgz", + "integrity": "sha512-L/w/HH5MqpzMDuZD7fQdt/+KqymuvrpaApaIjAH2XA3ILePwlcvXCVVvP75xVrXCEt2ggK2marrrHHFB5Qu0kA==", + "license": "MIT-0", + "engines": { + "node": ">=20.0.0" + } + }, "node_modules/nopt": { "version": "6.0.0", "resolved": "https://registry.npmjs.org/nopt/-/nopt-6.0.0.tgz", @@ -8165,6 +8183,16 @@ "node": ">=6" } }, + "node_modules/punycode.js": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/punycode.js/-/punycode.js-2.3.1.tgz", + "integrity": "sha512-uxFIHU0YlHYhDQtV4R9J6a52SLx28BCjT+4ieh7IGbgwVJWO+km431c4yRlREUAsAmt/uMjQUyQHNEPf0M39CA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, "node_modules/qified": { "version": "0.10.1", "resolved": "https://registry.npmjs.org/qified/-/qified-0.10.1.tgz", @@ -8836,6 +8864,21 @@ "npm": ">= 3.0.0" } }, + "node_modules/smtp-server": { + "version": "3.21.4", + "resolved": "https://registry.npmjs.org/smtp-server/-/smtp-server-3.21.4.tgz", + "integrity": "sha512-FnkLEd4QAsuUJTd7AK6zSDB8y2Fn3T1EXIC0OIUMqYbUmCv4VH9p6opt8afCiEd6x+hxjlh/CUFCSJKMW+Nfyg==", + "dev": true, + "license": "MIT-0", + "dependencies": { + "ipv6-normalize": "1.0.1", + "nodemailer": "10.5.0", + "punycode.js": "2.3.1" + }, + "engines": { + "node": ">=20.0.0" + } + }, "node_modules/socks": { "version": "2.8.10", "resolved": "https://registry.npmjs.org/socks/-/socks-2.8.10.tgz", diff --git a/package.json b/package.json index 426b698..056f51b 100644 --- a/package.json +++ b/package.json @@ -41,6 +41,7 @@ "electron-updater": "^6.8.11", "libsodium-wrappers": "^0.8.4", "libsodium-wrappers-sumo": "^0.8.4", + "nodemailer": "10.5.0", "onnxruntime-node": "^1.31.1", "open-bot-avatar": "0.2.1", "qrcode": "^1.5.4", @@ -62,6 +63,7 @@ "playwright": "1.65.0", "react": "^18.3.1", "react-dom": "^18.3.1", + "smtp-server": "3.21.4", "typescript": "^5.7.2", "vite": "^5.4.11", "vitest": "^2.1.9" diff --git a/scripts/corp-container-smoke.mjs b/scripts/corp-container-smoke.mjs new file mode 100644 index 0000000..50b5036 --- /dev/null +++ b/scripts/corp-container-smoke.mjs @@ -0,0 +1,38 @@ +// Validates a prebuilt image with a disposable Docker volume; never publishes it. +import { execFileSync } from 'node:child_process' +import { randomBytes } from 'node:crypto' +import assert from 'node:assert/strict' +import { mkdirSync, writeFileSync } from 'node:fs' +const image = process.argv[2] +if (!image) throw Error('Usage: node scripts/corp-container-smoke.mjs IMAGE') +const name = `keepmind-test-${randomBytes(6).toString('hex')}`, volume = name + '-data' +const url = 'http://127.0.0.1:18787', key = randomBytes(32).toString('hex') +const report = { checks: [], errors: [] } +const docker = (...args) => execFileSync('docker', args, { encoding:'utf8', stdio:['ignore','pipe','pipe'] }).trim() +async function request(route, body) { + const r = await fetch(url+route,{method:body ? 'POST':'GET',headers:{Origin:url,'content-type':'application/json'},body:body ? JSON.stringify(body):undefined}) + return {status:r.status,body:await r.json()} +} +async function ready() { + for(let i=0;i<60;i++){try { if ((await request('/api/health')).status===200) return }catch {} await new Promise(r=>setTimeout(r,500))} + throw Error('Container failed readiness: '+docker('logs',name)) +} +try { + docker('volume','create',volume) + docker('run','-d','--name',name,'--mount',`source=${volume},target=/data`,'-p','127.0.0.1:18787:8787', + '-e',`KEEPMIND_CORP_PUBLIC_URL=${url}`,'-e','KEEPMIND_CORP_EMAIL_DOMAINS=company.test','-e',`KEEPMIND_CORP_SETUP_TOKEN=${key}`,image) + await ready(); assert.equal((await request('/api/meta')).body.setupRequired,true); report.checks.push('image starts as unprivileged server with persistent volume') + assert.notEqual(docker('exec',name,'id','-u'),'0') + const result = await request('/api/setup',{setupToken:key,orgName:'Container workspace',name:'Administrator',email:'admin@company.test',password:'synthetic-container-password',confirm:'synthetic-container-password'}) + assert.equal(result.status,201); report.checks.push('workspace creation through image HTTP endpoint') + docker('restart',name); await ready() + assert.equal((await request('/api/meta')).body.setupRequired,false) + assert.equal((await request('/api/login',{email:'admin@company.test',password:'synthetic-container-password'})).status,200) + report.checks.push('workspace and login survive container restart') + console.log(JSON.stringify(report)) +} catch(e) { report.errors.push(String(e)); process.exitCode=1; console.error(e) } +finally { + try { docker('rm','-f',name) } catch {} + try { docker('volume','rm',volume) } catch {} + mkdirSync('artifacts/corp-container',{recursive:true}); writeFileSync('artifacts/corp-container/report.json',JSON.stringify(report,null,2)+'\n') +} diff --git a/scripts/corp-workspace-smoke.mjs b/scripts/corp-workspace-smoke.mjs new file mode 100644 index 0000000..64f43a9 --- /dev/null +++ b/scripts/corp-workspace-smoke.mjs @@ -0,0 +1,95 @@ +// Used by the existing CRM/Corp batch. Real HTTP + SMTP STARTTLS; only temporary data. +import assert from 'node:assert/strict' +import { createServer } from 'node:http' +import { readFile, mkdir } from 'node:fs/promises' +import { execFileSync } from 'node:child_process' +import path from 'node:path' +import { SMTPServer } from 'smtp-server' +import { createCorp } from '../corp/server.mjs' +import { smtpMailer } from '../corp/workspace.mjs' + +export async function workspaceSmoke({ browser, root, artifacts, check }) { + const directory = path.join(root, 'workspace'); await mkdir(directory) + const key = path.join(directory, 'smtp-key.pem'), cert = path.join(directory, 'smtp-cert.pem') + execFileSync('openssl', ['req','-x509','-newkey','rsa:2048','-nodes','-keyout',key,'-out',cert,'-days','1','-subj','/CN=localhost','-addext','subjectAltName=DNS:localhost'], { stdio: 'ignore' }) + const certificate = await readFile(cert), messages = [] + const smtp = new SMTPServer({ key: await readFile(key), cert: certificate, authOptional: true, disabledCommands: ['AUTH'], onData(stream, session, done) { let text = ''; stream.on('data', c => { text += c }); stream.on('end', () => { messages.push({ text, tls: session.secure }); done() }) } }) + let server, context, invited + try { + await new Promise((r,j) => { smtp.on('error', j); smtp.listen(0, '127.0.0.1', r) }) + let corp + server = createServer((req,res) => corp.handle(req,res)); await new Promise(r => server.listen(0, '127.0.0.1', r)) + const base = `http://127.0.0.1:${server.address().port}` + const setupToken = 'synthetic-install-key-'.repeat(4) + const env = { KEEPMIND_CORP_MODE:'server', KEEPMIND_CORP_PUBLIC_URL:base, KEEPMIND_CORP_EMAIL_DOMAINS:'aurora.test', KEEPMIND_CORP_SETUP_TOKEN:setupToken } + const mailer = smtpMailer({ KEEPMIND_SMTP_HOST:'127.0.0.1', KEEPMIND_SMTP_PORT:String(smtp.server.address().port), KEEPMIND_SMTP_FROM:'corp@aurora.test' }, { ca: certificate, servername:'localhost' }) + corp = createCorp({ dataDir:path.join(directory,'data'), env, mailer, disableCrmScheduler:true, disableGithubScheduler:true, oidc:false }) + context = await browser.newContext({ viewport:{width:1024,height:640}, reducedMotion:'reduce' }) + await context.route('**/*', r => new URL(r.request().url()).origin === base ? r.continue() : r.abort()) + const page = await context.newPage(), errors = []; page.on('pageerror', e => errors.push(e.message)); page.setDefaultTimeout(15000) + await check('VPS workspace: protected first administrator and keyboard-ready setup', async () => { + await page.goto(base) + await page.getByRole('button',{name:'Começar configuração'}).click() + await page.getByRole('alert').filter({hasText:'Informe a chave'}).waitFor() + assert.equal(await page.locator('#form-error').evaluate(e => e === document.activeElement),true) + await page.getByLabel('Chave de instalação').fill(setupToken) + await page.getByRole('button',{name:'Começar configuração'}).click() + await page.getByLabel('Nome da organização').fill('Aurora — Workspace') + await page.getByRole('button',{name:'Continuar',exact:true}).click() + await page.getByLabel('Seu nome',{exact:true}).fill('Admin Aurora') + await page.getByLabel('Email de trabalho').fill('owner@aurora.test') + await page.getByRole('button',{name:'Continuar',exact:true}).click() + await page.getByLabel('Senha',{exact:true}).fill('synthetic-owner-password') + await page.getByLabel('Confirmar senha').fill('synthetic-owner-password') + await page.getByRole('button',{name:'Criar organização e entrar'}).click() + await page.waitForURL('**/brain/') + await page.goto(base+'/admin/') + await page.getByRole('button',{name:'Pessoas',exact:true}).click() + await page.getByRole('heading',{name:'Convide sua equipe'}).waitFor() + }) + let link + await check('VPS workspace: corporate invitation delivered via SMTP STARTTLS', async () => { + await page.getByLabel('E-mail corporativo').fill('ana@other.test') + await page.getByRole('button',{name:'Enviar convite',exact:true}).click() + await page.getByRole('alert').filter({hasText:'domínio corporativo'}).waitFor() + assert.equal(messages.length,0) + await page.getByLabel('E-mail corporativo').fill('ana@aurora.test') + await page.getByRole('button',{name:'Enviar convite',exact:true}).click() + await page.getByText('Convite enviado por e-mail.',{exact:true}).waitFor() + assert.equal(messages.length,1); assert.equal(messages[0].tls,true) + // Decode MIME quoted-printable soft wrapping used by Nodemailer. + const text = messages[0].text.replace(/=\r?\n/g,'').replace(/=([A-F0-9]{2})/g,(_,h)=>String.fromCharCode(parseInt(h,16))) + link = text.match(/http:\/\/127\.0\.0\.1:\d+\/#invite=[a-f0-9]{64}/)?.[0] + assert.ok(link, 'SMTP message must contain the canonical invitation URL') + await page.screenshot({path:path.join(artifacts,'workspace-invitations.png'),fullPage:true}) + }) + await check('VPS workspace: recipient acceptance, login and single use at compact size', async () => { + invited = await browser.newContext({viewport:{width:390,height:844},reducedMotion:'reduce'}) + await invited.route('**/*', r => new URL(r.request().url()).origin === base ? r.continue() : r.abort()) + const member = await invited.newPage(); member.on('pageerror', e => errors.push(e.message)) + await member.goto(link) + await member.getByRole('heading',{name:'Entre em Aurora — Workspace'}).waitFor() + assert.equal(await member.url(),base+'/') + assert.equal(await member.evaluate(()=>document.documentElement.scrollWidth <= innerWidth),true) + assert.equal(await member.locator('.card').evaluate(e=>getComputedStyle(e).animationName),'none') + await member.screenshot({path:path.join(artifacts,'workspace-invitation-mobile.png'),fullPage:true}) + await member.getByLabel('Seu nome',{exact:true}).fill('Ana Aurora') + await member.getByLabel('Senha (mínimo de 12 caracteres)').fill('synthetic-member-password') + await member.getByLabel('Confirmar senha').fill('different-password') + await member.getByRole('button',{name:'Aceitar convite e entrar'}).click() + await member.getByRole('alert').filter({hasText:'não conferem'}).waitFor() + assert.equal(await member.getByLabel('Seu nome',{exact:true}).inputValue(),'Ana Aurora') + await member.getByLabel('Confirmar senha').fill('synthetic-member-password') + await member.getByRole('button',{name:'Aceitar convite e entrar'}).click(); await member.waitForURL('**/brain/') + const forbidden = await invited.request.get(base+'/api/members'); assert.equal(forbidden.status(),403) + await member.goto(link); await member.getByRole('heading',{name:'Não foi possível abrir o convite'}).waitFor() + await invited.request.post(base+'/api/logout',{headers:{Origin:base}}) + await member.goto(base); await member.getByLabel('Email',{exact:true}).fill('ana@aurora.test'); await member.getByLabel('Senha',{exact:true}).fill('synthetic-member-password'); await member.getByRole('button',{name:'Entrar',exact:true}).click(); await member.waitForURL('**/brain/') + assert.deepEqual(errors,[]) + }) + } finally { + await invited?.close(); await context?.close() + if (server) await new Promise(r=>server.close(r)) + await new Promise(r=>smtp.close(r)) + } +} diff --git a/scripts/crm-smoke.mjs b/scripts/crm-smoke.mjs index 544fcaf..c2a6070 100644 --- a/scripts/crm-smoke.mjs +++ b/scripts/crm-smoke.mjs @@ -1,6 +1,7 @@ // Real Corp HTTP server and CRM service, backed only by a temporary synthetic vault. // No providers, personal data, or external browser requests are used. import assert from 'node:assert/strict' +import { workspaceSmoke } from './corp-workspace-smoke.mjs' import { createServer } from 'node:http' import { mkdtemp, mkdir, rm, writeFile } from 'node:fs/promises' import { tmpdir } from 'node:os' @@ -103,6 +104,7 @@ try { await page.screenshot({path:`${artifacts}/mobile-crm.png`,fullPage:true}) }) assert.deepEqual(errors,[],'Uncaught browser errors') + await workspaceSmoke({ browser, root, artifacts, check }) } catch (error) { report.errors.push(String(error?.stack ?? error));console.error(error) if(page) await page.screenshot({path:`${artifacts}/failure.png`,fullPage:true}).catch(()=>{}) diff --git a/tests/corp-workspace.test.ts b/tests/corp-workspace.test.ts new file mode 100644 index 0000000..d5cfa9e --- /dev/null +++ b/tests/corp-workspace.test.ts @@ -0,0 +1,131 @@ +import { createSign, generateKeyPairSync } from 'node:crypto' +import { afterEach, expect, it } from 'vitest' +import { get, createServer, type Server } from 'node:http' +import { mkdtempSync, readFileSync, writeFileSync, rmSync } from 'node:fs' +import { tmpdir } from 'node:os' +import path from 'node:path' +import { createCorp } from '../corp/server.mjs' +import { workspaceConfig } from '../corp/workspace.mjs' +const dirs: string[] = [], servers: Server[] = [] +afterEach(async () => { for (const s of servers.splice(0)) await new Promise(r => s.close(() => r())); for (const d of dirs.splice(0)) rmSync(d, { recursive: true, force: true }) }) +const setup = { setupToken: 'a'.repeat(64), orgName: 'Aurora', name: 'Admin', email: 'owner@aurora.test', password: 'synthetic-password', confirm: 'synthetic-password' } +async function fixture(extra: Record = {}) { + const dir = mkdtempSync(path.join(tmpdir(), 'corp-workspace-')); dirs.push(dir) + let corp: any, time = Date.now(), fail = false + const mail: any[] = [] + const server = createServer((req, res) => corp.handle(req, res)); servers.push(server) + await new Promise(r => server.listen(0, '127.0.0.1', r)) + const url = `http://127.0.0.1:${(server.address() as any).port}` + const env = { KEEPMIND_CORP_MODE: 'server', KEEPMIND_CORP_PUBLIC_URL: url, KEEPMIND_CORP_EMAIL_DOMAINS: 'aurora.test', KEEPMIND_CORP_SETUP_TOKEN: setup.setupToken } + const reopen = () => { corp = createCorp({ dataDir: dir, env, oidc: false, disableCrmScheduler: true, disableGithubScheduler: true, now: () => time, mailer: async (m: any) => { if (fail) throw Error('SMTP failure'); mail.push(m) }, ...extra }) } + reopen() + const req = async (route: string, body?: any, cookie = '', method = body === undefined ? 'GET' : 'POST', origin = url) => { + const res = await fetch(url + route, { method, headers: { 'Content-Type': 'application/json', Origin: origin, Cookie: cookie, 'x-keepmind-corp': '1' }, body: body === undefined ? undefined : JSON.stringify(body) }) + return { status: res.status, body: await res.json(), cookie: res.headers.get('set-cookie')?.split(';')[0] || '' } + } + return { dir, url, req, mail, reopen, advance: () => { time += 49 * 3600000 }, failMail: () => { fail = true } } +} +const token = (m: any) => /#invite=([a-f0-9]{64})/.exec(m.text)![1] +it('requires safe deployment configuration', () => { + expect(() => workspaceConfig({ KEEPMIND_CORP_MODE: 'server' })).toThrow() + expect(() => workspaceConfig({ KEEPMIND_CORP_PUBLIC_URL: 'http://corp.example.com' })).toThrow() + expect(() => workspaceConfig({ KEEPMIND_CORP_PUBLIC_URL: 'https://corp.example.com/subpath' })).toThrow() + expect(workspaceConfig({ KEEPMIND_CORP_PUBLIC_URL: 'https://corp.example.com' }).secure).toBe(true) +}) +it('protects first workspace creation from takeover, CSRF, wrong domains and concurrent setup', async () => { + const f = await fixture() + expect((await f.req('/api/setup', { ...setup, setupToken: 'wrong' })).status).toBe(403) + expect((await f.req('/api/setup', setup, '', 'POST', 'https://evil.test')).status).toBe(403) + expect((await f.req('/api/setup', { ...setup, email: 'x@other.test' })).status).toBe(400) + const results = await Promise.all([f.req('/api/setup', setup), f.req('/api/setup', setup)]) + expect(results.map(r => r.status).sort()).toEqual([201, 409]) + const saved = JSON.parse(readFileSync(path.join(f.dir, 'org.json'), 'utf8')) + expect(saved.users).toHaveLength(1); expect(saved.name).toBe('Aurora') + expect(JSON.stringify(saved)).not.toContain(setup.setupToken) + expect(await new Promise(resolve => { get(f.url + '/api/meta', { headers: { Host: 'evil.test' } }, res => { res.resume(); resolve(res.statusCode!) }) })).toBe(400) +}) +it('delivers bound single-use invitations, persists membership and isolates members from administration', async () => { + const f = await fixture(), owner = (await f.req('/api/setup', setup)).cookie + expect((await f.req('/api/invitations', { email: 'x@sub.aurora.test' }, owner)).status).toBe(400) + expect((await f.req('/api/invitations', { email: 'hidden,ana@aurora.test' }, owner)).status).toBe(400) + expect((await f.req('/api/members', { email: 'x@aurora.test' }, owner)).status).toBe(409) + const sent = await f.req('/api/invitations', { email: 'ANA@aurora.test', role: 'member' }, owner) + expect(sent.status).toBe(201); const secret = token(f.mail[0]) + expect(JSON.stringify(sent.body)).not.toContain(secret) + expect(readFileSync(path.join(f.dir, 'org.json'), 'utf8')).not.toContain(secret) + expect((await f.req('/api/invitations', { email: 'ana@aurora.test' }, owner)).status).toBe(409) + const accept = { token: secret, email: 'ana@aurora.test', name: 'Ana', password: 'password-for-ana', confirm: 'password-for-ana', role: 'owner' } + expect((await f.req('/api/invitations/accept', { ...accept, email: 'bob@aurora.test' })).status).toBe(400) + const results = await Promise.all([f.req('/api/invitations/accept', accept), f.req('/api/invitations/accept', accept)]) + expect(results.map(r => r.status).sort()).toEqual([201, 410]) + const member = results.find(r => r.status === 201)! + expect(member.body.user.role).toBe('member') + expect((await f.req('/api/invitations', undefined, member.cookie)).status).toBe(403) + expect((await f.req('/api/invitations', { email: 'bob@aurora.test' }, member.cookie)).status).toBe(403) + expect((await f.req('/api/login', { email: accept.email, password: accept.password }, '', 'POST', 'https://evil.test')).status).toBe(403) + f.reopen() + expect((await f.req('/api/login', { email: accept.email, password: accept.password })).status).toBe(200) + expect((await f.req('/api/invitations/accept', accept)).status).toBe(410) + await f.req('/api/invitations', { email: 'next@aurora.test' }, owner) + const liveToken = token(f.mail.at(-1)); const other = await fixture() + expect((await f.req('/api/invitations/inspect', { token: liveToken })).status).toBe(200) + expect((await other.req('/api/invitations/inspect', { token: liveToken })).status).toBe(410) +}) +it('rejects revoked/expired/failed invitations and restricts privileged invitations', async () => { + const f = await fixture(), owner = (await f.req('/api/setup', setup)).cookie + const invite = async (email: string, role = 'member') => f.req('/api/invitations', { email, role }, owner) + const revoked = await invite('revoked@aurora.test'); const rt = token(f.mail.at(-1)) + expect((await f.req('/api/invitations/' + revoked.body.invitation.id, undefined, owner, 'DELETE')).status).toBe(200) + expect((await f.req('/api/invitations/inspect', { token: rt })).status).toBe(410) + await invite('expired@aurora.test'); const et = token(f.mail.at(-1)); f.advance() + expect((await f.req('/api/invitations/inspect', { token: et })).status).toBe(410) + await invite('admin@aurora.test', 'admin'); const at = token(f.mail.at(-1)) + const admin = await f.req('/api/invitations/accept', { token: at, email: 'admin@aurora.test', name: 'Admin 2', password: setup.password, confirm: setup.password }) + expect((await f.req('/api/invitations', { email: 'evil@aurora.test', role: 'owner' }, owner)).status).toBe(403) + expect((await f.req('/api/invitations', { email: 'evil@aurora.test', role: 'admin' }, admin.cookie)).status).toBe(403) + f.failMail(); expect((await invite('failed@aurora.test')).status).toBe(502) + expect((await f.req('/api/invitations', undefined, owner)).body.invitations.at(-1).status).toBe('failed') +}) + +it('recovers interrupted sends and rejects invitations from disabled administrators', async () => { + const f = await fixture(), owner = (await f.req('/api/setup', setup)).cookie + await f.req('/api/invitations', { email: 'crash@aurora.test' }, owner) + const oldToken = token(f.mail.at(-1)), file = path.join(f.dir, 'org.json'), org = JSON.parse(readFileSync(file, 'utf8')) + org.invitations[0].status = 'sending'; writeFileSync(file, JSON.stringify(org)); f.reopen() + expect((await f.req('/api/invitations/inspect', { token: oldToken })).status).toBe(410) + expect((await f.req('/api/invitations', { email: 'crash@aurora.test' }, owner)).status).toBe(201) + await f.req('/api/invitations', { email: 'admin@aurora.test', role: 'admin' }, owner) + const admin = await f.req('/api/invitations/accept', { token: token(f.mail.at(-1)), email: 'admin@aurora.test', name: 'Admin', password: setup.password, confirm: setup.password }) + await f.req('/api/invitations', { email: 'member@aurora.test' }, admin.cookie) + const memberToken = token(f.mail.at(-1)) + expect((await f.req('/api/members/' + admin.body.user.id, { disabled: true }, owner, 'PATCH')).status).toBe(200) + expect((await f.req('/api/invitations/inspect', { token: memberToken })).status).toBe(410) +}) +it('cannot bypass setup protection with an incomplete environment bootstrap', () => { + const dir = mkdtempSync(path.join(tmpdir(), 'corp-bootstrap-')); dirs.push(dir) + expect(() => createCorp({ dataDir: dir, disableCrmScheduler: true, disableGithubScheduler: true, env: { KEEPMIND_CORP_MODE: 'server', KEEPMIND_CORP_PUBLIC_URL: 'https://corp.example.com', KEEPMIND_CORP_EMAIL_DOMAINS: 'example.com', KEEPMIND_CORP_OWNER_EMAIL: 'owner@example.com' } })).toThrow('SETUP_TOKEN') +}) + +it('requires verified invited identities for SSO and rejects changed subject bindings', async () => { + const { publicKey, privateKey } = generateKeyPairSync('rsa', { modulusLength: 2048 }) + const jwk = { ...publicKey.export({ format: 'jwk' }), kid: 'test' } + let identity: any = { email: 'stranger@aurora.test', email_verified: true, sub: 'stranger' } + const signed = () => { + const header = Buffer.from(JSON.stringify({ alg: 'RS256', kid: 'test' })).toString('base64url') + const payload = Buffer.from(JSON.stringify({ iss: 'https://idp.test', aud: 'corp', exp: Math.floor(Date.now()/1000)+600, ...identity })).toString('base64url') + const signer = createSign('RSA-SHA256'); signer.update(header + '.' + payload); signer.end() + return header + '.' + payload + '.' + signer.sign(privateKey).toString('base64url') + } + const f = await fixture({ oidc: { issuer: 'https://idp.test', clientId: 'corp', clientSecret: 'synthetic', redirectUri: 'https://unused.test/callback', adminGroup: 'admins' }, fetchImpl: async (url: string) => new Response(JSON.stringify(url.endsWith('openid-configuration') ? { authorization_endpoint: 'https://idp.test/auth', token_endpoint: 'https://idp.test/token', jwks_uri: 'https://idp.test/jwks' } : url.endsWith('/token') ? { id_token: signed() } : { keys: [jwk] }), { status: 200 }) }) + await f.req('/api/setup', setup) + const callback = async () => { + const start = await fetch(f.url + '/api/oidc/start', { redirect: 'manual' }) + const state = new URL(start.headers.get('location')!).searchParams.get('state') + return fetch(f.url + '/api/oidc/callback?code=test&state=' + state, { redirect: 'manual' }) + } + expect((await callback()).status).toBe(403) + identity = { email: setup.email, email_verified: false, sub: 'owner-sub' } + expect((await callback()).status).toBe(403) + identity.email_verified = true; expect((await callback()).status).toBe(302) + identity.sub = 'changed-sub'; expect((await callback()).status).toBe(403) +}) From 8e868e737ea8d678a8e0ca96b4bf5c15298d8e61 Mon Sep 17 00:00:00 2001 From: Gustavo Caetano Date: Fri, 13 Nov 2026 17:44:14 -0300 Subject: [PATCH 2/2] fix(deploy): verify canonical-host container health --- deploy/corp/Dockerfile | 2 +- scripts/corp-container-smoke.mjs | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/deploy/corp/Dockerfile b/deploy/corp/Dockerfile index 6607b6d..2bdcd79 100644 --- a/deploy/corp/Dockerfile +++ b/deploy/corp/Dockerfile @@ -20,5 +20,5 @@ RUN mkdir /data && chown node:node /data USER node VOLUME /data EXPOSE 8787 -HEALTHCHECK --interval=30s --timeout=5s --start-period=20s CMD node -e "const u=new URL(process.env.KEEPMIND_CORP_PUBLIC_URL);fetch('http://127.0.0.1:8787/api/health',{headers:{Host:u.host}}).then(r=>{if(!r.ok)process.exit(1)}).catch(()=>process.exit(1))" +HEALTHCHECK --interval=30s --timeout=5s --start-period=20s CMD node -e "const u=new URL(process.env.KEEPMIND_CORP_PUBLIC_URL);require('node:http').get('http://127.0.0.1:8787/api/health',{headers:{Host:u.host}},r=>{r.resume();if(r.statusCode!==200)process.exit(1)}).on('error',()=>process.exit(1))" CMD ["node", "corp/server.mjs"] diff --git a/scripts/corp-container-smoke.mjs b/scripts/corp-container-smoke.mjs index 50b5036..8f4c57f 100644 --- a/scripts/corp-container-smoke.mjs +++ b/scripts/corp-container-smoke.mjs @@ -14,12 +14,12 @@ async function request(route, body) { return {status:r.status,body:await r.json()} } async function ready() { - for(let i=0;i<60;i++){try { if ((await request('/api/health')).status===200) return }catch {} await new Promise(r=>setTimeout(r,500))} + for(let i=0;i<60;i++){try { if ((await request('/api/health')).status===200 && docker('inspect','--format','{{.State.Health.Status}}',name)==='healthy') return }catch {} await new Promise(r=>setTimeout(r,500))} throw Error('Container failed readiness: '+docker('logs',name)) } try { docker('volume','create',volume) - docker('run','-d','--name',name,'--mount',`source=${volume},target=/data`,'-p','127.0.0.1:18787:8787', + docker('run','-d','--health-interval=1s','--health-start-period=1s','--name',name,'--mount',`source=${volume},target=/data`,'-p','127.0.0.1:18787:8787', '-e',`KEEPMIND_CORP_PUBLIC_URL=${url}`,'-e','KEEPMIND_CORP_EMAIL_DOMAINS=company.test','-e',`KEEPMIND_CORP_SETUP_TOKEN=${key}`,image) await ready(); assert.equal((await request('/api/meta')).body.setupRequired,true); report.checks.push('image starts as unprivileged server with persistent volume') assert.notEqual(docker('exec',name,'id','-u'),'0')