ガイド

Assigner とは？

Assigner は Jamf Mobile Assist アプリの一部であり、共有利用される iOS および iPadOS デバイスの迅速なセットアップと構成を可能にします。ユーザーは、デバイスを手に取り、認証し、コードをスキャンするか、管理者が定義したその他の情報を入力して、自身の役割や場所を識別するだけです。すると Assigner がそのニーズに合わせてデバイスを構成します。利用が終わったら、同じアプリ内のボタンをタップするだけで、それらの選択内容をデバイスから消去できます。

Mobile Assist バージョン 1.9.0 以降、Assigner は再設計され、より高度なカスタマイズが可能になったほか、Assigner がデバイスをユーザーに割り当てる方法を定義する基準を、管理者がより細かく設定できるようになりました。

このバージョンでの更新内容は以下のとおりです。

• タイルベースのユーザー割り当てワークフロー
• ワークフロー内の任意のタイルの有効化/無効化
• 色、テキスト、アイコン、入力方法（カメラでスキャン、手動入力、ドロップダウンメニューから選択など）を含む、各タイルのあらゆる要素をカスタマイズ
• ソリッド背景やグラデーションの使用を含む、アプリとテキストのすべての色をカスタマイズ
• 画像への URL を使用して会社ロゴでブランディングをカスタマイズ
• 上記のすべてを、アプリに組み込まれた Designer Mode から実行でき、Jamf Pro ですべてのデバイスに Assigner を構成するために使用する App Config を自動的に作成

Assigner の仕組み

大まかに言うと、Assigner はユーザーが iOS デバイスに入力した情報を Jamf Pro に書き込み、その情報を使用して Smart Group のメンバーシップを判断し、構成やアプリをデプロイします。

Jamf Pro に書き込まれるデータポイントは？

デバイスのインベントリレコードには、Assigner によって以下の項目が書き込まれます。

• ユーザー名
• Extension Attribute 1（管理者が定義）
• Extension Attribute 2（管理者が定義）
• Building（管理者が定義）
• Department（管理者が定義）

割り当てワークフロー / タイル

Assigner はタイルベースの割り当てワークフローを利用します。5 つのタイルのそれぞれを、さまざまな業界の幅広い組織のニーズに合わせてカスタマイズできます。さらに、テキスト、色、アイコン、メニュー、入力方法、ブランディングロゴなど、アプリのほぼすべての要素をカスタマイズできます。

ユーザーは、情報を手動で入力する、ドロップダウンメニューから選択する、またはデバイスのカメラを使ってテキスト/QR コードをスキャンすることで、タイルを進めていきます。

ユーザーがワークフローを正常に完了すると、確認が表示され、その構成/アプリが自動的にデプロイされます。次に Assigner アプリは、デバイスが現在割り当てられており、Reset ボタンで割り当てを解除できることを示すメッセージを表示します。

初期設定（必須）

Mobile Assist アプリから Assigner にアクセスするには、まず以下の手順を完了する必要があります。

Jamf Pro を介した Jamf Mobile Assist アプリのインストール

1. Volume Purchasing ワークフローを使用してアプリを Jamf Pro に配布します
2. 自動的に作成されない場合は、Jamf Mobile Assist を Jamf Pro のアプリカタログに追加します
   • Managed Distribution タブで Assign Content Purchased in Volume をチェックします
   • この時点ではスコープを設定せず、App Configuration は空白のままにしてください
3. 次の手順で参照するために、ブラウザのアドレスバーに表示される URL 内のアプリレコード ID を控えておきます。 https://yourinstance.jamfcloud.com/mobileDeviceApps.html?id=18&o=r この例では、ID は 18 です。

組み込みツール（Jamf App Wizard）で Assigner を有効化する

次に、Assigner が Jamf Pro で機能するように構成する必要があります。Mobile Assist アプリには Jamf App Wizard というツールが含まれています。このツールは、必要な API Role と Client を自動的にセットアップし、Assigner の Linked App Integration を作成します。

1. アクセスできるデバイスに Mobile Assist をスコープします。App Configuration は追加しないでください。

2. このデバイスで Mobile Assist を起動します。App Config が存在しない場合、Jamf App Wizard が自動的に開きます。デプロイ後の任意のタイミングで Wizard を開くには、以下の App Config キーを使用することもできます。

   <key>wizard-mode</key>
   <string>yes</string>
   

3. Administrator 権限を持つアカウントを使用して、Jamf Pro インスタンスにログインします。

4. 読み込みが完了すると、インスタンス内のすべてのモバイルデバイスアプリが表示されます。Jamf Mobile Assist のエントリを見つけます。注: 複数のエントリがある場合は、上記の手順 3 の ID を参照として使用してください。

5. アプリをタップして詳細を表示します。アプリの説明で Begin App Integration を選択します。

6. Assigner Integration ワークフローの各手順を完了します。

   1. Assigner タブが選択されていることを確認します
   2. API Role の名前を入力し、Create API Role をクリックします。注: すでに存在する名前を入力するとエラーが返されます。
   3. API Client の名前を入力し、Create API Client をクリックします
   4. Confirm App Link Request: この統合のために作成された名前とオブジェクト ID を確認します
   5. 問題がなければ、Complete App Link をクリックします
   6. 成功した場合は、Navigation タブに移動して Return ボタンをタップすることで、前のセクションに戻れます
   7. これで、Current Integrations タブで統合を確認できます

基本の必須 App Config

上記の手順が完了したら、Assigner が有効化されるように、アプリをスコープして以下の一時的な App Config を設定できます。Jamf Mobile Assist の Jamf Pro Mobile Device App レコードで、Assigner を有効にするためにこの一時的な App Config を追加します。

<!-- Assigner Mode Configuration -->
<key>assigner-mode-enabled</key>
<string>yes</string>

<!-- Required keys (do not edit) -->
<key>JPS_URL</key>
<string>$JPS_URL</string>
<key>JSSID</key>
<string>$JSSID</string>
<key>MANAGEMENTID</key>
<string>$MANAGEMENTID</string>
<key>OAUTH_AUTH_CODE</key>
<string>$OAUTH_AUTH_CODE</string>
<key>APP_CONFIG_REINSTALL_CODE</key>
<string>$APP_CONFIG_REINSTALL_CODE</string>

• 上記のコードをコピーし、Mobile Assist アプリに移動します（Devices > Mobile Device Apps > Jamf Mobile Assist > App Configuration）
• Edit をクリックし、上記のコードを貼り付けて Save をクリックします
• 上記の手順が完了すると、デバイスで Mobile Assist を開けるようになり、Assigner が自動的に起動するはずです

Designer Mode

Designer Mode を使用すると、Assigner アプリ内で直接 Assigner のタイルワークフローを構築できます。完了したら、App Config XML をエクスポートし、AirDrop や Message などでデバイスに送信して、そのコードを Jamf Pro にアクセスして貼り付けることができます。

Designer Mode に入る

Designer Mode に入るには:

• Mobile Assist / Assigner を起動します
• メインビューの上部にあるロゴを 5 秒間長押しします。パスフレーズのウィンドウが表示されます
• デフォルトのパスフレーズは「admin」で、Designer Mode で変更できます

Assigner のタイルと外観をカスタマイズする

各 Assigner タイルはカスタマイズでき、アプリに表示される色、テキスト、アイコン、入力方法、ロゴもカスタマイズできます。

Camera Scan / Form Entry モード

モードオプションを選択すると、以下のように動作します。

Form & Scan

• カメラスキャナーが有効になり、ユーザーはデバイスのカメラを使用してコードやテキストをスキャンできます
• 有効な場合、スキャンアイコンが表示されるタイルからスキャンできます

Form

• カメラスキャナーは有効にならず、すべてのフィールドを手動で入力する必要があります

Login タイル（Tile 1）

このタイルは、ユーザーが Jamf Pro（Jamf Pro アカウントまたは LDAP）に対して認証することを要求するように構成でき、正しい認証情報が入力されない限り先に進みません。

注: スキャナーが無効の場合、このタイルはユーザー名/パスワードの構成で表示されます。スキャナーが有効の場合、パスワードフィールドは表示されません。

このタイルは以下のように構成します。

Enabled — ワークフローからタイルを有効化または無効化します

Title — タイルのタイトルのテキストを変更します

Icon — タイトルの隣のアイコンを変更します。Designer Mode の一番下までスクロールして "Browse all images" をタップすると、利用可能なすべての画像をプレビューできます

Preview Tile — ここをタップしてデザインをプレビューします

Extension Attribute タイル（Tiles 2〜5）

これらのタイルは、ユーザーがドロップダウンリストから選択するか、テキストを直接スキャン/入力できるようにすることで、Jamf Pro の Mobile Device Extension Attributes に書き込みます。Input Type を Text Field に設定した Extension Attribute を、必要な数だけ作成してあることを確認してください。

これらのタイルは以下のように構成します。

Enabled — ワークフローからタイルを有効化または無効化します

Input

• Menu: ユーザーがドロップダウンリストから項目を選択できるようにします
• Text: ユーザーが値をスキャンまたは手動で入力できるようにします

Title — ここに Extension Attribute の正確な名前を入力します

Icon — タイトルの隣のアイコンを変更します

Menu — ドロップダウンメニューでユーザーに選択させたい項目を、カンマ区切りの値として入力します（例: Item 1, Item 2, Item 3）。注: Input を Menu に設定する必要があります。重要: キーボードの return を押して確定してください。

Building および Department タイル（Tiles 6〜7）

最後の 2 つのタイルは、デバイスレコードの Building および Department 属性に書き込みます。ユーザーには、利用可能な Building および/または Department の選択肢のドロップダウンが表示されます。

これらのタイルは以下のように構成します。

Enabled — ワークフローからタイルを有効化または無効化します

Title — Building または Department では変更できません

Icon — タイトルの隣のアイコンを変更します

Menu — ドロップダウンメニューでユーザーに選択させたい項目を、カンマ区切りの値として入力します。Building と Department については、次の命名規則に従う必要があります。

• ObjectID:Name, ObjectID:Name, ObjectID:Name（ObjectID は Building または Department の Jamf Pro ID、Name は Building または Department の名前）
• Building または Department の Jamf Pro ID を取得するには、Jamf Pro > Settings > Network > (Buildings または Departments) に移動 > 項目を選択 > その項目の URL を確認します — ID は末尾の数字です
• 例えば、「New York」という Building がある場合、それをクリックすると https://myinstance.jamfcloud.com/view/settings/network-organization/buildings/3 が表示されます。Assigner に追加するには、3:New York を使用します
• 重要: キーボードの return を押して確定してください

Text Color Scheme

これらの値は、アプリのタイルや背景に選択した色に合わせて機能するように、テキストの色（light または dark）を変更するために使用されます。

Headings Text — ロゴの下にあるテキストの色を設定します。テキスト自体は Other Text Values > Title で変更できます

Tile Text — タイル内のテキストとアイコンの色を設定します

Button Text — ボタン内のテキストの色を設定します（例: Submit/Reset、スキャン、ドロップダウンメニュー）

Other Text Values

ここでは、アプリのタイル以外の部分に表示されるテキストの内容を変更できます。

Title — ブランディングロゴの下に表示されるテキストを設定します

Reset Button — デバイスの割り当て後に、その割り当てをリセットするために使用するボタンのテキストを設定します

Assignment Complete Line 1 — 割り当てが成功した後に表示される 1 行目のテキストを設定します。これはタイルビューを置き換えます

Assignment Complete Line 2 — 割り当てが成功した後に表示される 2 行目のテキストを設定します。これはタイルビューを置き換えます

Branding Image Link

URL を使用して、メイン画面の上部に表示されるブランディング画像を設定します。

Branding Image Link — アプリに使用したいブランディング画像の URL を入力します。画像は下のスペースにすぐに表示されます。リンクが機能しない場合や、その他の理由で画像を表示できない場合は、プレースホルダー画像とテキストが自動的に適用されます。メインの Assigner 画面で、画像のサイズと間隔を必ずテストしてください。

Background Color Scheme

ここでは、アプリ、タイル、ボタンなどの全体的な色を設定できます。さらに、背景をグラデーションまたはソリッドカラーのいずれかに設定できます。

Background — アプリのグラデーションまたはフィル（ソリッド）の背景カラースキームを設定します

• グラデーションを選択した場合、Colors 1〜3 がアプリ全体で使用され、Color 1 が背景の上部、Color 2 が中央、Color 3 が下部に表示されます
• フィルを選択した場合、Color 1 が背景に使用され、Color 2 は使用されません

Color 1: Top Gradient / Fill — グラデーションが有効な場合は背景の上部グラデーション、フィルが有効な場合は背景のフィル

Color 2: Mid Gradient — グラデーションが有効な場合は背景の中央グラデーション

Color 3: Bottom Gradient / Buttons

• グラデーションが有効な場合は背景の下部グラデーション
• すべてのボタンと割り当て確認アニメーションの色を設定します
• タイルの色を設定します（タイルの上部ストライプ/枠線は 100% の色の不透明度である一方、タイルの残りの部分は Color 3 の動的な不透明度であり、背景やタイルのワークフローの進行状況に応じて変化します）

Designer Mode Passphrase

これにより、デフォルトの Designer Mode パスフレーズが変更されます。Assigner を構成する際は、必ずこの設定をすぐに変更してください。

Browse All Images

このボタンをクリックすると、各タイルのカスタマイズに使用できるすべてのアイコンのリストが表示されます。リストは非常に大きいですが、どのアイコンもデザインに使用できます。

View & Export App Config

デザインを完成させたら、App Config XML を表示およびエクスポートできます。これは Jamf Pro の Mobile Assist レコードに入り、Designer Mode で行ったカスタマイズに従って、Assigner を実行しているすべてのデバイスを構成します。

View App Config — XML を表示するには、View App Config をタップします。

Copy / Share App Config — この App Config をエクスポートして Jamf Pro に保存できるようにするには、Copy / Share App Config をタップし、構成を送信する共有方法を選択します。

App Config

Designer Mode で Assigner を構成すると、Jamf Pro に入れる必要のある完全な App Config が得られます。これは、Designer Mode で概説したカスタマイズに従って、Assigner を実行しているすべてのデバイスを構成します。Designer Mode から App Config をエクスポートした後、それをコピーして以下の手順を実行します。

App Config を Jamf Pro に追加する

App Config コードをクリップボードにコピーした状態で、Jamf Pro インスタンスにログインし、以下を実行します。

• Devices > Mobile Device Apps > Jamf Mobile Assist > App Configuration > Edit に移動します
• Preferences ウィンドウに App Config を貼り付けます
• Save をクリックします

Appendix A - App Config Reference

以下は Assigner を構成するためのテンプレートです。Assigner の Designer Mode が自動的にこれを作成するため、情報提供を目的として掲載しています。

<!-- Assigner Mode Configuration -->
<key>assigner-mode-enabled</key>
<string>yes</string>
<key>branding-image-link</key>
<string>https://resources.jamf.com/images/logos/Jamf-one-color.png</string>
<key>assigner-scanner-enabled</key>
<string>yes</string>

<!-- Field 1: Assign username -->
<key>assigner-username-enabled</key>
<string>yes</string>
<key>assigner-username-icon</key>
<string>person.fill</string>
<key>assigner-username-title</key>
<string>User</string>

<!-- Field 2: Assign extension attribute #1 -->
<key>assigner-ea1-enabled</key>
<string>yes</string>
<key>assigner-ea1-icon</key>
<string>person.text.rectangle</string>
<key>assigner-ea1-title</key>
<string>Extension Attribute 1</string>
<!-- Menu or Text -->
<key>assigner-ea1-type</key>
<string>menu</string>
<!-- if Menu, then required -->
<key>assigner-ea1-menu</key>
<string>Item 1, Item 2, Item 3</string>

<!-- Field 3: Assign extension attribute #2 -->
<key>assigner-ea2-enabled</key>
<string>yes</string>
<key>assigner-ea2-icon</key>
<string>ipad</string>
<key>assigner-ea2-title</key>
<string>Extension Attribute 2</string>
<!-- Menu or Text -->
<key>assigner-ea2-type</key>
<string>menu</string>
<!-- if Menu, then required -->
<key>assigner-ea2-menu</key>
<string>Item 1, Item 2, Item 3</string>

<!-- Field 4: Building -->
<key>assigner-building-enabled</key>
<string>yes</string>
<key>assigner-building-icon</key>
<string>building</string>
<!-- required -->
<!-- Example, 1:Seattle,2:New York,4:Minneapolis -->
<key>assigner-building-menu</key>
<string>1:Building 1,2:Building 2,3:Building 3</string>

<!-- Field 5: Department -->
<key>assigner-department-enabled</key>
<string>yes</string>
<key>assigner-department-icon</key>
<string>storefront</string>
<!-- required -->
<!-- Example, 1:Sales,7:Marketing,8:Engineering -->
<key>assigner-department-menu</key>
<string>1:Department 1, 2:Department 2, 3:Department 3</string>

<!-- Background Colors: 1: top/lightest gradient or fill, 2: mid gradient, 3: darkest/bottom gradient and buttons -->
<key>background-style</key>
<string>Gradient</string>
<key>bg-color1</key>
<string>red: -0.283, green: 0.75, blue: 0.6</string>
<key>bg-color2</key>
<string>red: -0.16, green: 0.765, blue: 0.928</string>
<key>bg-color3</key>
<string>red: 0.412, green: 0.412, blue: 0.631</string>

<!-- Text Colors -->
<key>text-color-tiles</key>
<string>dark</string>
<key>text-color-headings</key>
<string>dark</string>
<key>text-color-buttons</key>
<string>light</string>

<!-- General UI Text -->
<key>main-instruction-text</key>
<string>Please complete the steps below</string>
<key>completed-assignment-button-text</key>
<string>Reset</string>
<key>completed-assignment-text-message-1</key>
<string>This device is ASSIGNED.</string>
<key>completed-assignment-text-message-2</key>
<string>Tap below to clear assignment.</string>

<!-- Required keys (do not edit) -->
<key>JPS_URL</key>
<string>$JPS_URL</string>
<key>JSSID</key>
<string>$JSSID</string>
<key>MANAGEMENTID</key>
<string>$MANAGEMENTID</string>
<key>OAUTH_AUTH_CODE</key>
<string>$OAUTH_AUTH_CODE</string>
<key>APP_CONFIG_REINSTALL_CODE</key>
<string>$APP_CONFIG_REINSTALL_CODE</string>

Key/Value Reference Table

注: すべての値は string 型です

法的情報

• 使用許諾契約: Application End User License Agreement
• プライバシーポリシー: Jamf Privacy Policy