JWT経由でimpact.comマイクロサイトのSSOを設定する

Advocateプログラムのマイクロサイトでは通常、顧客アドボケートが共有リンクや報酬の詳細にアクセスする前に、ユーザー名とパスワードで登録する必要があります。ただし、高度な代替手段として、ユーザーを認証するために JSON Webトークン（JWT） をサーバー側で生成し、URLパラメータとしてマイクロサイトに渡します。

この方法を使うと、参加者はマイクロサイト用のログイン資格情報を持ちません。代わりに、既存の顧客ポータルにログインすることでアクセスし、その後JWTを使用して本人を識別し、パーソナライズされたコンテンツを表示するためにマイクロサイトへリダイレクトされます。

始める前に

重要： これは高度な実装で、マイクロサイトの標準のマネージドIDサービスを回避し、セットアップには開発チームのサポートが必要です。

次のすべてに該当する場合のみ、この方法を使用してください：

• 参加者をプログラムのマイクロサイトに自動的にログインさせることで、シングルサインオン（SSO）体験を再現したい。
• JWTをサーバー側で生成できる。
• 次をインストールできない、またはしたくない： ユニバーサル トラッキング タグ（UTT） をサイトに。

1

ステップ1：マネージドIDなしでマイクロサイトを作成する

マイクロサイトを作成するときは、マネージドIDサービスをオフにし、すべてのページを「未認証」ユーザーがアクセスできるように設定する必要があります。 ダッシュボード ページではJWTを使用してユーザーを認証し、マイクロサイトを読み込みます。

マイクロサイトを作成する

まず、設定を変更して次をオフにします： 参加者ログイン オプション。

1. 左側のナビゲーションメニューから、次を選択します： [Engage] → コンテンツ.
2. の マイクロサイト カードで、次を選択します： 設定を編集.
3. その後、新しい マイクロサイト設定 ページに移動します。
4. の ログイン セクションで、 [オフにする] 参加者ログイン.
5. 選択します： 設定を保存.

ダッシュボードページを設定する

次に、マイクロサイトの ダッシュボード ページを未認証ユーザーに表示されるように設定します。次に、ページ上のコンポーネントを紹介プログラムに接続して、正しい情報が表示されるようにします。

1. サイトの ダッシュボード ページ設定を調整します。

   • 左側のナビゲーションメニューから、次を選択します： [Engage] → コンテンツ → コンテンツを設定 または コンテンツを編集.
   • 次の マイクロサイト タブで、次を選択します： ダッシュボード の ログイン済みレイアウト セクション内で。
   • 選択します： [メニュー] → 設定.
   • 次の 許可されたユーザー のドロップダウンリストで、次を選択します： 未認証.
2. 次のコンポーネントにプログラムIDを追加します： ダッシュボード.

   • ユーザーステータス — 表示する各ユーザーステータスごとにIDを追加する必要があります。
   • 共有リンク
   • 紹介コード
   • ソーシャルメディアボタン — 含める各ソーシャルメディア共有ボタンごとにIDを追加する必要があります。
3. 右上隅で、次を選択します： 保存.

   

エディターを使ってページやコンポーネントの設定を見つけて調整する方法については、次を参照してください： マイクロサイトエディターの解説 および マイクロサイトのレイアウトとページのカスタマイズ.

不要なページを削除する

マイクロサイトで使用しないレイアウトとページを削除します。

1. ページまたはレイアウトにカーソルを合わせます。
2. 選択します： [その他] → 削除.
3. 次を削除します： ログイン済みレイアウト.
4. 次のページを削除します：

   • プロフィールを編集
   • メール認証
   • パスワードを忘れた場合
   • ログイン
   • ログアウト
   • 登録
   • パスワードをリセット
   • メールを確認

2

ステップ2：JWTを生成する

JWTの構造は、ユーザー認証に関する標準的なAdvocateの要件に従います。以前にAdvocateを統合したことがある場合、UTT用に同様のトークンをすでに生成している可能性があります。

JWTは、必ずサーバーまたは信頼できるバックエンドシステム上で安全に生成してください。ブラウザー内で生成してはいけません。

方法を学ぶ： JWTの生成方法とペイロード要件.

3

ステップ3：JWTをマイクロサイトのURLに追加する

ユーザーがプラットフォームにログインしたら、URLのクエリ文字列にJWTを含めてマイクロサイトへリダイレクトします。

例： https://your-microsite.squatch.app/?jwt=<YOUR_GENERATED_JWT>

マイクロサイトは新しいブラウザータブで開くことも、iframeを使ってアプリに埋め込むこともできます。マイクロサイトを埋め込む場合は、 クロスオリジンリソース共有（CORS） およびブラウザーの制限を適切に処理してください。

注意事項

• この認証方法を使用すると、ユーザーはマイクロサイトのログイン資格情報を持ちません。
• JWTベースのアクセスは厳格に管理する必要があります。クライアントサイドのJavaScriptで公開したり操作したりしないでください。
• これは標準的でない方法です。プログラムを本番展開する前に、ステージング環境で十分にテストしてください。
• サポートが必要な場合は サポート、サポート依頼にはマイクロサイトのURL、実装の詳細、サンプルのJWTペイロードを含めてください。