Microsoft Intuneを使用してWindows版Chromeを構成する

最終更新日: 2024年06月12日 08:50

この記事では、Microsoft Intuneを使用して、Windowsコンピューター上のGoogle ChromeウェブブラウザにPendo Launcher拡張機能を設定する手順について説明します。

構成する値を決定します。
PowerShellスクリプトを作成します。
PowerShellスクリプトをエンドユーザーのデバイスにプッシュします。
構成が正常に行われたことを検証します。

この記事で説明するプロセスを使用して、次の種類のデータを構成できます。

APIキー
訪問者ID
メタデータ

前提条件

エンドユーザーのデバイスで拡張機能を構成する前に、まずエンドユーザーのブラウザに拡張機能をインストールする必要があります。すべての導入オプションについては、Pendo Launcherを導入するためのITガイドを参照してください。また、展開ステップを実行する前に、ブラウザ拡張機能の実装を計画するという記事を読むことをお勧めします。

ステップ1. 構成する値を決定する

Pendo Launcherを完全に展開するには、APIキーと訪問者IDを構成する必要があります。役割や場所などのメタデータを含めることもできます。これらのメタデータは、アナリティクスやガイドのターゲット設定に活用できます。適切な訪問者IDとメタデータの選択に関する詳細は、ブラウザ拡張機能の実装を計画するを参照してください。

APIキー

構成プロセスのステップ2に必要なAPIキーは、［設定（Settings）］>［サブスクリプション設定（Subscription Settings）］に移動すると確認できます。以下のような個別の拡張機能APIキーが、ページ上部の［拡張機能APIキー（Extension API Key）］セクションに表示されます。

{
    "APIKey": {
        "Value": "c022bb1e-676d-4c58-731c-caf13fe12a89"
    }
}

訪問者IDとメタデータ

ほとんどの場合、Windowsへの展開では、MDMツール（Intuneなど）により制御可能なレジストリを通じて訪問者IDのみが提供され、APIやCSVアップロードなどの他の手段を通じてメタデータが補足されます。ただし、ユーザーのマシン上で値を動的に取得するメソッドがある場合は、訪問者オブジェクトにメタデータを提供することができます。

メタデータの提供について詳しくは、Active Directory（AD）スクリプトでPendoに送信するメタデータをカスタマイズするを参照してください。

訪問者情報は、PowerShellと互換性のない文字をすべて取り除いた文字列から成るJSONオブジェクトとして形式化する必要があります。PowerShellのエスケープ文字については、Microsoftのドキュメント「引用規則について（About Quoting Rules）」を参照してください。

ステップ2. PowerShellスクリプトを作成する

利用中のマシンにpendo-launcher-config.ps1というファイルを作成します。以下のコードをファイルにコピーし、ステップ1で決定したAPIキーの値を挿入します。

$api_key = "your-api-key-goes-here"

$username = $null

# ユーザー名が入力されるのを待ちます
while ($username -eq $null) {
    $username = (Get-CimInstance Win32_Process -Filter 'name = "explorer.exe"' | Invoke-CimMethod -MethodName getowner).User
    if ($username -is [array]) {
        $username = $username[0]
    }
    $username = $username -replace ' ', '.'
    Start-Sleep -Seconds 5 # 5秒間スリープ（オプション）
}

# ユーザー名をメールアドレスに変換して訪問者IDを定義します
# 訪問者IDの定義は異なる場合があります

$visitor_id = $username + "@pendo.io"

$visitor_json= "{ `"id`": `"$visitor_id`" }"

$registry_path_chrome = "HKLM:\SOFTWARE\Policies\Google\Chrome\3rdparty\extensions\epnhoepnmfjdbjjfanpjklemanhkjgil\policy"

$parent_path_chrome = Split-Path -Path $registry_path_chrome

# Pendo LauncherのChromeポリシーパスが存在しない場合は作成します

if (!(Test-Path $parent_path_chrome)) {
    New-Item -Path $parent_path_chrome -Force -ItemType Directory | Out-Null
}

if (!(Test-Path $parent_path_chrome\policy)) {
    New-Item -Path ("$parent_path_chrome\policy") -Force -ItemType Directory | Out-Null
}

# APIキー、訪問者ID、データ環境ポリシーを設定します

Set-ItemProperty -Path $registry_path_chrome -Name "APIKey" -Value $api_key
Set-ItemProperty -Path $registry_path_chrome -Name "visitor" -Value $visitor_json -Type ExpandString

# eu環境の場合はioをeuに、US1環境の場合はioをus1に、日本の環境の場合はioをjpnに変更します

Set-ItemProperty -Path $registry_path_chrome -Name "dataEnvironment" -Value "io"

exit 0

ステップ3. PowerShellスクリプトをエンドユーザーのデバイスにプッシュする

Microsoftのドキュメント「IntuneでWindows 10/11デバイス上のPowerShellスクリプトを使用する（Use PowerShell scripts on Windows 10/11 devices in Intune）」を参照してください。

Microsoft Intune管理センター（https://intune.microsoft.com）に移動します。
左側のメニューから［デバイス（Devices）］>［スクリプト（Scripts）］を選択します。
［スクリプト］ページの上部にある［+追加（+ Add）］を選択します。これにより、新しいスクリプトが追加されます。
ドロップダウンメニューから［Windows 10以降（Windows 10 and later）］を選択します。
［基本（Basics）］タブで、スクリプトのわかりやすい名前（「Pendo Launcher Configuration」など）を入力します。［次へ（Next）］を選択して続行します。
［スクリプト設定（Script settings）］タブで、ステップ2で作成したpendo-launcher-config.ps1ファイルをアップロードします。［ログイン時の認証情報を使用してこのスクリプトを実行する（Run this script using the logged in credentials）］が［いいえ（No）］に設定されていることを確認します。［次へ］を選択して続行します。
［割り当て（Assignments）］タブで、ランチャー構成を展開するデバイスのグループを選択します。［次へ］を選択して続行します。
- 「Microsoft Intuneを使用してWindows版Chromeにインストールする」の手順に従った場合は、Pendo Launcherの強制インストールで対象としたグループと同じものを選択する必要があります。
- まずは1台のデバイスで展開のテストと検証を行い、その後、エンドユーザーのデバイス全体をカバーするよう徐々に割り当て範囲を拡大することをお勧めします。
［確認と追加（Review + add）］タブで、スクリプト、設定、およびグループの割り当てを確認します。
確認が完了したら、［追加（Add）］を選択します。

ステップ4. 構成を検証する

まず、物理的にアクセスできる単一のデバイスでスクリプトをテストし、構成が正しいことを検証します。検証では、レジストリキーが正しく設定されていること、および拡張機能が期待どおりに構成されていることを確認します。

レジストリキーの設定を確認する

Windowsデバイスでレジストリエディタを開きます。タスクバーの検索ボックスに「regedit」と入力し、結果から［レジストリエディタ（Registry Editor）］（デスクトップアプリ）を選択します。
［HKEY_LOCAL_MACHINE］>［SOFTWARE］>［Google］>［Chrome］>［3rdparty］>［extensions］>［epnhoepnmfjdbjjfanpjklemanhkjgil］の順でレジストリキーの場所に移動します。

レジストリキーは以下のように表示されます。

ブラウザに拡張機能が構成されていることを確認する

レジストリキーが設定されていることを確認したら、ブラウザの拡張機能が有効になっていることを確認し、コンテンツが正しくフォーマットされているかどうか検証します。なお、Intuneがエンドデバイスで設定スクリプトを実行するには、最大で24時間かかります。

構成プロファイルのあるデバイス上でChromeを開きます。アプリがすでに実行されている場合は、終了して再度開きます。
「chrome://extensions」をコピーして、ブラウザのURLバーに貼り付けます。
ブラウザのツールバーの右上にあるPendo Launcher拡張機能を見つけます。拡張機能が表示されない場合は、パズル型のアイコンを選択して拡張機能をさらに表示してください。
拡張機能アイコンを右クリックし、［デバッグ情報を表示（Show Debug Info）］を選択します。
［構成タブを表示（Show Configuration Tab）］>［IT管理の構成（IT-Managed Config）］を選択します。
値がレジストリキーに設定されている値と一致していることを確認します。dataEnvironmentがデフォルト値のioに設定されている場合、dataEnvironmentキーはここでは表示されません。