ウェブアプリケーションを設定する

アプリケーション設定ページでWebアプリケーションタイプを選択すると、Web設定セクションが表示され、さまざまな設定オプションを含むいくつかのタブが現れます。

Webアプリケーションの一般設定の構成

選択したウェブアプリケーションのアプリケーション設定ページの一般タブから:

テンプレートとして使用するため、一致するアプリケーションのデフォルト設定をインポートすることができます。この機能にはNexthink Adoptが必要です。
URLパターンを定義します。
オプションでデジタル採用トグルボタンを有効にして、アプリ内ガイドを設定および展開します。この機能にはNexthink Adoptが必要です。
URLの収集オプションを確認または無効にします。
ソフトナビゲーションを確認または無効にします。
既存のキャンペーンに接続します。

このページで説明されている一般タブのフィールドを設定した後、特定のウェブアプリケーションの残りの設定タブを設定することができます。

ビルトインのデフォルト設定をテンプレートとしてインポート——オプション

ウェブアプリケーション用のビルトインデフォルト設定をインポートするには、Nexthink Adoptが必要です。

この機能は、Nexthink Libraryからインストールされたアプリケーションとは異なります。

Nexthinkは、アプリ内ガイドを正確に表示するために必要なアプリケーションキーページとCSSセレクターの設定を迅速化するため、デフォルトのアプリケーション設定をインポートする機能を提供します。

デフォルトのウェブアプリケーション設定をインポートする際の関連考慮事項:

組み込みのデフォルト設定は、特定のアプリケーションのセットにのみ利用可能です。
選択されたデフォルト構成のインポートと実装後は、それらのデフォルト設定を編集または削除することはできません。
Nexthink による組み込みデフォルト設定の変更は、ウェブアプリケーションの構成を保存した後でも、これらのインポートされた設定を使用するすべてのアプリケーションに影響を与えます。

ウェブアプリケーションのデフォルト設定をインポートするには、アプリケーション設定ページの｢一般｣サブタブにある｢設定モード｣ドロップダウンから選択します:

お使いのウェブアプリケーションに合うビルトインのデフォルト設定を選択します。
指定されたウェブアプリケーションで｢デフォルト設定をインポート｣を選択します。

組み込みテンプレート構成を追加する前に現在のアプリケーション構成をエクスポートすることをお勧めします。組み込みのデフォルトのインポートは取り消せません。

URLパターンの追加

監視したいウェブアプリケーションのURLパターンを追加します。以下を考慮してください：

URL の一致パターンは以下の構造を持っています：<scheme>://<host><path>
URLの照合パターンにはワイルドカードを含めることができますが、ポート番号を指定することはできません。
システムでは、スキームを*://<host><path>とするワイルドカードの使用が強制されるため、常にHTTPおよびHTTPSの両方に一致します。
ビジネスアプリケーションを管理するユーザーは、<host><path>の簡略化された構造でURLパターンを表示および入力します。
内部的には、すべてのソフトウェアコンポーネントが、スキームを含む完全なURLマッチパターンを処理する必要があります: <scheme>://<host><path>

有効なパターンの例

以下の URL パターンの例は、ウェブアプリケーションに有効です：

www.example.com/*は、http://www.example.com/またはhttps://www.example.com/で始まるすべてのURLに一致します。
*.example.com/*は、example.com、www.example.com、intra.example.com、support.intra.example.comなどに一致します。
*.intra.example.com/* は、intra.example.com、support.intra.example.comなどに一致します。
example.com/* は、*://example.com/* のみに一致します。
www.example.com/foo/* は、*://www.example.com/foo/で始まるすべてのURLに一致します。
myintranet/* は、内部アプリケーションに対して有効なパターンです。
www.example.com/foo/* は、存在するアプリケーションの一致パターンです。この場合、以下のパターンを任意のアプリケーションで使用することができます:
- *.example.com/bar/*
- www.example.com/foobar/*
- *.another-example.com/foo/*
- test.example.com/foo/*

無効なパターンの例

以下のURLパターンの例は、アプリケーションには無効です:

www.example.*/*
HTTPSのプロトコルがあるため、https://*.example.com/*は無効です
www.*.com/*
www.*.example.com/*
クエリ文字列コンポーネントがサポートされていないため、www.example.com/foo?barは無効です
*/*
www.example.com/foo#bar #URL のハッシュ成分はアプリケーション URL でサポートされていないため
ポートが原因で、*.example:1234.com/*は無効です（代わりに*.example.com/*を使用し、すべてのポートをサポートします）
*.example.com/#foo
ホストコンポーネント内のアスタリスクの後にドットがないため、*example.com/*は無効です
パス内にワイルドカードを1つしか許可されていないため、www.example.com/foo/*/bar/*は無効です
ホスト部分に1つしかワイルドカードが許可されていないため、*.customer.*.example.com/*は無効です
www.example.com/foo*は、既存のアプリケーション一致パターンです。この場合、次の交差パターンを任意のアプリケーションで使用することはできません:
- *.example.com/foo/*
- www.example.com/foobar/*
- www.example.com/fo*
- www.example.com/foo/bar/*

自動修正されたパターンの例

www.example.com が *://www.example.com/* に変わります。
www.example.com/ が *://www.example.com/* に変わります。
www.example.com/foo/ が *://www.example.com/foo/* に変わります。
www.example.com/foo が *://www.example.com/foo/* に変更されます
example.com が *://example.com/* に変更されます
*.example.com が *://*.example.com/* に変更されます

標準外ポートのURLパターン使用例

以下のURLを使用して、企業の文書管理システムにアクセスしてください。

https://prod.doxydoc.local:32890/start.phpを参照してください

業務アプリケーションの設定中に、以下のパターンを使用する必要があります。

*://prod.doxydoc.local/start.php*

NexthinkのURLパターン検証ロジックについて

ウェブアプリケーションの設定を続行するには、URLを収集するセクションにジャンプしてください。つまり、Generalタブの残りのフィールドです。

Nexthinkアプリケーションは、保存する前にパターンを検証するための以下のルールセットを使用します。

ユーザーは少なくとも1つのURLマッチパターンを入力する必要があります。
現在、http:// または https:// のようなスキームの指定はサポートされておらず、それは必ず*:// でなければなりません。
ユーザーが*:// を指定しない場合、フォームは自動的に*:// プレフィックスを追加します。
ユーザーがポート番号を含むURLを入力すると、フォームはエラーメッセージを表示します。
ホストコンポーネントは、完全修飾ドメイン名(FQDN)の一部を続ける形で*. で始めることができます。このパターンは、*. ワイルドカードの後に入力した表現とまったく同じホスト名にもマッチすることに注意してください。
ホストコンポーネントは、*. ワイルドカードで始まる場合、完全かつ有効なドメイン名で終わる必要があります。
ホストコンポーネントは、*. ワイルドカードで始まらない場合、ローカルホスト名だけを含むことができます（例: ドメイン名なし）。これはFQDNを使用しない内部ウェブアプリケーションをサポートするためです。
/* 以上でパスを指定する必要があります。ユーザーがパスを入力しない場合、フォームロジックはすべてのパスにマッチするように/* を追加します。
パスは* ワイルドカードで終わらなければなりません。パスがそうでない場合、フォームロジックがパターンに* を追加します。
パスには* ワイルドカードを1つ以上含むことはできません。
パターンにはクエリ文字列 (?...) を含めてはなりません。ユーザーがクエリ文字列を含むURLを入力すると、エラーメッセージが表示されます。
パターンにはフラグメント (#...) を含めてはなりません。ユーザーがフラグメントを含むURLを入力した場合、エラーメッセージが表示されます。
検証ロジックは、すべてのアプリケーションにおいて、互いに交差するパターンを防止します。
ワイルドカードを任意の単語で置き換え、最初にhttp:// を追加した後、パターン全体が標準的なURLとして検証されなければなりません。たとえば、ユーザーがパターン*.example.com/foo/* を入力した場合、展開された形式 http://www.example.com/foo/bar は標準的なURL検証ライブラリを使用して簡単に検証できます。
ホスト部分としてexample.comのようにドメイン名のみを入力することは有効です。しかし、www.example.com. のようなホスト名を持つURL名にマッチしません。
フォームロジックはユーザーが入力したパターンを自動修正し、これはテキストボックスからフォーカスを失った直後に行われ、ユーザーインターフェースはユーザーが送信する前に変更を確認できるようにします。
少なくとも1つのURLが両方のパターンによって一致した場合、パターンは互いに交差します。明示的に、パターンA1とB1が交差するのは、以下のすべての条件が真である場合です。

ホスト部分の先頭からワイルドカードを最終的に取り除いた後、A1.host が B1.host で終わる、または B1.host が A1.host で終わる。
パスの末尾からワイルドカードを取り除いた後、A1.path が B1.path で始まる、または B1.path が A1.path で始まる。

URLを収集する

URL の収集オプションはデフォルトで有効になっており、アプリケーションのキーページの設定を容易にします。

URLを収集するかどうかを決定する際は、以下を考慮してください。

URLを収集するを有効にすると、適切な権限を持つNexthinkユーザーアカウントが従業員が訪問する個々のURLを表示できるようになります。
URLを収集するを無効にすると、システムは拡張レベルでのURLの収集を停止します。
システムは、サニタイザーを使用してデータプライバシーを保護するために切り詰めたURLをレンダリングします。

Nexthink URLのサニタイズについて

ウェブアプリケーションの設定を続行するためには、ソフトナビゲーションの有効化セクションに移動してください。つまり、一般タブの残りの項目です。

可能な限り、Nexthinkは収集した全てのURLをサニタイズして、機密情報を隠すようにしています。これは、個人データや構成の秘密情報、特定のクエリ文字列のパターンを削除する試みとして行われます。

覚えておいてください、URLはウェブリソースのユニークな識別子として機能する文字列であり、4つの主要な要素で構成されています:

オリジンは、プロトコル（ http または https ）、ホスト名（ http://nexthink.com ）、ポート番号（ 80 または 443 ）を含み、例えば https://nexthink.com:443 です。
パス名は、サーバー上のリソースの正確な位置を示し、例えば /company/about-us です。
ハッシュとは、Web ページの現在の状態やユーザー設定のような情報をブラウザに保持するための URL のオプションの成分です。また、ハッシュ（ # ）から始まり、後に文字列が続きます。例えば、URL confluence.nexthink.com/pages/urlsanitisaation#url-sanitisation-rules では、ハッシュ部分は #url-sanitisation-rules です。
クエリパラメータは、サーバーに追加情報を提供するオプションのキーと値のペアです。それらは疑問符（ ? ）で始まり、アンパサンド（ & ）で区切られています。例えば ?projectKey=DCBSM&view=detail です。クエリパラメータは系統的にサニタイズされます。システムは各キー値ペアを [key] と置き換えます。例えば：
- https://confluence.intra.nexthink.com/pages/viewrecentblogposts.action?key=AppExEP は [key] によってサニタイズされます： https://confluence.intra.nexthink.com/pages/viewrecentblogposts.action?[key]

URLサニタイズメカニズム

URLサニタイズメカニズムは、送信前にURLから機密情報を取り除くことを目的としています：

最初に、?key1=value1&key2=value2 のようなクエリパラメータをすべて削除し、鍵を角括弧で囲んで ?[key1]&[key2] のみを保持します。
ハッシュセグメント内の他のアンカーを [anchor] コードに置き換えます。
以下に記載されている特定のパターンに基づいて、さらにURLをサニタイズします。
最後に、URLを必要に応じて切り詰めます。

このプロセスは、URLで誤って機密データが漏洩しないことを保証します。

パターンマッチとタグ置換

システムがアプリケーションのURLをサニタイズするために使用する一般的なコードの例:

[code]

説明

[uuid]

ユニバーサル一意識別子 (UUID) (3c9dee20-52e9-4ff7-b2ee-e672342bce56)

[id]

ID番号: /で始まり、/または?で終わる英数字の連番。非数値の文字は次のいずれかである必要があります: ., ,, _, \, -. 他の文字は数字である必要があります。

[json]

{"?????????"}形式のシーケンスで、?????????には任意の単語、数字、または次の文字%, \, ., ,, :, _, -, を含めることができます。

[gib]

識別番号、例えば: MS Outlookでの識別番号の後に続くメールIDでは, http://outlook.office.com/mail/inbox/id/です。

[hex]

16進値: 33以上の連続した16進数範囲の英数字: a-fおよび0-9。

[int]

整数値: 少なくとも4つの連続した数字のシーケンス。

これらのパターンはすべてのアプリケーションに対してグローバルに指定されています。 サニタイズされたURLのいずれかの部分がパターンのいずれかに一致する場合、それは対応するタグに置き換えられます。

例:

https://community.nexthink.com/s/profile/0052p00000BURowAAHを [hex] でサニタイズ:https://community.nexthink.com/s/profile/[hex]
https://outlook.office.com/mail/inbox/id/AAQkAGJhYmFkMTUxLTQ5NzgtNDNlZi1iZDkzLTQ2YzEwNDIwYzA0YgAQAKafeoP2TMVDozSlcBq2JGU%3Dを [gib] でサニタイズ:https://outlook.office.com/mail/inbox/id/[gib]

URL短縮

サニタイズされたURLの最大許容長があります。サニタイズされたURLが制限を超えると、Nexthinkは余分な部分を削除し、URLの一部が欠けていることを示すために三点リーダー (...) を追加します。

Nexthink URLサニタイズ要約

次の表は、NexthinkによるURLサニタイズプロセスを要約しています:

サニタイズステップ

説明

例URL

サニタイズされたURL

クエリパラメータのサニタイズ

キーとバリューのペアはキーで置き換えられます

https://nexthink.com?key1=value1&key2=value2を参照してください

https://nexthink.com?[key1]&[key2を参照してください]

ハッシュセグメントのサニタイズ

アンカーハッシュセグメントおよびクエリハッシュセグメントは隠されます

https://nexthink.com#?name=John#custom-anchor

https://nexthink.com#?[name]#[anchorを参照してください]

URLトークンのサニタイズ

URLはパターンマッチとタグ置換を用いてサニタイズされます

https://nexthink.com/2024/2fff5c59-18ba-44d3-bd95-4bee056f68caを参照してください

https://nexthink.com/[int]/[uuidを参照してください]

URL短縮

URLが最大長を超える場合は切り捨てられます

https://nexthink.com/custom-path/very/very/long/url

https://nexthink.com/custom-path/very/veを参照してください...

ソフトナビゲーションの有効化

ソフトナビゲーション測定の有効化は既定で有効になっています。不安定なページを持つWebアプリケーションには、このオプションを無効にします—ページの読み込み時間が長くなる可能性があります。

ソフトナビゲーションは非同期ページ読み込みの速度を測定可能にします。これはブラウザが新しいページをロードしない場合によく見られます。これはシングルページアプリケーション (SPA) では非常に一般的です。ソフトナビゲーションはページが安定するのにかかる時間を測定します。

既存のキャンペーンとの接続

Nexthinkアプリケーションは、既存のキャンペーンとの接続を可能にします。接続するには:

ターゲットキャンペーンからユニーク識別子 (UID) をピックし、EngageキャンペーンUIDフィールドに貼り付けます。

Engageキャンペーンライセンスが必要です。

または、Nexthinkメインメニューからキャンペーンに移動し、接続したいキャンペーンをリストから選択することでUID値にアクセスできます。キャンペーンのUIDはURLの一部として表示されます。

アプリケーションにキャンペーンがリンクされると、特定のアプリケーションページにセンチメントタブが表示されます。適切な権限を持っていることが必要です。 センチメントタブをクリックすると、関連するキャンペーンのダッシュボードを新しいタブで開くことができます。