アカウント紐づけ

アカウント紐づけ¶

MarionetteのPlayerIDと外部サービスのアカウントIDを紐付けることで、複数のサービスで同じ会話履歴を引き継げます。

アカウント紐づけ画面の開き方¶

ブラウザで /player/link にアクセスしてください。初回はログイン画面が表示されます。

ログイン / 新規登録¶

アカウント紐づけ画面を利用するには、メールアドレスとパスワードによる認証が必要です。

新規登録¶

画面上部の「新規登録」タブを選択
メールアドレスとパスワード（8文字以上）を入力
「登録」をクリック

登録完了後、自動的にログインされ紐づけ画面が表示されます。

ログイン¶

画面上部の「ログイン」タブを選択（デフォルト）
登録済みのメールアドレスとパスワードを入力
「ログイン」をクリック

パスワードを忘れた場合¶

「パスワードを忘れた」タブを選択してください。

メールリセットが有効な場合: メールアドレス入力フォームが表示されます。登録済みのメールアドレスを入力して「リセットメールを送信」をクリックすると、パスワードリセット用のリンクがメールで届きます。リンクの有効期限は15分です。
メールリセットが未設定の場合: 「管理者にお問い合わせください」と表示されます。管理者はダッシュボードのプレイヤー管理画面からパスワードを再設定できます。

ログアウト¶

画面右上の「ログアウト」ボタンからログアウトできます。

利用可能なサービス¶

管理者がダッシュボードの「利用アプリ登録」で追加したサービスだけが一覧に表示されます。

連携方法¶

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

/player/link?service_key=<管理者が登録したservice_key>&external_user_id=<外部サービス側のユーザーID>

service_key は画面上の表示名（例: 梵そよぎ）ではなく、ダッシュボードの「利用アプリ登録」で設定した キー文字列と完全一致 させてください。一致しないと別のサービス扱いとなり、一覧の該当カードが「未連携」のままに見えることがあります。
service_key と external_user_id はそれぞれ 256 文字以内 です。どちらか一方だけクエリに付けるとエラー扱いになります。クエリ名は service_key と external_user_id のみ 有効で、service_id や player_id など古い名前は使えません。
external_user_id には、外部システムが発行する 推測困難でエントロピーが高い ID を使ってください（例: Firebase Authentication の UID、Auth0 の sub、十分な長さのランダム文字列や UUID など）。連番や、メールアドレス・電話番号・ログイン名のように 人が読んでパターンが分かり、辞書やブルートフォースで列挙しやすい値は避けてください。衝突の心配が実質なく、かつ第三者が「当てにいく」ことが現実的でないことが望ましいです。

`external_user_id` を推測しやすくした場合のセキュリティ上のリスク¶

紐づけは「service_key と external_user_id の組」で外部側の利用者を識別します。ここに メールアドレスのように推測・列挙しやすい値 をそのまま使うと、第三者が自分の Marionette アカウントでログインしたうえで、知っている・当てた external_user_id を自分のアカウントに紐づけようとする（なりすまし）ことが現実的になります。運用や実装の詳細次第では、本来別の Marionette プレイヤー（別の player_id）に紐づいていた会話履歴や記憶に、アクセスできてしまう、あるいは 意図しないアカウントへ紐づけが奪われる といった事態につながり得ます。外部サービス側では、ユーザーに見えても構わない表示用の識別子と、API・連携専用の 非公開・高エントロピーな安定 ID を分け、external_user_id には後者だけを渡す実装を推奨します。

ログインまたは新規登録が完了すると、その Marionette アカウントに上記の service_key と external_user_id が自動で紐づきます。

手動連携¶

ディープリンクと同様、入力する外部 ID は 推測困難なサービス発行 ID にしてください（上記「external_user_id を推測しやすくした場合のセキュリティ上のリスク」を参照）。

連携したいサービスの「手動で連携」ボタンをクリック
モーダルで外部IDを入力（コピー＆ペースト）
ラベル（任意）を入力（例: メイン、仕事用）
「登録」をクリック

複数アカウントの紐付け¶

1つのサービスに複数のアカウントを紐付けられます（例: メイン用とサブ用）。

既に1件紐付いている状態で「別のアカウントを追加」をクリック
上記と同様の手順で追加

紐付けの編集¶

該当アカウント行の編集アイコン（ペン）をクリック
IDやラベルをインラインで編集
チェックアイコンで保存、×アイコンでキャンセル

紐付けの解除¶

該当アカウント行の「解除」ボタンをクリック
確認モーダルで「解除」をクリック

アカウント紐づけ