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

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

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

始める前に

重要： これは、マイクロサイトの標準の Managed Identity Service を迂回する高度な実装であり、設定には開発チームのサポートが必要です。

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

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

1

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

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

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

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

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

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

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

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

   • 左側のナビゲーションメニューから、 [エンゲージ] → コンテンツ → セットアップ内容 または コンテンツを編集.
   • 〜から マイクロサイト タブで、次を選択し ダッシュボード 次の ログイン済みレイアウト セクション。
   • 選択 [メニュー] → [設定].
   • 〜から 許可されたユーザー ドロップダウン リストで、 未確認.
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 ペイロードを含めてください。