⚠️ 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の秘密鍵のローテーションは当社側で行います。ワークスペース側ではできません。ローテーションを行うには、直接ご連絡いただき以下を行ってください。
Intercom内でIdentity Verificationを無効にしましたか(ウェブ、iOS、Androidそれぞれ個別に)
特定の秘密鍵をローテーションします。
新しい秘密鍵を表示するためにページを更新します。
新しい秘密鍵をコードに実装し、適切なuser_hashを生成してください。
最後にIdentity Verificationを再度有効にします。
ダウンタイムはありませんが、ステップ2〜5の完了中はユーザーがIdentity VerificationなしでMessengerを使用できる状態になります。











