キオスク設定QRの発行

キオスク設定QRは、キオスクアプリを一括セットアップするためのQRコードです。管理画面のAPIキー画面から発行します。

動作モード

モード	値	挙動
スキャンのみ	scan	QRスキャン → 検証結果表示のみ
スキャン→プリント	scan_print	QRスキャン → 検証成功時に自動でレシート印字

発行手順

1. 管理画面の左サイドバーから「APIキー」を開きます（管理者のみ）。
2. 「キオスク設定QRを発行」ボタンをクリックします。
3. ダイアログで以下を入力します：
   • 設定名：端末や設置場所を識別する名前（例: 「メインゲート 端末1」）
   • モード：scan（スキャンのみ）または scan_print（スキャン→プリント）
4. 「発行」をクリックします。

:::danger このQRは二度と表示されません 設定QRにはAPIキーの生の値が含まれます。モーダルを閉じると再表示できません。

• 「ダウンロード」ボタンでPNG画像を保存するか
• すぐにキオスク端末でスキャンしてください

端末台数分のQRをまとめて発行することをお勧めします。 :::

QRペイロードの内容

設定QRは以下のJSONをエンコードしています：

{
  "v": 1,
  "kind": "pasta_kiosk_config",
  "api_base_url": "https://api.passes.me",
  "api_key": "pasta_xxxxxxxxxxxxxxxxxxxx",
  "mode": "scan",
  "tenant_name": "テナント名"
}

このペイロードは @pasta/core の kioskConfigSchema として定義されており、キオスクアプリとバックエンドが共有するデータ構造です。

セキュリティの注意事項

• 設定QRに含まれるAPIキーは validate スコープ専用です（発行・管理操作はできません）。
• 設定QRの画像ファイルは安全な場所に保管し、不要になったら削除してください。
• 端末を紛失・盗難した場合は、対応するAPIキーを管理画面から即時失効させてください。
• 1台の端末に1つのAPIキーを対応させることを推奨します（失効範囲を最小化するため）。