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 アクセス
maas360	IBM MaaS360
citrix	Citrix セキュア

例

{"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. [更新] を選択して、変更を保存します。