Pluginを構成できます。プラグインを構成すると、その存在がカスタムポータルに伝えられます。プラグインがインストールされていない場合に検出するようにカスタムポータルを構成して、プラグインのインストールをエンドユーザーに促すことができます。このプラグインでは、状態を更新するためにOktaに対して次のAPI呼び出しも行われます。/api/plugin/2/sites:この呼び出しは、カスタムポータルのサイトのリストに関する情報を取得します。これはSSOのシナリオで役立ちます。/api/v1/users/me/home/tabs:この呼び出しは、ポータル上のタブとアプリの場所に関する情報を取得します。メニューを作成します。/api/internal/enduser/home:この呼び出しは、有効化されているプラグイン設定など、現在サインインしているユーザーに関する情報を取得します。/api/plugin/2/hashed-self-service-sites:この呼び出しは、必要時にアプリを追加する上で有用な情報を取得します。Pluginに送られるリクエストの信頼済みオリジンとして構成できます。この機能は、廃止される予定のサードパーティ製cookieに依存しています。手順については、「サードパーティ製cookie廃止の影響を軽減する」を参照してください。特定の親ドメインを使用するiFrameのよりセキュアな埋め込みのために特定の親ドメインを利用できます。Consoleで[Security(セキュリティ)][API]に移動します。Origins(信頼済みオリジン)]タブをクリックします。Origin(オリジンを追加)]をクリックして設定を構成します。name(オリジン名)]:組織のオリジン名を入力します。URL(オリジンのURL)]:信頼するオリジンのURLを入力します(例:https://example.okta.com)。Type(タイプを選択)]:次のiFrame埋め込みオプションを選択します。embed(iFrameの埋め込み)]:OktaサインインページとシングルソーシングURLのiFrame埋め込みを許可するには、このオプションを選択します。DashboardのiFrame埋め込みを許可するには、このオプションを選択します。[Save(保存)]をクリックします。任意の親ドメインを使用するiFrameの埋め込みに任意の親ドメインを利用します。orgはクリックジャッキング攻撃を受けやすくなります。代わりに「特定の親ドメインを使用する」の手順に従います。[Other(その他)]に移動します。embedding(IFrameの埋め込みを許可)]を選択します。カスタムポータルを構成する次に、ポータルを信頼済みオリジンとして構成します。次の非表示iFrameを追加して、カスタムポータルのHTMLを変更します。postMessageリクエストがiFrameに送信されます。'https://example.okta.com/app/UserHome/plugin-info')"/>iFrameからのpostMessage応答を処理するために、いくつかのJavaScriptコードをサイトに追加します。https://*.okta.com/app/UserHome*という形式のフレームが1つあるかどうかが検出されます。プラグインは、プラグインがインストール済みであることをフレームに伝えます。Oktaサーバーでリクエストが受信され、iFrame所有者のオリジンが信頼されていることが検証されます。信頼関係が確認されると、OktaサーバーはJavascripコードが含まれるJSPページで応答します。このコードは、信頼済みオリジンからのpostMessageリクエストに次のJSONで応答します。present}プラグインは、これが正しく読み込まれた/app/UserHome/plugin-infoエンドポイントにあることを検出します。次に、前述のように、Oktaへの4つのAPI呼び出しを行うことで状態を適切に更新します。iFrameからのpostMessage応答は、次のようなコードによって処理されます。}});セキュリティに関する考慮事項Oktaでは、この機能のために認証済みのセッションが必要です。/plugin-infoエンドポイントは、次の条件と一致する場合にアクセスを拒否されます。管理者が信頼済みオリジンを定義していない。管理者が定義した信頼済みオリジンのリストにリクエストの参照元(親フレームなど)がない。完全に機能する例を構成するこの機能の機能する例を表示するには、単純なHTMLページをホスティングするローカルWebサーバー(node.jsサーバーなど)を作成します。次の例では、https://example.okta.com上のページがホスティングされます。それぞれの商標は、それぞれの商標所有者に帰属します。