メインコンテンツにスキップ

ウェブおよびモバイル用のIdentity Verificationの設定【非推奨】

Identity Verificationを設定してセキュリティを強化し、なりすましを防止しましょう。

⚠️ Identity Verificationは現在非推奨です

Identity Verificationは引き続きサポートされ動作しますが、インストールや変更を検討している場合は、JSON Web Tokensを使用してFin Messengerを保護する方法に移行することを強くお勧めします。

ウェブでIdentity Verificationを設定する

インストール方法を選択してください

まずDeploy > Fin Messenger > Installに移動し、Secure the messenger with Identity Verificationのドロップダウンをクリックして、Messengerをどの方法でインストールしたか(NPMパッケージか統合か)を選択してください。

IntercomをWordPressまたはShopifyでインストールしている場合は、設定なしでIdentity Verificationを強制できます(米国ホストのワークスペースのみ利用可能)。

サーバーでHMACコードを生成する

コードスニペットインストールの場合、ログインした各ユーザーのためにサーバーでHMACを生成し、Intercomに送信する必要があります。

まず、ユーザーを一意に識別する方法を選択してください:User IDまたはEmailで。

注意:

  • 両方をIntercomに送信する場合、User IDが優先されます。

  • 秘密鍵は安全に保管してください!リポジトリやクライアント側コード、第三者が見つけられる場所に直接コミットしないでください。

次に、HMACを生成するために使用しているサーバーサイドの言語やフレームワークを選択してください。

サイトを更新してHMACを送信する

ユーザーデータを読み込み、window.intercomSettingsコードスニペットがあるすべての場所で、新しい属性user_hashを追加し、そこにHMACコードを割り当ててください。

HMAC値をパラメータとしてFin Messengerに送信する更新済みコードスニペットを提供しています。コードをコピーをクリックしてご利用ください。

インストールを確認する

Identity Verificationを設定し、各ユーザーのuser_hashを送信し始めたら、インストールが期待通りに動作しているか確認してください。

インストールを確認をクリックしてください。このボタンはMessengerが見つかったドメインとそのIdentity Verificationの状態を表形式で表示します。緑のチェックは成功、警告の三角は正しいIdentity Verification設定でMessengerが見つからなかったことを示します。

リスト内のすべてのドメインのエラーを処理したことを確認してください。これらはすべてpingを受信したドメインです。

ハッシュチェッカーを使って、Intercomに送信しているユーザーハッシュ値が正しいか検証できます。ここでは、user_idまたはemail(user_idを使っていない場合)に基づく期待されるユーザーハッシュを確認できます。

ウェブでIdentity Verificationを強制するには、すべてのpingリクエストにuser_hashを含める必要があります。

MessengerのIdentity Verificationを強制する

Messengerコードを正しく修正しエラーがなければ、Enforce Identity Verification for messengerオプションをオンにしてEnforce Identity Verification for messengerをクリックして強制できます。反映に5〜10秒かかる場合があります。

強制後はuser_hashなしのリクエストは拒否され、Messengerを通じたユーザーのなりすましを防止します。


モバイルアプリでIdentity Verificationを設定する

Deploy > Fin Messenger > Installで、モバイルアプリにMessengerをインストールに進みます。ウェブのインストールと同様に、Install for mobileの下にiOS、Android、React Nativeの切り替えがあります。

次にIdentity Verificationの秘密鍵を取得し、サーバーの安全な場所に保管してください。

秘密鍵はモバイルアプリに保存しないでください。サーバーがuser_hashのみをモバイルアプリに送信するべきです。

使用しているプラットフォームのモバイルSDKガイドに従ってください。

Messengerがアプリで期待通りに動作することを確認したら、Identity Verificationをオフにして新しいIdentity Verification対応バージョンをApp Storeに公開してください。採用率が高まったらIdentity Verificationをオンに切り替え、すべてのアプリバージョンで強制を開始します。

Identity Verificationを有効にすると、有効なuser_hashを送信しない古いバージョンのアプリはIntercomと通信できなくなります。


Identity Verificationをオフにする方法

いつでもDeploy > Fin Messenger > Installに移動し、選択したプラットフォームのSecure the messenger with Identity Verificationの最終ステップまでスクロールして「Enforce Identity Verification for messenger」をオフに切り替えればIdentity Verificationをオフにできます。開発中に便利です。

Identity Verificationがオフの間、アプリは保護されません。これにより、あるユーザーが別のユーザーになりすますことができ、Intercom内の会話を見たりデータを変更したりする可能性があります。


Identity Verificationの秘密鍵をローテーションする方法

Identity Verificationの秘密鍵のローテーションは当社側で行います。ワークスペース側ではできません。ローテーションを行うには、直接ご連絡いただき以下を行ってください。

  1. Intercom内でIdentity Verificationを無効にしましたか(ウェブ、iOS、Androidそれぞれ個別に)

  2. 特定の秘密鍵をローテーションします。

  3. 新しい秘密鍵を表示するためにページを更新します。

  4. 新しい秘密鍵をコードに実装し、適切なuser_hashを生成してください。

  5. 最後にIdentity Verificationを再度有効にします。

ダウンタイムはありませんが、ステップ2〜5の完了中はユーザーがIdentity VerificationなしでMessengerを使用できる状態になります。

こちらの回答で解決しましたか?