ServiceNowモバイルアプリ用の外部認証ブラウザーの構成

アドミニストレーターは、モバイルアプリ用に外部ブラウザを構成できます。この外部ブラウザは認証中に使用されるため、同じブラウザによって開かれた外部 URL はセッションと Cookie を維持できます。

始める前に

必要なロール：admin

このタスクについて

Cookie は、 ServiceNow® モバイル アプリのブラウザーと、外部サイトを読み込む外部ブラウザーの間で共有されません。 ServiceNow モバイル アプリを使用すると、エンドユーザーは Okta や Microsoft Entra ID などの SSO (シングルサインオン) サービスでログインできます。これらの SSO サービスは、エンドユーザーにシームレスで安全な認証エクスペリエンスを提供します。ただし、エンドユーザーは、アプリ内で同じ SSO サービスを使用する認証済みサードパーティのリンクを開きたいが、再ログインは要求したくない場合があります。たとえば、エンドユーザーは、 ServiceNow モバイル アプリと同じ SSO サービスを使用する別のプラットフォームでホストされているレポートへのリンクを開くことができます。

エンドユーザーが ServiceNow モバイル アプリと同じSSOサービスを使用する異なるプラットフォーム上のリンクにアクセスできるようにするために、管理者は ServiceNow モバイル アプリにログインするための外部ブラウザを構成して、Cookieがログインと外部サイトの間で共有されるようにすることができます。つまり、SSO セッションはエンドユーザーのログイン後も保持され、外部サイトが ServiceNow モバイル アプリと同じ SSO プロバイダーを使用している場合は、外部サイトに自動的にログインします。

Web ブラウザーのプロパティ

次のプロパティを使用して、 CustomPreAuthProperties スクリプトインクルードで外部ブラウザと認証ブラウザを指定します。

表 : 1. Web ブラウザーのプロパティ

モバイルアプリのオペレーティングシステム	プロパティ	説明
iOS	SNExternalBrowseriOS	iOSアプリで外部リンクを開くために使用するブラウザタイプを設定します。
iOS	SNAuthenticationBrowseriOS	iOSアプリでユーザーを認証するために使用するブラウザタイプを設定します。
Android	SNExternalBrowserAndroid	Androidアプリで外部リンクを開くために使用するブラウザタイプを設定します。
Android	SNAuthenticationBrowserAndroid	Androidアプリでユーザーを認証するために使用するブラウザタイプを設定します。

プロパティ値

Web ブラウザーのプロパティには、次のブラウザータイプを指定できます。

表 : 2. ブラウザタイプ

プロパティ値	説明
safari	Apple Safari
chrome	Google Chrome
firefox	Mozilla Firefox
edge	Microsoft Edge
workspaceone	AirWatch VMware Workspace ONE
webatwork	MobileIron Web@Work
blackberryaccess	BlackBerry Access
maas360	IBM MaaS360
citrix	Citrix Secure

例

{"SNExternalBrowseriOS": "safari", "SNAuthenticationBrowseriOS": "safari"}

重要:

SSO セッションをログインと他のブラウジングの間で保持するには、両方のプロパティの値が一致する必要があります。

手順

1. 移動先 すべて > sys_extension_point.list.
   [拡張ポイント] テーブルが表示されます。
2. [API 名] 列で 、グローバルを検索します。CustomPreAuthProperties エントリを選択して選択します。
3. 拡張ポイント CustomPreAuthProperties レコードの 関連リンク で、 実装の作成 を選択します。
4. スクリプトインクルード CustomPreAuthProperties レコードで、外部ブラウザーと認証ブラウザーのプロパティを スクリプトに追加します。

   たとえば、外部ブラウザーと認証ブラウザーの Apple Safari ブラウザーを指定する構成を次に示します。

   var CustomPreAuthProperties = Class.create();
   CustomPreAuthProperties.prototype = {
        initialize: function() {
        },
   
        /**
         * Returns a JSON object keyed by the custom property names.
         */
        getProperties: function(input) {
             return {"SNExternalBrowseriOS": "safari", "SNAuthenticationBrowseriOS": "safari"};
        },
   
        type: 'CustomPreAuthProperties'
   };

5. [ アクティブ ] を選択して、スクリプトインクルードをアクティブにします。
6. [更新] を選択して、変更を保存します。