利用アプリ登録

利用アプリ登録¶

Marionetteでは、アカウント紐づけ画面で利用可能な外部サービスを管理画面から登録・編集できます。

概要¶

• サービス一覧: 利用する外部サービスは、管理画面の「利用アプリ登録」から追加します（初期状態では空の場合があります）
• アイコン: 各サービスにアイコン画像をアップロードして表示できます（DBに保存）

利用アプリ登録画面の開き方¶

1. ダッシュボードにログイン
2. サイドバーで「外部連携」→「利用アプリ登録」をクリック

サービスの追加¶

1. 「新規追加」ボタンをクリック
2. 以下の項目を入力:
3. サービスキー: 英数字・ハイフンのみ（例: my-game-app）。追加後は変更不可
4. 表示名: ユーザーに表示される名前（例: My Game App）
5. アイコン: 画像ファイル（PNG/SVG推奨）をアップロード（任意）
6. 「保存」をクリック

サービスの編集¶

1. 一覧で「編集」ボタンをクリック
2. 表示名・アイコンを変更
3. 一覧の「削除」で登録を取り除けます（保護フラグが付いた行を除く）

アカウント紐づけ画面での表示¶

登録したサービスは、/player/link のアカウント紐づけ画面に自動的に表示されます。ユーザーは一覧からサービスを選び、手動で外部IDを登録できます。

アプリからのディープリンク（自動連携）¶

外部アプリや Web から、ログイン完了後に自動で Marionette アカウントと外部ユーザー ID を紐づけたい場合は、次の形式の URL を開かせてください（ベース URL はご利用の Marionette ホストに置き換えます）。

/player/link?service_key=<ここで登録したサービスキー>&external_user_id=<外部サービス側のユーザーID>

• service_key は この画面で設定したキーと完全一致 させる必要があります（表示名ではありません）。
• external_user_id には Firebase UID など 推測・列挙されにくい高エントロピーな ID を渡してください。メールアドレスなど分かりやすい値にすると、第三者のなりすましにより 別プレイヤーの会話・記憶が参照される リスクが高まります。詳細と注意事項は アカウント紐づけ を参照してください。
• パラメータの制約・レガシーなクエリ名の禁止など、その他の利用上の詳細も同ページの「アプリからのディープリンク（自動連携）」に記載しています。