構成プロファイルを使用してmacOS版Chromeで構成する – Pendoヘルプセンター

この記事では、モバイルデバイス管理（MDM）ツールを使用して、MacのGoogle ChromeウェブブラウザにPendo Launcher拡張機能を構成する手順について説明します。

構成する値を決定します。
お使いのデバイスで.plistファイルを作成します。
.plistファイルをエンドユーザーのデバイスにプッシュします。
構成が正常に行われたことを検証します。

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

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

前提条件

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

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

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

APIキー

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

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

訪問者IDとメタデータ

訪問者情報は、XMLと互換性のないすべての文字を取り除いた、文字列のJSONオブジェクトとして形式化する必要があります。このファイルの作成方法は以下のとおりです。

1. 以下のような情報を含む通常のJSONオブジェクトを作成します。

{
  "id": "foo",
  "bar": "baz",
  "bingo": [
    1,
    2,
    3
  ],
  "tango": "2006-01-02T15:04:05.999-05:00"
}

2. 文字列を取り除くには、freeformatter.comやcodebeautify.orgなどのオンラインツールを使います。上記のオブジェクトから得られる文字列は以下のようになります。

{
  &quot;id&quot;: &quot;foo&quot;,
  &quot;bar&quot;: &quot;baz&quot;,
  &quot;bingo&quot;: [
    1,
    2,
    3
  ],
  &quot;tango&quot;: &quot;2006-01-02T15:04:05.999-05:00&quot;
}

3. この訪問者オブジェクトに値を動的に入力する方法については、MDMツールのドキュメントを参照してください。たとえば、Jamfでペイロード変数を使うと、対象となるエンドユーザーに固有の値を構成プロファイルに動的に挿入できます。

ステップ2. .plistファイルを作成する

ステップ1で作成した文字列を使用して .plistファイルを作成します。Plist（プロパティリスト）ファイルは、アプリケーション設定の保存に使用されるMacシステムに固有の拡張子です。XML形式のこれらのファイルには、さまざまなプログラムのプロパティと環境設定が含まれています。

利用中のマシンにcom.google.Chrome.extensions.epnhoepnmfjdbjjfanpjklemanhkjgil.plistというファイルを作成します。以下のコードをファイルにコピーし、ステップ1で決定した値を挿入します。

<?xml version="1.0"encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>APIKey</key>
    <string>ここに あなたの API キー</string>
    <key>visitor</key>
    <string>ここに あなたの 訪問者 文字列</string>
  </dict>
</plist>

以下は、.plistファイルの例です。

<?xml version="1.0"encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <dict>
    <key>APIKey</key>
    <string>c025bc1f-606d-4d62-731c-caf13fe12j24</string>
    <key>visitor</key>
    <string>{&quot;id&quot;: &quot;john.smith@example.com&quot;}</string>
  </dict>
</plist>

ステップ3. .plistファイルをエンドユーザーのデバイスにプッシュする

MDMツールを使用して、.plistファイルを構成プロファイルとしてエンドユーザーのデバイスにプッシュします。この構成プロファイルの優先ドメインは、com.google.Chrome.extensions.epnhoepnmfjdbjjfanpjklemanhkjgil.plistです。お使いのツールの要件として、アップロードする前に.plistファイルを構成プロファイルに変換する必要がある場合は、オープンソースツールmcxToProfileを使用してください。

MDMツールには、カスタム構成プロファイルを展開する方法に関する具体的な手順が記載されています。以下は、Macデバイスで使用される最も一般的なMDMツールのドキュメントです。

Jamf（PendoのドキュメントJamfを使用してmacOS版Chromeで構成するも参照してください）
Kandji
Hexnode
Workspace ONE

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

まず、物理的にアクセスできる単一のデバイスでスクリプトをテストし、構成が正しいことを検証します。検証では、構成プロファイルの存在を確認し、正しいブラウザの動作を検証します。

構成プロファイルの存在を確認する

構成プロファイルが正常に構成されたことを確認するには、次の2つの方法があります。

Appleのシステム設定

Macのアップルメニューで［システム設定］を選択します。
サイドバーで［プライバシーとセキュリティ（Privacy & Security）］ を選択します。
［その他（Others）］で［プロファイル（Profile）］を選択します。下にスクロールすると見つかる場合があります。
MDMツールで設定した名前の構成プロファイルを検索し、存在することを確認します。

コマンドライン

Macターミナルアプリを開きます。
コマンドcd /Library/Managed\ Preferencesを入力して、管理対象設定フォルダー（managed preferences folder）に移動します。
com.google.Chrome.plistファイルが存在することを確認します。
コマンドdefaults read /Library/Managed\ Preferences/com.google.Chromeを入力します。
ステップ2で設定した値と内容が一致していることを確認します。

ブラウザの動作を検証する

ブラウザが構成プロファイルの内容を正しく読み取っていることを確認します。

構成プロファイルを使用してデバイス上でChromeを開きます。Chromeアプリがすでに実行されている場合は、終了して再度開きます。
Chromeのブラウザに、Pendo Launcherブラウザ拡張機能をインストールします。Pendo Launcherの強制インストールをすでに設定している場合は、この手順をスキップできます。
Pendoなど、Chrome以外のウェブページにアクセスします。
ブラウザのツールバーの右上にあるPendo Launcher拡張機能アイコンを右クリックします。
［デバッグ情報を表示（Show Debug Info）］を選択します。
［識別対象（Identified as）］フィールドの訪問者IDが正しいことを確認します。
［コンフィギュレーション情報を表示（Show Configuration Info）］を選択します。
［IT管理の構成（IT-Managed Config］ドロップダウンメニューを開き、構成値を検索して、その値が存在することを確認します。

IT管理