4 Commits
Author SHA1 Message Date
Olaf b89d12769c Privacy assesment by AI.
Build LinkLog Development Image / development-image (push) Successful in 28s
2026-09-30 09:08:52 +02:00
Olaf 370a91b23b Privacy review, on request by a colleague
Build LinkLog Development Image / development-image (push) Successful in 43s
2026-09-15 21:09:52 +02:00
olaf 24c4753093 Profile tweaks
Build LinkLog Development Image / development-image (push) Successful in 11s
2026-09-07 15:04:05 +02:00
olaf 17c72f89bf Comment area width
Build LinkLog Development Image / development-image (push) Successful in 29s
2026-09-07 12:41:37 +02:00
7 changed files with 145 additions and 12 deletions
+1 -1
View File
@@ -10,7 +10,7 @@ APP_HEALTHCHECK_RETRIES=3
LINKLOG_APP_NAME=LinkLog LINKLOG_APP_NAME=LinkLog
LINKLOG_SECRET_KEY=replace-with-a-long-random-secret LINKLOG_SECRET_KEY=replace-with-a-long-random-secret
LINKLOG_DATA_ENCRYPTION_KEY=generate-with-python-cryptography-fernet-key LINKLOG_DATA_ENCRYPTION_KEY=generate-with-python-cryptography-fernet-key
LINKLOG_TOKEN_EXPIRY_MINUTES=15 LINKLOG_TOKEN_EXPIRY_MINUTES=300
LINKLOG_REFRESH_TOKEN_EXPIRY_DAYS=30 LINKLOG_REFRESH_TOKEN_EXPIRY_DAYS=30
LINKLOG_PUBLIC_URL=linklog.example.com LINKLOG_PUBLIC_URL=linklog.example.com
LINKLOG_SMTP_HOST= LINKLOG_SMTP_HOST=
+8
View File
@@ -1,4 +1,11 @@
# Changelog # Changelog
## Version v0.3.1
### Features
### Fixed
* Made the feed profile summary visually distinct with a contrasting background and slightly smaller text
### Modification
* Made the feed profile summary collapsible under a subdued `:profile` title
## Version v0.3.0 ## Version v0.3.0
### Features ### Features
* Implemented toolbar search functionality, using Google-like syntax (implicit AND, quoted phrases, `OR`, `-` exclusions, and the `site:` operator) * Implemented toolbar search functionality, using Google-like syntax (implicit AND, quoted phrases, `OR`, `-` exclusions, and the `site:` operator)
@@ -17,6 +24,7 @@
## Version v0.2.0 ## Version v0.2.0
### Features ### Features
* Users can edit or delete labels created by themselves on the labels page * Users can edit or delete labels created by themselves on the labels page
+84
View File
@@ -0,0 +1,84 @@
# LinkLog Privacy and Fingerprinting
## Scope
This document describes the privacy and fingerprinting characteristics of the LinkLog web service and Firefox extension as implemented in this repository. It is a source-code assessment, not a legal privacy policy, penetration test, or guarantee about a particular deployment.
## Summary
LinkLog does not contain explicit canvas, WebGL, audio, font, hardware, timezone, analytics, or third-party advertising fingerprinting code. Its main privacy risk is different: LinkLog is designed to publish link activity, and that activity can form a highly distinctive identity profile.
A deployment operator, public visitor, upstream website, Mastodon instance, or network observer may be able to correlate a user through the data and request patterns described below.
## Fingerprinting and Correlation Risks
### Public activity and identity profile
The public feed exposes usernames, profile avatars, bios, exact creation timestamps, titles, original URLs, comments, tags, and whether an entry was posted to Mastodon. Public user enumeration and per-user feed URLs make it easy to collect this information for a particular account.
A sequence of saved links, topics, tags, timestamps, writing style, and referenced websites can be distinctive enough to associate a LinkLog account with activity on other services. This is a high privacy risk for users who expect saved links to be private.
Relevant implementation: `backend/app/api/public.py` and `backend/app/services/link_service.py`.
### URL and query-parameter leakage
LinkLog removes a configurable list of common advertising and analytics parameters, including `utm_*`, `gclid`, `fbclid`, and several vendor-specific parameters. This reduces routine campaign tracking but does not make URLs anonymous.
Other query parameters, path segments, fragments that are retained by the URL cleaner, document identifiers, search terms, access codes, repository names, and user-specific URLs may still identify a person or expose sensitive information. Operators should treat saved URLs, comments, titles, and tags as potentially personal data.
The tracking-parameter list is configured through `LINKLOG_TRACKING_PARAMS`; changing it can also change the URL-normalization behavior of a deployment.
### Firefox extension website activity
The extension uses `activeTab` and requests optional HTTP/HTTPS host permissions for the configured LinkLog backend. When a user saves a page, the extension reads the active page's URL and title and sends the selected data to that backend.
The extension therefore handles website activity by design. A malicious or compromised configured backend could receive the URLs that users submit, and a user can disclose sensitive page URLs by saving them. The extension stores the backend URL and username in local extension storage and keeps session credentials in Firefox session storage.
Relevant implementation: `webextension/manifest.json`, `webextension/popup.js`, and `webextension/options.js`.
### Mastodon and external-service correlation
When enabled, the Mastodon plugin publishes the link title, comment, tags, source URL, and a UTC timestamp to the configured Mastodon instance. Posts include a recognizable `User-Agent: LinkLog/1.0` in server-to-server requests. The resulting public Mastodon post can link the user's LinkLog identity, interests, and activity times to a Mastodon account.
The plugin also makes LinkLog activity observable to the configured Mastodon server, including the instance connection and publication time.
Relevant implementation: `backend/app/services/plugin_manager.py`.
### Server-side URL fetching
The authenticated scrape endpoint fetches a user-provided URL from the LinkLog server to obtain a page title. The target website may see the LinkLog server's network address and request characteristics rather than the user's browser address. This creates server-side attribution and may reveal that a URL was submitted to LinkLog.
### Deployment fingerprinting
A deployment may be distinguishable through its public version, FastAPI/OpenAPI metadata, static asset version parameters, enabled themes, feed page sizes, maximum post length, response headers, health endpoint, public hostname, and extension update metadata. These signals generally identify an installation or software version rather than a person, but they can assist cross-site correlation and targeted attack reconnaissance.
The public configuration endpoint intentionally returns feed page sizes and the maximum post-character limit. The application also exposes `/health`, and the README documents `/docs` and OpenAPI access. Production operators should decide which of these should remain public.
### Authentication and account-state observation
Login throttling, response status differences, verification state, reset-mail behavior, response timing, and refresh-token behavior can reveal limited information about account state to a party able to make repeated requests. Current login errors are mostly generic, but verified and unverified account paths still differ, and failed login handling may trigger password-reset mail for known verified accounts when SMTP is configured.
Client IP handling and throttling are also deployment-sensitive. In a multi-instance deployment, the current SQLite-based limiter does not provide a shared, atomic privacy or abuse-control boundary.
## Recommended Mitigations
Prioritize these changes for privacy-sensitive or public deployments:
1. Make feeds and links private by default, with explicit per-link or per-profile publication controls.
2. Make public user enumeration and profile indexing opt-in, and consider requiring authentication for user lists and private feeds.
3. Strip or allow-list URL query parameters and warn users before saving URLs that contain credentials, access codes, search terms, or other sensitive identifiers.
4. Offer privacy controls for avatars, bios, tags, comments, exact timestamps, and original URLs; consider timestamp coarsening for public entries.
5. Minimize extension permissions and clearly disclose that saving a page sends its URL and title to the configured backend. Keep backend origin permissions restricted to the configured origin.
6. Make Mastodon publication an explicit opt-in, show the complete data that will be published, and allow users to disable URL and timestamp inclusion.
7. Protect or disable `/docs`, `/openapi.json`, detailed health/configuration endpoints, version disclosures, and unnecessary response metadata in production.
8. Use uniform authentication responses and timing where practical, independently throttle password-reset mail, and use a shared atomic rate limiter such as Redis for multi-instance deployments.
9. Configure strict security headers, trusted hosts, HTTPS, log retention, and access controls. Do not log authorization headers, tokens, passwords, OTP values, or secret-bearing URLs.
10. Document retention, deletion, backup, and export behavior for links, profiles, audit records, avatars, tokens, and server logs.
## User Guidance
Do not save private document links, password-reset URLs, invitation URLs, access tokens, or URLs containing sensitive query parameters to a public feed. Review titles, comments, tags, timestamps, and the Mastodon preview before publishing. Use a private deployment and disable Mastodon integration when the link history itself is sensitive.
## Assessment Limits
This document reflects the repository implementation reviewed on 2026-09-16. Reverse-proxy settings, browser privacy settings, database access, server logs, deployment networking, dependencies, and third-party Mastodon behavior can materially change the effective risk. A production deployment should supplement this review with configuration review, dependency and container scanning, authenticated dynamic tests, and a retention/access-control review.
+12
View File
@@ -279,6 +279,12 @@ Add authenticated admin/user configuration
### Assistant outcome ### Assistant outcome
Added shared bearer-token dependencies, protected user configuration endpoints, restricted plugin administration to administrator accounts, and changed user configuration to use the authenticated user's ID instead of hard-coded `user-1`. The seeded `alice` account is an administrator for development and `bob` remains a standard user. README authentication guidance was added, and the strict backend suite passed with 8 tests. Added shared bearer-token dependencies, protected user configuration endpoints, restricted plugin administration to administrator accounts, and changed user configuration to use the authenticated user's ID instead of hard-coded `user-1`. The seeded `alice` account is an administrator for development and `bob` remains a standard user. README authentication guidance was added, and the strict backend suite passed with 8 tests.
### User
What are the fingerprinting risks of this system?
### Assistant outcome
Reviewed the public feed, authentication and link APIs, frontend, Firefox extension, Mastodon integration, configuration, and existing security audit. Identified high privacy risk from public link and profile metadata, plus medium risks from deployment/configuration fingerprinting, extension website activity, external-request attribution, and observable authentication behavior. No code changes were made.
### User ### User
Make sure the link-log page is responsive Make sure the link-log page is responsive
@@ -1617,3 +1623,9 @@ Implement the same functionality in the firefox plugin
### Assistant outcome ### Assistant outcome
Added the same live character-count warning to the Firefox extension popup: it fetches `/api/public/config` for the limit and the user's `/api/user/plugins/mastodon` post prefix, estimates the assembled Mastodon post length the same way as the New Entry page and backend plugin, and shows a localized `used/limit characters` counter (with an over-limit warning message) that updates on every relevant input and tag toggle. Added the `characterCount`/`characterCountOverLimit` translations to all five locale files (en-US, de, es, fr, nl) and verified all locale JSON files parse and `popup.js` passes a Node syntax check. Added the same live character-count warning to the Firefox extension popup: it fetches `/api/public/config` for the limit and the user's `/api/user/plugins/mastodon` post prefix, estimates the assembled Mastodon post length the same way as the New Entry page and backend plugin, and shows a localized `used/limit characters` counter (with an over-limit warning message) that updates on every relevant input and tag toggle. Added the `characterCount`/`characterCountOverLimit` translations to all five locale files (en-US, de, es, fr, nl) and verified all locale JSON files parse and `popup.js` passes a Node syntax check.
# Chat Log # Chat Log
### User
Add these findings and recomendations to Privacy.md
### Assistant outcome
Created `Privacy.md` with a source-grounded privacy and fingerprinting assessment covering public activity correlation, URL and query-parameter leakage, Firefox extension website activity, Mastodon correlation, server-side URL fetching, deployment fingerprinting, authentication observability, user guidance, and prioritized mitigations. Validated the document contents; no runtime code was changed.
+5
View File
@@ -278,6 +278,7 @@
248. Release script fails because the runner's hashlib module has no file_digest attribute. 248. Release script fails because the runner's hashlib module has no file_digest attribute.
249. The filtering on tags does not work. When I click on the button I cannot select. Remember that any visitor on the site should be able to filter the tag for the link-feed. 249. The filtering on tags does not work. When I click on the button I cannot select. Remember that any visitor on the site should be able to filter the tag for the link-feed.
250. Update VIBE and Changelog 250. Update VIBE and Changelog
251. What are the fingerprinting risks of this system?
## 2026-08-30 ## 2026-08-30
@@ -316,6 +317,10 @@ If the user uses the filters and/or search in the toolbox then those should limi
261. In the new-entry form, provide a warning when the total ammount of characters is over LINKLOG_MAX_POST_CHARACTERS=500 (also indicat the number of characters used/500 count). This is to prevent Mastodon posts from failing - so all characters should be counted. 261. In the new-entry form, provide a warning when the total ammount of characters is over LINKLOG_MAX_POST_CHARACTERS=500 (also indicat the number of characters used/500 count). This is to prevent Mastodon posts from failing - so all characters should be counted.
262. Implement the same functionality in the firefox plugin 262. Implement the same functionality in the firefox plugin
## 2026-09-16
263. Add these findings and recomendations to Privacy.md
## Future entries ## Future entries
Append each new user prompt here with its date and preserve the chronological order. Append each new user prompt here with its date and preserve the chronological order.
+21
View File
@@ -847,6 +847,11 @@ button:disabled {
border-top: 1px solid var(--border); border-top: 1px solid var(--border);
} }
.edit-form textarea {
width: 100%;
}
.edit-tags { .edit-tags {
display: grid; display: grid;
gap: 8px; gap: 8px;
@@ -941,6 +946,21 @@ button:disabled {
box-shadow: var(--shadow); box-shadow: var(--shadow);
} }
.profile-summary summary {
color: var(--subtext);
cursor: pointer;
font-size: 0.9rem;
font-weight: 600;
}
.profile-summary[open] summary {
margin-bottom: 8px;
}
.profile-summary-content {
font-size: 0.95rem;
}
.about-content { .about-content {
display: grid; display: grid;
gap: 14px; gap: 14px;
@@ -1007,6 +1027,7 @@ button:disabled {
.profile-summary p { .profile-summary p {
margin: 12px 0 0; margin: 12px 0 0;
color: var(--subtext); color: var(--subtext);
font-size: 0.95rem;
line-height: 1.65; line-height: 1.65;
} }
+5 -2
View File
@@ -73,7 +73,9 @@
<main class="container"> <main class="container">
{% if profile %} {% if profile %}
<section class="link-item profile-summary"> <details class="link-item profile-summary">
<summary>Profile</summary>
<div class="profile-summary-content">
<div class="link-header"> <div class="link-header">
<div class="avatar"> <div class="avatar">
{% if profile.avatar_url %} {% if profile.avatar_url %}
@@ -85,7 +87,8 @@
<div class="user-name">{{ profile.username }}</div> <div class="user-name">{{ profile.username }}</div>
</div> </div>
<p>{{ profile.bio or 'No profile information provided.' }}</p> <p>{{ profile.bio or 'No profile information provided.' }}</p>
</section> </div>
</details>
{% endif %} {% endif %}
<section id="feed" class="feed" aria-live="polite"></section> <section id="feed" class="feed" aria-live="polite"></section>
<nav id="pagination" class="pagination" aria-label="Feed pages"></nav> <nav id="pagination" class="pagination" aria-label="Feed pages"></nav>