> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/set-up-sso-for-an-impactcom-microsite-via-jwt.md).
# JWT経由でimpact.comのマイクロサイトにSSOを設定する
Advocateプログラムのマイクロサイトでは通常、顧客アドボケートが共有リンクや報酬の詳細にアクセスする前に、ユーザー名とパスワードで登録する必要があります。ただし、高度な代替手段として、ユーザーを認証するために [JSON Webトークン（JWT）](https://en.wikipedia.org/wiki/JSON_Web_Token) をサーバー側で生成し、URLパラメータとしてマイクロサイトに渡します。
この方法を使うと、参加者はマイクロサイト用のログイン資格情報を持ちません。代わりに、既存の顧客ポータルにログインすることでアクセスし、その後JWTを使用して本人を識別し、パーソナライズされたコンテンツを表示するためにマイクロサイトへリダイレクトされます。
#### 始める前に
{% hint style="warning" %}
**重要：** これは高度な実装で、マイクロサイトの標準のマネージドIDサービスを回避し、セットアップには開発チームのサポートが必要です。
{% endhint %}
次のすべてに該当する場合のみ、この方法を使用してください：
* 参加者をプログラムのマイクロサイトに自動的にログインさせることで、シングルサインオン（SSO）体験を再現したい。
* JWTをサーバー側で生成できる。
* 次をインストールできない、またはしたくない： [ユニバーサル トラッキング タグ（UTT）](/brand/ja/what-would-you-like-to-learn-about/platform-features/tracking/javascript-tag-tracking/tracking-with-universal-tracking-tag-utt.md) をサイトに。
{% stepper %}
{% step %}
#### ステップ1：マネージドIDなしでマイクロサイトを作成する
マイクロサイトを作成するときは、マネージドIDサービスをオフにし、すべてのページを「未認証」ユーザーがアクセスできるように設定する必要があります。 *ダッシュボード* ページではJWTを使用してユーザーを認証し、マイクロサイトを読み込みます。
マイクロサイトを作成する
まず、設定を変更して次をオフにします： *参加者ログイン* オプション。
1. 左側のナビゲーションメニューから、次を選択します：  **\[Engage]** **→ コンテンツ**.
2. の *マイクロサイト* カードで、次を選択します： **設定を編集**.
3. その後、新しい *マイクロサイト設定* ページに移動します。
4. の *ログイン* セクションで、  **\[オフにする]** **参加者ログイン**.
5. 選択します： **設定を保存**.
ダッシュボードページを設定する
次に、マイクロサイトの *ダッシュボード* ページを未認証ユーザーに表示されるように設定します。次に、ページ上のコンポーネントを紹介プログラムに接続して、正しい情報が表示されるようにします。
1. サイトの *ダッシュボード* ページ設定を調整します。
* 左側のナビゲーションメニューから、次を選択します：  **\[Engage]** **→ コンテンツ** → **コンテンツを設定** または **コンテンツを編集**.
* 次の *マイクロサイト* タブで、次を選択します： **ダッシュボード** の *ログイン済みレイアウト* セクション内で。
* 選択します：  **\[メニュー] → 設定**.
* 次の *許可されたユーザー* のドロップダウンリストで、次を選択します： **未認証**.
2. 次のコンポーネントにプログラムIDを追加します： *ダッシュボード*.
* ユーザーステータス — 表示する各ユーザーステータスごとにIDを追加する必要があります。
* 共有リンク
* 紹介コード
* ソーシャルメディアボタン — 含める各ソーシャルメディア共有ボタンごとにIDを追加する必要があります。
3. 右上隅で、次を選択します： **保存**.
エディターを使ってページやコンポーネントの設定を見つけて調整する方法については、次を参照してください： [マイクロサイトエディターの解説](/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/microsite-editor-explained.md) および [マイクロサイトのレイアウトとページのカスタマイズ](/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/customize-microsite-layouts-and-pages.md).
不要なページを削除する
マイクロサイトで使用しないレイアウトとページを削除します。
1. ページまたはレイアウトにカーソルを合わせます。
2. 選択します：  **\[その他]** **→ 削除**.
3. 次を削除します： *ログイン済みレイアウト*.
4. 次のページを削除します：
* プロフィールを編集
* メール認証
* パスワードを忘れた場合
* ログイン
* ログアウト
* 登録
* パスワードをリセット
* メールを確認
{% endstep %}
{% step %}
#### ステップ2：JWTを生成する
JWTの構造は、ユーザー認証に関する標準的なAdvocateの要件に従います。以前にAdvocateを統合したことがある場合、UTT用に同様のトークンをすでに生成している可能性があります。
JWTは、必ずサーバーまたは信頼できるバックエンドシステム上で安全に生成してください。ブラウザー内で生成してはいけません。
方法を学ぶ： [JWTの生成方法とペイロード要件](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-tracking-integrations/json-web-tokens-jwts).
{% endstep %}
{% step %}
#### ステップ3：JWTをマイクロサイトのURLに追加する
ユーザーがプラットフォームにログインしたら、URLのクエリ文字列にJWTを含めてマイクロサイトへリダイレクトします。
{% hint style="info" %}
**例：** `https://your-microsite.squatch.app/?jwt=`
{% endhint %}
マイクロサイトは新しいブラウザータブで開くことも、iframeを使ってアプリに埋め込むこともできます。マイクロサイトを埋め込む場合は、 [クロスオリジンリソース共有（CORS）](https://en.wikipedia.org/wiki/Cross-origin_resource_sharing) およびブラウザーの制限を適切に処理してください。
{% endstep %}
{% endstepper %}
#### 注意事項
* この認証方法を使用すると、ユーザーはマイクロサイトのログイン資格情報を持ちません。
* JWTベースのアクセスは厳格に管理する必要があります。クライアントサイドのJavaScriptで公開したり操作したりしないでください。
* これは標準的でない方法です。プログラムを本番展開する前に、ステージング環境で十分にテストしてください。
* サポートが必要な場合は [サポート](mailto:saasquatch-support@impact.com)、サポート依頼にはマイクロサイトのURL、実装の詳細、サンプルのJWTペイロードを含めてください。
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://help.impact.com/brand/ja/what-would-you-like-to-learn-about/advocate-program/manage-advocate-participant-experiences/microsite-experiences/set-up-sso-for-an-impactcom-microsite-via-jwt.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.