Glossary
用語集/ Glossary
本文で用いた技術用語と、稼働中のサービス名を一覧にしました。技術は正式名のまま、平易な説明を添えています。
技術用語Terms
ウイルススキャンMalware Scanning
アップロードされたファイルを検査し、安全と確定したものだけを流通させる仕組み。
ClamAV
オープンソース(GPLv2)のアンチウイルスエンジン。Cisco の Talos が検出定義を管理。clamav.net(新しいタブで開きます) / docs(新しいタブで開きます)
clamd
ClamAV の常駐スキャンデーモン。ファイルをストリームで受け取り検査する。
freshclam
ClamAV 標準の定義更新ツール。本プロジェクトではデーモンとしては使わず、自前のミラー経由で更新。
cvdupdate
ClamAV 公式の定義取得ツール。CDN 作法を守って取得し、ミラー更新ジョブに同梱。
シグネチャSignature
既知の脅威の特徴一覧(検出定義)。
main.cvd / daily.cvd / bytecode.cvd の 3 ファイル。INSTREAM
clamd にファイルをストリームとして流し込んで検査するコマンド。ディスクに保存せず読みながら検査する。EICAR
アンチウイルスの動作確認用に業界標準化された無害なテストファイル。すべてのアンチウイルスが検出する約束。eicar.org(新しいタブで開きます)
検証不能skipped
暗号化・上限超過などで中身を確認できないファイルの終端状態。危険と断定はできないが、受信者へは渡さず止める。
Eventarc
Cloud Storage へのファイル到着などのイベントを検知し、指定した送信先へ配送する仕組み。
Pub/Sub
サービス間でメッセージを配送する仕組み。1 つの合図を複数の受け手に配れる。
Cloud Run
コンテナを実行するサーバーレス基盤。リクエストやイベントに応じて自動で起動・拡張する。
Cloud StorageGCS
ファイル(オブジェクト)を保管するサービス。バケットという入れ物の単位で管理する。
Cloud Scheduler
決まった間隔で処理を起動する仕組み(いわゆる cron)。定義更新や月次テストの起動に使用。
OIDC
呼び出し元が正当かを、署名されたトークンで検証する認証方式。到着イベントの受信で使用。
署名付き URLSigned URL
時間を区切ってファイルの受け渡しを許可する短命の URL。隔離ファイルの取り出しは短時間だけ有効。
RLSRow Level Security
行単位で「誰がどの行を読めるか」をデータベース自身が強制する仕組み。「検査済み以外は見せない」を担保。
冪等Idempotent
同じ操作が複数回実行されても、結果が 1 回分になる性質。重複配信への備え。
at-least-once
メッセージが少なくとも 1 回は届く配送保証。裏返すと「重複して届くことがある」。
rewrite
バケット間でファイルを移す操作(コピーしてから元を削除)。検査済み/隔離への振り分けで使用。
impersonation
別のサービスアカウントの権限を一時的に借りること。隔離ファイルの取り出し署名で使用。
稼働リソース名Running Resources
matsuba-scanner
検査を行う Cloud Run サービス。ClamAV を同梱し、検査・振り分け・シグネチャ更新を担う。
未検査バケット
アップロードされたファイルが最初に着地する場所。
検査済みバケット
clean と確定したファイルを置き、利用者に開放する。
隔離バケット
感染したファイルを保管する。管理者の取り出し・恒久削除の対象。
ミラーバケット
シグネチャのミラー。取得ジョブが定義を置き、検査サービスがそこから受け取る。
scanner の実行 SA
matsuba-scanner の実行サービスアカウント。バケットの読み書きと結果の publish を行う。隔離読取専用 SA
隔離バケットの読み取り専用サービスアカウント。通常は誰にも紐付けず、取り出し時だけ借りる。
clamav-mirror-updater
シグネチャを取得してミラーへ置くジョブ。6 時間ごとに起動。
clamav-eicar-test
EICAR を投入して検出できることを確認する月次ジョブ。