松葉 / Matsuba ・開発過程資料

期限つき共有リンク/ Secure Share Links

アカウントを持たない相手へ、期限・パスワード・本人確認つきでファイルを渡す仕組み

取引先へ渡したいファイルが 1 件だけあるとき、そのためにアカウントを用意してもらうのは重すぎます。かといってメールに添付すると、容量で弾かれ、宛先を間違えても取り消せず、いつまで手元に残るかも分かりません。共有リンクは、この「渡すだけ」の受け渡しを、期限と回数と本人確認つきで完結させる仕組みです。まずは実際の動きをご覧ください。

この資料について： システム担当向けの技術共有です。用いる技術は正式名で記し、初出には短い注釈を、末尾の用語集にも一覧を用意しています。稼働中のサービス名（例：matsuba-batch）は名前と役割を併記します。各章へは目次から移動できます。通読の目安は 12〜15 分です。

デモンストレーションDemonstration

発行から受け取り、ダウンロードまでを一本の操作で通した記録です。この先の各章は、ここで起きていることを分解してご説明します。

（動画は掲載していません）

発行ダイアログでの設定 → 受取人が URL を開く → パスワードと確認コードを通す → ダウンロード。

共有リンクの全構成System Map

この仕組みを構成する稼働リソース（サービス・バケット・ジョブ・トピック）と、その間を流れるものを一枚にまとめました。①発行 → ②案内メールの配送 → ③受け取り → ④配布の実体 → ⑤記録・検知・管理、の 5 区画で読めます。①だけがログインを必要とし、③以降はアカウントを持たない相手が通る経路です。各要素の詳しい役割は、この先の各章で扱います。

図 01 · 共有リンクの全構成 — 稼働リソースと受け渡しの全体マップ

色の凡例 ― テール＝処理サービス・アプリ／金茶＝保管と時間に関わるもの・社外の人／赤＝防御と危険／破線＝補足。稼働リソース名（matsuba-batch など）はすべて用語集に説明があります。

概要Overview

共有リンクは、Box に招待していない相手へファイルやフォルダを一時的に渡すための仕組みです。相手にアカウントを作ってもらう必要はなく、受け取る側がすることは「送られた URL を開く」だけです。

発行できるのは、その Box の Editor または Owner です。対象を選び、有効期限・パスワード・ダウンロード回数・受取人の本人確認を決めると、推測できない URL が 1 本できます。案内メールを同時に送ることもできます。渡せるのはウイルス検査を通過したファイルだけで、検査中や隔離されたファイルは対象に選べません。

受け取る側は、その URL を開くと、必要な確認（パスワード・確認コード）を順に通ってからダウンロードします。単ファイルはそのまま、フォルダは ZIP にまとめて渡します。ファイルの中身が API を通ることはありません。短時間だけ有効な URL を発行し、ブラウザが Cloud Storage から直接取得します。

渡したあとも止められます。発行者と Box Owner はいつでも無効化でき、管理者は全社の一覧から強制的に失効させられます。元のファイルを削除すれば、そのファイルを指す共有リンクは自動的に無効になります。そしてすべてのアクセスが記録され、そこから 3 種類の異常を自動で見つけます。

この仕組みが引き受けている難しさ： 受け取る側はログインしていません。つまり「誰が来ているか」をアカウントで判断できないまま、正しい相手には確実に渡し、それ以外には渡さない必要があります。この資料の後半（防御の設計・記録と異常検知）は、そのために積み上げた層を扱います。