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

注意: この文書は利便性と情報提供を目的に翻訳されたものです。この翻訳とオリジナルの英語版間に差異や矛盾がある場合、オリジナルの英語版が優先されます。この翻訳から生じる可能性のある誤りや誤解についての責任は負いかねます。

ページでWebアプリケーションタイプを選択すると、Web設定セクションが表示され、そこに様々な設定オプションを含む複数のタブがあります。

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

選択したWebアプリケーションのアプリケーション設定ページのアプリケーション設定 > 一般タブから：

必要に応じてマッチングするアプリケーションのデフォルト設定をインポートして、テンプレートとして使用します。この機能を利用するにはNexthink Adoptが必要です。

URLパターンを定義します。

必要に応じて、デジタルアダプションを有効にするトグルボタンを押して、ガイドを構成およびデプロイします。この機能にはNexthink Adoptが必要です。

URLを収集するオプションを確認または無効にします。

ソフトナビゲーションを確認または無効にします。

既存のキャンペーンに接続します。

以下の各ステップを詳しく掘り下げてください。

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

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

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

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

組み込みアプリケーションテンプレートとNexthink Libraryからインストールされたアプリケーションの比較

デフォルトのアプリケーションテンプレートを使用する場合と、Nexthink Libraryからインストールされたアプリケーションを使用する場合の主な違い:

選択した設定テンプレートをインポートして実装した後は、これらのデフォルト設定を編集したり削除したりすることはできません。

Nexthink による組み込みデフォルト設定の変更は、ウェブアプリケーションの構成を保存した後でも、これらのインポートされた設定を使用するすべてのアプリケーションに影響を与えます。

Nexthinkは、デフォルトのウェブアプリケーション設定を、定義済みのキーページおよびCSSセレクタと共にインポートする機能を提供しています。これは、Adoptインアプリガイドを正しく表示するために必要です。

デフォルトのアプリケーションテンプレートをインポートするには、選択したWebアプリケーションのアプリケーション設定ページから：

アプリケーション設定 > 一般タブを開きます。
設定モードのドロップダウンから、組み込みのアプリケーション設定テンプレートを選択します。

組み込みテンプレート設定を選択する前に、現在のアプリケーション設定をエクスポートしてください。組み込みのデフォルトを選ぶと元に戻せません。

組み込みのデフォルト設定は、特定のアプリケーションのセットにのみ利用可能です。

URLパターンの追加

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

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

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 パターンの例は、ウェブアプリケーションに有効です：

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*

URLを収集する

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

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

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

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

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

可能な限り、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]

Nexthink URL サニタイズの概要

ウェブアプリケーションの設定を続行するには、ソフトナビゲーションの有効化セクションに移動します。つまり General タブの下に残るフィールドです。

次の表は、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を参照してください...

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

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

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

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

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

Nexthink Applications は、既存のキャンペーンと接続することを可能にします。接続するには:

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

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

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

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