Cette page est une traduction automatique de la page en anglais, qui fait foi. Lire la page en anglais
La page en anglais a changé depuis la traduction de ces sections :
Mesures sur les comptes et les domaines, et traitement des signalements
Comment les exploitants et les modérateurs agissent sur les comptes et les domaines, tranchent les contestations, traitent les signalements, vérifient ce qui a atteint un serveur distant et lisent le journal d’audit.
Tout ce qui figure ici, sauf la gestion des comptes et la vérification des envois (API d’administration uniquement), peut se faire par l’API d’administration (/api/v1/admin/..., périmètres admin:read / admin:write) et la CLI (my admin account action / my admin domain / my admin report / my admin appeal).
L’API d’administration exige des permissions de rôle : la gestion des comptes, les mesures et les contestations exigent manage_accounts, les mesures sur les domaines exigent manage_domains, et les signalements exigent manage_reports.
La CLI se connecte directement à la base de données avec la même configuration que le serveur (-config ou variables d’environnement) et n’enregistre pas quel utilisateur l’a utilisée (issued_by_user_id et les champs similaires valent NULL, et l’acteur dans le journal d’audit est cli).
D’un signalement à une mesure et à une contestation
Section intitulée « D’un signalement à une mesure et à une contestation »Du haut du schéma vers le bas :
- Un signalement arrive. Un utilisateur local en dépose un, un autre serveur envoie un
Flag(abandonné lorsque son domaine areject_reports, voir mesures sur les domaines), ou un point de décision répondflag(signalements déposés par un examen externe). Un utilisateur local qui signale un compte d’un autre serveur peut choisir de transmettre le signalement, ce qui envoie aussitôt unFlagà ce serveur. - Examen. Le signalement est
open, et les modérateurs reçoivent une notificationadmin_report. Le résoudre le fait passer àresolvedavec le résultatactionedoudismissed, et un auteur de signalement local reçoit une notificationreport_resolved. Le rouvrir le remet àopen. Transmettre un signalement concernant un compte d’un autre serveur envoie unFlagà ce serveur (signalements). - Mesure. Un modérateur prend une mesure sur un compte depuis le signalement, ce qui résout le signalement comme
actioned; une mesure peut aussi être prise sans signalement. La mesure a un type, un motif et une heure de fin, et prend fin lorsqu’elle est levée ou qu’elle expire. Avecnotify_target, l’utilisateur reçoit une notificationmoderation_notice(ce que voit l’utilisateur). Les autres serveurs reçoivent unDeletedes publications pourdelete_statuses, unUpdatede l’acteur lorsque lesuspendou leband’un compte local commence ou se termine, et unReject/Undodes abonnements que coupe lesuspendd’un compte distant. - Contestation. L’utilisateur local conteste la mesure. La contestation est
pending, et les modérateurs reçoivent une notificationadmin_appeal. La décision estupheldouoverturned, et l’utilisateur reçoit une notificationappeal_decided. Annuler la mesure la lève et annule la suppression d’unban, donc unsuspendou unbanlevé par une contestation acceptée sur un compte local envoie unUpdatede l’acteur (contestations).
Les attributions, les notes, les avis et les contestations restent sur ce serveur ; seules les activités de la colonne de droite le quittent.
Modération et administration du serveur dans le client web
Section intitulée « Modération et administration du serveur dans le client web »Le client web sépare les écrans du personnel en deux. La navigation n’affiche « Modération » et « Administration » qu’aux personnes dont le rôle a au moins une permission de ce groupe. Chaque écran n’affiche qu’une raison aux personnes sans la permission, et le serveur rejette aussi leurs requêtes.
| Groupe | Permissions | Écrans |
|---|---|---|
Modération (/moderation) |
manage_reports, manage_accounts, manage_domains, manage_invites, view_audit |
Signalements (/moderation/reports), Contestations (/moderation/appeals), Inscriptions (/moderation/registrations), Examens automatisés (/moderation/hook-decisions), Comptes (/moderation/accounts), Blocages d’inscription (/moderation/signup-blocks), Invitations (/moderation/invites), Actions de domaine (/moderation/domain-actions), Serveurs distants (/moderation/instances), Journal d’audit (/moderation/audit-log) |
Administration du serveur (/admin) |
manage_settings, manage_rules, manage_roles, manage_jobs, manage_login_recovery, manage_custom_emojis, manage_webhooks, manage_announcements, manage_finance, manage_supporters, manage_oauth_apps, manage_service_closure, manage_errors, manage_login_providers |
Paramètres du serveur (/admin/settings), Règles (/admin/rules), Conditions et politiques (/admin/documents), Domaines de cartes de lien (/admin/link-card-domains), la file de jobs et les jobs en échec (/admin/jobs), Erreurs (/admin/errors, manage_errors), Mesures d’expérience utilisateur (/admin/ux-measurements, manage_errors), Émojis personnalisés (/admin/custom-emojis), Annonces (/admin/announcements), Webhooks (/admin/webhooks), Coûts et revenus (/admin/finance, manage_finance), Soutiens (/admin/supporters, manage_supporters). manage_login_recovery (récupération de connexion : retirer l’authentification à deux facteurs et émettre un lien de réinitialisation du mot de passe) et manage_roles (attribuer et révoquer les rôles d’un compte) apparaissent comme des sections de la page Gestion d’un compte (/moderation/accounts/{id}/manage, qui exige aussi manage_accounts) |
- Le badge sur « Modération » est le total des signalements ouverts, des inscriptions en attente d’approbation et des contestations en attente d’examen (notifications pour les modérateurs et compteurs en attente). « Administration » n’affiche aucun nombre.
- Chaque groupe s’ouvre sur une liste de ses écrans que les permissions de votre rôle ouvrent, chacun avec une ligne sur ce qu’il contient et, pour une file, combien d’éléments y attendent (Signalements compte les signalements ouverts, Contestations celles en attente d’examen, Inscriptions celles en attente d’approbation, Émojis personnalisés les demandes en attente d’examen, Erreurs les erreurs ouvertes) ; un groupe dont aucun écran ne vous est ouvert en indique la raison. L’adresse d’un écran que votre rôle n’ouvre pas l’indique, avec un lien vers la liste du groupe.
- Le
moderatorintégré n’a quemanage_reports,manage_accountsetview_audit, et ne voit pas « Administration ». Il ne voit pas non plus les écrans Actions de domaine et Serveurs distants (manage_domains) ; pour les déléguer, créez un rôle avec cette permission et attribuez-le (attribuer et révoquer des rôles). - Les chemins de l’API d’administration restent
/api/v1/admin/...quel que soit le groupe, et les portées sont la même paireadmin:read/admin:write. Les groupes sont séparés par des balises dans la référence de l’API (admin-moderation,admin-server). Un service extérieur au serveur peut appeler les opérations d’une permission avec une portée de permission à la place (laisser un autre service utiliser l’API d’administration). - Il existe un troisième groupe de permissions, les « fonctions utilisateur » (
view_finance,create_custom_emojis,start_voice_rooms,create_invites,keep_posts_longer,create_articles,create_events), qui vit en dehors des écrans du personnel. Une personne qui n’a que ces permissions ne voit ni « Modération » ni « Administration », et pour une personne avecview_finance, la navigation affiche « Finances » (/finance) après Paramètres. Son API est dans l’espace de noms utilisateur (GET /api/v1/finance/cost_totalsetGET /api/v1/finance/income_totals, portéeread:finance) et n’exige aucune portéeadmin:*. Ce qu’elle affiche est défini parfinance_viewer_*dans les paramètres de l’instance.
Laisser un autre service utiliser l’API d’administration
Section intitulée « Laisser un autre service utiliser l’API d’administration »Un service que vous exécutez à côté du serveur, un qui distribue des invitations ou enregistre des coûts, par exemple, peut appeler l’API d’administration pour une permission sans plugin.
- Inscrivez un compte pour le service et accordez-lui un rôle avec uniquement les permissions dont le service a besoin (pour les invitations, un rôle avec
manage_invites; attribuer et révoquer des rôles). - Connecté en tant que ce compte, enregistrez une application dans Paramètres → Applications → Vos applications dont les portées incluent la portée de permission,
admin:et la permission :admin:manage_invites. - Émettez un jeton pour le compte à partir de l’application, avec cette portée, et donnez au service le jeton d’accès et le jeton d’actualisation.
- Le jeton n’atteint que les opérations des permissions que ses portées nomment, et seulement tant que les rôles du compte les conservent ; le journal d’audit enregistre ce qu’il fait comme des actions du compte.
- Le jeton d’accès dure une heure. Le service l’actualise avec le jeton d’actualisation et conserve à chaque fois le nouveau jeton d’actualisation : un ancien jeton réutilisé révoque le jeton.
manage_roles,manage_oauth_apps,manage_login_recovery,manage_login_providersetmanage_service_closuren’ont aucune portée de permission, et aucune application ne peut en demander une à un membre du personnel sur l’écran de consentement.- Pour arrêter le service, révoquez les jetons de l’application ou supprimez l’application, retirez le rôle, ou désactivez l’application dans Administration → Applications OAuth.
Mesures sur les comptes
Section intitulée « Mesures sur les comptes »Une mesure est appliquée à la projection des restrictions (account_restrictions) dans la transaction qui l’enregistre, et prend effet dès la requête suivante.
| Type | Effet sur un compte local |
|---|---|
warn |
Aucune restriction (informe seulement l’utilisateur) |
force_sensitive |
Affiche toutes les pièces jointes comme sensibles |
limit |
Traite les publications (y compris passées) comme réservées aux abonnés et les garde hors des fils publics |
restrict_posting |
Interdit de publier, de répondre, de booster et de modifier |
restrict_interaction |
Interdit de suivre, de mettre en favori, de booster et de répondre |
disable_login |
Interdit l’usage de l’application et de l’API, et révoque les sessions et jetons actifs (la page de connexion permet quand même à l’utilisateur de voir la mesure) |
suspend |
Applique toutes les restrictions ci-dessus, et masque le profil et les publications à tout le monde sauf à l’utilisateur |
ban |
Applique les mêmes restrictions que suspend et supprime le compte après 30 jours. Elle ne peut pas être levée (elle n’est annulée que si une contestation faite pendant ces 30 jours est acceptée) |
delete_statuses |
Supprime les publications indiquées. Elles deviennent invisibles même pour l’utilisateur, et le serveur envoie aux autres serveurs le même Delete que lorsque l’utilisateur les supprime |
mark_statuses_sensitive |
Affiche les pièces jointes des publications indiquées comme sensibles |
Pour un compte distant, vous ne pouvez prendre que limit, suspend et force_sensitive (tout autre type donne 422 dans l’API d’administration et échoue dans la CLI). L’effet est local à ce serveur. Les seules choses envoyées à l’autre serveur sont le Reject / Undo des abonnements coupés par suspend.
| Type | Effet sur un compte distant |
|---|---|
force_sensitive |
Affiche toutes les pièces jointes comme sensibles |
limit |
Traite les publications (y compris passées) comme réservées aux abonnés, les garde hors des fils publics, et ne crée aucune notification pour les utilisateurs qui ne suivent pas le compte |
suspend |
Abandonne tout ce qui est reçu du compte et masque son profil et ses publications. Coupe les abonnements entre le compte et les utilisateurs locaux dans les deux sens (demandes d’abonnement comprises), et envoie à l’autre serveur un Reject des abonnements du compte et un Undo des abonnements des utilisateurs. La lever rétablit l’affichage et la réception depuis le compte (ce qui a été abandonné et les abonnements coupés pendant la suspension ne reviennent pas) |
notify_target(-no-notify) n’a aucun sens pour un compte distant (aucune notification ne l’atteint).- Un utilisateur local qui a perdu des abonnements à cause d’un
suspendreçoit une notification (relationships_severed) qui indique combien d’abonnés et d’abonnements ont été perdus (abonnements rompus). - La prise et la levée d’une mesure sont consignées dans le journal d’audit, comme pour les mesures sur les comptes locaux.
my admin account action issue -kind suspend -category spam -public-reason "spam" -duration 720h @alicemy admin account action issue -kind limit -report <report id> @bob@remote.examplemy admin account action issue -kind delete_statuses -status <status id> -status <status id> @alicemy admin account action issue -kind ban -category legal -public-reason "illegal content" @alicemy admin account action list -active @alicemy admin account action lift -reason "appealed" <action id>Dans l’API d’administration : POST /api/v1/admin/accounts/{id}/actions (le corps contient kind, reason_category, public_reason, private_note, report_id, notify_target, expires_in en secondes et status_ids), GET /api/v1/admin/accounts/{id}/actions (filtrez avec active), GET /api/v1/admin/account_actions/{id}, et POST .../{id}/lift (le corps {"reason": "..."} est facultatif).
- Désignez un compte avec
@username(local),@username@domain(distant) ou l’ID du compte dans la CLI, et avec l’ID du compte dans l’API d’administration. - Plusieurs mesures s’empilent (l’union de leurs restrictions). Lever une mesure ne retire que ses propres restrictions, et une mesure ayant une heure de fin se termine d’elle-même à ce moment (affichée comme
expireddans les listes). Une heure de fin est au plus à dix ans (expires_injusqu’à 315360000) ; une heure plus lointaine est refusée avec422. - Les sessions et jetons que
disable_login,suspendetbanont révoqués ne reviennent pas lorsque vous levez la mesure. L’utilisateur se reconnecte. - Un
suspendou unband’un compte local envoie unUpdatede l’acteur avec un profil vidé aux serveurs des abonnés et aux serveurs connus pour montrer la suspension (Mastodon l’affiche comme « suspendu »). La levée et l’expiration envoient unUpdateavec le profil d’origine. L’expiration est envoyée par une tâche qui s’exécute toutes les 5 minutes, elle peut donc avoir jusqu’à 5 minutes de retard. delete_statusesetmark_statuses_sensitiveprennent de 1 à 100 publications non supprimées du compte cible via-status(status_ids). Elles ne peuvent pas avoir d’heure de fin. Leverdelete_statusesne rétablit pas les publications supprimées. Levermark_statuses_sensitiverétablit l’affichage d’origine.- Un
banne peut pas avoir d’heure de fin et ne peut pas être levé. Il n’est annulé que si une contestation que l’utilisateur a faite dans les 30 jours précédant la suppression est acceptée (contestations). En cas de doute, utilisez unsuspendavec une heure de fin. Trente jours après la mesure, une tâche qui s’exécute toutes les heures supprime le compte (le compte et les publications disparaissent de la vue, et le serveur envoie unDeleteaux autres serveurs). report_id(-report) ne peut désigner qu’un signalement concernant le compte cible. Un signalement ouvert est résolu commeactioneden même temps que la mesure (la résolution figure aussi dans le journal d’audit). Un signalement résolu ne change pas.public_reasonest le motif montré à l’utilisateur etprivate_noteest une note réservée aux modérateurs.notify_target(vrai par défaut ; faux avec-no-notifydans la CLI) décide si l’utilisateur est informé.
Ce que voit l’utilisateur
Section intitulée « Ce que voit l’utilisateur »- Une mesure avec
notify_targetvrai parvient à l’utilisateur sous la forme d’une notification (moderation_notice). Elle contient le type, la catégorie du motif,public_reason, l’heure de fin et l’état. Le type et la catégorie reviennent aussi sous forme de noms d’affichage dans la langue de l’interface de l’utilisateur. - L’utilisateur peut consulter les mesures qui le visent avec l’API de première partie
GET /api/v1/moderation/actions(filtrable avecactive), de la plus récente à la plus ancienne. Les mesures avecnotify_targetfaux et les mesures levées ou expirées sont aussi listées. private_note, le signalement, la personne qui a pris la mesure et le motif de la levée ne sont jamais montrés à l’utilisateur.- Un utilisateur peut contester chaque mesure une fois (contestations). La liste des mesures et la mesure dans une notification indiquent si elle peut être contestée (
appealable), l’échéance (appeal_deadline), ainsi que la contestation et son issue (appeal). - Un utilisateur soumis à
disable_login,suspendoubanne peut pas utiliser l’application ni l’API mais peut quand même se connecter sur la page de connexion (/auth/sign_in). Il y voit le type, le motif et l’heure de fin de la mesure en vigueur (pourban, le nombre de jours avant la suppression du compte), et peut la contester depuis cette page (contestations). Le point de terminaison d’autorisation (/oauth/authorize) répond403et n’émet aucun jeton. Un utilisateur soumis àbanpeut se connecter jusqu’à la suppression du compte, et la suppression révoque aussi cette session. Un utilisateur dont la propre suppression est programmée, et un compte qui a été désactivé, ne peuvent pas se connecter, même sur la page de connexion.
Comptes que leurs propriétaires ont désactivés
Section intitulée « Comptes que leurs propriétaires ont désactivés »Un utilisateur peut désactiver son propre compte depuis les paramètres du compte, après avoir saisi à nouveau son mot de passe ou un code à deux facteurs, ou confirmé avec une clé d’accès (un utilisateur sans aucun de ces éléments se reconnecte chez un fournisseur de connexion associé). Le compte n’est pas une mesure de modération et les modérateurs ne peuvent désactiver personne :
- Le profil et les publications sont masqués à tout le monde sauf aux modérateurs, et les autres serveurs reçoivent un
Updatede l’acteur marquésuspended, de sorte qu’ils peuvent afficher le compte comme suspendu. Chaque session et chaque jeton de l’utilisateur prennent fin. Là où le serveur envoie des e-mails, un e-mail indique la date de la suppression ; aucun autre e-mail n’est envoyé avant. - Rien n’atteint le compte : les mentions et les messages directs sont abandonnés, aucune notification, aucun e-mail ni Web Push n’est généré, et les nouveaux abonnés sont refusés. Les favoris et les boosts sont comptés. Les abonnements existants restent.
- L’utilisateur se connecte à une page du serveur, qui montre la date de la suppression et lui permet de réactiver ou de supprimer le compte. La réactivation rétablit tout. La désactivation suivante doit attendre 24 heures.
- Trente jours après la désactivation, la tâche horaire supprime le compte. Une réactivation après cette date est refusée même si la tâche ne s’est pas encore exécutée. Le nom d’utilisateur n’est pas libéré.
Les modérateurs voient l’état deactivated dans la liste des comptes (state=deactivated), et peuvent toujours lire les signalements concernant le compte et agir dessus. Une mesure de modération ne change pas la date de suppression, sauf un ban, qui la remplace par la sienne : dès lors l’utilisateur ne peut plus réactiver. Une suspension n’envoie rien aux autres serveurs tant que le compte est désactivé, et elle reste en vigueur après que l’utilisateur a réactivé. Un utilisateur ne peut pas désactiver un compte tant que la modération l’empêche de se connecter, tant que sa suppression est programmée, après un déplacement, tant que son inscription attend un examen, tant qu’une souscription payante est encore en cours (y compris une souscription réglée pour se terminer à la fin de sa période), ou lorsqu’il est le seul administrateur pouvant se connecter. Un administrateur désactivé ne compte pas comme tel. Si la date d’un administrateur désactivé arrive alors qu’aucun autre administrateur ne peut se connecter, la tâche horaire ne supprime pas le compte et consigne un avertissement. Cet administrateur ne peut plus se connecter non plus, créez donc un autre administrateur avec my admin create ; l’exécution suivante supprime alors le compte.
Contestations
Section intitulée « Contestations »Un utilisateur local peut contester une mesure prise contre lui.
Un modérateur examine la contestation et soit la maintient (uphold), soit l’annule (overturn).
my admin appeal list -state pendingmy admin appeal uphold -reason "The posts were spam." <appeal id>my admin appeal overturn -reason "Sorry, our mistake." <appeal id>L’utilisateur conteste avec POST /api/v1/moderation/actions/{id}/appeal (portée write:accounts, corps {"text": "..."}).
Un utilisateur sous disable_login, suspend ou ban ne peut pas obtenir de jeton d’accès et conteste par le formulaire propre à chaque mesure sur la page de connexion (POST /auth/appeal).
Tant que la connexion est limitée aux fournisseurs de connexion, un tel utilisateur n’atteint le formulaire que par un fournisseur lié.
La page affiche le formulaire et la date limite pour une mesure qui peut être contestée, le contenu et le résultat pour une mesure déjà contestée, et la raison pour une mesure dont la date limite est passée ou qui ne peut pas être contestée. Pour une contestation rejetée, elle affiche la raison.
Dans l’API d’administration : GET /api/v1/admin/appeals (filtre avec state), GET .../{id}, et POST .../{id}/uphold et POST .../{id}/overturn (le corps {"public_reason": "..."} est facultatif). Elles exigent la permission manage_accounts.
Dans le client web, Modération → Contestations (/moderation/appeals) liste les contestations en attente d’examen, ou toutes ; la page d’une contestation (/moderation/appeals/{id}) affiche ce que l’utilisateur a écrit et la mesure, avec la raison à communiquer à l’utilisateur et « Maintenir » et « Annuler », chacun demandant d’abord confirmation.
- Une mesure ne peut être contestée qu’une fois, et le texte compte de 1 à 2 000 caractères. La date limite est le nombre de jours du paramètre d’instance
appeal_window_daysaprès la mesure (180 jours par défaut, de 20 à 365 ; voir paramètres de l’instance). Une mesure passée la date limite et une seconde contestation donnent422(/api/v1/problems/appeal-window-closedet/api/v1/problems/already-appealed). - Un
banpeut être contesté jusqu’à ce que le compte soit supprimé (30 jours après la mesure, ou jusqu’à la date limiteappeal_window_dayssi elle est plus courte). Unband’un compte supprimé donne422(/api/v1/problems/not-appealable). Une mesure levée ou expirée peut encore être contestée dans le délai. - Lorsqu’un utilisateur conteste, les personnes avec
manage_accountsreçoivent une notification (admin_appeal). Lorsqu’elle est examinée, l’utilisateur reçoit une notification (appeal_decided) et peut voir le résultat etpublic_reason. L’examinateur n’est pas montré. - Annuler une mesure la lève dans la même transaction (le même effet que
lift, avec un motif de levée vide). Annulerdelete_statusesne ramène pas les publications supprimées. Une mesure déjà levée avant l’examen reste telle quelle. - Annuler un
banannule aussi la suppression programmée du compte dans la même transaction (le journal d’audit enregistreaccount_deletion_canceled), met fin à la suspension et envoie leUpdatedu profil d’origine aux autres serveurs. Les sessions et jetons révoqués ne reviennent pas ; l’utilisateur se reconnecte donc. Si le compte a été supprimé avant l’examen, il ne peut pas être annulé (422,/api/v1/problems/not-appealable; le maintien reste possible). - Un examen n’a lieu qu’une fois. Réexaminer avec le même résultat ne change rien, et le résultat opposé donne
409(/api/v1/problems/appeal-decided).
Gestion des comptes
Section intitulée « Gestion des comptes »La recherche de comptes, l’affichage de leurs détails et la révélation des adresses IP et des adresses e-mail se font par l’API d’administration et exigent la permission manage_accounts.
Dans le client web, un compte a trois pages, avec des liens entre elles sous le titre de la page :
- Examen (
/moderation/accounts/{id}) : l’état du compte et ses restrictions, son inscription et qui l’a invité, le formulaire d’une nouvelle mesure (ouvert depuis un signalement avec « Agir sur ce compte » ; le formulaire propose aussi les mesures sur les publications du signalement, et la mesure résout le signalement), les mesures les plus récentes prises contre lui avec leurs motifs, avec « Toutes les mesures » vers sa page Mesures lorsqu’il peut y en avoir davantage, et ses signalements, les plus récents d’abord, le reste sous « Afficher plus ». - Mesures (
/moderation/accounts/{id}/actions) : chaque mesure prise contre le compte, ou celles en vigueur, une page à la fois. Chaque mesure ouvre sa propre page (/moderation/accounts/{id}/actions/{action id}) avec tous ses détails et, tant qu’elle est en vigueur, « Lever » avec un motif pour les modérateurs. La page d’un bannissement n’a pas de « Lever » : seule l’annulation de sa contestation l’annule. - Gestion (
/moderation/accounts/{id}/manage) : pour un compte local, ses rôles (manage_roles), sa suppression d’e-mail, le retrait de l’authentification à deux facteurs et l’émission d’un lien de réinitialisation du mot de passe (manage_login_recovery), ainsi que ses adresses e-mail et IP, montrées seulement après « Afficher », avec ses connexions et les comptes qui ont utilisé les mêmes adresses IP, chaque liste des plus récentes aux plus anciennes avec le reste sous « Afficher plus » (chaque appui lit une page, enregistrée dans le journal d’audit), et un lien vers ceux du même domaine d’e-mail ; pour un compte distant, la récupération de ses publications depuis son serveur (manage_domains). Chaque section n’apparaît qu’aux personnes qui ont sa permission.
Le personnel n’agit que sur les rangs inférieurs : émettre ou lever une mesure, décider d’une contestation, lever une suppression d’e-mail, révéler des données privées, émettre un lien de réinitialisation du mot de passe et retirer l’authentification à deux facteurs exigent que la position la plus élevée de vos rôles soit supérieure à celle de chaque rôle de la cible.
Un rang supérieur ou égal, y compris votre propre compte, renvoie 403 avec le type de problème /api/v1/problems/target-outranks-actor ; un modérateur ne peut donc pas bannir un administrateur et un administrateur ne peut pas en bannir un autre. Les commandes my admin n’ont pas une telle limite.
Une mesure qui empêche le seul administrateur pouvant se connecter de se connecter (disable_login, suspend, ban) est refusée quel que soit son auteur, et cet administrateur ne peut pas supprimer son propre compte (409 avec /api/v1/problems/last-administrator). Voir admin-cli.md pour les rôles.
GET /api/v1/admin/accountsrenvoie les comptes locaux et distants, les plus récents d’abord (l’Actor de l’instance est exclu). Vous pouvez filtrer par préfixe de nom d’utilisateur (username), domaine (domain), local ou distant (origin), état (state), et, pour les comptes locaux, adresse e-mail (email), domaine d’e-mail (email_domain) et adresse IP utilisée pour s’inscrire ou se connecter (ip). Vous ne pouvez donner qu’un seul deemail,email_domainetip. La liste n’inclut ni adresses IP ni adresses e-mail.- L’état est le premier qui s’applique dans cette liste :
deleted,suspended(suspend,ban),disabled(disable_login),rejectedetpending(examen de l’inscription),limited(limit),active. L’état et les restrictions (restrictions) proviennent uniquement des mesures prises contre le compte lui-même et n’incluent pas les actions de domaine. GET /api/v1/admin/accounts/{id}renvoie l’état et les restrictions et, pour un compte local, la demande d’inscription et son examen, la confirmation de l’e-mail, les rôles, et jusqu’à 20 mesures et signalements, les plus récents d’abord.GET /api/v1/admin/reports?target_account_id={id}parcourt page par page tous les signalements concernant un compte.POST /api/v1/admin/accounts/{id}/revealrenvoie l’adresse e-mail d’un compte local, les adresses IP et les User-Agents de l’inscription et des connexions (20 entrées, les plus récentes d’abord), et les autres comptes qui ont utilisé la même adresse IP (jusqu’à 20 par adresse IP).GET /api/v1/admin/accounts/{id}/sign_insetGET /api/v1/admin/accounts/{id}/same_ip_accounts?ip=les parcourent tous page par page. Chaque appel de ces trois enregistrerevealed_private_datadans le journal d’audit, et les données ne sont renvoyées que si l’enregistrement a pu être écrit. Les adresses IP sont supprimées après la période de conservation (180 jours par défaut) ; les origines de connexion plus anciennes ne peuvent donc pas être montrées.two_factor_enableddansGET /api/v1/admin/accounts/{id}indique si l’utilisateur d’un compte local utilise l’authentification à deux facteurs (TOTP). Un utilisateur qui a perdu à la fois l’application d’authentification et les codes de récupération peut se connecter avec le seul mot de passe une fois que vous retirez l’authentification à deux facteurs avecPOST /api/v1/admin/accounts/{id}/two_factor/disable. Seuls les utilisateurs ayant la permissionmanage_login_recoverypeuvent le faire, et par défaut seul le rôle d’administrateur intégré l’a (elle relève de l’administration du serveur ; le client web n’affiche la section qu’à eux). Le retrait enregistretwo_factor_disableddans le journal d’audit. Vérifiez que la personne est bien la propriétaire du compte par une autre voie, comme l’e-mail, avant de le retirer. Lorsqu’un administrateur sans autre administrateur l’a perdue, l’opérateur la retire avec la commande CLImy admin account disable-two-factor @alice(l’acteur du journal d’audit est la CLI).- Sur un serveur qui envoie des e-mails, un utilisateur qui a oublié son mot de passe reçoit par e-mail un lien pour en définir un nouveau depuis « Mot de passe oublié ? » sur la page de connexion.
Pour un serveur qui n’envoie pas d’e-mails (
mail = none), ou un utilisateur que les e-mails n’atteignent pas, un administrateur émet le lien et le transmet. Dans les écrans d’administration, émettez-le avec « Réinitialiser le mot de passe » sur la page Gestion du compte (/moderation/accounts/{id}/manage,POST /api/v1/admin/accounts/{id}/password_reset_link). Seuls les utilisateurs ayant la même permission que pour retirer l’authentification à deux facteurs,manage_login_recovery, peuvent l’émettre, et par défaut seul le rôle d’administrateur intégré l’a (quiconque détient le lien peut entrer dans le compte ; lemanage_accountsd’un modérateur ne suffit donc pas). Le lien émis est montré une seule fois sur-le-champ et peut être copié. Le serveur ne stocke qu’un hachage du lien ; vous ne pouvez donc pas le voir ensuite ; émettez-le de nouveau si besoin. Lorsqu’aucun administrateur n’est disponible ou que les écrans d’administration ne le sont pas, l’opérateur l’émet avec la commande CLImy admin account password-reset-link @alice(l’acteur du journal d’audit est la CLI). Tant que la connexion est limitée aux fournisseurs de connexion, les deux émettent quand même le lien et indiquent qu’il ne fonctionne pas avant la fin de la limite. Le lien fonctionne pendant 1 heure et une seule fois, et cesse de fonctionner si le mot de passe change ensuite par une autre voie. Les deux façons de l’émettre enregistrentpassword_reset_link_issueddans le journal d’audit. Quiconque détient le lien peut définir le mot de passe ; vérifiez donc la personne par une autre voie comme l’e-mail et ne donnez le lien qu’à elle. Définir le nouveau mot de passe révoque toutes les sessions et tous les jetons d’application de l’utilisateur. Les clés d’accès et l’authentification à deux facteurs restent. email_suppressiondansGET /api/v1/admin/accounts/{id}indique que l’envoi vers l’adresse principale d’un compte local est arrêté. Unhard_bounce(la destination n’existe pas) arrête tous les e-mails sauf l’e-mail de confirmation, et uncomplaint(signalé comme spam) n’arrête que les e-mails de notification et d’annonce. Les e-mails de réinitialisation du mot de passe s’arrêtent aussi ; émettez donc le lien ci-dessus et transmettez-le si besoin. Lorsque l’utilisateur demande un e-mail de confirmation et confirme de nouveau l’adresse, la suppression due à un rebond définitif est levée. Lorsque vous avez vérifié que l’envoi est correct, par exemple parce que l’utilisateur a réparé sa boîte aux lettres, levez-la avecPOST /api/v1/admin/accounts/{id}/email_suppression/lift(permissionmanage_accounts). Elle enregistreemail_suppression_lifteddans le journal d’audit.- Une recherche lit jusqu’à 400 comptes pour remplir une page. Lorsque peu de comptes correspondent, même une page courte ou vide peut porter
next_cursor; continuez donc la lecture.
Actions de domaine
Section intitulée « Actions de domaine »| Type | Effet |
|---|---|
suspend |
Arrête toute livraison, récupération et réception (la réception reçoit 403 avant la vérification de la signature). Les comptes et publications existants sont masqués des fils et des profils. Coupe les abonnements entre les utilisateurs locaux et les comptes du domaine dans les deux sens (rien n’est envoyé à l’autre côté) |
limit |
Garde les publications hors des fils publics et de la recherche, et ne crée aucune notification pour les utilisateurs qui ne suivent pas le compte |
reject_media |
Ne récupère pas les médias |
reject_reports |
Abandonne les signalements (Flag) du domaine |
force_sensitive |
Affiche les médias comme sensibles |
my admin domain issue -kind suspend -public-comment "spam" spam.examplemy admin domain issue -kind limit -duration 720h noisy.examplemy admin domain list -activemy admin domain lift <action id>Dans l’API d’administration : POST /api/v1/admin/domain_actions (le corps contient domain, kind, public_comment, private_note, obfuscate et expires_in en secondes),
GET /api/v1/admin/domain_actions (filtre avec domain et active), GET .../{id}, POST .../{id}/lift,
et GET .../impact?domain=, qui compte les abonnements qu’un suspend du domaine mettrait fin.
Dans le client web, ouvrez Modération → Actions de domaine (/moderation/domain-actions). La liste affiche le domaine, la raison publique, le type, la fin et l’état de chaque action, en vigueur ou toutes, de chaque domaine ou de celui que vous recherchez ;
« Nouvelle action » ouvre le formulaire (/moderation/domain-actions/new), et choisir un domaine ouvre la page de l’action avec ses motifs et ses dates, où « Lever » y met fin.
Un suspend demande d’abord confirmation : la confirmation indique combien d’abonnements entre les utilisateurs locaux et les comptes du domaine il met fin définitivement, et vous demande de saisir le domaine.
Le lien « Actions de domaine » sur la page d’un serveur distant ne liste que les actions de ce domaine, et « Nouvelle action » y démarre le formulaire avec le domaine renseigné.
- Les domaines sont enregistrés normalisés en étiquette A IDNA (minuscules, sans point final).
例え.jpetxn--r8jz45g.jpsont le même domaine. - Une action s’applique aussi aux sous-domaines (une action sur
spam.examples’applique aussi àa.spam.example). - Une action est appliquée à la projection des restrictions (
domain_restrictions) et aux restrictions des fils dans la transaction qui l’enregistre, et prend effet à partir de la prochaine livraison, récupération ou réception. - Une action avec une heure de fin (
-duration/expires_in, dix ans au plus) prend fin d’elle-même à ce moment. L’expiration n’est pas une « levée » ; les listes l’affichent donc commeexpired. - Lever ne supprime que les restrictions de cette action. Les autres actions sur le même domaine restent. Lever une action déjà levée ne change rien.
- Les listes sont des plus récentes aux plus anciennes, et
-active(active=true) n’affiche que les actions en vigueur.
Importer et exporter du CSV Mastodon
Section intitulée « Importer et exporter du CSV Mastodon »Vous pouvez échanger la liste des actions de domaine avec Mastodon au format CSV des blocages de domaine de Mastodon (#domain,#severity,#reject_media,#reject_reports,#public_comment,#obfuscate).
Vous pouvez importer un CSV exporté par Mastodon, et Mastodon peut importer un CSV exporté par ce serveur.
my admin domain export > domain_blocks.csvmy admin domain import domain_blocks.csv # only shows what it would domy admin domain import -apply -only spam.example,bad.example domain_blocks.csvDans l’API d’administration : GET /api/v1/admin/domain_actions/export (text/csv), POST .../import/preview (le corps contient csv), et POST .../import (le corps contient blocks, les lignes choisies, et private_note).
Une ligne pour le propre domaine de ce serveur est ignorée (own_domain), et une action de domaine sur lui est refusée.
Dans le client web, ouvrez Modération → Actions de domaine et choisissez « CSV de Mastodon » (/moderation/domain-actions/import) : « Enregistrer en CSV » enregistre le fichier, et l’import affiche un aperçu d’un fichier choisi avant d’importer les lignes que vous conservez ; un suspend parmi elles demande d’abord confirmation.
| Ligne CSV | Action sur ce serveur |
|---|---|
#severity vaut suspend (ou est vide) |
suspend |
#severity vaut silence |
limit |
#severity vaut noop |
Aucune |
#reject_media / #reject_reports est vrai |
Ajoute respectivement reject_media / reject_reports |
- Un import se fait en deux étapes. Vérifiez d’abord dans l’aperçu quelles actions chaque ligne émettrait, choisissez les lignes à conserver, puis importez (la CLI ne change rien tant que vous n’ajoutez pas
-apply, et-onlychoisit des lignes par domaine). - Une ligne dont le domaine ou un domaine parent a déjà une action du même type en vigueur n’émet pas ce type (si chaque type est déjà là, c’est « déjà appliqué »). Une seconde ligne pour le même domaine, une ligne invalide et une ligne qui n’émettrait rien (
noopseul) sont aussi ignorées. Importer de nouveau le même CSV n’ajoute pas d’actions. - Un CSV sans en-tête
#domainest lu comme une liste d’un domaine par ligne, et chaque domaine reçoitsuspend(comme Mastodon). Un import accepte jusqu’à 5 000 lignes. - Les actions importées durent « jusqu’à levée » et portent le commentaire public et l’obfuscation de la ligne ainsi que la note privée que vous avez donnée. Elles apparaissent dans le journal d’audit comme les actions émises une à une (l’acteur est la personne pour l’API et
clipour la CLI). - Un export écrit une ligne par domaine pour les actions en vigueur. Un domaine avec un
suspendreçoitsuspend, un domaine avec unlimitreçoitsilence, et un domaine avec aucun des deux reçoitnoop. Un domaine avec seulementforce_sensitive, que les blocages de domaine de Mastodon n’ont pas, n’est pas exporté. Les notes privées et les heures de fin ne sont pas exportées.
S’abonner à des listes de blocage
Section intitulée « S’abonner à des listes de blocage »Au lieu d’importer un CSV à la main, vous pouvez vous abonner à une liste de blocage de domaines qu’un autre serveur ou une autre personne publie à une URL https. Le serveur récupère la liste juste après votre abonnement, chaque jour ensuite, et lorsque vous le demandez, et transforme ses lignes en mesures sur les domaines : soit sous forme de brouillons qu’un modérateur accepte ou rejette (le mode draft, par défaut), soit directement à chaque récupération (le mode automatic).
my admin domain subscription add -format mastodon_csv -title "Shared blocklist" https://lists.example/blocklist.csvmy admin domain subscription listmy admin domain subscription drafts <subscription id>my admin domain subscription accept -keys issue:suspend:spam.example <subscription id>my admin domain subscription reject -all <subscription id>my admin domain subscription update -mode automatic <subscription id>my admin domain subscription fetch <subscription id> # fetch now and print the outcomemy admin domain subscription fetches <subscription id>my admin domain subscription remove [-lift-actions] <subscription id>Dans l’API d’administration : GET et POST /api/v1/admin/domain_list_subscriptions, GET, PATCH et DELETE .../{id} (lift_actions=true lève les mesures de l’abonnement), POST .../{id}/fetch, GET .../{id}/fetches, GET .../{id}/drafts, et POST .../{id}/drafts/accept et .../drafts/reject (le corps contient keys, ou rien pour tous les brouillons). Toutes exigent manage_domains.
Dans le client web, ouvrez Modération → Mesures sur les domaines et choisissez « Abonnements aux listes de blocage » (/moderation/domain-actions/subscriptions). La liste montre le mode et la dernière récupération de chaque abonnement, avec les échecs consécutifs ; « Ajouter un abonnement » ouvre le formulaire du nom, de l’URL, du format et des réglages ci-dessous, et s’abonner ouvre la page de l’abonnement. Cette page a quatre sections : les brouillons, que vous acceptez ou rejetez un par un ou tous ensemble (accepter des brouillons qui suspendent un domaine demande d’abord confirmation) ; les récupérations, avec « Récupérer maintenant » et le résultat de chaque récupération ; les réglages ; et « Se désabonner », qui demande s’il faut lever les mesures émises par l’abonnement. La notification admin_domain_list_failing renvoie vers la liste.
| Format | Ce qu’est la liste |
|---|---|
mastodon_csv |
Le CSV des blocages de domaines de Mastodon, lu comme le lit un import |
mastodon_json |
La réponse de GET /api/v1/instance/domain_blocks d’un serveur Mastodon qui publie ses blocages de domaines. Les domaines qu’il masque (avec *) sont ignorés, et un serveur qui ne publie pas la liste (401, 403, 404) fait échouer la récupération |
plain_text |
Un domaine par ligne, chacun un suspend |
Ce qu’émet une ligne suit le même tableau qu’un import, modifié par les réglages de l’abonnement : suspend_as (suspend, limit ou ignore ; suspend par défaut), silence_as (limit ou ignore ; limit par défaut), si les reject_media et reject_reports de la ligne s’appliquent (les deux par défaut), et si les mesures copient le commentaire public de la ligne (pas par défaut).
- Une récupération passe par la même protection que les récupérations des autres serveurs : une URL, ou une redirection, qui mène à une adresse privée échoue. Elle lit au plus 2 MiB et 5 000 lignes ; une liste plus grande fait échouer la récupération. Le serveur renvoie l’
ETaget leLast-Modifiedde la liste, de sorte qu’une liste inchangée coûte peu, et qu’une liste identique à la dernière lue ne change rien. - Une récupération qui échoue ne change aucune mesure. Elle est enregistrée avec la raison de l’échec (
http_status,network,forbidden_destination,too_large,too_many_entriesoumalformed) et affichée dans la liste des abonnements et leurs récupérations. Après 3 échecs consécutifs, les personnes dont le rôle amanage_domainsreçoivent la notificationadmin_domain_list_failing. - Un abonnement ne lève ni ne remplace jamais une mesure qu’il n’a pas émise. Si une mesure du même type couvre déjà le domaine, sur lui ou sur un domaine parent, quelle que soit la personne qui l’a émise, l’abonnement n’émet rien à cet endroit. Lorsque deux abonnements listent le même domaine, la mesure de celui qui l’a émise en premier est en vigueur ; si celui-ci la lève, le suivant émet la sienne.
- Lorsque la liste retire un domaine, le mode automatique lève, à la récupération suivante, la mesure que l’abonnement a émise dessus. Si une récupération levait plus de 10 mesures et plus de la moitié de celles de l’abonnement, les levées attendent plutôt sous forme de brouillons, puisqu’une liste cassée ou vide ressemble à cela.
- Une gravité que le serveur ne connaît pas (ni
suspend, nisilence, ninoop) attend toujours sous forme de brouillon, comme unsuspendselon les réglages de l’abonnement. - Les brouillons listent ce que la liste ajouterait (
issue) et retirerait (lift), chacun avec une clé telle queissue:suspend:spam.example. Un brouillon rejeté ne revient pas tant que la liste ne change pas la ligne du domaine (unissue) ou que la mesure ne se termine pas (unlift). - Si un modérateur lève une mesure qu’un abonnement a émise, l’abonnement ne la réémet pas tant que la liste ne change pas la ligne du domaine.
- Changer les réglages les applique à la récupération que le changement déclenche. L’URL et le format ne changent pas ; abonnez-vous de nouveau pour les changer.
- Supprimer un abonnement conserve les mesures qu’il a émises, qui comptent alors comme celles d’un modérateur, sauf si vous les levez avec lui.
- Le journal d’audit enregistre l’abonnement, la modification, la suppression, les brouillons acceptés et rejetés, et les récupérations demandées à la main. Les mesures du mode automatique sont enregistrées comme les autres mesures sur les domaines avec
systemcomme acteur, et sont envoyées aux webhooks sousdomain_moderation_action.createdet.lifted, dont ledatacontient lesubscription_id.
Abonnements rompus
Section intitulée « Abonnements rompus »Un suspend de domaine et un suspend de compte distant coupent les abonnements entre les utilisateurs locaux et les comptes suspendus dans les deux sens.
- Pour un
suspendde domaine, une tâche (moderation.sever_domain) qui s’exécute après l’enregistrement de la mesure les coupe un utilisateur local à la fois. Tant que la tâche n’est pas terminée, les abonnements apparaissent encore dans les listes. Les comptes des sous-domaines sont aussi coupés. - Pour un
suspendde compte distant, les abonnements sont coupés dans la transaction qui enregistre la mesure. Un secondsuspendd’un compte déjà suspendu ne coupe rien. - Chaque utilisateur qui a perdu des abonnements approuvés reçoit une notification (
relationships_severed) qui indique combien d’abonnés et d’abonnements ont été perdus. Un utilisateur qui n’a perdu que des demandes d’abonnement n’en reçoit aucune. - Lever la mesure ne rétablit pas les abonnements coupés. Les utilisateurs se réabonnent.
- Traiter à nouveau la même mesure (par exemple lorsqu’une tâche se réexécute) n’ajoute ni enregistrements de relations rompues ni notifications.
Fédérer uniquement avec des serveurs autorisés
Section intitulée « Fédérer uniquement avec des serveurs autorisés »Le paramètre d’instance federation_scope décide avec quels serveurs ce serveur fédère : open (par défaut) fédère avec tout serveur qu’aucune action de domaine ne suspend,
et allowlist uniquement avec les domaines de la liste d’autorisation et leurs sous-domaines, pour une organisation ou un serveur personnel qui ne parle qu’avec des serveurs qu’il connaît.
Tant que federation_scope vaut allowlist :
- Un serveur sans autorisation est traité comme un domaine suspendu : ses livraisons reçoivent
403avant la vérification de leurs signatures, rien ne lui est livré ni n’est récupéré chez lui, et les relais n’apportent rien de lui. - Une autorisation couvre ses sous-domaines : autoriser
friend.exampleautorise aussisocial.friend.example. - Les actions de domaine s’appliquent toujours aux serveurs autorisés : un domaine autorisé avec un
suspendreste suspendu, et un domaine avec unlimitoureject_mediareste limité. - Les GET ActivityPub exigent une signature d’un serveur autorisé, quoi que dise
authorized_fetch, afin qu’un serveur sans autorisation ne puisse pas lire les publications publiques. Les serveurs et robots qui ne signent pas leurs GET reçoivent401. - NodeInfo indique
metadata.federationScope, afin que les autres serveurs puissent le savoir.
Tant qu’il vaut open, la liste d’autorisation ne change rien, et elle est conservée pour la prochaine fois que vous basculez.
my admin domain allow add -comment "partner" friend.examplemy admin domain allow listmy admin domain allow remove friend.examplemy admin federation scope # prints the settingmy admin federation scope allowlist # shows what the switch would end, and changes nothingmy admin federation scope -apply allowlist # switchesmy admin federation scope openDans l’API d’administration : GET /api/v1/admin/domain_allows, POST /api/v1/admin/domain_allows (le corps contient domain et comment ; un domaine déjà autorisé répond 200 et conserve son autorisation), et DELETE /api/v1/admin/domain_allows/{domain}, avec la permission manage_domains.
GET /api/v1/admin/settings/federation_scope/impact compte ce que la bascule mettrait fin, avec la permission manage_settings, et PATCH /api/v1/admin/settings change federation_scope comme tout autre paramètre.
La liste d’autorisation contient au plus 5 000 domaines, et un commentaire, qui n’est jamais publié, au plus 5 000 caractères. Le propre domaine de ce serveur ne peut pas être autorisé.
Passer à allowlist, et retirer une autorisation pendant qu’elle est active, met fin définitivement à des abonnements :
- Avant de basculer, lisez combien d’abonnements approuvés entre les utilisateurs locaux et les serveurs sans autorisation la bascule mettrait fin, combien d’utilisateurs locaux en perdent un, et les serveurs qui en ont le plus (l’impact ci-dessus, ou
my admin federation scope allowlistsans-apply). - La bascule coupe les abonnements avec chaque serveur que la liste d’autorisation n’autorise pas, dans les deux sens et sans en informer ces serveurs, comme le fait un
suspendde domaine : un job (moderation.sever_allowlist) les coupe un utilisateur local à la fois, et chaque utilisateur qui a perdu des abonnements approuvés reçoit une notification (relationships_severed) avec les nombres. - Retirer une autorisation alors que
federation_scopevautallowlistcoupe de la même façon les abonnements avec les comptes de ce domaine et de ses sous-domaines qu’aucune autre autorisation ne couvre. Retirer l’autorisation d’un sous-domaine dont le domaine parent est autorisé ne coupe rien. - Revenir à
open, ou autoriser de nouveau le domaine, ne ramène pas les abonnements coupés. Les utilisateurs suivent de nouveau. - Définir
allowlistalors qu’il vaut déjàallowlistne coupe rien de plus.
Dans le client web, ouvrez Modération → Actions de domaine et choisissez « Domaines autorisés » (/moderation/domain-actions/allowed) pour lire,
ajouter et retirer des autorisations ; en retirer une demande d’abord confirmation, puisque cela coupe le domaine tant que federation_scope vaut allowlist. Le
paramètre lui-même est « Serveurs » sur la page Fédération des paramètres du serveur (/admin/settings/federation, avec la
permission manage_settings) : choisir « Serveurs autorisés uniquement » et enregistrer affiche les abonnements que la bascule mettrait fin, les comptes
locaux qui en perdent un, et les serveurs qui en ont le plus, et n’enregistre qu’une fois que vous avez confirmé.
L’ajout et le retrait d’une autorisation figurent dans le journal d’audit (domain_allow_added et domain_allow_removed), et la bascule est le setting_changed de federation_scope.
Publier les domaines sur lesquels vous agissez
Section intitulée « Publier les domaines sur lesquels vous agissez »Vous pouvez publier les actions limit et suspend en vigueur par GET /api/v1/instance/domain_actions.
Le paramètre d’instance domain_actions_visibility (off / signed_in / everyone, off par défaut) décide qui voit la liste, et
domain_actions_rationale_visibility (les mêmes valeurs, off par défaut) décide qui voit les commentaires publics (paramètres de l’instance).
my instance set domain_actions_visibility signed_inmy instance set domain_actions_rationale_visibility signed_in- Avec
off, l’API renvoie404, et avecsigned_inelle renvoie401à une requête sans jeton d’accès. - Il y a une entrée par action, des plus récentes aux plus anciennes. Une entrée contient le domaine, le SHA-256 du domaine (hexadécimal) et le type, et le commentaire public pour les personnes autorisées à le voir. Les notes privées ne sont jamais renvoyées.
- Pour une action avec
-obfuscate(obfuscate), la moitié centrale des caractères du domaine (hors points) est remplacée par*(bad.exampledevientbad.*****le). Quiconque peut comparer le SHA-256 d’un domaine qu’il connaît pour vérifier s’il s’agit d’un domaine obfusqué. - Les actions
reject_media,reject_reportsetforce_sensitive, et les actions levées ou expirées, ne sont pas publiées. - La page d’information de l’instance du client web (
https://<host>/about) affiche cette liste selon les mêmes paramètres. Avecoff, la section n’est pas affichée, et avecsigned_in, les personnes non connectées voient une note indiquant que seuls les utilisateurs connectés peuvent la voir.
Récupérer à nouveau les publications distantes
Section intitulée « Récupérer à nouveau les publications distantes »Vous pouvez récupérer à nouveau depuis l’autre serveur les publications distantes stockées. Une récupération n’a lieu que lorsque vous la demandez via l’API d’administration, la CLI ou le client web, jamais périodiquement.
my admin refetch status <post ID or URI>my admin refetch account @bob@remote.examplemy admin refetch domain remote.exampleDans l’API d’administration : POST /api/v1/admin/statuses/{id}/refetch, POST /api/v1/admin/accounts/{id}/refetch_statuses et POST /api/v1/admin/instances/{domain}/refetch_statuses. Elles exigent la permission manage_domains. Dans le client web, utilisez « Récupérer à nouveau les publications » sur la page d’examen du compte (/moderation/accounts/{id}, comptes distants) et sur l’écran du serveur distant (/moderation/instances/{domain}).
- Une publication est traitée comme un
Updatereçu. S’il existe une version plus récente, le serveur ajoute une version ; il met à jour les décomptes de votes des sondages ; et il ne fait rien si rien n’a changé. Une publication pour laquelle l’autre serveur renvoie 410 Gone ou unTombstoneest supprimée. Une publication qui ne peut pas être récupérée (404 compris) est laissée telle quelle. - Pour un compte, le serveur récupère à nouveau jusqu’à 1 000 de ses publications stockées non supprimées les plus récentes, 100 à la fois, à une minute d’intervalle.
- Pour un domaine, le serveur récupère à nouveau en partant des comptes les plus récents du domaine, jusqu’à 20 des publications les plus récentes par compte et jusqu’à 1 000 publications au total, 5 comptes à la fois, à une minute d’intervalle.
- Il ne récupère rien depuis un domaine soumis à un
suspend, ni depuis un domaineunavailableparce que des livraisons ont échoué. Un échec de récupération de la même URI est mémorisé pendant 1 heure, et une nouvelle récupération pendant ce délai ne la récupère pas. - Votre demande est consignée dans le journal d’audit sous
status_refetch_queued,account_statuses_refetch_queuedoudomain_statuses_refetch_queued.
Vérifier ce qui a atteint un serveur distant
Section intitulée « Vérifier ce qui a atteint un serveur distant »Lorsqu’un utilisateur demande si une publication, un abonnement ou une acceptation a atteint un autre serveur, listez les livraisons vers ce serveur avec l’API d’administration.
Elle affiche chaque livraison d’une activité vers une boîte de réception du serveur, des plus récentes aux plus anciennes, avec chaque tentative et ce que le serveur a répondu, y compris les livraisons réussies.
Elle exige la permission manage_domains.
Dans le client web, la section Livraisons de l’écran du serveur distant (/moderation/instances/{domain}) affiche la même liste, avec ses filtres par ID d’activité et Compte local, et Afficher pour chaque champ masqué sous Détails d’une livraison masquée ; l’écran indique lesquels sont enregistrés dans le journal d’audit avant leur exécution.
La liste Serveurs distants n’affiche que les serveurs que les livraisons n’ont pas pu atteindre. Pour ouvrir tout autre serveur, saisissez son domaine, un identifiant sur lui ou une URL sur lui dans Ouvrir un serveur au-dessus de la liste,
ou utilisez Ouvrir le serveur du compte sur la page Examen d’un compte distant ou sur un signalement concernant un compte distant, ou le domaine dans une entrée du journal d’audit concernant un domaine.
curl -H "Authorization: Bearer $TOKEN" \ "https://example.com/api/v1/admin/instances/misskey.io/deliveries"- Chaque livraison a le type d’activité (
Create,Follow,Accept, etc.), la date d’enregistrement de l’activité et la date d’ajout de la boîte de réception, et sesattempts, des plus anciennes aux plus récentes. Chaque tentative a sonoutcome(succeeded,retryable_failure,permanent_failure,skipped), lesignature_schemeet lestatus_codede la réponse, l’errord’un échec sans réponse ou la raison pour laquelle rien n’a été envoyé, et l’heure. Une tentativesucceededavec202signifie que l’autre serveur a accepté l’activité ; qu’il l’affiche ensuite dépend de ce serveur. - Les tentatives sont conservées 30 jours ; l’historique remonte donc à 30 jours.
- Pour restreindre la liste, ajoutez
activity_uri=<the activity's ID>, ouaccount_id=<a local account's ID>pour les livraisons d’un compte. Une requête avecaccount_idest enregistrée dans le journal d’audit sousaccount_deliveries_viewed, avec le compte et le serveur ; les autres requêtes ne sont pas enregistrées. - Le corps de l’activité n’est jamais affiché.
Certaines livraisons sont masquées : leur expéditeur, l’URI de l’activité et la boîte de réception sont omis, et mask en indique la raison.
mask |
L’activité concerne |
|---|---|
private, direct, local |
une publication avec cette visibilité |
approves_followers |
un abonnement, son annulation, une acceptation ou un refus d’un compte local qui approuve ses abonnés |
unknown |
une publication ou un compte qui a disparu, de sorte que ce que c’était n’est plus connu |
Une boîte de réception partagée ne nomme aucun destinataire et est toujours affichée ; une boîte de réception personnelle masquée dans l’erreur d’une tentative se lit [masked].
Le type, les heures et chaque tentative d’une livraison masquée sont affichés ; vous pouvez donc toujours voir si elle a atteint le serveur.
Pour voir les champs masqués d’une livraison, utilisez POST /api/v1/admin/instances/{domain}/deliveries/{id}/reveal ; chaque appel est enregistré dans le journal d’audit sous delivery_revealed avant que quoi que ce soit soit affiché.
Signalements
Section intitulée « Signalements »Les signalements (Flag) reçus d’autres serveurs entrent dans la liste des signalements comme ouverts (open).
my admin report list -state openmy admin report show <report id>my admin report assign <report id> <username>my admin report unassign <report id>my admin report resolve -outcome dismissed <report id>my admin report note <report id> "Same person as an earlier report"my admin report reopen <report id>my admin report forward -comment "Spam account, see the linked posts" <report id>Dans le client web, Modération → Signalements (/moderation/reports) liste les signalements ouverts, les plus récents d’abord, avec qui a déposé chacun, sa catégorie, la date et qui s’en occupe.
Ses filtres (état, catégorie et qui s’en occupe : vous ou personne) et l’ordre (la colonne Déposé : les plus récents ou les plus anciens en attente d’abord) restent dans l’adresse de la page, et Précédent et Suivant parcourent les pages.
La page d’un signalement (/moderation/reports/{id}) affiche son état, sa catégorie, les règles citées (une règle retirée depuis l’indique), qui l’a déposé et qui s’en occupe, s’il est allé au serveur du compte, et combien d’autres signalements et mesures le compte a ;
puis le compte ; le commentaire ; les publications signalées, une publication supprimée avec la date de suppression ; ce qui s’est passé dans le salon de chat vocal ou les modifications de l’événement ; et les notes.
À partir de wide, la page de la liste d’où vous venez se tient à côté. M’assigner et Désassigner, Résoudre (Mesure prise ou Aucune mesure nécessaire) et Rouvrir sont sous son titre, Ajouter une note sous les notes.
Dans l’API d’administration : GET /api/v1/admin/reports (filtre avec state, category et assignee : me, none ou l’ID d’un compte local ; order=oldest liste d’abord le signalement en attente depuis le plus longtemps au lieu du plus récent), GET .../{id}, POST .../{id}/assign_to_self, POST .../{id}/unassign,
POST .../{id}/resolve (corps {"outcome": "actioned" | "dismissed"}), POST .../{id}/notes (corps {"body": "..."}), POST .../{id}/reopen et POST .../{id}/forward (corps {"comment": "..."}, facultatif).
- Une assignation (
assign) ne peut aller qu’à un utilisateur local dont le rôle amanage_reports. Dans l’API d’administration, vous vous assignez vous-même. - Le résultat d’une résolution (
resolve) estactioned(une mesure a été prise contre la cible) oudismissed(aucune mesure n’était nécessaire). Résoudre de nouveau un signalement résolu ne change pas le résultat. - Lorsque vous émettez une mesure à partir d’un signalement (
report_id/-reportde la mesure), le signalement est résolu commeactioneddans la même opération. - Une note (
note) est une note interne que seuls les modérateurs voient, de 2 000 caractères au plus. Elle n’est montrée ni à la cible ni à l’auteur du signalement. Elle ne peut être ni modifiée ni supprimée. - Rouvrir (
reopen) remet un signalement résolu àopen(l’assignation reste). Un signalement ouvert ne peut pas être rouvert (409dans l’API d’administration). - Transférer (
forward, Envoyer à leur serveur… à la fin de la page du signalement, qui demande d’abord confirmation) envoie un signalement concernant un compte d’un autre serveur à ce serveur, comme unFlagde l’acteur de votre instance avec le compte et les publications signalées qui existent encore. Le seul texte qu’il porte est ce que vous écrivez pour les modérateurs de ce serveur lorsque vous le transférez (-comment,commentdans l’API d’administration, ou Texte pour leurs modérateurs sur la page du signalement ; jusqu’à 1 000 caractères, aucun par défaut). Le commentaire de l’auteur du signalement et la note d’un examen externe ne quittent jamais votre serveur de cette façon, et rien sur l’auteur du signalement n’est envoyé. Un signalement que son auteur a choisi de transférer en le déposant est parti aussitôt, avec le commentaire de son auteur. Le transfert fonctionne pour un signalement déposé sur ce serveur, par une personne ou par un examen externe, ouvert ou résolu, qui n’a pas encore été transféré ; un signalement reçu d’un autre serveur ou concernant un salon de chat vocal ou un événement ne peut pas être transféré (409report-not-forwardabledans l’API d’administration, et les détails du signalement n’affichent aucun bouton). Un signalement n’est envoyé qu’une fois : le transférer de nouveau, avec n’importe quel texte, ou transférer un signalement que son auteur avait transféré en le déposant, ne change rien.forwardeddans l’API d’administration indique s’il a été envoyé,forwardablesi vous pouvez l’envoyer maintenant. - Les détails du signalement (
show,GET .../{id}) renvoient les notes, des plus anciennes aux plus récentes, avec le nombre d’autres signalements concernant la cible et le nombre de mesures contre la cible (y compris celles levées et expirées). La liste ne renvoie pas les notes. - Les assignations, résolutions, réouvertures, notes et transferts sont conservés sous forme d’événements (
report_assignments,report_resolutions,report_reopenings,report_notes,report_forwards), etreport_statescontient l’état actuel. - Les modérateurs peuvent traduire les publications signalées et le commentaire de l’auteur du signalement sur la page du signalement, ou avec
POST .../{id}/statuses/{status_id}/translationetPOST .../{id}/comment/translation(corps{"target_language": "en"}). Le texte n’est envoyé à un fournisseur de traduction que tant que le paramètre d’instancetranslation_reports_to_serverest activé, et alors uniquement à un fournisseur autorisé pour la visibilité de la publication : l’accès d’un modérateur n’élargit rien ; une publication directe ne va donc qu’à un fournisseur autorisé pourdirect, et le commentaire compte commeprivate. La traduction du commentaire n’est pas conservée, pas plus que celle d’une publication supprimée, et les caractères ne comptent que dans la limite mensuelle du serveur. La traduction intégrée du navigateur, lorsquetranslation_browserest activé, fonctionne sur les publications signalées quoi que disetranslation_reports_to_server; le commentaire, qui ne nomme aucune langue, n’est traduit que par le serveur. - Un auteur de signalement ne voit de la cible que ce qu’il verrait du compte autrement : tant qu’elle est suspendue ou le bloque, son signalement reste listé sans le compte. Les modérateurs voient toujours toute la cible.
- Un auteur de signalement local reçoit une notification (
report_resolved) à la première résolution. Rouvrir puis résoudre de nouveau n’ajoute aucune notification. Un auteur de signalement peut lister ses propres signalements avecGET /api/v1/reportset ne voit que si chacun est ouvert ou résolu. Le résultat, la mesure prise, la raison donnée à la cible et la personne assignée ne sont pas montrés.
Signalements déposés par un examen externe
Section intitulée « Signalements déposés par un examen externe »Un point de décision qui répond flag dépose un signalement avec l’acteur de votre instance comme auteur. Le signalement l’indique : hook_origin dans l’API d’administration et le webhook report.created, une ligne dans les détails du signalement, et automated dans my admin report show. Son commentaire est la note du plugin, et sa catégorie provient du motif. Il n’est pas transmis lorsqu’il est déposé, et le résoudre ne notifie personne. Lorsque la cible est sur un autre serveur, vous pouvez le transmettre vous-même (forward) : la note du plugin reste sur votre serveur, et seul le texte que vous écrivez part. Annuler la décision laisse le signalement tel quel.
Salons de chat vocal
Section intitulée « Salons de chat vocal »- Un utilisateur local peut signaler un salon de chat vocal ouvert qu’il peut voir (
POST /api/v1/reportsavecvoice_room_id, etaccount_iddéfini sur l’hôte du salon). Le signalement cible l’hôte à ce moment-là et renvoie aux paramètres du salon (nom et description) tels qu’ils étaient alors. Il ne renvoie à aucune publication et n’est jamais transféré à un autre serveur. - Les détails du signalement (
GET /api/v1/admin/reports/{id}) affichent le salon (voice_room) : chaque modification de ses paramètres, qui y a participé et quand cette personne est partie, qui en a été retiré, et comment il s’est terminé. Les enregistrements de qui a participé sont conservés 90 jours après la fin du salon (voice_participants_retention_days) et aussi longtemps qu’un signalement renvoie au salon (conservation des enregistrements). Il n’y a ni enregistrements audio ni discussion textuelle ; ces enregistrements sont donc la seule preuve. - Un titulaire de
manage_reportspeut mettre fin à un salon ouvert pour tous les participants avecPOST /api/v1/admin/voice_rooms/{id}/end(corps{"reason": "..."}, facultatif, jusqu’à 500 caractères). La raison n’est destinée qu’aux modérateurs ; les participants voient seulement que le salon a pris fin. Cela fonctionne aussi lorsque le chat vocal est désactivé, et le journal d’audit enregistrevoice_room_ended. Dans le client web, la page du signalement d’un salon ouvert comporte « Mettre fin au salon », qui demande d’abord confirmation, avec la raison.
Événements
Section intitulée « Événements »- Un utilisateur local peut signaler un événement qu’il peut voir, y compris un événement annulé (
POST /api/v1/reportsavecevent_id, etaccount_iddéfini sur l’organisateur de l’événement). Le signalement cible l’organisateur et renvoie aux paramètres de l’événement (titre, description et lieux) tels que l’auteur du signalement les a vus. Un événement encore en sondage de date peut être signalé et annulé comme n’importe quel autre. Il ne renvoie à aucune publication et n’est jamais transféré à un autre serveur. - Les détails du signalement (
GET /api/v1/admin/reports/{id}) affichent l’événement (event) : sa date, s’il a été annulé et comment, et chaque modification de ses paramètres, des plus anciennes aux plus récentes, avec tous ses lieux, y compris ceux que seuls les participants approuvés voyaient.reported_revision_idest la version que l’auteur du signalement a vue ; un titre ou une adresse modifié après le signalement reste donc sous vos yeux. - Un titulaire de
manage_reportspeut annuler un événement avecPOST /api/v1/admin/events/{id}/cancel(corps{"reason": "..."}, facultatif, jusqu’à 500 caractères). La raison est montrée avec l’annulation à toutes les personnes qui voient l’événement. Les utilisateurs qui ont répondu qu’ils viennent ou peut-être, et les utilisateurs invités, sont notifiés, comme pour l’annulation par l’organisateur lui-même, et le journal d’audit enregistreevent_cancelled. Un événement déjà annulé répond409event-closed. Dans le client web, la page du signalement d’un événement comporte « Annuler l’événement », qui demande d’abord confirmation, avec la raison. - Suspendre ou supprimer l’organisateur annule les événements de l’organisateur qui n’ont pas encore commencé, y compris ceux encore en sondage de date (
gathering.cancel_organized), et notifie leurs participants. Ces annulations ne nomment personne comme auteur de l’annulation, et lever la suspension ne les rétablit pas. Les événements qui ont déjà commencé ne sont pas annulés.
Notifications pour les modérateurs et compteurs en attente
Section intitulée « Notifications pour les modérateurs et compteurs en attente »Les nouveaux signalements, les inscriptions en attente d’approbation et les contestations parviennent aux personnes qui ont la permission sous forme de notifications dans l’application.
| Notification | Quand elle arrive | Qui la reçoit |
|---|---|---|
admin_report |
Lorsque la cible du signalement n’a aucun autre signalement ouvert (un deuxième signalement ou un suivant concernant le même compte ne notifie pas) | Les personnes dont le rôle a manage_reports, sauf l’auteur du signalement et la cible du signalement |
admin_sign_up |
Lorsqu’une inscription démarre en attente d’approbation (mode d’approbation, ou open sur une configuration qui ne peut pas envoyer d’e-mails) |
Les personnes dont le rôle a manage_accounts |
admin_appeal |
Lorsqu’une contestation est faite contre une mesure | Les personnes dont le rôle a manage_accounts, sauf la personne qui a contesté |
admin_custom_emoji_request |
Lorsque la création d’un émoji personnalisé ou le remplacement de son image est demandé | Les personnes dont le rôle a manage_custom_emojis, sauf le demandeur |
admin_error_group |
Lorsque le serveur ou le client web signale une erreur d’un nouveau type, ou qu’un groupe d’erreurs qui avait été résolu se reproduit sur une autre version du serveur | Les personnes dont le rôle a manage_errors |
admin_domain_list_failing |
Lorsque la récupération d’une liste de blocage abonnée échoue pour la troisième fois de suite | Les personnes dont le rôle a manage_domains |
admin_error_grouparrive au plus 10 fois par heure pour tout le serveur. Le reste de l’heure se replie en une seule notification qui indique combien de groupes d’erreurs de plus il y a eu. Un groupe en sourdine ne notifie jamais. Une erreur que le client web signale pour un visiteur non connecté ne notifie qu’une fois que le navigateur d’un utilisateur connecté la signale aussi, et sa récurrence ne notifie personne. Les groupes d’erreurs sont lus et résolus, mis en sourdine ou réactivés parGET /api/v1/admin/error_groupsetPOST /api/v1/admin/error_groups/{id}/resolve(/mute,/unmute), qui exigentmanage_errors.- Qui reçoit une notification est décidé par sa permission au moment où la notification est créée. Une personne qui perd ensuite la permission ne voit plus ce type dans sa liste ni dans son compteur de non lues. Si la permission revient, elle le revoit.
- Chaque type de notification ci-dessus arrive aussi par e-mail, activé par défaut. Chaque personne active ou désactive chaque type dans l’application et par
e-mail sur la page Notifications des paramètres (
/settings/notificationsdans le client web), qui ne liste que les types que son rôle reçoit. Un type désactivé dans l’application n’est pas créé pour elle ; il n’est donc ni envoyé en push ni par e-mail ; les compteurs deGET /api/v1/admin/countsne changent pas, car ils comptent les signalements, les inscriptions et les contestations eux-mêmes. Avec les signalements ouverts, les compteurs renvoient aussi la date de dépôt du plus ancien signalement ouvert (oldest_open_report_filed_at). Le serveur met en file le job d’e-mail dans la transaction qui enregistre la notification, et le job envoie l’e-mail juste après la validation, sans attendre que la notification soit lue. Si la personne a perdu la permission ou désactivé l’e-mail de ce type au moment de l’envoi, ou si son adresse principale n’est pas confirmée ou que ses e-mails sont arrêtés, rien n’est envoyé. L’e-mail ne contient que le type de notification et un lien vers l’écran des notifications, et rien du contenu du signalement ou du compte. Son lien de désabonnement ne désactive que l’e-mail de ce type. Avecmail = none, aucun e-mail n’est envoyé, etsends_emaildansGET /api/v1/instancevautfalse.
GET /api/v1/admin/counts renvoie le nombre de signalements ouverts (open_reports, exige manage_reports), le nombre d’inscriptions en attente d’approbation (pending_registrations) et le nombre de contestations en attente d’examen (pending_appeals) (les deux exigent manage_accounts), le nombre de demandes d’émojis personnalisés en attente d’une décision (pending_custom_emoji_requests, exige manage_custom_emojis), et le nombre de groupes d’erreurs ouverts, nouveaux, régressés ou réactivés (open_error_groups, exige manage_errors).
Les éléments pour lesquels vous n’avez pas la permission ne sont pas renvoyés.
Journal d’audit
Section intitulée « Journal d’audit »Les opérations des modérateurs et des administrateurs sont enregistrées à raison d’une ligne chacune dans le journal d’audit (audit_log_entries) dans la même transaction que l’opération.
Les opérations en échec et celles qui n’ont rien changé ne sont pas enregistrées : lever une mesure déjà levée, résoudre un signalement résolu, assigner à la même personne, retirer une règle déjà retirée, déplacer à la même position, attribuer un rôle que l’utilisateur a déjà, et révoquer un rôle que l’utilisateur n’a pas.
| Type de cible | Opérations |
|---|---|
account |
account_action_issued et account_action_lifted (émettre et lever une mesure contre un compte), account_deletion_canceled (la suppression annulée parce qu’une contestation contre un ban a été annulée), revealed_private_data (adresses IP et adresses e-mail révélées), two_factor_disabled (authentification à deux facteurs retirée), password_reset_link_issued (un lien de réinitialisation du mot de passe émis), email_suppression_lifted (suppression d’e-mail levée), account_moved (un compte local restreint a déménagé vers un compte local ; les restrictions ne sont pas reportées sur la destination, c’est donc à vous de décider de les y appliquer), account_statuses_refetch_queued (nouvelle récupération des publications d’un compte distant), account_deliveries_viewed (les livraisons d’un compte local vers un serveur listées ; le nom de la cible est l’identifiant et le serveur) |
status |
status_refetch_queued (nouvelle récupération d’une publication distante ; le nom de la cible est l’URI de la publication) |
domain |
domain_action_issued et domain_action_lifted (émettre et lever une action de domaine), domain_statuses_refetch_queued (nouvelle récupération des publications des comptes du domaine), instance_marked_available (effacement des échecs d’un serveur), delivery_revealed (l’expéditeur masqué, l’URI de l’activité et la boîte de réception d’une livraison vers le serveur affichés) |
report |
report_assigned, report_unassigned, report_resolved, report_reopened, report_note_added, report_forwarded (assigner, désassigner, résoudre et rouvrir un signalement, ajouter une note, et le transférer) |
user |
registration_approved, registration_rejected (examen de l’inscription) |
setting |
setting_changed (paramètres de l’instance), text_changed (textes de l’instance) |
rule |
rule_added, rule_revised, rule_moved, rule_retired (règles de l’instance) |
role |
role_granted, role_revoked (attribuer et révoquer un rôle pour un utilisateur), role_created, role_updated, role_deleted (créer, modifier et supprimer un rôle) |
appeal |
appeal_upheld, appeal_overturned (examen de la contestation ; l’annuler enregistre aussi account_action_lifted pour la mesure, et account_deletion_canceled pour un ban) |
signup_block |
signup_block_added, signup_block_lifted (ajouter et lever un blocage d’inscription) |
hook_decision |
hook_decision_applied (le serveur a agi sur le verdict d’un examen externe et laissé un état ; l’acteur est le système), hook_decision_overridden (un modérateur a annulé la décision, aussi en annulant sa contestation), hook_appeal_upheld (un modérateur a maintenu la contestation d’une publication refusée, et la décision reste) |
custom_emoji |
custom_emoji_created, custom_emoji_image_replaced, custom_emoji_copied, custom_emoji_updated, custom_emoji_enabled, custom_emoji_disabled, custom_emoji_deleted (enregistrer un émoji personnalisé, remplacer son image, copier un émoji d’un autre serveur, le modifier, l’activer, le désactiver et le supprimer) |
webhook |
webhook_created, webhook_updated, webhook_deleted, webhook_enabled, webhook_disabled, webhook_secret_rotated (créer, modifier, supprimer, activer et désactiver un webhook, et régénérer son secret) |
announcement |
announcement_created, announcement_updated, announcement_published, announcement_withdrawn, announcement_deleted (créer, modifier, publier et retirer une annonce, et supprimer un brouillon) |
invite |
invite_created, invite_revoked (créer et révoquer une invitation ; le nom de la cible est constitué des 4 premiers caractères du code) |
billing_source |
billing_import_queued (un import de facturation a été lancé à la main ; le nom de la cible est le nom du fournisseur) |
cost_item |
cost_item_created, cost_item_relabeled, cost_item_price_revised, cost_item_end_changed, cost_item_deleted (enregistrer un coût, changer son nom et autres, réviser son montant, changer sa date de fin et le supprimer ; le nom de la cible est le nom de l’élément) |
supporter_program |
supporter_program_enabled, supporter_program_disabled (activer et désactiver la facturation ; le nom de la cible est le nom du fournisseur de paiement), et supporter_tips_enabled, supporter_tips_revised, supporter_tips_disabled (activer les pourboires, changer leurs montants et les désactiver ; le nom de la cible est la devise et les montants en unités mineures) |
supporter_plan |
supporter_plan_created, supporter_plan_revised, supporter_plan_retired (créer, modifier et retirer une formule de soutien ; le nom de la cible est le nom de la formule) |
supporter_subscription |
supporter_subscription_ended (un administrateur a mis fin aussitôt à un abonnement ; le nom de la cible est le nom de la formule et l’identifiant de l’utilisateur) |
custom_emoji_request |
custom_emoji_request_submitted, custom_emoji_request_withdrawn, custom_emoji_request_approved, custom_emoji_request_rejected (soumettre, retirer, approuver et rejeter une demande d’émoji personnalisé ; le nom de la cible est le :shortcode:) |
payment_provider |
payment_reconcile_queued (la réconciliation avec le fournisseur de paiement a été lancée à la main ; le nom de la cible est le nom du fournisseur) |
oauth_client |
oauth_client_disabled, oauth_client_enabled (désactiver et réactiver un client OAuth ; le désactiver révoque tous ses jetons ; le nom de la cible est le nom du client et client_id) |
oauth_client_host |
oauth_client_host_denied, oauth_client_host_allowed (refuser et lever le refus d’un hôte de Client ID Metadata Document ; le refuser révoque les jetons des clients de cet hôte ; le nom de la cible est l’hôte) |
instance |
service_closure_announced, service_closure_withdrawn, service_closure_closed, service_closure_delivery_completed (annoncer la fermeture du service ou en changer la date, retirer l’annonce, fermer, et terminer la livraison de la fermeture ; le nom de la cible est service_closure) |
voice_room |
voice_room_ended (un modérateur a mis fin à un salon de chat vocal ouvert ; le nom de la cible est l’ID du salon, puisque le nom disparaît lorsque le compte qui l’a écrit est effacé ; les détails du signalement affichent le nom) |
event |
event_cancelled (un modérateur a annulé un événement ; le nom de la cible est l’ID de l’événement, puisque le titre disparaît lorsque le compte qui l’a écrit est effacé ; les détails du signalement affichent le titre) |
domain_allow |
domain_allow_added, domain_allow_removed (ajouter un domaine à la liste d’autorisation de la fédération et l’en retirer ; voir fédérer uniquement avec des serveurs autorisés ; le nom de la cible est le domaine) |
link_card_domain |
link_card_domain_fetch_stopped, link_card_domain_images_stopped, link_card_domain_rule_removed (définir une règle de l’outil de récupération des cartes de lien sur un domaine, et la retirer ; voir domaines de cartes de lien) |
login_provider |
login_provider_created, login_provider_updated, login_provider_deleted, login_provider_enabled, login_provider_disabled, login_provider_secret_rotated (ajouter, modifier, supprimer, activer et désactiver un fournisseur de connexion externe, et remplacer son secret client ; le nom de la cible est le nom d’affichage du fournisseur) |
domain_list_subscription |
domain_list_subscription_created, domain_list_subscription_updated, domain_list_subscription_deleted (s’abonner à une liste de blocage, changer ses paramètres et la retirer), domain_list_draft_accepted et domain_list_draft_rejected (accepter un brouillon, ce qui enregistre aussi l’action de domaine, et en rejeter un), domain_list_fetch_queued (une récupération demandée à la main) ; le nom de la cible est le titre de l’abonnement ; voir s’abonner à des listes de blocage |
La liste indique si la cible existe encore. Les comptes, signalements, contestations et blocages d’inscription qui ont disparu après leur période de conservation, les autorisations retirées, ainsi que les rôles, émojis personnalisés et webhooks supprimés, n’affichent que le nom au moment de l’enregistrement et aucun lien vers un écran.
my admin audit listmy admin audit list -actor alice -action domain_action_issuedmy admin audit list -target-kind domain -target-id spam.exampleDans l’API d’administration : GET /api/v1/admin/audit_log (filtre avec actor_account_id, action, target_kind et target_id). Elle exige la permission view_audit.
Dans le client web, ouvrez Modération → Journal d’audit (/moderation/audit-log) : chaque entrée se lit comme une phrase de qui a fait quoi à quoi, des plus récentes aux plus anciennes, la personne et la cible liées à leurs écrans.
Filtrez-le par qui l’a fait (vous, ou la personne d’une entrée via « Ses autres opérations »), par type de cible puis d’opération, et par une cible (« Autres opérations sur ceci » d’une entrée).
- Une ligne est l’acteur (l’utilisateur pour
user, ouclipour la CLI), l’opération, le type et l’ID de la cible, le nom d’affichage de la cible, l’ID de l’enregistrement d’origine et l’heure. L’ID de la cible est l’ID du compte, du signalement, de la contestation, de l’utilisateur, de la règle, du rôle ou du blocage d’inscription ; pour une action de domaine, c’est le domaine ; pour les paramètres et les textes, c’est la clé. - Le nom d’affichage de la cible (
@alice,@bob@example.com, un domaine, une clé de paramètre, le texte d’une règle ; pour un texte sa clé, pour un rôle sa clé et l’identifiant de l’utilisateur, pour un blocage d’inscription son type et sa valeur) est une copie prise au moment de l’enregistrement, et reste donc lisible après la disparition de la cible. Chaque ligne de l’API renvoie aussi si la cible existe encore (target_exists), qui vautfalsepour les comptes, signalements, contestations et blocages d’inscription disparus. Le journal d’audit web n’affiche que le nom d’affichage, sans lien, pour une cible disparue. - Le texte des motifs et des notes n’est pas copié. Retrouvez-le par l’ID de l’enregistrement d’origine (la mesure, l’assignation, la résolution, la réouverture, la note, l’examen, ou la version d’un paramètre ou d’une règle).
- La liste va des plus récentes aux plus anciennes, avec une pagination par clé (
-before <entry id>dans la CLI). - Il n’existe ni API ni CLI pour modifier ou supprimer le journal d’audit. Les anciennes lignes sont supprimées après la période de conservation.
Conservation des enregistrements et conservations obligatoires
Section intitulée « Conservation des enregistrements et conservations obligatoires »Après la durée de conservation de chaque type d’enregistrement, des tâches horaires (moderation.purge_records, identity.purge_origins, voice.purge_records et gathering.purge_records) retirent les enregistrements de modération.
Vous pouvez modifier les durées dans les paramètres d’instance, mais pas en dessous de la limite inférieure (paramètres de l’instance). Une durée modifiée prend effet à partir de la prochaine exécution. Une conservation obligatoire levée, avec son motif, est retirée une fois que la durée de conservation des mesures de modération s’est écoulée depuis sa levée.
| Enregistrement | Paramètre | Valeur par défaut | Limite inférieure | Point de départ |
|---|---|---|---|---|
| Adresse IP et User-Agent de connexion | session_origins_retention_days |
180 jours | 90 jours | La connexion |
| Adresse IP d’inscription | registration_origins_retention_days |
180 jours | 90 jours | L’inscription |
| Signalements (commentaire, publications visées, notes, attributions, résolutions, réouvertures) | reports_retention_days |
365 jours | 180 jours | La dernière résolution |
| Mesures contre des comptes (motif, note, publications visées, levée) et contestations | moderation_actions_retention_days |
365 jours | 180 jours | La fin de la mesure |
| Journal d’audit | audit_log_retention_days |
730 jours | 365 jours | L’enregistrement |
| Blocages d’inscription | Aucun (ne peut pas être modifié) | 30 jours | s. o. | La première des deux dates entre la levée et l’expiration |
| Qui a participé à un salon de chat vocal (participations, intervenants et auditeurs, mains levées, invitations, retraits) | voice_participants_retention_days |
90 jours | 30 jours | La fin du salon |
| Les décisions des hooks de décision | hook_decisions_retention_days |
90 jours | 30 jours | La décision |
| Les réponses, approbations, invitations et votes sur les dates candidates d’un événement | event_records_retention_days |
90 jours | 30 jours | La première des deux dates entre la fin de l’événement (pour un événement dont la date n’a jamais été fixée, la fin de sa dernière date candidate) et son annulation |
- Les signalements ouverts ne sont jamais retirés. Un signalement auquel une mesure fait référence (
report_idde la mesure) reste jusqu’à ce que cette mesure soit retirée. - La fin d’une mesure est la première des deux dates entre la levée et l’expiration. Pour une mesure qui a fait l’objet d’une contestation, si l’examen survient après cela, la fin est le moment de l’examen, et la mesure est conservée tant que la contestation attend son examen.
warnetdelete_statusesn’ont aucun effet durable ; leur fin est donc le moment où elles ont été émises. Une mesure sans fin (unban, unsuspendsans heure de fin, etc.) n’est retirée que lorsqu’elle est levée. - Les publications auxquelles un signalement ou une mesure fait référence ne sont pas physiquement supprimées par la tâche de purge, avec leurs médias joints, tant que ce signalement ou cette mesure n’est pas retiré, même si l’auteur les a supprimées (elles disparaissent de la vue). Les publications distantes restent aussi au-delà de la durée de conservation (y compris le paramètre d’instance
remote_status_max_retention_days). - Un blocage d’inscription qui n’a ni levée ni heure de fin reste aussi longtemps qu’il est en vigueur.
- Les enregistrements de qui a participé à un salon de chat vocal visé par un signalement restent jusqu’à ce que ce signalement soit retiré. Le salon lui-même (son nom, sa description, ses hôtes et la manière dont il s’est terminé) n’est jamais retiré.
- Les réponses, votes et invitations d’un événement visé par un signalement restent jusqu’à ce que ce signalement soit retiré, tout comme ceux qui nomment un compte sous conservation obligatoire. L’événement lui-même (ses réglages et lieux, sa date et ses dates candidates, ses co-organisateurs et son annulation) n’est jamais retiré ; une fois ses réponses disparues, il ne compte plus personne comme participant.
- Une exécution de tâche ne retire qu’un nombre limité de lignes par type (100 à la fois, 20 fois, pour les mesures, les signalements et les blocages d’inscription ; 1 000 lignes à la fois, 20 fois, pour le journal d’audit). L’exécution suivante retire le reste.
Conservations obligatoires
Section intitulée « Conservations obligatoires »Tant qu’une ordonnance judiciaire interdit l’effacement (loi japonaise sur les plateformes de diffusion d’informations, article 16) ou qu’une demande de divulgation est en cours de traitement, vous pouvez arrêter l’effacement par compte.
my admin retention hold -reason "court order 2026-123" @alicemy admin retention list -account @alicemy admin retention release <hold id>- Pour un compte soumis à une conservation obligatoire, ses mesures et contestations, les signalements le concernant et ceux qu’il a faits, les journaux d’audit correspondants, les adresses IP de connexion et d’inscription, ses publications, et les enregistrements des salons de chat vocal auxquels il a participé ou dans lesquels il a agi ne sont pas supprimés après la durée de conservation. Un blocage d’inscription créé à partir du bannissement de ce compte est aussi conservé au-delà de 30 jours après la levée ou l’expiration.
- Vous pouvez placer plusieurs conservations obligatoires sur un même compte. Lorsque vous les levez toutes, les enregistrements dont la durée est dépassée sont supprimés à l’exécution suivante. Lever une conservation déjà levée ne change rien.
- Les conservations obligatoires et leur levée ne se font qu’avec la CLI, et l’acteur dans l’enregistrement est la CLI.
- Les données d’un compte supprimé (un compte dont le
bana atteint sa date, un compte que l’utilisateur a supprimé, ou un compte distant que son serveur a supprimé) sont effacées 7 jours après la suppression par la tâche horaireaccount.erase_deleted. Les publications d’un compte distant partent aussi, y compris celles que des utilisateurs locaux ont mises en marque-page ou auxquelles ils ont répondu. Un compte distant qui a été marqué comme supprimé uniquement parce qu’une récupération a répondu410 Gone, sans son propreDeletesigné, est d’abord récupéré une fois de plus. Un second410l’efface. Si son serveur le sert de nouveau, il revient avec ses publications, et rien n’est effacé. Toute autre réponse (404, ou aucune réponse) attend une exécution ultérieure, et 30 jours après la suppression le compte est effacé de toute façon. Un compte soumis à une conservation obligatoire n’est pas effacé. Les publications vers lesquelles un signalement ou une mesure renvoie restent jusqu’à la suppression de cet enregistrement. L’URI et le nom d’utilisateur du compte ainsi que les enregistrements de mesures subsistent. Les noms et descriptions que le compte a donnés à ses salons de chat vocal sont vidés ; les salons restent.
Exporter pour les demandes de divulgation
Section intitulée « Exporter pour les demandes de divulgation »Pour une demande de divulgation (RGPD, article 15 ; loi japonaise sur la protection des informations personnelles, article 33), répondez en exportant en JSON tous les enregistrements de modération d’un compte.
my admin account export-moderation @alice > alice-moderation.json- L’export contient les mesures contre le compte (y compris les notes privées, la levée, les contestations et les examens), les signalements concernant le compte (commentaire, publications visées, règles citées, notes des modérateurs, attributions, résolutions, réouvertures), les signalements faits par le compte (seulement si chacun est ouvert ou résolu), et les journaux d’audit correspondants.
- L’identité des auteurs de signalements (le compte qui signale, et l’URI et le serveur d’origine d’un signalement reçu) n’est pas exportée. Avant de remettre l’export, vérifiez que le commentaire d’un signalement ne dit rien qui identifie l’auteur du signalement.
- Un modérateur est exporté par ID d’utilisateur. Placez d’abord une conservation obligatoire afin que les enregistrements ne soient pas supprimés pendant que vous traitez la demande.
Pour les LLM et les agents de programmation :llms.txt,llms-full.txt, llms-small.txt