導入手順書

最終更新: 2026年8月8日 · 管理者向け

グループを開設するのは管理者ひとりです。保管場所を1つ用意し、アプリの開設ウィザードを最後まで進めれば終わります。ここに書いてあるのは実際の画面の流れそのままです。

1. 保管場所を用意する

グループのアカウントでバケットを1つ作ります。名前は何でもかまいません (例: mofune)。

1-1. CORS を設定する

ブラウザから読み書きするため、バケットの CORS 設定に次を入れます。ここが抜けていると接続確認が「サーバーまで届いていません」で止まります。DELETE も要ります。担当者が投函物を回収したあと、受信箱から消すためです。

R2 のダッシュボードなら、バケット → 設定 → CORS ポリシーに次を貼ります。

[
  {
    "AllowedOrigins": ["https://mofune.site"],
    "AllowedMethods": ["GET", "PUT", "HEAD", "DELETE"],
    "AllowedHeaders": ["*"],
    "ExposeHeaders": ["ETag"]
  }
]

1-2. 公開読み取りURLを用意する

参加者はアカウントを持たずに読みます。バケットの公開アクセスを有効にして、そのURLを控えてください。R2 なら https://pub-xxxx.r2.dev か、割り当てた独自ドメインです。中身は暗号化されているので、公開しても本文・写真・連絡先は読めません。

1-3. 書き込み用の資格情報を発行する

そのバケットに対して読み書きできる API トークン (アクセスキーID とシークレットアクセスキー) を発行し、手元に控えます。この資格情報は担当者だけが持ちます。

2. 開設ウィザードを進める

アプリを開き、「グループを作る」を押します。3ステップです。

1. グループの情報。 グループの名前と、管理者のログインID・表示名・パスワード・メールアドレスを入れます。
2. データの置き場。 エンドポイント・リージョン・バケット名・公開読み取りURL・アクセスキーID・シークレットアクセスキーを入れます。
3. 接続の確認と開設。 「書き込む → 読み戻す → 資格情報なしで読む → 消す」の4つを試します。すべて成功したときだけ開設が進みます。失敗した場合、保管場所には何も書き込まれていないので、設定を直してやり直せます。

3. 接続コードとリカバリキットを控える

• 接続コード — 参加者に配ります。どのグループのデータをどこから読むかを表す文字列です。これだけでは中身は読めません。
• リカバリキット — 管理者のルート鍵です。これを失うと名簿に署名し直せなくなり、メンバーの追加・削除ができなくなります。暗号化していない紙なので、鍵のかかる場所に保管してください。転記ミスに気づけるよう照合用のチェックサムを併記しています。

保管を確認するチェックを入れるまで、ウィザードは完了しません。面倒に見えますが、ここを飛ばすと後から取り返しがつきません。

4. 参加者に配る

参加者ひとりずつに、次の3つを紙かQRで渡します。

• 接続コード
• ログインID
• 最初のパスワード

参加者はアプリを開いてこの3つを入れるだけです。アカウント登録もアプリのインストールも要りません。ホーム画面に追加すると、アプリのように使えます。

5. うまくいかないとき

いまの制限

• アプリから接続できる保管場所は S3互換のみです。
• メンバーの招待・追加の画面は準備中です。現在は開設時に登録した人が対象になります。
• 通知は担当者の端末からメールアプリを開いて送る方式です。自動送信 (Web Push) は準備中です。
• この手順書の画面写真は、実際の運用での確認後に追加します。

仕組みの詳細は 要件書・設計書 に、不具合の報告は Issues にお願いします。