本文へ移動

2026-08-01 時点の資料です。読みやすさのために、一部の文字の色を濃くしています。

松葉 / Matsuba ・ システム管理者向け機能説明資料

管理と運用のしくみ/ Administration & Operations

システム管理者として何を確認でき、何を操作できるか ― 実装済みの機能と、これから実装する機能

松葉は、お取引先との業務ファイル共有をメール添付から Web アプリへ置き換える社内基盤です。この資料は、その管理・運用面 ― システム管理者として何を確認でき、何を操作できるか ― を横断してまとめました。日々の見張りと対応に使う画面、裏側で自動的に動いている処理、異常が起きたときの知らせの流れ、そしてこれから実装される管理機能を、実装状況が分かる形で説明します。

01

この資料についてAbout

この資料の目的は 2 つあります。1 つ目は、管理・運用機能の全体像を共有し、開発と運用の進め方をそろえることです。2 つ目は、機能の全体像を踏まえたうえで追加する機能を検討する材料にすることです。実装の段取りは開発の現在地にまとめてあります。利用者としての基本操作(ファイルの閲覧・アップロードなど)はスコープ外とし、管理者としての機能に絞っています。

本文中のすべての機能記述には、次の 3 種類のバッジが付きます。実装済みの機能と、これから実装する機能を峻別することが本資料の生命線だからです。バッジの無い一般的な説明文は、稼働中の仕組みを指します。

稼働中 本番環境で動いており、いま使えます。 実装中 仕様が確定し、実装作業に入っている段階です。本資料では、アラート一覧画面と、同じ実装のまとまりに入る一部のアラート起票がこの状態です。 実装予定 · Step 4b 設計は済んでおり、実装はこれからです。「· Step 4b」のように実装フェーズ名を添えます。フェーズの全体像は開発の現在地を参照してください。
画面イメージについて: この資料のスクリーンショット枠は、実際の画面を見ながら説明するための目印です。用いる技術は正式名で記し、初出には短い注釈を、末尾の用語集にも一覧を用意しています。稼働中のサービスの名前(例:matsuba-scanner)は、名前と役割を併記します。
02

松葉の全体構成System Map

システム管理者が守る対象の地図です。①誰が使い、②どこで動き、③ファイルがどう保管・検査され、④裏側で何が自動的に走り、⑤管理者はどこから全体を見張るか ― の 5 区画で読めます。それぞれの詳しい中身は、この先の各章で扱います。

図 01 · 松葉の全体構成 — システム管理者が守る対象の地図
① 利用者 — 社内・社外・アカウントを持たない相手社内ユーザGoogle のアカウントでサインイン社外ユーザ(取引先)メール+パスワード または Google共有・提出の相手アカウントなし・URL で受け渡し② 本体 — portal.example.com(共有・提出の受け渡しだけ inbox.portal.example.com)matsuba-web画面(Box・ファイル・管理コンソール)matsuba-api業務処理と権限の判定PostgreSQLデータの保管(Supabase)Row Level Security — データベース側の範囲制限画面の出し分けだけに頼らず、別の Box のデータはデータベース層でも取り出せない③ ファイルの保管と検査 — 検査を通ったものだけが Box に現れる未検査バケット検査前の置き場matsuba-scannerClamAV でウイルス検査検査済みバケット検査済みの保管先 → Box に出現隔離バケット検出されたファイルの隔離先(管理者が対応)matsuba-syncGoogle Drive への片方向ミラー(バックアップ閲覧用)バケットは用途別に全 9 種(アバター・サムネイル・一括ダウンロード・監査ログ退避など)。いずれも非公開で、期限付きの署名付き URL でだけ読み書きできます④ 自動運転と通知 — 決まった時刻の起動とイベント連携Cloud Scheduler決まった時刻に起動matsuba-batch定期バッチ 17 種Pub/Subイベントの仲介Resendメールの配送毎分の通知払い出しから月次の監査ログ退避まで。ほかに Drive 定期補修とウイルス定義の取り寄せが独立のジョブとして毎日動きます(詳細は「自動メンテナンスと長期運用」)⑤ 管理コンソール — システム管理者の持ち場(アプリ内で完結)システム管理者全体を見張り、対応する管理コンソール(稼働中 6 画面 + アラート件数バッジ)スキャンキュー / 隔離 / 通知状況 / Drive 同期 / 管轄外検知 / 共有リンク

色の役割 — Teal:処理を行うサービス / 金茶:利用者・保管・時間もの / 赤:防御と隔離 / 破線:外部サービス。区画③〜④は利用者から見えない裏側ですが、止まると業務に影響するため、管理者が区画⑤から見張れるようになっています。

03

システム管理者の役割The Administrator's Job

松葉におけるシステム管理者の仕事は、次の 5 つに要約できます。それぞれの詳しい機能は各章で説明します。

Five Responsibilities
役割具体的には主に使うもの
① 日々の健全性確認ウイルス検査・Drive 同期・通知配送が正常に流れているかを確認する管理コンソール
② 異常への対応アラートを受けて、再スキャン・隔離対応・再投入・強制失効・再送などを行う管理コンソール / 運用
③ 台帳の管理ユーザと Box の状態を把握し、無効化・復元・オーナー変更などを行うアカウント / 実装予定の画面
④ ポリシー設定保持期間・許可拡張子・サイズ上限・通知テンプレートなど全社の既定値を決める実装予定の画面
⑤ 説明責任「誰がいつ何をしたか」を監査ログから辿り、必要に応じて書き出す記録と監査
持ち場について: 日常運用はアプリ内の管理コンソールで完結する設計です。クラウド側(Google Cloud のコンソールなど)の操作はエンジニアの持ち場で、システム管理者が日常的に触ることは想定していません。本資料でクラウド側の仕組みに触れるのは、裏側で何が動いているかを知ってもらうためと、アプリの外から届く知らせの意味が分かるようにするためです。線引きの詳細は自動メンテナンスと長期運用の「持ち場の線引き」を参照してください。
04

この資料の構成Pages

資料の目次からいつでも移動できます。「アカウントと権限」「データ保護と検査」「管理コンソール」「自動メンテナンスと長期運用」の 4 章が厚めです。

Roadmap

開発の現在地Roadmap

実装フェーズの全体像と「今どこか」。各フェーズが管理面に足すもの。本資料に登場する全機能と実装状態の対応表。

読む
Accounts

アカウントと権限Accounts

社内と社外で分かれた入口。二要素認証と信頼済みデバイス。Box のロールと可視性。招待・参加申請。無効化から 5 年後の完全消去までのライフサイクル。

読む
Guard

データ保護と検査Protection

三層の守り。アップロード全量のウイルス検査と 6 つの状態。隔離ファイルの運用。社外との受け渡しの防御。暗号化とバックアップ、復元演習。

読む
Notify

通知のしくみNotifications

通知の 3 系統と届き方の設定。配送の裏側と、知らせが黙って消えないための見張り。届かないときの自己回復。管理者が編集できるようになるもの。

読む
Audit

記録と監査Audit

何が記録されるか。改ざんできない保管と 2 年 + 退避の保持。Box のアクティビティタブと CSV 出力。管理者の操作も記録されること。

読む
Console

管理コンソール(稼働中)Console

いま使える 6 画面のツアー。スキャンキュー・隔離ファイル・通知状況・Drive 同期管理・Drive 管轄外検知・共有リンク全社一覧。アラート件数バッジと一覧画面。

読む
Next

管理コンソール(実装予定)Console Next

ダッシュボード・ユーザ管理・Box 管理・ファイル管理・保持期間の運用・各種設定。メンテナンスモード。

読む
Ops

自動メンテナンスと長期運用Operations

裏側で自動的に動いているもの。異常に気づく経路と 28 種のアラート。管理者とエンジニアの持ち場の線引き。20 年運用の備えと費用の見張り。

読む
Terms

用語集Glossary

本文に出てくる技術用語の定義と、稼働しているサービス・バケット・ジョブの名前と役割、管理用語(保持期間・HOLD・隔離など)。

読む
05

規模と主要指標Key Figures

管理・運用面の輪郭がつかめる数値です。それぞれの根拠は各章で扱います。

6/ 19 画面
管理コンソールの稼働中 / 計画ページ数。残りは実装フェーズの進行とともに増えていきます。
28種
自動起票されるアラートの種類。セキュリティ・配送・Drive・容量など 6 分類で見張ります。
17種
稼働中の定期自動バッチ。毎分の通知払い出しから月次の監査ログ退避まで。
2 年 + 退避
監査ログの保持。データベースで 2 年、25 ヶ月を超えた分はストレージへ退避して長期保存します。
20年
想定運用年数。記録の肥大・鍵の劣化・死蔵アカウントなど、長期のリスクに備えた設計です。
14日
招待・共有リンク・ファイルリクエストに共通の最長期限。開けっ放しの入口を作りません。