Diese Seite ist eine maschinelle Übersetzung der englischen Seite, die maßgeblich ist. Englische Seite lesen
Decision Hooks
Ein Decision Hook fragt ein Plugin von dir, ob etwas angenommen werden soll, bevor der Server es annimmt. Das Plugin antwortet mit einem Verdikt aus einer festen Liste. Es schreibt nie etwas um und unternimmt nichts gegen ein Konto: Es kann höchstens einen Beitrag, ein Folgen, eine Registrierung, einen Upload oder eine Profiländerung stoppen oder eine Meldung für deine Moderatoren erstellen. Menschen entscheiden, was mit einem Konto geschieht.
Standardmäßig wird nichts geprüft. Ein Server ohne Hook-Adresse ruft nichts auf und verbraucht dafür keine Zeit. Diese Version enthält
die hier beschriebenen Datensätze, Modi und Admin-Bildschirme. Von den Eingangswegen fragen Beiträge von anderen Servern
inbound.status, Folgen von anderen Servern inbound.follow, Registrierungen signup.check, Uploads
media.check, Beiträge lokaler Konten local.status, Profile von Konten auf anderen Servern inbound.actor und
Profiländerungen lokaler Konten local.profile; die anderen Hooks werden noch nicht aufgerufen.
Vom oberen Rand des Diagramms nach unten:
- Was geprüft wird und wer wartet. Ein Beitrag von einem anderen Server (
inbound.status), ein Folgen von einem anderen Server (inbound.follow) und ein Upload (media.check) werden in einem Job geprüft. Eine Registrierung (signup.check) wird geprüft, während die antragstellende Person wartet, ein Beitrag eines lokalen Kontos (local.status), während sein Autor wartet, und eine Änderung des Profils eines lokalen Kontos (local.profile), während sein Inhaber wartet. Ein Profil von einem anderen Server (inbound.actor) wird dort geprüft, wo der Server das Konto abruft: in einem Job und auch, während eine Anfrage wartet, etwa die eines Servers, dessen Konto hier neu ist. - Der Modus,
hook_<hook>_mode:offruft nichts auf,observeverzeichnet das Verdikt und handelt nicht danach, undenforcehandelt danach (Modi). - Dein Plugin erhält
POST /my.plugin.hook.v1.HookService/Check. Der Server wartet bis zuplugin_<hook>_timeout, führt höchstens 8 Aufrufe gleichzeitig aus und überspringt das Plugin nach 5 Fehlschlägen in Folge für 30 Sekunden (breaker_open). - Ein Verdikt:
allownimmt den Gegenstand an,flagnimmt ihn an und erstellt eine Meldung,mark_sensitivenimmt ihn als sensibel markiert an,require_approvalhält eine Registrierung zurück, unddropundrejectstoppen ihn und behalten nichts (dasrejecteiner Registrierung nur mithook_signup_check_reject). Ein Fehlschlag ist eintimeout, einerror, eineinvalide Antwort oderbreaker_open, und eine Antwort, die der Hook nicht annimmt, zählt als einer. Setzt der Hook durch, entscheidethook_<hook>_on_failure:passnimmt den Gegenstand ungeprüft an,retryverzeichnet keine Entscheidung und führt den Job erneut aus, undrequire_approvalhält eine Registrierung zurück (Wenn das Plugin fehlschlägt). - Eine Entscheidung pro Hook und Gegenstand wird verzeichnet, und ein Job, der erneut läuft, liest sie, statt das Plugin aufzurufen (Die Entscheidungen).
Die Hooks
Abschnitt betitelt „Die Hooks“| Hook | Was er prüft | Was er antworten kann | Wenn das Plugin fehlschlägt |
|---|---|---|---|
inbound.status |
Beiträge von anderen Servern | allow, drop, flag, mark_sensitive |
pass (Standard) oder retry |
inbound.follow |
Folgen von anderen Servern | allow, drop, flag |
pass (Standard) oder retry |
signup.check |
Registrierungen, nach dem CAPTCHA und der Sperrliste | allow, require_approval, reject |
pass (Standard) oder require_approval |
media.check |
Hochgeladene Medien, bevor jemand sie nutzen kann | allow, mark_sensitive, flag, reject |
pass (Standard) oder retry |
local.status |
Beiträge lokaler Konten und ihre Bearbeitungen | allow, flag, reject |
pass |
inbound.actor |
Profile von Konten auf anderen Servern, wenn sie sich ändern | allow, drop, flag |
pass (Standard) oder retry |
local.profile |
Profiländerungen lokaler Konten | allow, flag, reject |
pass |
Setze plugin_<hook>_address, um einem Hook ein Plugin zu geben, wobei ein Punkt im Namen zu _ wird
(plugin_inbound_status_address). Plugins behandelt das Ziel, seine Authentifizierung und wie du ein
Plugin mit my plugin test --kind inbound.status <address> testest. Der Aufruf ist POST /my.plugin.hook.v1.HookService/Check.
Was jede Antwort bewirkt:
dropstoppt den Gegenstand und speichert nichts davon. Beiinbound.actorbehält es das zuvor gespeicherte Profil (unten). Ein falschesdropverbirgt einen Beitrag stillschweigend auch vor seinen Followern, lies also inobserve, was ein Hook verwerfen würde, bevor du ihn durchsetzt.flaglässt ihn durch und erstellt eine Meldung pro Entscheidung. Beiinbound.followbetrifft die Meldung das Konto, das das Folgen gesendet hat, nennt keinen Beitrag und wird erstellt, sobald das Folgen verzeichnet ist; Melder, Kategorie und Kommentar sind die der Meldung zu einem Beitrag. Beiinbound.actorbetrifft die Meldung das Konto, dessen Profil es ist, auf dieselbe Weise.mark_sensitivelässt ihn durch und zeigt seine Anhänge als sensibel, bis ein Moderator die Entscheidung aufhebt.require_approvalhält die Registrierung zur Genehmigung zurück.rejectlehnt ihn ab, mit festem Text, der nichts von der Antwort des Plugins zeigt. Beisignup.checkgilt außerdem die Einstellung unten. Beimedia.checkbehält es nichts vom Upload, auch das Original nicht (unten). Beilocal.statuskann der Autor Einspruch einlegen. Beilocal.profilebleibt das Profil, wie es war, und es gibt keinen Einspruch (unten).
Eine Antwort kann einen kodierten Grund (spam, harassment, sexual, violence, illegal, malware, other) und eine Notiz von
bis zu 200 Zeichen für deine Moderatoren tragen. Eine Antwort, die der Hook nicht annimmt, zählt als Fehlschlag.
Was inbound.status prüft
Abschnitt betitelt „Was inbound.status prüft“Der Server fragt bei jedem Create eines Beitrags und jedem Update eines solchen, den er annehmen würde, bevor er etwas speichert. Jede
Revision ist ein eigener Gegenstand mit einer eigenen Entscheidung.
- Nach einem Beitrag wird nur gefragt, wenn er mit einem lokalen Konto zu tun hat: Ein lokales Konto folgt seinem Autor, er nennt ein lokales
Konto, oder er steht in einem Thread mit einem lokalen Beitrag. Ob ein lokales Konto dem Autor folgt, schränkt das nicht weiter ein:
Das Plugin erhält
any_local_followerund kann es abwägen. Nach einem Beitrag, den nur ein Relay hereingebracht hat, wird nie gefragt, ebenso wenig nach einemUpdateeines gespeicherten Beitrags, der nichts mehr mit einem lokalen Konto zu tun hat: Seine Revision wird ohne Frage gespeichert. - Ein Direktbeitrag eines Autors, dem kein lokales Konto folgt, wird nicht gesendet, es sei denn, du schaltest
hook_inbound_status_unfollowed_directein. Beiträge deiner lokalen Konten werden nie gesendet, bei keiner Einstellung. - Nach Umfragestimmen, Löschungen, Undos, Likes, Reaktionen und Boosts wird nie gefragt, sodass das Anhalten eines Plugins nicht verhindern kann, dass eine Löschung eintrifft. Ein Thread-Abruf oder der Abruf eines Boosts kann denselben Beitrag trotzdem auf anderem Weg hereinbringen.
Was jede Antwort mit einem Beitrag macht:
dropbei einemCreatespeichert nichts und erzeugt weder eine Benachrichtigung noch einen Timelines-Eintrag, und eine erneute Zustellung wird als Duplikat ignoriert.dropbei einemUpdateerzeugt keine Revision und behält die vorherige. Ein verworfener Beitrag wird nicht gespeichert, daher wird einUpdatedavon, das innerhalb des letzten Tages veröffentlicht wurde, als neuer Beitrag genommen: Das Plugin wird zu dieser Revision erneut gefragt, wie bei jeder anderen, und seine Antwort auf das frühereCreateüberträgt sich nicht.flagerstellt eine Meldung pro Entscheidung, mit deinem Server-Akteur als Melder, der Kategorie des Grundes (spamundmalwareals Spam,illegalals Legal,harassment,sexualundviolenceals Violation und alles andere als Other) und der Notiz des Plugins als Kommentar. Die Meldung gibt an, dass eine Prüfung sie erstellt hat. Sie wird nicht an den Server des Autors weitergeleitet, es sei denn, ein Moderator leitet sie weiter, und eine Weiterleitung sendet nie die Notiz: nur den Text, den der Moderator dann schreibt. Das Auflösen benachrichtigt niemanden. Jede Entscheidung erstellt ihre eigene Meldung, eine Spam-Welle kann also die Warteschlange füllen.mark_sensitivemarkiert den Beitrag, nicht die Revision: Die Markierung bleibt auf späteren Revisionen, was auch immer dazu geantwortet wird, bis ein Moderator die Entscheidung aufhebt. Sie zeigt Anhänge als sensibel und lässt den Text unberührt, ein Beitrag ohne Anhang sieht also nicht anders aus, und andere Server sehen sie nicht.
Was media.check prüft
Abschnitt betitelt „Was media.check prüft“Der Server fragt bei jeder Datei, die ein lokales Konto hochlädt, für jeden Zweck: einen Anhang, einen Avatar, ein Header-Bild oder ein eigenes Emoji. Er fragt einmal, wenn die Datei zum ersten Mal verarbeitet wird und bevor sie bereit ist, sodass niemand sie nutzen kann, während das Plugin entscheidet. Wird dieselbe Datei später für etwas anderes verwendet, liest das die bereits getroffene Entscheidung. Nach entfernten Medien wird nie gefragt.
Er sendet das kleinste Bild, das der Server aus der Datei erzeugt hat, ohne Metadaten, und nie das Original: bei einer Video- oder
Audiodatei das kleine Bild ihres Posters oder eingebetteten Covers oder kein Bild, wenn es keins gibt. Dazu gehören, wofür die Datei
gedacht ist, ob sie ein Bild, Video oder Audio ist, ihre Größe, wie lange sie abspielt und ob sie sich bewegt. Der Alternativtext und
alles zum Konto oder zu einem Beitrag werden nicht gesendet. Die Nachricht MediaSubject des HookService-Protokolls hat die Felder.
Was jede Antwort mit einem Upload macht:
rejectlässt die Verarbeitung fehlschlagen, wie bei einer Datei, die der Server nicht lesen kann: Die hochladende Person sieht, dass die Datei nicht verarbeitet werden konnte, und ein Beitrag kann sie nicht anhängen. Der Server behält nichts von einer abgelehnten Datei. Er löscht das Original, sobald die Verarbeitung endet, was auch immer die Antwort ist, und eine abgelehnte Datei erhält keine verarbeitete Version. Wenn du solche Dateien aufbewahren oder jemandem melden musst, muss dein Plugin das bei seiner Antwort tun: Der Server kann die Datei nicht herausgeben. Das Aufheben einesrejectändert nur seinen Datensatz.mark_sensitivemarkiert den Beitrag, der die Datei anhängt, in der Transaktion, die den Beitrag erstellt, oder in der Bearbeitung, die die Datei hinzufügt, und die Markierung bleibt, bis ein Moderator die Entscheidung aufhebt, wie beiinbound.status. Ein Avatar, ein Header oder ein Emoji hat keinen Beitrag, die Entscheidung wird also nur verzeichnet.flagerstellt eine Meldung pro Entscheidung, mit deinem Server-Akteur als Melder. Bei einem Anhang wird sie mit dem Beitrag erstellt, der die Datei anhängt, und verweist auf diesen Beitrag; eine Datei, die nie gepostet wird, erzeugt keine. Bei einem Avatar, einem Header oder einem Emoji wird sie erstellt, wenn die Datei verarbeitet wird, über das Konto, das sie hochgeladen hat.
Der Verarbeitungsjob wartet bis zu plugin_media_check_timeout auf das Plugin (standardmäßig 10 Sekunden). Das Hinzufügen eines eigenen
Emojis von einem anderen Server oder das Genehmigen einer Emoji-Anfrage verarbeitet das Bild, während der Moderator wartet, dieses Warten
geht also zu seinen Lasten.
Registrierungen
Abschnitt betitelt „Registrierungen“signup.check läuft bei Registrierungen über die Registrierungsseite und über einen Login-Anbieter, nach dem CAPTCHA und der
Sperrliste für Registrierungen, eine Anfrage, die eines von beiden ablehnt, erreicht das Plugin also nie. Eine Registrierung mit
Einladungscode ruft ihn nie auf. Er sendet die E-Mail-Adresse, die die antragstellende Person eingegeben hat, und die IP-Adresse des Clients; das Konto
existiert noch nicht, der Schlüssel des Gegenstands ist deshalb die ID, die das Konto bekäme, und wer es erneut versucht, ist ein neuer Gegenstand.
Die Antworten wirken wie die der Sperrliste, wenn der Hook durchsetzt:
require_approvallässt die Registrierung unter Moderation > Registrierungen warten, wie es eine Sperre mit demselben Schweregrad tut, in jedem Registrierungsmodus. Genehmige oder lehne sie dort ab: Das Aufheben der Entscheidung ändert die Registrierung nicht.rejectbewirkt nichts, bis duhook_signup_check_rejecteinschaltest (Servereinstellungen > Externe Prüfung, standardmäßig aus). Solange es aus ist, wird einrejectinobserveverzeichnet, da es nichts stoppt, und die Registrierung geht weiter. Ist es an, sieht die antragstellende Person denselben festen Text wie bei einer Sperre („Dieser Server kann diese Registrierung nicht annehmen.“). Es wird kein Konto geschrieben, das Aufheben einer solchen Entscheidung ändert also nur ihren Datensatz, und die Person registriert sich erneut.
Antragstellende sehen nie den Grund oder die Notiz einer Entscheidung.
Die Anfrage der antragstellenden Person wartet bis zu plugin_signup_check_timeout auf das Plugin (standardmäßig 2 Sekunden; halte es kurz, da
eine Person wartet). Das Warten ist nicht Teil einer Datenbanktransaktion. Eine Registrierung, die später scheitert, etwa wegen eines vergebenen
Nutzernamens, behält ihre Entscheidung, bis die Aufbewahrung sie entfernt.
Profile von anderen Servern
Abschnitt betitelt „Profile von anderen Servern“inbound.actor prüft das Profil eines Kontos auf einem anderen Server dort, wo der Server es aufnimmt: beim ersten Abruf
des Kontos, wenn das Konto ein Update seiner selbst sendet, und wenn der Server es erneut abruft, wie er es für die Konten,
denen deine Nutzer folgen, einmal am Tag tut. Er fragt nur, wenn das Profil sich vom gespeicherten unterscheidet, ein erneuter Abruf eines Kontos mit
demselben Profil löst also keinen Aufruf aus. Das Profil, das er prüft, besteht aus:
- dem Anzeigenamen als reinem Text,
- der Bio und den Profilfeldern, wie der Server sie speichert (bereinigtes HTML),
- den Adressen des Avatars und des Header-Bilds auf dem anderen Server. Der Server sendet kein Bild.
Das Plugin erhält außerdem die Adresse des Kontos, seinen Server, seinen Nutzernamen und ob das Konto für deinen Server neu ist. Der
Schlüssel einer Entscheidung ist die Adresse des Kontos, # und ein Digest des Profils, sodass jedes verschiedene Profil eine Entscheidung erhält und
dasselbe erneut gesendete Profil sie liest.
Was die Verdikte bewirken:
dropbehält das zuvor gespeicherte Profil: Der Anzeigename, die Bio, die Felder, der Avatar, der Header und ihre eigenen Emojis bleiben, wie sie waren. Der Server speichert weiterhin den Rest dessen, was er empfangen hat: die Schlüssel des Kontos, seine Inbox und andere Adressen, seinen Nutzernamen und ob es gesperrt (locked), ein Bot, auffindbar (discoverable) und indexierbar (indexable) ist. Ohne die Schlüssel und Adressen könnte der Server weder die Aktivitäten des Kontos prüfen noch an es zustellen, und die Einstellungen locked und indexable sagen, wie dem Konto zu folgen ist und ob sein Inhaber Indexierung erlaubt. Solange das Profil verworfen bleibt, liest ein erneuter Abruf dieselbe Entscheidung und behält das gespeicherte.- Ein Konto, das zum ersten Mal abgerufen wird, wird immer gespeichert, weil Folgen und Erwähnungen es brauchen, sein
dropwird daher alsflaggenommen: Das Profil wird gespeichert und eine Meldung erstellt. Die Entscheidung zeigt weiterhindrop. flagspeichert das Profil und erstellt eine Meldung zum Konto pro Entscheidung.
Wenn das Plugin fehlschlägt, speichert pass das Profil ungeprüft, und der Server fragt erst wieder danach, wenn es sich ändert.
Mit retry speichert der Server kein Konto, dessen Profil sich geändert hat, während das Plugin fehlschlägt: Ein Update wartet in seinem
Job, der die anderen Aktivitäten dieses Kontos zurückhält wie bei inbound.status, und ein Abruf,
der gemacht wird, während eine Anfrage wartet, schlägt fehl, sodass einem Server, dessen Konto hier neu ist, die Zustellung abgelehnt wird, bis das Plugin wieder da ist
und er sie erneut sendet.
Das Aufheben eines drop von inbound.actor ruft das Konto erneut von seinem Server ab, der das Profil speichert, das er jetzt ausliefert,
ohne das Plugin aufzurufen, wenn es das verworfene ist, und der danach fragt, wenn es sich seither geändert hat.
Lokale Beiträge
Abschnitt betitelt „Lokale Beiträge“local.status prüft einen Beitrag eines Kontos auf deinem Server, bevor der Server ihn erstellt, und jede Bearbeitung davon, bevor der
Server sie speichert. Der Autor wartet auf das Plugin, deshalb
ist das Warten kurz: plugin_local_status_timeout (standardmäßig 1 Sekunde). Ein Fehlschlag, ein Timeout oder ein offener Breaker lässt den
Beitrag immer durch (pass ist sein einziges Fehlschlagsverhalten), und das Warten ist nicht Teil einer Datenbanktransaktion.
Was er sendet und wann:
- Nur die Beiträge von Konten, die jünger sind als
hook_local_status_account_age_days(Servereinstellungen > Externe Prüfung, standardmäßig 7 Tage;0sendet die Beiträge jedes Kontos). Neue Konten sind die Quelle der meisten Spams, und etablierte Konten werden nicht gesendet. - Nur
public-,local- undunlisted-Beiträge.private- unddirect-Beiträge werden nie gesendet. - Der Text, wie der Autor ihn getippt hat und wie der Server ihn rendert, die Inhaltswarnung, die Sprache, ob er als sensibel markiert ist, die Bildbeschreibungen, die Umfrageoptionen, die Hashtags, wie viele Konten er erwähnt, die Adresse, die der Beitrag bekäme, der Beitrag, auf den er antwortet oder den er zitiert (nur als Adresse), die Adresse und der Nutzername des Autors und wann das Konto erstellt wurde. Es werden keine Medien gesendet.
- Der Schlüssel des Gegenstands ist die ID, die der Beitrag bekäme. Das erneute Senden eines Beitrags mit demselben
Idempotency-Keyliefert den Beitrag zurück, der erstellt wurde, ohne das Plugin aufzurufen; ein neuer Versuch ist ein neuer Gegenstand. - Eine Bearbeitung wird auf dieselbe Weise gesendet, mit dem Beitrag, wie er bearbeitet wurde, für dieselben Konten: die innerhalb von
hook_local_status_account_age_days. Ihr Schlüssel ist die ID des Beitrags,#und die ID der neuen Revision, sodass jede Bearbeitung ein eigener Gegenstand ist. - Das Starten eines Sprachchat-Raums erstellt seinen ersten Beitrag ohne diesen Hook.
Wenn er durchsetzt, lehnt reject den Beitrag ab, und nichts wird gespeichert. Der Autor sieht festen Text („Dieser Beitrag wurde nicht veröffentlicht.“)
und eine Möglichkeit zum Einspruch; nie den Grund oder die Notiz. flag lässt den Beitrag durch und erstellt eine Meldung dazu, gegen seinen
Autor.
Bei einer Bearbeitung lehnt reject nur diese Bearbeitung ab: Der Beitrag bleibt, wie er war, und der Autor sieht festen Text („Diese Bearbeitung wurde nicht
gespeichert.“). Gegen eine Bearbeitung kann kein Einspruch eingelegt werden, da der Beitrag noch da ist und deine Moderatoren wie gewohnt handeln können. flag speichert die
Bearbeitung und erstellt eine Meldung zum Beitrag, und allow lässt sie durch.
Einsprüche
Abschnitt betitelt „Einsprüche“Der Autor eines abgelehnten Beitrags kann innerhalb von appeal_window_days (dasselbe Fenster wie bei Moderationsaktionen) Einspruch einlegen, einmal pro
Entscheidung. Der Einspruch enthält den Text des Beitrags, da der Server nichts davon gespeichert hat, und einen optionalen Kommentar für deine
Moderatoren. Es wird kein Plugin aufgerufen.
Deine Moderatoren (manage_reports) werden über jeden neuen Einspruch benachrichtigt („Einsprüche gegen abgelehnte Beiträge“ in ihren Benachrichtigungs-
einstellungen, die sie auch per E-Mail erhalten können; die Benachrichtigung öffnet den Einspruch) und prüfen Einsprüche unter Moderation >
Automatische Prüfungen > Einsprüche gegen abgelehnte Beiträge. Jeder Einspruch öffnet sich auf einer eigenen Seite, mit dem Text, den der Autor gesendet hat:
- Maßnahme bestätigen (Uphold) lässt die Entscheidung bestehen und kommt als
hook_appeal_upheldins Audit-Log. - Maßnahme aufheben (Overturn) hebt die Entscheidung auf, was als
hook_decision_overriddenins Audit-Log kommt, und hört auf, die Beiträge des Kontos anlocal.statuszu senden, in einer Transaktion. Der abgelehnte Beitrag wird nicht wiederhergestellt: Der Autor postet ihn erneut.
So oder so wird der Autor über das Ergebnis benachrichtigt, unter den Benachrichtigungen der Moderatoren, und das Beitragsformular zeigt es unter
der Ablehnung. Die Benachrichtigung und das Formular sagen nur, ob die Entscheidung bleibt oder aufgehoben wurde, nie den Grund oder die
Notiz. Ein Erstanbieter-Client liest den Stand eines Einspruchs mit GET /api/v1/hook_decisions/{id}/appeal.
Ein Konto, das ein aufgehobener Einspruch aus dem Hook genommen hat, bleibt draußen, bis das Konto gelöscht wird. Wird es später
übernommen, prüft local.status es nicht mehr.
Lokale Profile
Abschnitt betitelt „Lokale Profile“local.profile prüft eine Änderung des Profils eines Kontos auf deinem Server, bevor der Server sie speichert. Der Inhaber wartet
auf das Plugin, deshalb ist das Warten kurz: plugin_local_profile_timeout (standardmäßig 1 Sekunde). Ein Fehlschlag, ein Timeout oder ein offener
Breaker lässt die Änderung immer durch (pass ist sein einziges Fehlschlagsverhalten), und das Warten ist nicht Teil einer Datenbank-
transaktion.
Was er sendet und wann:
- Nur die Änderungen von Konten, die jünger sind als
hook_local_profile_account_age_days(Servereinstellungen > Externe Prüfung, standardmäßig 7 Tage;0sendet die jedes Kontos). - Nur eine Änderung dessen, was der Hook sieht: der Anzeigename, die Bio, die Profilfelder, der Avatar oder der Header. Eine Änderung, die das Konto nur sperrt (locked) oder seine Auffindbarkeitseinstellungen ändert, wird nicht gesendet.
- Der Anzeigename, die Bio, wie getippt und wie der Server sie rendert, Name und Wert jedes Profilfelds (getippt und gerendert), ob die Änderung den Avatar oder den Header setzt, ersetzt oder entfernt, die Adresse und der Nutzername des Kontos und wann das Konto erstellt wurde. Es wird kein Bild gesendet. Das Profil ist öffentlich, der Hook darf also einfaches TCP verwenden.
- Der Schlüssel des Gegenstands ist die ID des Kontos,
#und die ID der Profilrevision, die die Änderung speichern würde, sodass jede Änderung ein eigener Gegenstand ist.
Wenn er durchsetzt, lehnt reject nur diese Änderung ab: Das Profil bleibt, wie es war, und der Inhaber sieht festen Text („Diese
Änderung deines Profils wurde nicht gespeichert.“), nie den Grund oder die Notiz. Es gibt keinen Einspruch: Der Inhaber kann das Profil ändern
und erneut speichern. flag speichert die Änderung und erstellt eine Meldung zum Konto, die keinen Beitrag nennt; Melder,
Kategorie und Kommentar sind die der Meldung zu einem Beitrag.
Jeder Hook hat einen Modus, eine Servereinstellung (hook_inbound_status_mode und so weiter), die du unter
Servereinstellungen > Externe Prüfung änderst, wo enforce erst angeboten wird, wenn der Modus nicht off ist. Änderungen kommen als setting_changed ins Audit-Log.
| Modus | Was er tut |
|---|---|
off |
Ruft nichts auf. |
observe |
Verzeichnet das Verdikt und handelt nicht danach. Das ist der Standard jedes Hooks. |
enforce |
Handelt nach dem Verdikt. |
Ein Hook geht von off nur über observe zu enforce.
Wenn das Plugin fehlschlägt
Abschnitt betitelt „Wenn das Plugin fehlschlägt“Ein Timeout, ein Fehler und eine ungültige Antwort werden als eigene Ergebnisse verzeichnet (timeout, error, invalid), nie als
Verdikte. Nach 5 fehlgeschlagenen Aufrufen in Folge überspringt der Server das Plugin für 30 Sekunden und versucht dann einen Aufruf, sodass ein Ausfall
jeden Gegenstand keine Wartezeit kostet; ein übersprungener Aufruf wird als breaker_open verzeichnet. Jeder Serverprozess zählt für sich.
Was dann mit dem Gegenstand geschieht, hängt von hook_<hook>_on_failure ab:
passlässt ihn ungeprüft durch. Spam kann bei einem Ausfall hereinkommen, aber sonst bleibt nichts stehen. Das ist der Standard.retrylässt den Job fehlschlagen, der erneut läuft und das Plugin erneut aufruft, und verzeichnet keine Entscheidung. Jobs eines Akteurs laufen der Reihe nach, alles Spätere von diesem Akteur wartet in der Zwischenzeit, auch Löschungen, bis zu etwa 4 Stunden und 15 Minuten. Nach seinem letzten Lauf wird der Job zu einem toten Job, was die anderen freigibt.require_approvalhält die Registrierung für einen Moderator zurück.
Bei media.check macht pass die Datei ungeprüft bereit. retry hält den Upload als noch in Verarbeitung, bis das Plugin
antwortet oder dem Job die Läufe ausgehen; die Datei ist in der Zwischenzeit nie bereit, und ein toter Job lässt sie unverarbeitet, was die
Bereinigung nicht angehängter Uploads dann löscht. Kein anderer Job wartet darauf.
Jeder Prozess macht höchstens 8 Aufrufe eines Plugins gleichzeitig, und ein Aufruf, der über die Frist des Hooks hinaus auf seinen Platz wartet, zählt als
Timeout. Wartezeiten zeigen sich in my.plugin.slot_wait (Betrieb). Halte plugin_inbound_status_timeout kurz: Während ein Aufruf
wartet, warten spätere Jobs desselben Akteurs mit.
In observe hält ein Fehlschlag nie etwas auf. Moderatoren erhalten einmal am Tag pro Hook eine Benachrichtigung, wenn seine Aufrufe weiter fehlschlagen.
Die Metriken sind my.hook.decisions, my.hook.failures und my.hook.duration (Betrieb).
Die Entscheidungen
Abschnitt betitelt „Die Entscheidungen“Der Server verzeichnet eine Entscheidung pro Hook und Gegenstand, sodass ein Job, der erneut läuft, sie liest und das Plugin nicht erneut aufruft. Eine Entscheidung enthält den Hook, den Schlüssel des Gegenstands, den Modus, das Ergebnis, den Grund, die Notiz und wie lange der Aufruf dauerte. Sie enthält keinen Beitragstext, keine E-Mail-Adresse und keine IP-Adresse.
Moderation > Automatische Prüfungen (manage_reports) zeigt die Zahlen und Wartezeiten der letzten 7 Tage und was die Hooks
gestoppt haben, in observe gestoppt hätten oder nicht prüfen konnten. Jede Entscheidung öffnet sich auf einer eigenen Seite mit Grund, Notiz und
Wartezeit. Das Aufheben einer Entscheidung, aus der Liste oder von ihrer Seite, kommt als hook_decision_overridden ins Audit-Log. Ein reject von local.status wird dort nicht aufgehoben: Sein Autor legt Einspruch ein.
Was das Aufheben bewirkt, hängt von der Antwort ab. Ein mark_sensitive verliert seine Markierung, und eine Markierung aus einer Moderationsaktion am selben
Beitrag bleibt. Ein flag behält seine Meldung, die du wie gewohnt auflöst. Ein drop von inbound.status verarbeitet den empfangenen Beitrag
erneut, ohne das Plugin zu fragen, solange der Server die empfangene Aktivität behält (7 Tage); danach
sagt der Bildschirm das, und das Aufheben verzeichnet nur die Aufhebung.
Das Aufheben eines drop von inbound.follow führt das Folgen erneut aus, ohne das Plugin aufzurufen, solange der Server
die empfangene Aktivität behält (7 Tage). Danach kann das Folgen nicht zurückkommen, und die Aufhebung wird nur verzeichnet; der
andere Server muss ein neues Folgen senden.
Ein Folgen fragt den Hook nur, wenn es als neues Folgen oder neue Folgeanfrage verzeichnet würde. Das Zurücknehmen eines Folgens (Undo) fragt nie,
und ebenso wenig ein Folgen, das der Server ohnehin ablehnt: eines, das der Föderationsmodus ablehnt, eines von einem umgezogenen oder
deaktivierten Konto, eines des Server-Akteurs oder eines zwischen Konten, die einander blockieren und wie gewohnt ihre Ablehnung erhalten. Ein erneut gesendetes Folgen
zu einem bereits bestehenden Folgen oder einer bestehenden Anfrage fragt ebenfalls nicht: Der Server beantwortet es wie gewohnt
und nimmt es erneut an, wenn das Folgen schon angenommen ist. Ein verworfenes Folgen erhält keine Antwort, der andere Server zeigt es also weiter
als angefragt an. Dieselbe Aktivität erneut zu senden, wird als Duplikat ignoriert.
Ein automatisierter Effekt kommt mit dem System als Akteur nur ins Audit-Log, wenn er einen Zustand hinterlässt: mark_sensitive, ein
erstelltes flag und require_approval (hook_decision_applied). drop und reject speichern nichts, sie bleiben also allein in den
Entscheidungen.
Der Job hook.purge_decisions entfernt Entscheidungen nach hook_decisions_retention_days Tagen (Standard 90, mindestens 30). Er behält
die, auf denen eine Sensitiv-Markierung an einem bestehenden Beitrag beruht, die eines Kontos unter einer
Aufbewahrungssperre und jedes reject eines neuen Beitrags durch local.status, gegen das sein Autor noch
Einspruch einlegen kann oder dessen Einspruch auf Prüfung wartet. Gegen ein reject einer Bearbeitung kann kein Einspruch eingelegt werden, es verschwindet also, sobald die Aufbewahrungsfrist
vorbei ist. Ein Einspruch geht mit seiner Entscheidung. Das Löschen eines Kontos entfernt seine Entscheidungen, seine Einsprüche und
seine Ausnahme von local.status.
Was du deinen Nutzern sagst
Abschnitt betitelt „Was du deinen Nutzern sagst“Solange ein Hook ein Plugin hat und nicht off ist, gibt deine Informationsseite (/about) an, dass eine externe Prüfung im Einsatz ist, was
sie abdeckt und was an sie gesendet wird. Der Server schreibt das aus deinen Einstellungen, einschließlich des Kontoalters aus
hook_local_status_account_age_days und hook_local_profile_account_age_days (oder dass die jedes Kontos gesendet werden, bei
0) und ob
hook_inbound_status_unfollowed_direct die Direktbeiträge von Autoren sendet, denen hier niemand folgt.
Was gesendet wird und was es kostet
Abschnitt betitelt „Was gesendet wird und was es kostet“Aufrufe, ihre Kosten und gesendete Daten wachsen mit dem Volumen, das der Server empfängt, vor allem bei inbound.status: Jeder Beitrag im Geltungsbereich
ist ein Aufruf und jede Revision ein weiterer. Prüfe, was du sendest, bevor du einen Hook einschaltest:
inbound.statusundlocal.statussenden den Text von Beiträgen und lehnen einfaches TCP ab, auch auf Loopback.inbound.statussendet, was der entfernte Server gesendet hat: den Text in jeder seiner Sprachen, die Inhaltswarnung, ob er als sensibel markiert ist, wann er veröffentlicht wurde, die Adresse und URL des Beitrags, die Adresse des Beitrags, auf den er antwortet, die Adressen und Beschreibungen von Anhängen (keine Medien), Umfrageoptionen, Hashtags, den Autor und den Server des Autors, die Sichtbarkeit und wie viele Konten der Beitrag nennt und wie viele davon lokal sind. Er sendet auch, ob ein lokales Konto dem Autor folgt (any_local_follower), was Daten über deine Nutzer sind. Beiträge nur für Follower (private) werden wie öffentliche gesendet, und Direktbeiträge wie oben. Vom Beitrag, auf den er antwortet, sendet er nur die Adresse.local.statussendet die unter Lokale Beiträge aufgeführten Felder. Die NachrichtInboundStatusdesHookService-Protokolls hat die Felder.signup.checksendet die E-Mail-Adresse und die IP-Adresse jeder antragstellenden Person und lehnt einfaches TCP ab.inbound.followsendet die beiden Parteien eines Folgens.inbound.actorsendet das öffentliche Profil eines Kontos auf einem anderen Server, wie unter Profile von anderen Servern aufgeführt, und darf einfaches TCP verwenden. Er wird immer aufgerufen, wenn sich ein solches Profil ändert, sein Volumen folgt also der Zahl der Konten, die dein Server kennt.media.checksendet das kleinste verarbeitete Bild jedes Uploads, nie das Original, mit dem Zweck der Datei, ihrer Art, Größe und Länge. Er darf einfaches TCP verwenden, da er keinen Text sendet: Ein verarbeitetes Bild kann trotzdem eine Person zeigen.local.profilesendet das unter Lokale Profile aufgeführte öffentliche Profil und kein Bild. Er darf einfaches TCP verwenden.
Für LLMs und Coding-Agenten:llms.txt,llms-full.txt, llms-small.txt