Classification labels on files and folders (ISO 27001 A.5.12/A.5.13) (research first) #1043

Closed
opened 2026-10-28 23:37:31 +00:00 by Cordy · 4 comments
Owner

Gap found in the #847 customer compliance mapping (2026-10-29): Cairn has free tags only; no sensitivity labels (e.g. public / internal / confidential / secret, or Swiss ISG intern / vertraulich / geheim). Nextcloud and M365 offer labels. Research first (market, standards incl. ISG/ISV classification, what labels should enforce: sharing/link restrictions, watermarking, download rules), then decisions and a mockup. Optional/toggleable feature.

Gap found in the #847 customer compliance mapping (2026-10-29): Cairn has free tags only; no sensitivity labels (e.g. public / internal / confidential / secret, or Swiss ISG intern / vertraulich / geheim). Nextcloud and M365 offer labels. Research first (market, standards incl. ISG/ISV classification, what labels should enforce: sharing/link restrictions, watermarking, download rules), then decisions and a mockup. Optional/toggleable feature.
Author
Owner

Scope note (v0.7 feature-gap research, 2026-11-04). The cheap 80% competitors offer is admin-only labels plus a rule such as "no public links for items labelled X" (ownCloud 10 classification with the file firewall); Nextcloud added sensitivity labels only in 2026 as an enterprise add-on in early access. Start the research from that slice. Source: scratch/b7e/backlog/gap-v07/research-owncloud10.md, research-nextcloud-files.md.

**Scope note (v0.7 feature-gap research, 2026-11-04).** The cheap 80% competitors offer is admin-only labels plus a rule such as "no public links for items labelled X" (ownCloud 10 classification with the file firewall); Nextcloud added sensitivity labels only in 2026 as an enterprise add-on in early access. Start the research from that slice. Source: `scratch/b7e/backlog/gap-v07/research-owncloud10.md`, research-nextcloud-files.md.
Author
Owner

Research done (2026-11-11, scratch/b7e/backlog/research-1043.md). Sources: Box Shield, Microsoft Purview, Google Drive labels, ownCloud classification, Nextcloud, Swiss ISV, German VSA, TLP 2.0. Box has the most complete model.

Recommended design

  • Labels: a separate label store, off by default, up to 10 admin-defined labels or a preset (Business, Swiss ISG, German VS-NfD, TLP 2.0).
  • Inheritance: an item's label is the highest of its own and its folders'. Moves and copies keep the label.
  • Lowering: space owners only, with a reason; every change is audited.
  • Per-label effects: block links, guests or OCM; view-only with watermark ({classification}); password and shorter expiry. They are enforced at serve time, so existing links stop too.

Code findings:

  • Tag updates after a move are best-effort, which labels must not copy.
  • The tag store caps at 5,000 items.
  • Today's share rules never touch existing links.
  • Every way out needs the same check: links, ZIP, the editor, guests and OCM.

Next: decisions.

**Research done** (2026-11-11, `scratch/b7e/backlog/research-1043.md`). Sources: Box Shield, Microsoft Purview, Google Drive labels, ownCloud classification, Nextcloud, Swiss ISV, German VSA, TLP 2.0. Box has the most complete model. **Recommended design** - **Labels:** a separate label store, off by default, up to 10 admin-defined labels or a preset (Business, Swiss ISG, German VS-NfD, TLP 2.0). - **Inheritance:** an item's label is the highest of its own and its folders'. Moves and copies keep the label. - **Lowering:** space owners only, with a reason; every change is audited. - **Per-label effects:** block links, guests or OCM; view-only with watermark (`{classification}`); password and shorter expiry. They are enforced at serve time, so existing links stop too. **Code findings:** - Tag updates after a move are best-effort, which labels must not copy. - The tag store caps at 5,000 items. - Today's share rules never touch existing links. - Every way out needs the same check: links, ZIP, the editor, guests and OCM. **Next:** decisions.
Author
Owner

Decisions (2026-11-12)

  • Store: labels get their own store. An item's label is the highest of its own and its folders'. Moves and copies keep it, and a move whose label update fails is refused or undone.
  • Existing shares are checked when served: links, guests and OCM stop serving labelled items, the owner gets one bell, and Shares shows "Stopped by classification". The share works again if the label is lowered. Why: a folder link serves the folder's current content, so a check only at creation would let "link first, label later" through. ISV and ISO 27001 A.5.13 tie handling to the label from when it is set, and Box behaves the same way.
  • The rest as researched:
    • Off by default.
    • Up to 10 labels, or a preset: Business, Swiss ISG INTERN/VERTRAULICH, German VS-NfD, TLP 2.0.
    • Effects are chosen per label.
    • Lowering a label: only the space owner (or the owner of a Personal folder), with a reason.
    • Showing the label to outsiders is a per-label setting.
    • Optional "unlabelled items count as" default.
    • Optional "classified until" date with a review list.
    • Moves into linked folders are allowed, with a warning.
    • New watermark placeholder {classification}.

Next: mockups.

**Decisions (2026-11-12)** - **Store:** labels get their own store. An item's label is the highest of its own and its folders'. Moves and copies keep it, and a move whose label update fails is refused or undone. - **Existing shares** are checked when served: links, guests and OCM stop serving labelled items, the owner gets one bell, and Shares shows "Stopped by classification". The share works again if the label is lowered. Why: a folder link serves the folder's current content, so a check only at creation would let "link first, label later" through. ISV and ISO 27001 A.5.13 tie handling to the label from when it is set, and Box behaves the same way. - **The rest as researched:** - Off by default. - Up to 10 labels, or a preset: Business, Swiss ISG INTERN/VERTRAULICH, German VS-NfD, TLP 2.0. - Effects are chosen per label. - Lowering a label: only the space owner (or the owner of a Personal folder), with a reason. - Showing the label to outsiders is a per-label setting. - Optional "unlabelled items count as" default. - Optional "classified until" date with a review list. - Moves into linked folders are allowed, with a warning. - New watermark placeholder `{classification}`. **Next:** mockups.
Author
Owner

Shipped in v0.6.407 (PR #1170), live on both dogfoods (v0.6.407, ready, 0 restarts, no new WARN/ERROR; classification is off until an admin turns it on).

What shipped:

  • Classification labels (off by default, presets incl. TLP 2.0 and a Swiss federal set), ordered, highest of item and folders wins.
  • Effects per label: public links, guests, other servers (OCM and Send to peer), view-only links with watermark/password/max lifetime. Existing shares stop while they would serve a labelled item and work again when lowered; owners get bells and the opt-in mail (with Stop link).
  • Labels survive every rename/copy surface (REST, WebDAV, guest, rewind, parked recovery, peering delivery, owner transfer) via a label layer inside the unscoped store; refused with 503 label-store-busy when they cannot be written.
  • Only the owner lowers, with a reason; an administrator where the place has no owner (incl. a deleted account's Personal folder). Every label event is always audited (admin tier).
  • Administration › Classification (Labels, Review, Labelled items), file chips, Details, label: search, export table account/classification.

Docs: classification-labels.md, sharing.md, admin-policy.md, CHANGELOG. Follow-ups filed separately.

Shipped in **v0.6.407** (PR #1170), live on both dogfoods (v0.6.407, ready, 0 restarts, no new WARN/ERROR; classification is off until an admin turns it on). What shipped: - Classification labels (off by default, presets incl. TLP 2.0 and a Swiss federal set), ordered, highest of item and folders wins. - Effects per label: public links, guests, other servers (OCM and Send to peer), view-only links with watermark/password/max lifetime. Existing shares stop while they would serve a labelled item and work again when lowered; owners get bells and the opt-in mail (with Stop link). - Labels survive every rename/copy surface (REST, WebDAV, guest, rewind, parked recovery, peering delivery, owner transfer) via a label layer inside the unscoped store; refused with 503 `label-store-busy` when they cannot be written. - Only the owner lowers, with a reason; an administrator where the place has no owner (incl. a deleted account's Personal folder). Every label event is always audited (admin tier). - Administration › Classification (Labels, Review, Labelled items), file chips, Details, `label:` search, export table `account/classification`. Docs: classification-labels.md, sharing.md, admin-policy.md, CHANGELOG. Follow-ups filed separately.
Cordy closed this issue 2026-11-12 19:12:08 +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#1043
No description provided.