連絡先の Source ID によるログイン不要のチャット
自社サイトにログイン済みのユーザーが、自分のユーザー番号(Source ID)を持ったまま、再ログインなしで直接会話できるようにします。プラットフォームはこの番号をもとに 1 人のコンタクトに対応付け、貴社のバックエンドで署名されていないリクエストでは誰にもなりすませません。
Web Chat を自社サイトに埋め込む場合、ユーザーはすでに自社サイトにログインしていることがよくあります。この設定を使うと、ユーザーは貴社システムのユーザー番号を持ったまま、ログイン画面を再度経由することなく直接会話を始められます。一方で、公開されている会話用 URL への匿名アクセスは引き続きブロックされます。
この番号は MaiAgent では Source ID と呼ばれ、管理画面でも埋め込みスクリプトでもこの名称が使われます。プラットフォームは Source ID を受け取ると、コンタクトに対応付け(または新規作成し)、そのユーザーの会話履歴をこのコンタクトに紐付けます。
一、この設定で解決できること
この設定が登場する前は、ログイン設定は二者択一でした。
ログイン設定をオンにする:埋め込み側ですでに本人確認が済んでいるにもかかわらず、ユーザーは再度ログインを求められます。
ログイン設定をオフにする:公開されている会話用 URL を誰でも匿名で利用できてしまいます。
この設定をオンにすると、両方を同時に成立させられます。Source ID と有効な署名を持ってアクセスしたユーザーは直接会話でき、それらを持たないアクセスは常にログインページへ誘導されます。
二、設定をオンにする
設定の場所:左側のメニューの「カスタマーサポート > チャットプラットフォーム」から、Web サイトタイプのチャットプラットフォームを選択し、「ログイン設定」タブを開きます。
1. 先にログインソースを選択する
このスイッチはログイン設定に依存しているため、先に「ログインソース」でいずれかのソース(MaiAgent/AD/Keycloak/LINE)を選択する必要があります。未選択の間はスイッチをクリックできず、画面に「先にログインソースを選択してください」と表示されます。

2. スイッチをオンにする
「埋め込み側が Source ID でログインなしの会話を行うことを許可する」をオンにします。オンにすると、検証方式、署名シークレット、連携サンプルが表示されます。

3. 検証方式を選択する
署名検証を必須にする(推奨)
埋め込み側は、貴社のバックエンドで計算した署名を付与する必要があり、署名検証に通った場合のみアクセスが許可されます。シークレットを保持するサーバーだけが、ユーザーに代わって会話を開始できます。
本番環境
Source ID のみ
署名を検証せず、Source ID が付いていればアクセスを許可します。
テスト環境、または閉じた社内ネットワーク環境

4. 署名シークレットを取得する
署名モードを選択して設定を保存すると、プラットフォームが署名シークレットを生成します。シークレット欄では次の操作ができます。
「表示」をクリックして、完全なシークレットを確認する(初期状態はマスク表示)
「コピー」をクリックして、エンジニアに渡す
「再生成」をクリックして、新しいシークレットに更新する
5. 署名の有効期限を設定する
1 分、5 分、15 分から選択でき、初期値は 5 分です。期限切れの署名や、すでに使用された署名は拒否されます。

三、エンジニアによる連携方法
管理画面の「連携サンプル」セクションには、このチャットプラットフォームの識別子が入力済みの状態で、バックエンドでの署名計算(PHP/Node/Python)とフロントエンドでの受け渡しのサンプルが用意されています。そのままコピーしてエンジニアに渡せます。署名アルゴリズム、検証ルール、SDK パラメータの詳細は、エンジニアに技術マニュアルの Web Chat の埋め込みと SDK › 署名検証を参照してもらってください。
1. バックエンドで署名を計算する
ユーザーが会話に入るたびに、貴社のバックエンドが署名シークレットを使ってタイムスタンプ ts と署名 sig を計算します。アルゴリズムと 3 言語のサンプルは、技術マニュアルの署名検証をご覧ください。
2. フロントエンドで埋め込みスクリプトに渡す
フロントエンドは、Source ID とバックエンドで計算済みの ts、sig を埋め込みスクリプトに渡します。
埋め込み設定の auth フィールドに直接記述することもでき、その場合は埋め込みスクリプトの読み込み後に自動的に反映されます。記述方法は技術マニュアルをご覧ください。
3. 連携時の注意事項
アクセスのたびに署名し直す:同じ署名は 1 回しか成功しないため、埋め込み側で署名をキャッシュしてはいけません。
署名はバックエンドで計算する:シークレットがフロントエンドのコードに現れた時点で、公開されたのと同じです。
時計を正確に保つ:システムは 60 秒までの時計のずれを許容します。タイムスタンプがこの範囲を超えると拒否されます。
チャットプラットフォームの識別子を正しく指定する:署名にはチャットプラットフォームの識別子が含まれるため、別のチャットプラットフォームの識別子で計算した署名は通りません。
四、動作一覧
Source ID + 有効な署名あり
ログイン画面なしで直接会話
Source ID あり、署名が不正または期限切れ
拒否
同じ署名を繰り返し使用
1 回目は成功、2 回目は拒否
Source ID なし(公開 URL を直接開いた場合を含む)
ログインページへ誘導
検証方式が「Source ID のみ」+ Source ID あり
署名を検証せず直接会話
このスイッチがオフ
従来のログイン設定の動作を維持
五、署名検証の失敗ログ
連携がうまくいかない場合は、設定セクションの「署名検証の失敗ログを表示」をクリックすると、直近の失敗イベントを確認でき、エンジニアが自分で原因を調査できます。ログにはシークレットや完全な署名は含まれません。

署名の期限切れ
サーバーの時計のずれ、または埋め込み側が署名をキャッシュしている
タイムスタンプが未来の許容範囲を超過
サーバーの時計が 60 秒以上進んでいる
署名の不一致(シークレットが一致していない可能性)
バックエンドで使っているシークレットが管理画面と異なる、または署名文字列の組み立て方が誤っている
タイムスタンプまたは署名がない
埋め込み側が ts または sig を付けていない
署名が使用済み
同じ署名を 2 回送信した
リプレイ防止キャッシュが利用不可
プラットフォーム側の一時的な状況。システムは許可せず拒否します
Source ID が複数のコンタクトに対応
そのチャットプラットフォームに、同じ Source ID の重複したコンタクトデータが存在する
六、よくある質問
最終更新
役に立ちましたか?