コンテンツにスキップ

このページは英語のページを機械翻訳したものです。内容は英語のページが正です。 英語のページを読む

判定フック

判定フックは、サーバーが何かを受け入れる前に、受け入れてよいかをあなたのプラグインに問い合わせます。プラグインは決められた一覧の中から判定を返します。プラグインが何かを書き換えることはなく、アカウントに対して措置をとることもありません。できるのはせいぜい、1 件の投稿、フォロー、登録、アップロード、プロフィールの変更を止めることか、モデレーターのために通報を起こすことだけです。アカウントをどうするかは人が決めます。

既定では何も審査されません。フックのアドレスがないサーバーは呼び出しを行わず、そのために時間を使うこともありません。このバージョンには、ここで説明する記録、モード、管理画面があります。受け入れの経路のうち、ほかのサーバーからの投稿は inbound.status に、ほかのサーバーからのフォローは inbound.follow に、登録は signup.check に、アップロードは media.check に、ローカルアカウントの投稿は local.status に、ほかのサーバーのアカウントのプロフィールは inbound.actor に、ローカルアカウントのプロフィールの変更は local.profile に問い合わせます。ほかのフックはまだ呼び出されません。

判定フックの経路。リモートの投稿、リモートのフォロー、登録、アップロード、ローカルの投稿、またはリモートのアクターの変更されたプロフィールが、フックのモードを通ってあなたのプラグインに届き、その判定または失敗から、記録される 1 つの決定が生まれます。下の一覧が各段階を説明しています。

図の上から順に説明します。

  1. 何を審査し、誰が待つか。 ほかのサーバーからの投稿(inbound.status)、ほかのサーバーからのフォロー(inbound.follow)、アップロード(media.check)はジョブの中で審査されます。登録(signup.check)は申請者が待つ間に、ローカルアカウントの投稿(local.status)は投稿者が待つ間に、ローカルアカウントのプロフィールの変更(local.profile)はその持ち主が待つ間に審査されます。ほかのサーバーのプロフィール(inbound.actor)は、サーバーがそのアカウントを取得するところならどこでも審査されます。ジョブの中のほか、このサーバーにとって新しいアカウントがいるサーバーからのリクエストのように、リクエストが待つ間にも審査されます。
  2. モード、hook_<hook>_mode: off は呼び出しを行わず、observe は判定を記録して何も実行せず、enforce は判定どおりに実行します(モード)。
  3. あなたのプラグインは POST /my.plugin.hook.v1.HookService/Check を受け取ります。サーバーは最長 plugin_<hook>_timeout まで待ち、同時に行う呼び出しは最大 8 件で、5 回続けて失敗すると 30 秒間プラグインを飛ばします(breaker_open)。
  4. 判定: allow は対象を受け入れ、flag は受け入れて通報を起こし、mark_sensitive はセンシティブとして受け入れ、require_approval は登録を保留し、drop と reject は対象を止めて何も保存しません(登録の reject は hook_signup_check_reject を有効にしたときだけ)。失敗は timeout、error、invalid な応答、または breaker_open で、フックが受け付けない応答も失敗として数えます。フックが実行するとき、hook_<hook>_on_failure で扱いが決まります。pass は対象を審査せずに受け入れ、retry は決定を記録せずにジョブをもう一度実行し、require_approval は登録を保留します(プラグインが失敗したとき)。
  5. フックと対象の組ごとに 1 つの決定が記録され、もう一度実行されたジョブはプラグインを呼び出さずにその決定を読みます(決定の記録)。
フック 審査するもの 返せる判定 プラグインが失敗したとき
inbound.status ほかのサーバーからの投稿 allow、drop、flag、mark_sensitive pass(既定)または retry
inbound.follow ほかのサーバーからのフォロー allow、drop、flag pass(既定)または retry
signup.check CAPTCHA とブロックリストのあとの登録 allow、require_approval、reject pass(既定)または require_approval
media.check 誰かが使えるようになる前の、アップロードされたメディア allow、mark_sensitive、flag、reject pass(既定)または retry
local.status ローカルアカウントの投稿とその編集 allow、flag、reject pass
inbound.actor ほかのサーバーのアカウントのプロフィール(変更されたとき) allow、drop、flag pass(既定)または retry
local.profile ローカルアカウントのプロフィールの変更 allow、flag、reject pass

フックにプラグインを割り当てるには plugin_<hook>_address を設定します。名前のドットは _ になります(plugin_inbound_status_address)。宛先、その認証、my plugin test --kind inbound.status <address> でのプラグインのテストについてはプラグインを参照してください。呼び出しは POST /my.plugin.hook.v1.HookService/Check です。

各判定の働き:

  • drop は対象を止め、何も保存しません。inbound.actor では、以前に保存したプロフィールを保ちます(後述)。誤った drop は投稿をフォロワーからも黙って隠してしまうので、実行する前に observe でフックが何を止めるかを確認してください。
  • flag は対象を通し、決定ごとに 1 件の通報を起こします。inbound.follow では、通報はフォローを送ったアカウントについてのもので、投稿を示さず、フォローが記録された時点で起こされます。通報者、カテゴリー、コメントは投稿の通報と同じです。inbound.actor でも同じように、プロフィールの持ち主のアカウントについての通報になります。
  • mark_sensitive は対象を通し、モデレーターが決定を取り消すまで、その添付をセンシティブとして表示します。
  • require_approval は登録を承認待ちにします。
  • reject は対象を拒否し、プラグインの応答を何も示さない決まった文言を表示します。signup.check では下の設定も必要です。media.check では、元のファイルも含めてアップロードの何も保存しません(後述)。local.status では投稿者が異議を申し立てられます。local.profile ではプロフィールは元のまま残り、異議申し立てはできません(後述)。

応答には、コード化された理由(spam、harassment、sexual、violence、illegal、malware、other)と、モデレーター向けの 200 文字までのメモを付けられます。フックが受け付けない応答は失敗として数えます。

サーバーは、取り込もうとする投稿の Create とその Update のそれぞれについて、何かを保存する前に問い合わせます。リビジョンはそれぞれが独立した対象で、それぞれに決定があります。

  • 投稿について問い合わせるのは、その投稿がローカルアカウントに関係するときだけです。ローカルアカウントが投稿者をフォローしている、ローカルアカウントを名指ししている、またはローカルの投稿と同じスレッドにある、のいずれかです。ローカルアカウントが投稿者をフォローしているかどうかでさらに絞り込むことはありません。プラグインは any_local_follower を受け取り、それを考慮できます。リレーだけが持ち込んだ投稿について問い合わせることはなく、もうローカルアカウントに関係しなくなった保存済みの投稿の Update についても問い合わせません。そのリビジョンは問い合わせなしに保存されます。
  • どのローカルアカウントもフォローしていない投稿者のダイレクトの投稿は、hook_inbound_status_unfollowed_direct を有効にしない限り送られません。あなたのローカルアカウントの投稿は、どの設定でも送られません。
  • 投票への回答、削除、取り消し、いいね、リアクション、ブーストについては問い合わせないので、プラグインを止めても削除が届くのを止めることはできません。スレッドの取得やブーストの取得によって、同じ投稿が別の経路で持ち込まれることはあります。

各判定が投稿に対して行うこと:

  • Create への drop は何も保存せず、通知もタイムラインの項目も作らず、再配送は重複として無視されます。Update への drop はリビジョンを作らず、以前のリビジョンを保ちます。止められた投稿は保存されていないので、直近 1 日以内に公開されたその投稿の Update は新しい投稿として扱われます。プラグインには、ほかのリビジョンと同じようにそのリビジョンについてあらためて問い合わせ、以前の Create への判定は引き継がれません。
  • flag は決定ごとに 1 件の通報を起こします。通報者はあなたのインスタンスアクター、カテゴリーは理由に応じたもの(spam と malware は Spam、illegal は Legal、harassment・sexual・violence は Violation、それ以外は Other)、コメントはプラグインのメモです。通報には、審査によって起こされたことが示されます。モデレーターが転送しない限り、投稿者のサーバーには転送されません。転送してもメモは送られず、送られるのはモデレーターがそのとき書く文章だけです。解決しても誰にも通知されません。決定ごとに通報が起こされるので、スパムが押し寄せるとキューが埋まることがあります。
  • mark_sensitive はリビジョンではなく投稿に印を付けます。印は、モデレーターが決定を取り消すまで、以降のリビジョンにどんな判定が出ても残ります。添付をセンシティブとして表示し、本文はそのままなので、添付のない投稿は見た目が変わらず、ほかのサーバーからは印が見えません。

サーバーは、ローカルアカウントがアップロードする各ファイルについて、添付、アバター、ヘッダー、カスタム絵文字のどの用途でも問い合わせます。問い合わせるのは 1 回だけで、ファイルを最初に処理するとき、使えるようになる前です。そのため、プラグインが判定する間は誰もそのファイルを使えません。あとで同じファイルを別の用途に使うときは、すでにある決定を読みます。リモートのメディアについて問い合わせることはありません。

送るのは、サーバーがそのファイルから作ったいちばん小さな画像で、メタデータを除いたものです。元のファイルは決して送りません。動画や音声のファイルでは、そのポスターか埋め込まれたカバーの小さな画像を送り、それがなければ画像は送りません。あわせて、ファイルの用途、画像・動画・音声のどれか、サイズ、再生時間、動くかどうかを送ります。代替テキストや、アカウントや投稿に関することは送りません。フィールドは HookService プロトコルのメッセージ MediaSubject にあります。

各判定がアップロードに対して行うこと:

  • reject は、サーバーが読めないファイルと同じように処理を失敗させます。アップロードした人にはファイルを処理できなかったことが表示され、投稿に添付することもできません。サーバーは拒否されたファイルを何も保存しません。 判定にかかわらず、処理が終わると元のファイルを削除し、拒否されたファイルには処理済みのものも作りません。そのようなファイルを保全したり誰かに報告したりする必要があるなら、プラグインが応答するときにそれを行ってください。サーバーはファイルを返せません。reject を取り消しても、変わるのはその記録だけです。
  • mark_sensitive は、そのファイルを添付する投稿に、投稿を作るトランザクション(またはファイルを加える編集)の中で印を付けます。印は inbound.status と同じく、モデレーターが決定を取り消すまで残ります。アバター、ヘッダー、絵文字には投稿がないので、決定が記録されるだけです。
  • flag は決定ごとに 1 件の通報を起こし、通報者はあなたのインスタンスアクターです。添付では、ファイルを添付した投稿とともに起こされ、その投稿を示します。投稿されないファイルでは通報は起こされません。アバター、ヘッダー、絵文字では、ファイルの処理時に、アップロードしたアカウントについて起こされます。

処理のジョブは、最長 plugin_media_check_timeout(既定は 10 秒)までプラグインを待ちます。ほかのサーバーからカスタム絵文字を追加するときや、絵文字のリクエストを承認するときは、モデレーターが待つ間に画像を処理するので、その待ち時間はモデレーターのものになります。

signup.check は、登録ページからの登録とログインプロバイダーを通した登録について、CAPTCHA と登録のブロックリストのあとで実行されます。そのため、どちらかが拒否したリクエストがプラグインに届くことはありません。招待コードを使った登録では呼び出されません。送るのは、申請者が入力したメールアドレスとクライアントの IP アドレスです。アカウントはまだ存在しないので、対象のキーはそのアカウントに付くはずの ID で、申請者がもう一度試すと新しい対象になります。

フックが実行するとき、判定はブロックリストと同じように働きます。

  • require_approval は、どの登録モードでも、同じ重さのブロックと同じように、登録を「モデレーション」>「登録の審査」で待たせます。そこで承認または却下してください。決定を取り消しても登録は変わりません。
  • reject は、hook_signup_check_reject(「サーバーの設定」>「外部の審査」、既定では無効)を有効にするまで何もしません。無効の間は、reject は何も止めないので observe として記録され、登録はそのまま進みます。有効にすると、申請者にはブロックのときと同じ決まった文言(「このサーバーでは、この登録を受け付けられません。」)が表示されます。アカウントは書き込まれないので、そのような決定を取り消しても変わるのは記録だけで、申請者はもう一度登録します。

申請者に決定の理由やメモが見えることはありません。

申請者のリクエストは、最長 plugin_signup_check_timeout(既定は 2 秒。人が待っているので短くしてください)までプラグインを待ちます。この待ち時間はデータベースのトランザクションの一部ではありません。ユーザー名がすでに使われているなどの理由であとから失敗した登録も、保持期間によって消されるまで決定が残ります。

ほかのサーバーのプロフィール

Section titled “ほかのサーバーのプロフィール”

inbound.actor は、ほかのサーバーのアカウントのプロフィールを、サーバーがそれを取り込むところで審査します。アカウントを初めて取得するとき、アカウントが自分自身の Update を送ってきたとき、そしてサーバーがアカウントを取得し直すとき(利用者がフォローしているアカウントについては 1 日 1 回行います)です。問い合わせるのは保存済みのものとプロフィールが異なるときだけなので、同じプロフィールのアカウントを取得し直しても呼び出しは行いません。審査するプロフィールは次のとおりです。

  • 表示名(プレーンテキストとして)
  • 自己紹介とプロフィールの項目(サーバーが保存しているとおりの、サニタイズされた HTML として)
  • ほかのサーバー上のアバターとヘッダー画像のアドレス。サーバーは画像を送りません。

プラグインは、アカウントのアドレス、そのサーバー、ユーザー名、そしてそのアカウントがあなたのサーバーにとって新しいかどうかも受け取ります。決定のキーは、アカウントのアドレス、#、プロフィールのダイジェストをつなげたものです。そのため、異なるプロフィールごとに 1 つの決定があり、同じプロフィールがもう一度送られてきたときはその決定を読みます。

各判定の働き:

  • drop は、以前に保存したプロフィールを保ちます。表示名、自己紹介、項目、アバター、ヘッダー、それらのカスタム絵文字は元のまま残ります。受け取ったもののうち残りは、サーバーはそのまま保存します。アカウントの鍵、inbox などのアドレス、ユーザー名、そして鍵アカウントかどうか、ボットかどうか、見つけやすくするかどうか、インデックスを許可するかどうかです。鍵とアドレスがなければ、サーバーはアカウントのアクティビティを検証することも、そこへ配送することもできません。また、鍵アカウントとインデックスの設定は、そのアカウントをどうフォローするかと、持ち主がインデックスを許可しているかを示します。プロフィールが止められている間は、取得し直しても同じ決定を読み、保存済みのプロフィールを保ちます。
  • 初めて取得したアカウントは、フォローやメンションに必要なので常に保存されます。そのため、その drop は flag として扱われ、プロフィールが保存されて通報が起こされます。決定には drop のまま表示されます。
  • flag はプロフィールを保存し、決定ごとにそのアカウントについての通報を 1 件起こします。

プラグインが失敗したとき、pass はプロフィールを審査せずに保存し、サーバーはそれが変わるまで再び問い合わせません。retry では、プラグインが失敗している間にプロフィールが変わったアカウントを、サーバーは保存しません。Update はジョブの中で待ち、inbound.status と同じように、そのアカウントのほかのアクティビティを足止めします。リクエストが待つ間に行う取得は失敗するので、このサーバーにとって新しいアカウントがいるサーバーは、プラグインが戻ってもう一度送るまで配送を拒否されます。

inbound.actor の drop を取り消すと、そのアカウントをサーバーから取得し直します。いま提供されているプロフィールが止められたものと同じならプラグインを呼び出さずに保存し、その後変わっていればそれについて問い合わせます。

local.status は、あなたのサーバーのアカウントの投稿をサーバーが作る前に、またその編集をサーバーが保存する前に審査します。投稿者がプラグインを待つので、待ち時間は短く、plugin_local_status_timeout(既定は 1 秒)です。失敗、タイムアウト、ブレーカーが開いた状態では常に投稿を通し(失敗時の扱いは pass だけです)、この待ち時間はデータベースのトランザクションの一部ではありません。

何をいつ送るか:

  • 送るのは、作られてから hook_local_status_account_age_days(「サーバーの設定」>「外部の審査」、既定は 7 日。0 ならすべてのアカウントの投稿を送ります)より短いアカウントの投稿だけです。スパムの多くは新しいアカウントから来るもので、すでに定着したアカウントの投稿は送りません。
  • public、local、unlisted の投稿だけです。private と direct の投稿は決して送りません。
  • 投稿者が入力したとおりの本文とサーバーが描画した本文、注意書き、言語、センシティブとしての印の有無、画像の説明、投票の選択肢、ハッシュタグ、メンションしているアカウントの数、投稿に付くはずのアドレス、返信先または引用元の投稿(アドレスだけ)、投稿者のアドレスとユーザー名、アカウントが作られた日時。メディアは送りません。
  • 対象のキーは、投稿に付くはずの ID です。同じ Idempotency-Key で投稿を送り直すと、プラグインを呼び出さずに、作られた投稿が返されます。新しく試すと新しい対象になります。
  • 編集も同じように、編集後の投稿を、同じアカウント(hook_local_status_account_age_days の範囲内のもの)について送ります。キーは、投稿の ID、#、新しいリビジョンの ID をつなげたものなので、編集のそれぞれが独立した対象になります。
  • 通話のルームを始めたときの最初の投稿は、このフックを通さずに投稿されます。

フックが実行するとき、reject は投稿を拒否し、何も保存しません。投稿者には決まった文言(「この投稿は公開されませんでした。」)と異議を申し立てる手段が表示され、理由やメモが見えることはありません。flag は投稿を通し、その投稿についての通報を投稿者に対して 1 件起こします。

編集では、reject はその編集だけを拒否します。投稿は元のまま残り、投稿者には決まった文言(「この編集は保存されませんでした。」)が表示されます。投稿は残っていてモデレーターがいつもどおり対応できるので、編集には異議を申し立てられません。flag は編集を保存してその投稿についての通報を起こし、allow は編集を通します。

拒否された投稿の投稿者は、appeal_window_days(モデレーションの措置と同じ期間)の間に、決定ごとに 1 回、異議を申し立てられます。サーバーは投稿を何も保存していないので、異議申し立てには投稿の本文と、モデレーターへの任意のコメントが含まれます。プラグインは呼び出されません。

モデレーター(manage_reports)には、新しい異議申し立てごとに通知が届き(通知設定の「拒否された投稿への異議申し立て」で、メールで受け取ることもできます。通知を開くと異議申し立てが開きます)、異議申し立ては「モデレーション」>「自動審査の記録」>「止められた投稿への異議申し立て」で審査します。各異議申し立ては、投稿者が送った本文とともに専用のページで開きます。

  • 「維持する」は決定をそのままにし、監査ログに hook_appeal_upheld として記録されます。
  • 「撤回する」は、1 つのトランザクションで決定を取り消し(監査ログに hook_decision_overridden として記録されます)、そのアカウントの投稿を local.status に送るのをやめます。拒否された投稿は復元されないので、投稿者がもう一度投稿します。

どちらの場合も、投稿者にはモデレーターからのお知らせの中で結果が通知され、投稿フォームでも拒否の下に結果が表示されます。通知とフォームが伝えるのは決定が維持されたか取り消されたかだけで、理由やメモは伝えません。ファーストパーティのクライアントは、GET /api/v1/hook_decisions/{id}/appeal で異議申し立ての状況を読みます。

撤回された異議申し立てによってフックの対象から外れたアカウントは、削除されるまで対象から外れたままです。あとでそのアカウントが乗っ取られても、local.status はもうそれを審査しません。

local.profile は、あなたのサーバーのアカウントのプロフィールの変更を、サーバーが保存する前に審査します。持ち主がプラグインを待つので、待ち時間は短く、plugin_local_profile_timeout(既定は 1 秒)です。失敗、タイムアウト、ブレーカーが開いた状態では常に変更を通し(失敗時の扱いは pass だけです)、この待ち時間はデータベースのトランザクションの一部ではありません。

何をいつ送るか:

  • 送るのは、作られてから hook_local_profile_account_age_days(「サーバーの設定」>「外部の審査」、既定は 7 日。0 ならすべてのアカウントの変更を送ります)より短いアカウントの変更だけです。
  • フックが見るもの、つまり表示名、自己紹介、プロフィールの項目、アバター、ヘッダーの変更だけです。アカウントを鍵アカウントにするだけの変更や、見つけやすさの設定を変えるだけの変更は送りません。
  • 表示名、入力したとおりの自己紹介とサーバーが描画した自己紹介、プロフィールの各項目の名前と値(入力したとおりのものと描画したもの)、変更がアバターやヘッダーを設定するのか、置き換えるのか、削除するのか、アカウントのアドレスとユーザー名、アカウントが作られた日時。画像は送りません。プロフィールは公開されているので、このフックは平文の TCP を使ってもかまいません。
  • 対象のキーは、アカウントの ID、#、変更によって保存されるはずのプロフィールのリビジョンの ID をつなげたものなので、変更のそれぞれが独立した対象になります。

フックが実行するとき、reject はその変更だけを拒否します。プロフィールは元のまま残り、持ち主には決まった文言(「このプロフィールの変更は保存されませんでした。」)が表示され、理由やメモが見えることはありません。異議申し立てはできませんが、持ち主はプロフィールを変えてもう一度保存できます。flag は変更を保存し、そのアカウントについての通報を 1 件起こします。この通報は投稿を指さず、通報者、カテゴリ、コメントは投稿の通報のものと同じです。

各フックにはモードがあります。これはインスタンスの設定(hook_inbound_status_mode など)で、「サーバーの設定」>「外部の審査」で変更します。モードが off でないときだけ enforce を選べます。変更は監査ログに setting_changed として記録されます。

モード 働き
off 何も呼び出しません。
observe 判定を記録し、何も実行しません。すべてのフックの既定値です。
enforce 判定どおりに実行します。

フックを off から enforce にするには、必ず observe を経由します。

タイムアウト、エラー、不正な応答は、判定としてではなく、それぞれ独自の結果(timeout、error、invalid)として記録されます。5 回続けて呼び出しに失敗すると、サーバーは 30 秒間プラグインを飛ばし、そのあと 1 回だけ呼び出しを試します。そのため、障害の間も対象ごとの待ち時間は生じません。飛ばした呼び出しは breaker_open として記録されます。数はサーバーのプロセスごとに数えます。

そのとき対象がどうなるかは hook_<hook>_on_failure で決まります。

  • pass は対象を審査せずに通します。障害の間にスパムが入り込むことはありますが、それ以外に止まるものはありません。これが既定値です。
  • retry はジョブを失敗させ、決定を記録しません。ジョブはもう一度実行され、プラグインをもう一度呼び出します。1 つのアクターからのジョブは順に実行されるので、その間、そのアクターからのそれ以降のすべてのもの(削除も含みます)が最長でおよそ 4 時間 15 分待ちます。最後の実行のあと、ジョブはデッドジョブになり、ほかのジョブは解放されます。
  • require_approval は登録をモデレーターのために保留します。

media.check では、pass はファイルを審査せずに使える状態にします。retry は、プラグインが応答するか、ジョブが実行回数を使い切るまで、アップロードを処理中のままにします。その間ファイルが使える状態になることはなく、デッドジョブになるとファイルは処理されないまま残り、添付されていないアップロードの後始末で削除されます。このファイルを待つほかのジョブはありません。

各プロセスが 1 つのプラグインに同時に行う呼び出しは最大 8 件で、順番を待つ間にフックの期限を過ぎた呼び出しはタイムアウトとして数えます。待ち時間は my.plugin.slot_wait に表れます(運用)。plugin_inbound_status_timeout は短くしてください。呼び出しが待つ間、同じアクターからのそれ以降のジョブも一緒に待ちます。

observe では、失敗が何かを足止めすることはありません。フックの呼び出しが失敗し続けると、モデレーターにはフックごとに 1 日 1 回通知が届きます。メトリクスは my.hook.decisions、my.hook.failures、my.hook.duration です(運用)。

サーバーはフックと対象の組ごとに 1 つの決定を記録するので、もう一度実行されたジョブはその決定を読み、プラグインを再び呼び出しません。決定には、フック、対象のキー、モード、結果、理由、メモ、呼び出しにかかった時間が含まれます。投稿の本文、メールアドレス、IP アドレスは含まれません。

「モデレーション」>「自動審査の記録」(manage_reports)には、直近 7 日間の件数と待ち時間、そしてフックが止めたもの、observe なら止めていたもの、確認できなかったものが表示されます。各決定は、理由、メモ、待ち時間とともに専用のページで開きます。一覧またはそのページから決定を取り消すと、監査ログに hook_decision_overridden として記録されます。local.status の reject はここでは取り消しません。投稿者が異議を申し立てます。

取り消したときに何が起こるかは判定によります。mark_sensitive は印がなくなり、同じ投稿へのモデレーションの措置による印は残ります。flag は通報が残り、いつもどおり解決します。inbound.status の drop は、サーバーが受け取ったアクティビティを保持している間(7 日間)なら、プラグインに問い合わせずに受け取った投稿をもう一度処理します。それを過ぎると画面にそのことが表示され、取り消しは記録されるだけです。

inbound.follow の drop を取り消すと、サーバーが受け取ったアクティビティを保持している間(7 日間)なら、プラグインを呼び出さずにフォローをもう一度処理します。それを過ぎるとフォローは戻せず、取り消しは記録されるだけです。ほかのサーバーが新しいフォローを送る必要があります。

フォローがフックに問い合わせるのは、新しいフォローまたはフォローリクエストとして記録されるときだけです。フォローの取り消し(Undo)は問い合わせません。サーバーがどのみち拒否するフォローも問い合わせません。連合のモードが拒否するもの、移行したか無効化されたアカウントのもの、インスタンスアクターのもの、互いにブロックしているアカウント同士のもので、これらはいつもどおり拒否されます。すでにあるフォローやリクエストについて送り直されたフォローも問い合わせません。サーバーはいつもどおり応答し、フォローがすでに承認されていればもう一度承認します。止められたフォローには応答がないので、ほかのサーバーではリクエスト中のまま表示され続けます。同じアクティビティを送り直しても重複として無視されます。

自動の効果は、状態を残すときだけ、システムを実行者として監査ログに記録されます。mark_sensitive、起こされた flag、require_approval です(hook_decision_applied)。drop と reject は何も保存しないので、決定の記録にだけ残ります。

ジョブ hook.purge_decisions は、hook_decisions_retention_days 日(既定は 90、最低 30)を過ぎた決定を削除します。ただし、存在する投稿のセンシティブの印の根拠になっている決定、保持の保留の下にあるアカウントの決定、そして local.status による新しい投稿の reject のうち、投稿者がまだ異議を申し立てられるものや、異議申し立てが審査を待っているものは残します。編集の reject には異議を申し立てられないので、保持期間が終われば削除されます。異議申し立ては、その決定とともに削除されます。アカウントを削除すると、その決定、異議申し立て、local.status からの除外も削除されます。

フックにプラグインがあり、off でない間は、情報ページ(/about)に、外部の審査を使っていること、その対象、そこに送るものが表示されます。サーバーはこれをあなたの設定から書きます。hook_local_status_account_age_days と hook_local_profile_account_age_days のアカウントの経過日数(0 ならすべてのアカウントのものが送られること)や、hook_inbound_status_unfollowed_direct が、ここで誰もフォローしていない投稿者のダイレクトの投稿を送るかどうかも含まれます。

呼び出しの数、その費用、送られるデータは、サーバーが受け取る量に応じて増え、とくに inbound.status で顕著です。対象となる投稿のそれぞれが 1 回の呼び出しで、リビジョンのそれぞれがさらに 1 回です。フックを有効にする前に、何を送るかを確認してください。

  • inbound.status と local.status は投稿の本文を送るので、ループバックでも平文の TCP を拒否します。inbound.status は、リモートのサーバーが送ってきたものを送ります。各言語の本文、注意書き、センシティブとしての印の有無、公開日時、投稿のアドレスと URL、返信先の投稿のアドレス、添付のアドレスと説明(メディアは送りません)、投票の選択肢、ハッシュタグ、投稿者と投稿者のサーバー、公開範囲、そして投稿が名指ししているアカウントの数とそのうちローカルのものの数です。ローカルアカウントが投稿者をフォローしているかどうか(any_local_follower)も送り、これはあなたの利用者についてのデータです。フォロワー限定(private)の投稿は公開の投稿と同じように送り、ダイレクトの投稿は前述のとおりです。返信先の投稿については、アドレス以外は何も送りません。local.status はローカルの投稿に挙げたフィールドを送ります。フィールドは HookService プロトコルのメッセージ InboundStatus にあります。
  • signup.check は各申請者のメールアドレスと IP アドレスを送るので、平文の TCP を拒否します。
  • inbound.follow はフォローの当事者 2 人を送ります。
  • inbound.actor は、ほかのサーバーのプロフィールに挙げたとおり、ほかのサーバーのアカウントの公開プロフィールを送り、平文の TCP を使ってもかまいません。そのようなプロフィールが変わるたびに呼び出されるので、量はあなたのサーバーが知っているアカウントの数に比例します。
  • media.check は、各アップロードのいちばん小さな処理済みの画像(元のファイルは決して送りません)と、ファイルの用途、種類、サイズ、長さを送ります。本文を送らないので平文の TCP を使ってもかまいませんが、処理済みの画像にも人が写っていることはあります。
  • local.profile はローカルのプロフィールに挙げた公開プロフィールを送り、画像は送りません。平文の TCP を使ってもかまいません。

LLM とコーディングエージェント向け:llms.txt,llms-full.txt, llms-small.txt

このサイトのアクセス解析