Changeset d49b60b in Klonkt for CHANGELOG.nl.md

Timestamp:

07/19/2026 02:52:55 AM (7 weeks ago)

Author:

Robin <roboburr@…>

Branches:

main

Children:

dd568e7

Parents:

c867b7b

git-author:

Robin <roboburr@…> (07/19/2026 02:52:09 AM)

git-committer:

Robin <roboburr@…> (07/19/2026 02:52:55 AM)

Message:

Feature: OAuth 2.0 for ActivityPub C2S (phase 1 — auth handshake)

First half of AP Client-to-Server: the auth layer native/web clients (Shaer)
need before they can drive a Klonkt account. The AP spec's own C2S half is what
keeps this inside-spec instead of cloning Mastodon's REST API.

• OAuthService: public-client OAuth (RFC 8252), PKCE S256 REQUIRED, no secrets. Dynamic registration (RFC 7591 subset) with strict redirect_uri validation (https / loopback http / reverse-DNS custom scheme). Single-use 10-min codes; tokens stored sha256-hashed; a token is scoped to one user + one site.
• routes/oauth.js: /oauth/register, /oauth/authorize (session-authed consent screen picking the site), /oauth/token, and RFC 8414 server metadata at /.well-known/oauth-authorization-server. Redirect params are appended to the registered URI verbatim (no new URL() round-trip that would mangle a native custom scheme). Pre-redirect validation errors never bounce to an unvalidated URI (open-redirect guard).
• Actor doc advertises oauthAuthorizationEndpoint/oauthTokenEndpoint/uploadMedia in endpoints{} — all AP-spec terms, added to the AS2 conformance allowlist — so clients discover paths instead of hardcoding them (Klonkt's /ap/users/:slug differs from the daemon's /actors/:name; discovery makes that irrelevant).
• oauth_clients/oauth_codes/oauth_tokens tables (additive).
• i18n NL/EN/DE for the consent screen.

7 new OAuth tests (PKCE round-trip, replay protection, wrong-verifier reject,
bearer resolution incl. revoke, redirect-uri validation); 73 green. Verified
the full HTTP flow end to end (register → consent → code → token → bearer) and
that the raw Location header preserves the native redirect URI exactly. Beads:
klonkt-demo-srr. Next: klonkt-demo-1w4 (POST outbox accepts the activities).

Co-Authored-By: Claude Opus 4.8 <noreply@…>

File:

• CHANGELOG.nl.md (modified) (1 diff)

CHANGELOG.nl.md

@@ -5 +5 @@
 
 ## [Unreleased]
+
+### Toegevoegd
+- **App-toegang via OAuth 2.0 (ActivityPub Client-to-Server, fase 1).** Klonkt
+  spreekt nu de standaard AP C2S-authenticatie, zodat native en web-apps (de
+  Shaer-apps als eerste) kunnen verbinden: dynamische client-registratie
+  (RFC 7591), een PKCE authorization-code-flow met een toestemmingsscherm waarop
+  je kiest namens welke site de app mag posten, en bearer-tokens (gehasht
+  opgeslagen, eenmalige codes). De actor-doc adverteert de OAuth- en
+  uploadMedia-endpoints en `/.well-known/oauth-authorization-server` (RFC 8414)
+  geeft de metadata, dus apps ontdekken alles in plaats van paden vast te
+  spijkeren. Alleen publieke clients + PKCE, geen client-secrets. De outbox die
+  de tokens accepteert (POST) is de volgende fase.
 
 ### Opgelost