Changeset b1d5f3f in Klonkt

Timestamp:

10/24/2026 11:48:41 AM (23 hours ago)

Author:

Bart <bart@…>

Branches:

main

Children:

5d0d3f35

Parents:

61d52ed

Message:

Identiteitsbewijzen (FEP-c390): een sleutel van elders zegt dat dit account van hem is

Een Ed25519-sleutel die niet op deze server staat -- in Shaer op papier, alleen
ingetypt als hij nodig is -- ondertekent een VerifiableIdentityStatement:
"did:key:... is ook deze actor". Klonkt ondertekent niets. Hij controleert de
verklaring en zet hem onder attachment op de actor, waar iedereen hem zelf
kan nalopen.

Wat dat bewijst: dat dezelfde entiteit achter sleutel en account zit. Verhuist
het account, dan draagt het nieuwe dezelfde did:key, en dat bewijst de
continuiteit ook als de oude server weg of vijandig is -- een Move kan dat niet,
want die moet door de OUDE server getekend worden.

eddsa-jcs-2022, omdat Mitra en streams dat controleren. IdentityProof.js is
puur: JCS (RFC 8785, in JavaScript precies een gesorteerde JSON.stringify),
base58btc, did:key en de proof zelf. De controle volgt c390 regel voor regel,
met een eigen reden per weigering; verificationMethod moet PRECIES de subject
zijn, zonder het #-fragment dat de W3C-voorbeelden gebruiken.

Getoetst tegen de W3C-testvectoren (vc-di-eddsa B.3): dezelfde did:key, dezelfde
canonieke vorm, dezelfde hashes en byte voor byte dezelfde handtekening. Een
implementatie die het alleen met zichzelf eens is, bewijst niets.

POST /ap/users/:slug/identityProofs (alleen de eigenaar) controleert en
publiceert, één per did:key, hoogstens drie; DELETE ?subject= haalt hem weg.
Beide sturen een Update van de actor naar de volgers. De actor noemt het
eindpunt als endpoints.shaer:identityProofs. Elke verklaring draagt haar eigen
@context, zodat de actor er geen bij hoeft -- did/v1 en data-integrity/v1 hebben
beschermde termen die op actorniveau met onze inline context konden botsen.

shaer-jpxj
Co-Authored-By: Claude Opus 5.5 <claude@…>

Files:

• src/config/database.js (modified) (1 diff)
• src/routes/activitypub.js (modified) (2 diffs)
• src/services/ActivityPubService.js (modified) (2 diffs)
• src/services/IdentityProof.js (added)
• test/activitypub-as2.test.js (modified) (1 diff)
• test/identity-proofs.test.js (added)

src/config/database.js

@@ -245 +245 @@
   // kort bericht een halve pagina leegte gaf; nu is het een keuze.
   ensureColumn('sites', 'reader_full_page', 'INTEGER DEFAULT 0');
+  // Identiteitsbewijzen (FEP-c390, shaer-jpxj): de ondertekende verklaringen,
+  // als JSON-lijst, precies zoals ze binnenkwamen -- een handtekening hangt aan
+  // elke byte van de canonieke vorm, dus herschrijven zou hem breken.
+  ensureColumn('sites', 'identity_proofs', 'TEXT');
   ensureColumn('sites', 'show_search',     'INTEGER DEFAULT 1');
   ensureColumn('sites', 'show_archive_link', 'INTEGER DEFAULT 1');

src/routes/activitypub.js

@@ -21 +21 @@
 import * as Guardianship from '../services/guardianship/index.js';
 import * as ConversationKey from '../services/conversation-key.js';
+import * as IdentityProof from '../services/IdentityProof.js';
 import * as Migration from '../services/MigrationService.js';
 import { getPrimarySite } from '../middleware/site.js';
@@ -1029 +1030 @@
   },
 });
+// ── Identiteitsbewijzen (FEP-c390, shaer-jpxj) ────────────────────
+//
+// De eigenaar biedt een verklaring aan die met een sleutel van ELDERS is
+// ondertekend: "did:key:... is ook deze actor". Deze server ondertekent niets;
+// hij controleert (IdentityProof.checkStatement) en publiceert onder
+// `attachment` op de actor, waar iedereen hem zelf kan nalopen.
+//
+// Eén per did:key: een nieuwe verklaring met dezelfde sleutel vervangt de
+// vorige, want een verhuizing of een vernieuwde datum is dezelfde bewering.
+// Een handvol is genoeg; meer is geen identiteit meer maar een verzameling.
+const MAX_IDENTITY_PROOFS = 3;
+function readProofs(site) {
+  try { const a = JSON.parse(site.identity_proofs || '[]'); return Array.isArray(a) ? a : []; } catch { return []; }
+}
+function writeProofs(site, list) {
+  db.prepare('UPDATE sites SET identity_proofs = ? WHERE id = ?').run(list.length ? JSON.stringify(list) : null, site.id);
+  // De volgers horen dat de actor veranderde; anders blijft hun kopie de oude.
+  const vers = db.prepare('SELECT * FROM sites WHERE id = ?').get(site.id);
+  if (vers) AP.deliverActorUpdate(vers).catch((e) => console.warn('[c390] actor-update:', e && e.message));
+}
+router.post('/ap/users/:slug/identityProofs', express.json({ limit: '16kb', type: ['application/json', 'application/activity+json', 'application/ld+json'] }), (req, res) => {
+  const auth = OAuth.verifyBearer(req.headers.authorization);
+  if (!auth || auth.site.slug !== req.params.slug) return res.status(403).end();
+  const base = baseUrl(req);
+  const me = AP.actorId(base, auth.site.slug);
+  const stmt = req.body;
+  const uitslag = IdentityProof.checkStatement(stmt, me);
+  if (!uitslag.ok) return res.status(422).json({ error: uitslag.error });
+  const site = db.prepare('SELECT * FROM sites WHERE id = ?').get(auth.site.id);
+  const rest = readProofs(site).filter((b) => b && b.subject !== uitslag.subject);
+  if (rest.length >= MAX_IDENTITY_PROOFS) return res.status(409).json({ error: 'too_many_identity_proofs', max: MAX_IDENTITY_PROOFS });
+  writeProofs(site, [...rest, stmt]);
+  res.status(201).json({ subject: uitslag.subject, alsoKnownAs: me });
+});
+router.delete('/ap/users/:slug/identityProofs', (req, res) => {
+  const auth = OAuth.verifyBearer(req.headers.authorization);
+  if (!auth || auth.site.slug !== req.params.slug) return res.status(403).end();
+  const subject = String(req.query.subject || '');
+  if (!IdentityProof.publicKeyFromDidKey(subject)) return res.status(400).json({ error: 'subject must be an Ed25519 did:key' });
+  const site = db.prepare('SELECT * FROM sites WHERE id = ?').get(auth.site.id);
+  const voor = readProofs(site);
+  const na = voor.filter((b) => b && b.subject !== subject);
+  if (na.length === voor.length) return res.status(404).json({ error: 'no_such_identity_proof' });
+  writeProofs(site, na);
+  res.status(204).end();
+});
+
 router.post('/ap/users/:slug/uploadMedia', (req, res) => {
   const auth = OAuth.verifyBearer(req.headers.authorization);

src/services/ActivityPubService.js

@@ -393 +393 @@
       oauthTokenEndpoint: `${base}/oauth/token`,
       uploadMedia: `${id}/uploadMedia`,
+      // FEP-c390 (shaer-jpxj): waar de eigenaar een identiteitsbewijs aanbiedt.
+      // Alleen met zijn token; Shaer vindt het hier in plaats van het te raden.
+      'shaer:identityProofs': `${id}/identityProofs`,
     },
     publicKey: {
@@ -449 +452 @@
     }
   } catch { /* skip malformed profile_links */ }
+  // FEP-c390: de identiteitsbewijzen, ACHTER de profiellinks. Ongewijzigd uit de
+  // database: ze werden bij binnenkomst gecontroleerd, en een handtekening hangt
+  // aan elke byte. Elke verklaring draagt haar eigen @context, dus de actor zelf
+  // hoeft er geen bij.
+  try {
+    const bewijzen = JSON.parse(site.identity_proofs || '[]');
+    if (Array.isArray(bewijzen) && bewijzen.length) {
+      actor.attachment = [...(actor.attachment || []), ...bewijzen.filter((b) => b && b.type === 'VerifiableIdentityStatement')];
+    }
+  } catch { /* skip malformed identity_proofs */ }
   return actor;
 }

test/activitypub-as2.test.js

@@ -58 +58 @@
   // ActivityPub §4.1 `endpoints` vocabulary (same category as sharedInbox), used for C2S.
   'oauthAuthorizationEndpoint', 'oauthTokenEndpoint', 'uploadMedia',
+  // FEP-c390 (shaer-jpxj): waar de eigenaar een identiteitsbewijs aanbiedt. De
+  // verklaringen zelf staan onder `attachment` en dragen hun eigen @context
+  // (did/v1, data-integrity/v1, fep/c390), dus hun termen horen niet hier.
+  'shaer:identityProofs',
   'publicKey', 'owner', 'publicKeyPem',
   'Note', 'Person', 'Create', 'Update', 'Delete', 'Tombstone', 'Announce', 'Like', 'Follow',