source: Klonkt/src/views/pages/admin-migrate.ejs@ fbfd7a1

main
Last change on this file since fbfd7a1 was fbfd7a1, checked in by Robin <roboburr@…>, 4 weeks ago

Je berichten verhuizen mee: FEP-1580 plus een webinterface ervoor

FEP-7628 verhuist je volgers en zegt zelf dat de inhoud een ander probleem is.
Dat probleem stond open: na een Move bleven je berichten op de oude instantie
staan, en elke reactie van een derde wees naar een URI die verdwijnt zodra dat
domein opgezegd wordt. FEP-1580 regelt dat, status DRAFT.

DE AUTORISATIE IS DE MOVE, NIET EEN CODE. De bronkant behandelt een ondertekend
verzoek namens de doel-actor alsof de bron-actor het zelf deed. Dat mag omdat
moveAccount() no_backreference weigert: moved_to staat er alleen als de
doel-actor ons al in alsoKnownAs had. Beide kanten hebben ooit ja gezegd, dus er
is geen tweede vertrouwensmechanisme nodig. Een typefout komt hier niet binnen,
want die haalt de move zelf niet. Dat dit veilig is leunt op de keyId-binding
uit shaer-xd8i: zonder die controle is "wie tekende dit" te zacht om je hele
geschiedenis aan af te geven.

NIEUWE IDS ZIJN GEEN BUG, DE VERTAALTABEL IS HET ANTWOORD. Een verhuisd bericht
krijgt een eigen URI, want het staat op een ander domein. De migration-collectie
mapt oud naar nieuw en derden lezen die om hun eigen verwijzingen bij te werken.
Zonder die collectie is de draad kapot, met die collectie is het een
verhuisbericht. Niet-publieke items staan er alleen in voor wie ze mocht zien:
een lijst met de URIs van je fan-only posts is een lek, ook zonder de inhoud.

Er gaat geen Create de deur uit. Je volgers hebben die berichten jaren geleden
al gezien; driehonderd posts die als nieuw de tijdlijn in klateren is geen
verhuizing maar spam.

Daarnaast /admin/migrate: exporteren, importeren en ophalen via de
webinterface, zodat verhuizen geen SSH-toegang meer vraagt. Importeren gaat
altijd eerst droog, met een verslag en pas daarna een knop die het echt doet.

Getest op twee draaiende instanties, A verhuisd naar B via de echte
moveAccount. Anoniem zag A 3 van de 4 berichten; ondertekend als de doel-actor
kwamen alle 4 mee, inclusief de fan-only. Titel, webadres en publicatiedatum
blijven staan. Media komt echt over: gedownload, in de mediatabel, B serveert
het. Migration-collectie 4 rijen totaal, 3 publiek.

Changed files:
src/services/ActivityPubService.js

  • isMoveTarget: het hele autorisatiepredicaat van de bronkant
  • outboxAudience en mayReadNote: de doel-actor krijgt onze eigen kijkrechten
  • buildActor adverteert migration en moves, ook leeg (de FEP wijst er apart op dat "niets verhuisd" anders niet te onderscheiden is van "kent dit niet")
  • signedGetJson geexporteerd, de ingest heeft hem nodig
  • isMoveTarget en signedGetJson in de default export (movedLock verstopte zich een dag eerder precies zo)

src/services/ap-core.js

  • FEP-1580-termen in de JSON-LD-context

src/services/ArchiveImportService.js

  • een import uit een zip vult dezelfde vertaaltabel; de spec wil dat een geexporteerde collectie identiek behandeld wordt

src/routes/activitypub.js

  • /ap/users/:slug/migration en /moves
  • de blocked-collectie gaat open voor de doel-actor, want zichtbaarheidsvoorkeuren moeten meeverhuizen

src/config/database.js

  • ap_migration en ap_moves, plus sites.migration_complete

src/server.js

  • /admin/migrate aangesloten

src/views/pages/admin.ejs

  • knop naar Migreren

src/services/i18n.js

  • mig.* in nl/en/de

New file:
src/services/MigrationService.js

  • de doelkant: ingest-routine, migration- en moves-collectie, statusvlag

src/routes/admin-migrate.js

  • exporteren, droog importeren, echt importeren, ophalen bij de oude Klonkt

src/views/pages/admin-migrate.ejs

  • de pagina

test/fep1580-migration.test.js

  • 22 tests over beide rollen, plus de regressietest bij 4101c89

remarks: FEP-8b32 ontbreekt volledig (shaer-j1v0), dus er staat geen
handtekening onder de moves-collectie en we zijn niet naleveringsklaar. Bewust
geen leeg proof-veld: een derde die het controleert wordt dan misleid. De DERDE
rol zit er ook niet in, Klonkt leest nog geen migration-collecties van anderen,
dus andermans verhuizing repareert onze verwijzingen nog niet. Alle betrokken
FEPs zijn DRAFT, ook 7628 die we al volgden; 1580 is vers en de auteur schrijft
zelf dat het een audit verdient.

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

  • Property mode set to 100644
File size: 9.4 KB
Line 
1<div class="container mig-wrap">
2 <h1><%= t('mig.title') %></h1>
3 <p class="mig-lead"><%= t('mig.lead') %></p>
4
5 <% if (typeof success !== 'undefined' && success) { %><div class="alert alert-success"><%= success %></div><% } %>
6 <% if (typeof error !== 'undefined' && error) { %><div class="alert alert-error"><%= error %></div><% } %>
7
8 <%# ── Exporteren ─────────────────────────────────────────────── %>
9 <section class="mig-card">
10 <h2><%= t('mig.export_title') %></h2>
11 <p class="form-hint"><%= t('mig.export_hint') %></p>
12
13 <% if (telling) { %>
14 <ul class="mig-counts">
15 <li><strong><%= telling.posts %></strong> <%= t('mig.c_posts') %></li>
16 <li><strong><%= telling.replies %></strong> <%= t('mig.c_replies') %></li>
17 <li><strong><%= telling.media %></strong> <%= t('mig.c_media') %></li>
18 <% if (typeof telling.following === 'number') { %>
19 <li><strong><%= telling.following %></strong> <%= t('mig.c_following') %></li>
20 <% } %>
21 <li><strong><%= mb(telling.bytes) %></strong> <%= t('mig.c_size') %></li>
22 </ul>
23
24 <% if (telling.ontbrekend) { %>
25 <%# Niets stils: media die op schijf ontbreekt wordt geteld en gemeld, want
26 een archief dat stilzwijgend minder bevat is erger dan een waarschuwing. %>
27 <p class="alert alert-error"><%= t('mig.missing', { n: telling.ontbrekend }) %></p>
28 <% } %>
29
30 <% if (telling.groot) { %>
31 <p class="alert alert-error"><%= t('mig.too_big') %></p>
32 <% } else { %>
33 <p><a class="btn btn-primary" href="/admin/migrate/export"><%= t('mig.export_btn') %></a></p>
34 <% } %>
35 <% } else { %>
36 <p class="form-hint"><%= t('mig.export_none') %></p>
37 <% } %>
38 </section>
39
40 <%# ── Rechtstreeks ophalen (FEP-1580) ────────────────────────── %>
41 <section class="mig-card">
42 <h2><%= t('mig.pull_title') %></h2>
43 <p class="form-hint"><%= t('mig.pull_hint') %></p>
44
45 <% if (haalVerslag) { %>
46 <div class="mig-report<%= haalVerslag.error ? '' : ' is-done' %>">
47 <% if (haalVerslag.error) { %>
48 <h3><%= t('mig.pull_failed') %></h3>
49 <%# Elke weigering krijgt een eigen zin. "Er ging iets mis" laat je
50 raden welke van de twee kanten van de afspraak ontbreekt, en dat
51 is precies wat je moet weten om het op te lossen. %>
52 <p><%= t('mig.e_' + haalVerslag.error) !== 'mig.e_' + haalVerslag.error
53 ? t('mig.e_' + haalVerslag.error) : (haalVerslag.melding || haalVerslag.error) %></p>
54 <% if (haalVerslag.error === 'not_moved_here' && haalVerslag.movedTo) { %>
55 <p class="form-hint"><%= t('mig.e_points_at') %> <code><%= haalVerslag.movedTo %></code></p>
56 <% } %>
57 <% } else { %>
58 <h3><%= t('mig.pull_done') %></h3>
59 <ul class="mig-counts">
60 <li><strong><%= haalVerslag.posts %></strong> <%= t('mig.r_imported') %></li>
61 <% if (haalVerslag.overgeslagen) { %><li><strong><%= haalVerslag.overgeslagen %></strong> <%= t('mig.r_skipped') %></li><% } %>
62 <% if (haalVerslag.media) { %><li><strong><%= haalVerslag.media %></strong> <%= t('mig.r_media') %></li><% } %>
63 <% if (haalVerslag.blocks) { %><li><strong><%= haalVerslag.blocks %></strong> <%= t('mig.r_blocks') %></li><% } %>
64 </ul>
65 <% } %>
66 <% if (haalVerslag.waarschuwingen && haalVerslag.waarschuwingen.length) { %>
67 <ul class="mig-warnlist">
68 <% haalVerslag.waarschuwingen.slice(0, 6).forEach(function (w) { %><li><%= w %></li><% }); %>
69 </ul>
70 <% } %>
71 </div>
72 <% } %>
73
74 <form method="post" action="/admin/migrate/pull">
75 <label for="mig-bron"><%= t('mig.pull_source') %></label>
76 <input type="url" id="mig-bron" name="bron" value="<%= bron || '' %>"
77 placeholder="https://oude-klonkt.nl/ap/users/jij" class="mig-input">
78 <p class="form-hint"><%= t('mig.pull_source_hint') %></p>
79 <button type="submit" class="btn"><%= t('mig.pull_btn') %></button>
80 </form>
81
82 <% if (mig && (mig.total || mig.moves)) { %>
83 <p class="form-hint mig-state">
84 <%= t('mig.state', { n: mig.total }) %>
85 <%= mig.complete ? t('mig.state_done') : t('mig.state_busy') %>
86 </p>
87 <% } %>
88 </section>
89
90 <%# ── Importeren ─────────────────────────────────────────────── %>
91 <section class="mig-card">
92 <h2><%= t('mig.import_title') %></h2>
93 <p class="form-hint"><%= t('mig.import_hint') %></p>
94
95 <% if (verslag) { %>
96 <div class="mig-report<%= verslag.echt ? ' is-done' : '' %>">
97 <h3><%= verslag.echt ? t('mig.r_done') : t('mig.r_dry') %></h3>
98 <p class="form-hint"><%= verslag.bestand %> &middot; <%= mb(verslag.bytes) %></p>
99 <ul class="mig-counts">
100 <li><strong><%= verslag.posts %></strong> <%= verslag.echt ? t('mig.r_imported') : t('mig.r_would') %></li>
101 <li><strong><%= verslag.overgeslagen %></strong> <%= t('mig.r_skipped') %></li>
102 <% if (verslag.overschreven) { %><li><strong><%= verslag.overschreven %></strong> <%= t('mig.r_overwritten') %></li><% } %>
103 <% if (verslag.mediaMissing) { %><li><strong><%= verslag.mediaMissing %></strong> <%= t('mig.r_media_missing') %></li><% } %>
104 <% if (verslag.media) { %><li><strong><%= verslag.media %></strong> <%= t('mig.r_media') %></li><% } %>
105 </ul>
106 <% if (verslag.waarschuwingen && verslag.waarschuwingen.length) { %>
107 <ul class="mig-warnlist">
108 <% verslag.waarschuwingen.slice(0, 6).forEach(function (w) { %><li><%= w %></li><% }); %>
109 </ul>
110 <% } %>
111 <% if (verslag.idsBehouden === false) { %>
112 <%# Dit is de belangrijkste regel van het hele verslag: komt het archief
113 van een ANDER adres, dan krijgen de posts nieuwe id's en zijn het
114 nieuwe objecten voor de fediverse. %>
115 <p class="alert alert-error"><%= t('mig.r_new_ids') %></p>
116 <% } %>
117
118 <% if (!verslag.echt && verslag.posts > 0) { %>
119 <form method="post" action="/admin/migrate/import" enctype="multipart/form-data" class="mig-confirm">
120 <p class="form-hint"><%= t('mig.r_confirm_hint') %></p>
121 <label for="mig-file2"><%= t('mig.file_label') %></label>
122 <input type="file" id="mig-file2" name="archief" accept=".zip,application/zip" required>
123 <input type="hidden" name="echt" value="1">
124 <% if (verslag.overschrijf) { %><input type="hidden" name="overschrijf" value="1"><% } %>
125 <button type="submit" class="btn btn-primary"><%= t('mig.r_confirm_btn') %></button>
126 </form>
127 <% } %>
128 </div>
129 <% } %>
130
131 <form method="post" action="/admin/migrate/import" enctype="multipart/form-data">
132 <label for="mig-file"><%= t('mig.file_label') %></label>
133 <input type="file" id="mig-file" name="archief" accept=".zip,application/zip" required>
134
135 <label class="mig-check">
136 <input type="checkbox" name="overschrijf" value="1">
137 <%= t('mig.overwrite_label') %>
138 </label>
139 <p class="form-hint mig-warn"><%= t('mig.overwrite_hint') %></p>
140
141 <button type="submit" class="btn"><%= t('mig.check_btn') %></button>
142 <p class="form-hint"><%= t('mig.check_hint') %></p>
143 </form>
144 </section>
145
146 <%# ── Wie je volgt ────────────────────────────────────────────── %>
147 <section class="mig-card">
148 <h2><%= t('mig.follows_title') %></h2>
149 <p class="form-hint"><%= t('mig.follows_hint') %></p>
150 <p><a class="btn" href="/connect"><%= t('mig.follows_btn') %></a></p>
151 </section>
152</div>
153
154<style>
155 .mig-wrap { max-width: 46rem; }
156 .mig-lead { color: var(--sub); margin-bottom: 1.5rem; }
157 .mig-card { border: 1px solid var(--rule); border-radius: 12px; padding: 1.25rem 1.4rem; margin-bottom: 1.25rem; }
158 .mig-card h2 { margin: 0 0 .35rem; font-size: 1.1rem; }
159 .mig-counts { list-style: none; padding: 0; margin: .9rem 0; display: flex; flex-wrap: wrap; gap: .4rem 1.4rem; }
160 .mig-counts li { color: var(--sub); font-size: .94rem; }
161 .mig-counts strong { color: var(--ink); font-size: 1.05rem; }
162 .mig-card label { display: block; margin: .9rem 0 .35rem; font-weight: 600; font-size: .92rem; }
163 .mig-card input[type="file"] { display: block; margin-bottom: .6rem; }
164 .mig-check { display: flex; align-items: center; gap: .5rem; font-weight: 400 !important; }
165 .mig-input { width: 100%; max-width: 34rem; padding: .5rem .6rem; border: 1px solid var(--rule);
166 border-radius: 8px; background: transparent; color: var(--ink); font-size: .95rem; }
167 .mig-state { margin-top: .9rem; }
168 .mig-report code { word-break: break-all; font-size: .88rem; }
169 .mig-warn { color: var(--accent); }
170 .mig-report { border-left: 3px solid var(--accent); padding: .8rem 1rem; margin-bottom: 1.2rem;
171 background: color-mix(in srgb, var(--ink, #000) 4%, transparent); border-radius: 0 8px 8px 0; }
172 .mig-report.is-done { border-left-color: #3fa843; }
173 .mig-report h3 { margin: 0 0 .3rem; font-size: 1rem; }
174 .mig-warnlist { margin: .5rem 0; padding-left: 1.2rem; color: var(--accent); font-size: .9rem; }
175 .mig-confirm { margin-top: .9rem; padding-top: .9rem; border-top: 1px solid var(--rule); }
176</style>
Note: See TracBrowser for help on using the repository browser.