Research: external partners without an account (guests, OCM from spaces) #1036

Closed
opened 2026-10-28 09:55:11 +00:00 by Cordy · 6 comments
Owner

Split out of the space-sharing decision (2026-10-28). Today externals reach Cairn content only through public links, OCM from Personal, peering copies, or a local account an admin creates.

To research (playbook: market, users, standards, pitfalls, code):

  • Email-invited guest accounts: OpenCloud epic #2513 (in progress), ownCloud 10 Guests app, Seafile guest invitations, Entra B2B, Google visitor sharing.
  • OCM shares from spaces (ocm.go:175-181 "Space paths ride a later milestone").
  • Controls the standards require for outsiders: named identity, expiry of every external grant, access reviews, admin domain allow/block lists, one action to end a vendor's access, warn and label external shares (NIST AC-2/AC-21/PS-7, BSI ORP.4/CON.9, ISG Art. 14/21, NIS2 Annex 11, CISA SCuBA).
  • How guests interact with licence seats (Lizenzen).
Split out of the space-sharing decision (2026-10-28). Today externals reach Cairn content only through public links, OCM from Personal, peering copies, or a local account an admin creates. To research (playbook: market, users, standards, pitfalls, code): - Email-invited guest accounts: OpenCloud epic #2513 (in progress), ownCloud 10 Guests app, Seafile guest invitations, Entra B2B, Google visitor sharing. - OCM shares from spaces (ocm.go:175-181 "Space paths ride a later milestone"). - Controls the standards require for outsiders: named identity, expiry of every external grant, access reviews, admin domain allow/block lists, one action to end a vendor's access, warn and label external shares (NIST AC-2/AC-21/PS-7, BSI ORP.4/CON.9, ISG Art. 14/21, NIS2 Annex 11, CISA SCuBA). - How guests interact with licence seats (Lizenzen).
Author
Owner

Priority raised (v0.7 feature-gap research, 2026-11-04). OpenCloud 9.0.0 shipped passwordless e-mail guests on 2026-10-27, with a comparison table against anonymous links (release); ownCloud 10 has a core guests app (manual), and Kiteworks' migration treats guests as a standard user category. Seafile's report adds e-mail verification for public-link visitors as a lighter variant worth folding in here. Source: scratch/b7e/backlog/gap-v07/research-v07-gaps.md.

**Priority raised (v0.7 feature-gap research, 2026-11-04).** OpenCloud 9.0.0 shipped passwordless e-mail guests on 2026-10-27, with a comparison table against anonymous links ([release](https://github.com/opencloud-eu/opencloud/releases/tag/v9.0.0)); ownCloud 10 has a core guests app ([manual](https://doc.owncloud.com/server/10.16/admin_manual/configuration/user/guests_app.html)), and Kiteworks' migration treats guests as a standard user category. Seafile's report adds e-mail verification for public-link visitors as a lighter variant worth folding in here. Source: `scratch/b7e/backlog/gap-v07/research-v07-gaps.md`.
Author
Owner

Research done (scratch/b7e/backlog/research-1036.md). Market: e-mail code + ~24 h session + the share's end date everywhere (OpenCloud 9.0 single-use 30-min link and PIN, Entra 30-min code, Google 7-day PIN); Microsoft is retiring account-less verified links in favour of guest accounts. NIST 800-63B-4 §3.1.3.1: e-mail SHALL NOT be an out-of-band authenticator, so an e-mail code only shows mailbox control (to be said plainly). Mail scanners pre-fetch links, so the mail only opens a page and the code is sent on "Send code". Cairn gaps: 50-account local cap, picker open to any account, in-memory sessions, OCM refusing space paths (api/ocm.go:369-375). Recommended v0.7: e-mail-code guests on files and folders (Can view / Can edit, required end date), 8-digit 15-min code, 24 h signed session, web only under /g/, no Personal folder, picker, links, re-sharing, devices or OCM; off by default, needs mail; Guests admin list, domain lists, audit; records deleted 30 days after the last share ends. OCM from spaces as phase 2 or early v0.8. Decisions follow.

Research done (`scratch/b7e/backlog/research-1036.md`). Market: e-mail code + ~24 h session + the share's end date everywhere (OpenCloud 9.0 single-use 30-min link and PIN, Entra 30-min code, Google 7-day PIN); Microsoft is retiring account-less verified links in favour of guest accounts. NIST 800-63B-4 §3.1.3.1: e-mail SHALL NOT be an out-of-band authenticator, so an e-mail code only shows mailbox control (to be said plainly). Mail scanners pre-fetch links, so the mail only opens a page and the code is sent on "Send code". Cairn gaps: 50-account local cap, picker open to any account, in-memory sessions, OCM refusing space paths (`api/ocm.go:369-375`). Recommended v0.7: e-mail-code guests on files and folders (Can view / Can edit, required end date), 8-digit 15-min code, 24 h signed session, web only under `/g/`, no Personal folder, picker, links, re-sharing, devices or OCM; off by default, needs mail; Guests admin list, domain lists, audit; records deleted 30 days after the last share ends. OCM from spaces as phase 2 or early v0.8. Decisions follow.
Author
Owner

Decided by Nikola 2026-11-10: both e-mail-code guests and OCM from spaces in this batch. Guests: files and folders only (never whole spaces), "Send code" then an 8-digit code, 24 h session, web only under /g/, Can view / Can edit with a required end date (default 30 d, max 90 up to 365), no Personal folder/picker/links/re-sharing/devices/OCM, off by default, needs mail, record deleted 30 days after the last share ends, shared "Outside domains" list with Send a link by e-mail, no licence seat, always audited, editor under the guest's address. OCM from spaces: #1035 rule (managers count as owners), root refused, Can edit within the sharer's role, admin switch "Also with people on other servers" (on by default), bound to the space by id, follows moves, paused by trash/deactivation, ended on final delete; space name as the owner's display name, display names for all federated shares (after the #1005 live check), optional end dates on federated shares; nothing received into spaces yet. Next: mockups.

**Decided by Nikola 2026-11-10:** both e-mail-code guests **and OCM from spaces** in this batch. Guests: files and folders only (never whole spaces), "Send code" then an 8-digit code, 24 h session, web only under `/g/`, Can view / Can edit with a required end date (default 30 d, max 90 up to 365), no Personal folder/picker/links/re-sharing/devices/OCM, off by default, needs mail, record deleted 30 days after the last share ends, shared "Outside domains" list with Send a link by e-mail, no licence seat, always audited, editor under the guest's address. OCM from spaces: #1035 rule (managers count as owners), root refused, Can edit within the sharer's role, admin switch "Also with people on other servers" (on by default), bound to the space by id, follows moves, paused by trash/deactivation, ended on final delete; space name as the owner's display name, display names for all federated shares (after the #1005 live check), optional end dates on federated shares; nothing received into spaces yet. Next: mockups.
Author
Owner

Mockup 1036-guests-ocm-spaces-mockup.html approved by Nikola 2026-11-10 with its open points as recommended: switches in Sharing › Policy and a Users & access › Guests tab; /g/ with an address field (same answer for any address); "Copy guest link" without a credential; "Guests may only view" applies at once with a count first; lowering the longest access caps new ones only; first name typed kept for an address; guest shares from a space keep serving when the sharer leaves, from Personal they pause with the owner's files; no first-sign-in bell; audit by guest id + address hash (clear address only in invite and delete); the landing page names neither item nor sharer; no other guest e-mails in v0.7; optional end date on federated Personal shares; reworded space rule; the guest option greyed with its reason while off. Next: spec and plan (b6v07, v0.6.406).

Mockup `1036-guests-ocm-spaces-mockup.html` approved by Nikola 2026-11-10 with its open points as recommended: switches in Sharing › Policy and a Users & access › Guests tab; /g/ with an address field (same answer for any address); "Copy guest link" without a credential; "Guests may only view" applies at once with a count first; lowering the longest access caps new ones only; first name typed kept for an address; guest shares from a space keep serving when the sharer leaves, from Personal they pause with the owner's files; no first-sign-in bell; audit by guest id + address hash (clear address only in invite and delete); the landing page names neither item nor sharer; no other guest e-mails in v0.7; optional end date on federated Personal shares; reworded space rule; the guest option greyed with its reason while off. Next: spec and plan (b6v07, v0.6.406).
Author
Owner

Spec decisions (2026-11-10), after research on the spec's open points:

  • An address that is a verified account address is refused as a guest ("share with the account instead"), so a disabled account can't get back in with an e-mail code.
  • Wrong codes: a stored wait time (1, 2, 4, 8 s) answered with 429 and Retry-After. This also slows tries sent in parallel.
  • No public address configured: a separate code guests-need-address with its own texts.
  • The guest cookie is __Host- with Path=/, since browsers reject __Host- on /g/. Sign-out ends the guest in every browser.
  • Administrators can rename a guest (audit verb guest-renamed).
  • Send-code limits apply per guest and browser, so a stranger can't use up a guest's codes.
  • OCM wire fixes found before the lab check:
    • expiration is sent as Unix seconds, otherwise OpenCloud and oCIS refuse dated shares.
    • ownerDisplayName is sent on every share.
    • sharedBy and sharedByDisplayName are added for Nextcloud.
  • Mail and string fixes approved, including IT "amministratore".
  • Follow-up issue to be filed: __Host- prefix for the account session cookie.

Next: spec and plan updated, then build (b6v07).

Spec decisions (2026-11-10), after research on the spec's open points: - An address that is a verified account address is refused as a guest ("share with the account instead"), so a disabled account can't get back in with an e-mail code. - Wrong codes: a stored wait time (1, 2, 4, 8 s) answered with 429 and Retry-After. This also slows tries sent in parallel. - No public address configured: a separate code `guests-need-address` with its own texts. - The guest cookie is `__Host-` with `Path=/`, since browsers reject `__Host-` on `/g/`. Sign-out ends the guest in every browser. - Administrators can rename a guest (audit verb `guest-renamed`). - Send-code limits apply per guest and browser, so a stranger can't use up a guest's codes. - OCM wire fixes found before the lab check: - `expiration` is sent as Unix seconds, otherwise OpenCloud and oCIS refuse dated shares. - `ownerDisplayName` is sent on every share. - `sharedBy` and `sharedByDisplayName` are added for Nextcloud. - Mail and string fixes approved, including IT "amministratore". - Follow-up issue to be filed: `__Host-` prefix for the account session cookie. Next: spec and plan updated, then build (b6v07).
Author
Owner

Shipped in v0.6.406 (PR #1157, merge bee68e7c). Live on both dogfoods since 2026-11-11 15:34 UTC: pods ready, no restarts. /g/ answers guests-off (guests are off by default).

What shipped

  • Guests: people without an account sign in with an 8-digit e-mail code. Sessions last 24 h. An end date is required (30/90/365). Shares can be view-only. Guests have their own /g/ pages and the document editor, and their uploads are scanned like link drops.
  • How sign-in is protected:
    • The same answers for every address, with stand-in code records.
    • Waits of 1, 2, 4 and 8 s via 429 and Retry-After.
    • Code limits per guest and browser.
    • Verified account addresses (and config-account addresses) are refused as guests.
    • Signing out ends the guest in every browser.
  • Outside domains: one list in allow or block mode, used for guest invites and Send a link by e-mail.
  • Users & access › Guests: end all access, delete, rename, CSV.
  • Undeliverable guest codes no longer turn the mail status red.
  • Owners and managers see the guest's address in Deleted files and versions.
  • OCM from Spaces: items in Spaces can be shared with other servers. It is bound to the space by id, has optional end dates, and follows the space lifecycle (moving, paused, end). There is an admin switch and a version gate at v0.6.406.
  • OCM wire fixes: expiration is sent as Unix seconds, ownerDisplayName on every share, plus sharedBy and sharedByDisplayName.
  • Security fix #1156, found by this batch's review: the public link route no longer serves shares to people and groups by their internal key.
  • Docs: handbook pages updated in the repo (sharing, admin-policy, users-access, federation-ocm, spaces, mail, data protection, security standards).

Follow-ups:

  • Filed separately: receive OCM into Spaces, and the __Host- prefix for the account session cookie.
  • Backlog:
    • guest changes in a file's Activity;
    • the restore-to-earlier-time preview showing the raw guest author;
    • a Replace / Keep both choice for guest uploads.
  • #1005 live check: how display names render on Nextcloud, OpenCloud and oCIS.
Shipped in **v0.6.406** (PR #1157, merge bee68e7c). Live on both dogfoods since 2026-11-11 15:34 UTC: pods ready, no restarts. `/g/` answers `guests-off` (guests are off by default). **What shipped** - **Guests:** people without an account sign in with an 8-digit e-mail code. Sessions last 24 h. An end date is required (30/90/365). Shares can be view-only. Guests have their own `/g/` pages and the document editor, and their uploads are scanned like link drops. - **How sign-in is protected:** - The same answers for every address, with stand-in code records. - Waits of 1, 2, 4 and 8 s via 429 and Retry-After. - Code limits per guest and browser. - Verified account addresses (and config-account addresses) are refused as guests. - Signing out ends the guest in every browser. - **Outside domains:** one list in allow or block mode, used for guest invites and Send a link by e-mail. - **Users & access › Guests:** end all access, delete, rename, CSV. - **Undeliverable guest codes** no longer turn the mail status red. - **Owners and managers** see the guest's address in Deleted files and versions. - **OCM from Spaces:** items in Spaces can be shared with other servers. It is bound to the space by id, has optional end dates, and follows the space lifecycle (moving, paused, end). There is an admin switch and a version gate at v0.6.406. - **OCM wire fixes:** `expiration` is sent as Unix seconds, `ownerDisplayName` on every share, plus `sharedBy` and `sharedByDisplayName`. - **Security fix #1156,** found by this batch's review: the public link route no longer serves shares to people and groups by their internal key. - **Docs:** handbook pages updated in the repo (sharing, admin-policy, users-access, federation-ocm, spaces, mail, data protection, security standards). **Follow-ups:** - **Filed separately:** receive OCM into Spaces, and the `__Host-` prefix for the account session cookie. - **Backlog:** - guest changes in a file's Activity; - the restore-to-earlier-time preview showing the raw guest author; - a Replace / Keep both choice for guest uploads. - **#1005 live check:** how display names render on Nextcloud, OpenCloud and oCIS.
Cordy closed this issue 2026-11-11 15:37:35 +00:00
Sign in to join this conversation.
No labels
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference: Cordy/Cairn#1036
No description provided.