Branding and legal links: logo, instance name, imprint and privacy links on public pages and e-mails #1109

Closed
opened 2026-11-04 03:11:40 +00:00 by Cordy · 4 comments
Owner

Gap (v0.7 feature-gap research, 2026-11-04, decided by Nikola). An operator cannot put a logo on the sign-in page and public link pages, and there is no place for imprint and privacy-policy links. Swiss and EU operators who publish links to outsiders need those links on every public page (and in the e-mails from the sharing-e-mail issue).

Competitors. ownCloud 10 legal settings for imprint and privacy URLs (manual) and theming; OpenCloud branding in its paid tier; Nextcloud theming; Seafile custom logo.

To research and decide when worked on. What is set (logo light/dark, favicon, instance name, accent colour?, imprint URL, privacy URL); where it shows (sign-in, public links, drop links, e-mails, the web UI footer); upload validation (SVG sanitising, size); accessibility (contrast, alt text); storage with the state; licensing tier, if any.

Refs: scratch/b7e/backlog/gap-v07/research-v07-gaps.md A16.

**Gap (v0.7 feature-gap research, 2026-11-04, decided by Nikola).** An operator cannot put a logo on the sign-in page and public link pages, and there is no place for imprint and privacy-policy links. Swiss and EU operators who publish links to outsiders need those links on every public page (and in the e-mails from the sharing-e-mail issue). **Competitors.** ownCloud 10 legal settings for imprint and privacy URLs ([manual](https://doc.owncloud.com/server/10.16/admin_manual/configuration/server/legal_settings_configuration.html)) and theming; OpenCloud branding in its paid tier; Nextcloud theming; Seafile custom logo. **To research and decide when worked on.** What is set (logo light/dark, favicon, instance name, accent colour?, imprint URL, privacy URL); where it shows (sign-in, public links, drop links, e-mails, the web UI footer); upload validation (SVG sanitising, size); accessibility (contrast, alt text); storage with the state; licensing tier, if any. Refs: `scratch/b7e/backlog/gap-v07/research-v07-gaps.md` A16.
Author
Owner

Research done (at d02f2ba1, scratch/b7e/backlog/research-1109.md; claims marked VERIFIED/INFERRED/UNVERIFIED).

Today: the instance name reaches the web UI header, mails, share reports and the #1105 watermark, but the sign-in page and every public page still say "cairn" (login.html:100, pubtext1105.go:36). No imprint or privacy links anywhere. Two small bugs: the name is cut at 64 bytes (can split an umlaut, settings.go:603); the default watermark starts with " · " when no name is set (linkctl1105.go:242). The handover page's CSP would block a logo.

Recommended: an admin panel "Branding and legal", free in every tier, keeping the "via Cairn" credit (LICENSE.md point 3). Logo PNG/JPEG up to 2 MB, re-encoded on the server (no SVG: several logo-upload CVEs), optional dark-background logo and favicon, imprint and privacy URLs (https). Shown on sign-in, every public page, the handover page, the web UI header and user menu, and mail footers. Images stored in the state backend under a content hash and served with a long cache, so every instance shows the new logo at once (#742). Needed by #1103 (mail footers).

Decisions follow.

**Research done** (at d02f2ba1, `scratch/b7e/backlog/research-1109.md`; claims marked VERIFIED/INFERRED/UNVERIFIED). Today: the instance name reaches the web UI header, mails, share reports and the #1105 watermark, but the sign-in page and every public page still say "cairn" (`login.html:100`, `pubtext1105.go:36`). No imprint or privacy links anywhere. Two small bugs: the name is cut at 64 bytes (can split an umlaut, `settings.go:603`); the default watermark starts with " · " when no name is set (`linkctl1105.go:242`). The handover page's CSP would block a logo. Recommended: an admin panel "Branding and legal", free in every tier, keeping the "via Cairn" credit (LICENSE.md point 3). Logo PNG/JPEG up to 2 MB, re-encoded on the server (no SVG: several logo-upload CVEs), optional dark-background logo and favicon, imprint and privacy URLs (https). Shown on sign-in, every public page, the handover page, the web UI header and user menu, and mail footers. Images stored in the state backend under a content hash and served with a long cache, so every instance shows the new logo at once (#742). Needed by #1103 (mail footers). Decisions follow.
Author
Owner

Decided (Nikola, 2026-11-08):

  • Logo: PNG/JPEG and SVG, sanitised (spec: strict allow-list sanitiser on upload, served only as an <img> with Content-Type: image/svg+xml, nosniff and a sandbox CSP, never inlined; size cap).
  • Accent: a default picked from the four existing accents (people can still change their own).
  • "via Cairn" credit: a toggle on every tier, default on. LICENSE.md point 3 ("may not remove or alter attribution notices") gets a one-line clarification that switching the credit off in settings is allowed.
  • Everything else as recommended: optional dark-background logo and favicon; imprint and privacy URLs (https), also in the user menu; one URL per link; logo only in the new sharing mails, not security mails; config-file keys for the URLs; no third link in v0.7; an admin-only hint when no links are set; fix the watermark fallback and the 64-byte name cut.
**Decided (Nikola, 2026-11-08):** - Logo: PNG/JPEG **and SVG, sanitised** (spec: strict allow-list sanitiser on upload, served only as an `<img>` with `Content-Type: image/svg+xml`, `nosniff` and a sandbox CSP, never inlined; size cap). - Accent: a default picked from the four existing accents (people can still change their own). - "via Cairn" credit: **a toggle on every tier, default on.** LICENSE.md point 3 ("may not remove or alter attribution notices") gets a one-line clarification that switching the credit off in settings is allowed. - Everything else as recommended: optional dark-background logo and favicon; imprint and privacy URLs (https), also in the user menu; one URL per link; logo only in the new sharing mails, not security mails; config-file keys for the URLs; no third link in v0.7; an admin-only hint when no links are set; fix the watermark fallback and the 64-byte name cut.
Author
Owner

Mockup approved (Nikola, 2026-11-08): 1109-branding-legal-mockup.html, all 22 frames, and the open points as recommended: one branded 404 for unknown, expired, revoked and paused links; browser icon PNG/JPEG only; SVG logo shown as the instance name in mails; SVG uploads with anything active or external refused, naming what was found (harmless editor leftovers stripped); page titles "{name}: shared by {instance}"; one credit switch for public pages, the branded sign-in page and sharing mails (security mails keep their Cairn lines); tagline hidden when a logo is set; legal links open in a new tab; footer below the card in its own area.

**Mockup approved (Nikola, 2026-11-08):** `1109-branding-legal-mockup.html`, all 22 frames, and the open points as recommended: one branded 404 for unknown, expired, revoked and paused links; browser icon PNG/JPEG only; SVG logo shown as the instance name in mails; SVG uploads with anything active or external refused, naming what was found (harmless editor leftovers stripped); page titles "{name}: shared by {instance}"; one credit switch for public pages, the branded sign-in page and sharing mails (security mails keep their Cairn lines); tagline hidden when a logo is set; legal links open in a new tab; footer below the card in its own area.
Author
Owner

Shipped in v0.6.404 (PR #1146, merge 6a086e92), live on both dogfoods (pods ready, 0 restarts, no new WARN/ERROR).

What shipped: Administration › Basic settings › Branding and legal (instance name, light and dark logo, icon, default accent of the four, imprint and privacy addresses, "Show the Cairn credit" switch on by default and removable on every licence, LICENSE.md and licensing FAQ say so); SVG logos through an allow-list sanitiser (scripts, handlers, foreignObject, external refs, CSS url/@import, DOCTYPE/entities and <use> expansion over 5000 nodes refused); /branding/<id> and /auth/branding; branded header, sign-in page (footer Imprint, Privacy, Runs on Cairn) and one byte-identical branded 404 for every dead link; legal links in the user menu; mail footer with the -- signature line and Imprint/Privacy lines (logo only in sharing e-mails, Content-ID host in xn-- form).

Decisions 2026-11-09: with the credit off and no name, page titles use the link's host instead of "Cairn" (fx5b). New strings approved: brErrUnavail, brErrImgGone, mailWhatSent (new wording); brSvgEntityHint's DE/FR/IT Illustrator menu names are unverified against a localised Illustrator.

Follow-ups: #1149 (small items). #742 residuals: spec §13 items 1-9 (posix window between Claim and sweep, header until settings answer, EXIF orientation, pin removal falls back, no separate mail logo, dropped invisible CSS, old Illustrator DOCTYPE refused, re-upload racing an eviction, refused save leaves images used until the sweep).

Shipped in **v0.6.404** (PR #1146, merge 6a086e92), live on both dogfoods (pods ready, 0 restarts, no new WARN/ERROR). What shipped: Administration › Basic settings › Branding and legal (instance name, light and dark logo, icon, default accent of the four, imprint and privacy addresses, "Show the Cairn credit" switch on by default and removable on every licence, LICENSE.md and licensing FAQ say so); SVG logos through an allow-list sanitiser (scripts, handlers, foreignObject, external refs, CSS url/@import, DOCTYPE/entities and `<use>` expansion over 5000 nodes refused); `/branding/<id>` and `/auth/branding`; branded header, sign-in page (footer Imprint, Privacy, Runs on Cairn) and one byte-identical branded 404 for every dead link; legal links in the user menu; mail footer with the `-- ` signature line and Imprint/Privacy lines (logo only in sharing e-mails, Content-ID host in xn-- form). Decisions 2026-11-09: with the credit off and no name, page titles use the link's host instead of "Cairn" (fx5b). New strings approved: brErrUnavail, brErrImgGone, mailWhatSent (new wording); brSvgEntityHint's DE/FR/IT Illustrator menu names are unverified against a localised Illustrator. Follow-ups: #1149 (small items). #742 residuals: spec §13 items 1-9 (posix window between Claim and sweep, header until settings answer, EXIF orientation, pin removal falls back, no separate mail logo, dropped invisible CSS, old Illustrator DOCTYPE refused, re-upload racing an eviction, refused save leaves images used until the sweep).
Cordy closed this issue 2026-11-09 04:22:23 +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#1109
No description provided.