Jamf Concepts
指南

指南

Jamf Return to Service

~13 min read
這對您有幫助嗎？

簡介

在 Apple 於 iOS/iPadOS 17 與 tvOS 18 推出 Return to Service 之前，當裝置透過 Jamf Pro 清除後，重新註冊流程會要求使用者手動選取語言、位置並重新連接裝置至 Wi-Fi，才能繼續執行 Setup Assistant 步驟。有了 Return to Service，Jamf Pro 可傳送含有額外選項的清除指令以提供 Wi-Fi 設定，使用者便無需手動重新連接 Wi-Fi，同時還會自動選取語言與位置。

這項全新的工作流程改善了使用者體驗，讓裝置在經 Jamf Pro 清除後，無需額外手動步驟即可回到主畫面。

iOS/iPadOS 終端使用者體驗： 點一下 → 不再點按 → 主畫面

tvOS 終端使用者體驗： 按兩下 → 不再按按 → 主畫面

終端使用者體驗

啟動 app，觸碰重設按鈕（有 5 秒可供取消），接著裝置便會 return to service 回到主畫面，無需任何互動。

iOS/iPadOS 終端使用者體驗： 點一下 → 不再點按 → 主畫面

tvOS 終端使用者體驗： 按兩下 → 不再按按 → 主畫面

重要：全新的實作選項

自 3.1.3 版起，Jamf Return to Service App 提供兩種實作選項，分別稱為 Legacy 與 Recommended。Recommended 引入了一種更安全的方法，供原生行動 app 存取 Jamf Pro。Jamf 建議所有新安裝皆採用 Recommended。雖非必要，Jamf 仍建議現有的 Legacy 實作移轉至 Recommended 實作。

需求

iPad 與 iPhone

  • iOS/iPadOS 17 以上
  • Jamf Pro 10.50.0 以上（僅限 Legacy 實作）
  • Jamf Pro 11.24.1 以上（僅限 Recommended 實作）

Apple TV

  • tvOS 18 以上
  • Jamf Pro 11.13.0 以上（僅限 Legacy 實作）
  • Jamf Pro 11.24.1 以上（僅限 Recommended 實作）

所有裝置：

  • 裝置已設定範圍至 PreStage Enrollment（Automated Device Enrollment）

限制

  • 必須停用 Activation Lock（僅限 Legacy 實作）
  • 前次註冊或下次註冊皆不支援 Enrollment Customization
  • 不支援 Require Credentials for Enrollment
  • 註冊不支援 802.1x 與憑證式網路
  • 不建議使用含 captive portal 的網路（訪客網路）

啟用終端使用者工作流程（Recommended 實作）

注意： 下列步驟必須完全依所列順序完成。

Wi-Fi 組態描述檔

  • 建立或使用含有你上線網路 Wi-Fi 酬載的現有組態描述檔

注意： 註冊不支援 802.1x 與憑證式網路。不建議使用含 captive portal 的網路（訪客網路）。

啟用 PreStage

  • 勾選 Allow use of the Return to Service option during device reset
  • 選取 Wi-Fi 組態描述檔
  • 勾選 Preserve managed apps（選用）

注意： 一旦裝置以啟用 Preserve managed apps 的方式透過 PreStage 註冊，該裝置的 OS 便無法遠端更新或由使用者自行啟動更新，直到裝置後續以未勾選 Preserve managed apps 的方式再次透過 PreStage 註冊為止。

  • 將裝置設定範圍至 PreStage

注意： 前次註冊或下次註冊皆不支援 Enrollment Customization。不支援 Require Credentials for Enrollment。

初始 App 記錄設定

  1. 使用 Volume Purchasing 流程將 Return to Service app 派送至 Jamf Pro
  2. 若未自動建立，請將 Jamf Return to Service 新增至 Jamf Pro app 目錄
    • Managed Distribution：勾選 Assign Content Purchased in Volume
    • 此時請勿設定範圍，並將 managed app configuration 保持空白
    • 按一下 Save
  3. 記下瀏覽器網址列所顯示 URL 中的 app 記錄 ID： https://yourserver.jamfcloud.com/mobileDeviceApps.html?id=18&o=r

Linked App API Integration

  1. Create API Role

    • 在 Settings > System > API Roles and Clients 中，選取 API Roles 分頁
    • 按一下 + New 按鈕
    • 將 Display name 設為「Return to Service」
    • 選取下列權限並按一下 Save：
      • Send Mobile Device Remote Wipe Command

  2. Create API Client

    • 在 Settings > System > API Roles and Clients 中，選取 API Clients 分頁
    • 按一下 + New 按鈕
    • 將 Display name 設為「Return to Service」
    • 選取上一步驟建立的 API Role
    • 選取 "Enable API Client" 按鈕並按一下 Save

  3. 記下瀏覽器網址列所顯示 URL 中的 API Client 記錄 ID： https://yourserver.jamfcloud.com/view/settings/system-settings/apiroles-and-clients/api-clients/5

    注意： 請勿產生 client secret。

  4. 使用 Jamf Pro API 將 Jamf Return to Service 連結至上方建立的 API Client

    使用具備「Create API Integrations」權限的 client credential 來請求 bearer token。詳情請參閱 Authentication and Authorization 文件。

    A. 請求 bearer token。 以你儲存的、具備「Create API Integrations」權限之 client credential 的值，修改 yourserver.jamfcloud.com、your_client_id 與 your_client_secret。

    TOKEN=$(curl -s -X POST "https://yourserver.jamfcloud.com/api/oauth/token" \
  --header "Content-Type: application/x-www-form-urlencoded" \
  --data-urlencode "grant_type=client_credentials" \
  --data-urlencode "client_id=your_client_id" \
  --data-urlencode "client_secret=your_client_secret" \
  | plutil -extract access_token raw -)

    B. 連結 app。 修改 JPS 執行個體名稱，以及上方於初始 App 記錄設定（步驟 3）與 Linked App API Integration（步驟 3）所儲存的 2 個 ID。

    curl --request POST \
  --url https://yourserver.jamfcloud.com/api/v1/api-integrations-linked-app \
  --header "Authorization: Bearer $TOKEN" \
  --header "accept: application/json" \
  --header "content-type: application/json" \
  --data '
{
  "apiIntegrationId": "0",
  "linkedAppId": "0",
  "linkedAppType": "MOBILE_DEVICE_APP",
  "claims": {
    "targets": ["MOBILE_DEVICE_ID"]
  }
}
'

完成 App 記錄設定

  1. 編輯 Jamf Return to Service app 記錄

  2. 設定範圍

  3. 將下列內容新增至 App Configuration：

    <dict>
  <key>JPS_URL</key>
  <string>$JPS_URL</string>
  <key>JSSID</key>
  <string>$JSSID</string>
  <key>OAUTH_AUTH_CODE</key>
  <string>$OAUTH_AUTH_CODE</string>
  <key>APP_CONFIG_REINSTALL_CODE</key>
  <string>$APP_CONFIG_REINSTALL_CODE</string>
</dict>

  4. （iOS/iPadOS 選用） 部署 Web Clip 以支援自訂圖示與顯示名稱：

    • Label： 主畫面上的自訂顯示名稱
    • URL： return-to-service://
    • Icon： 上傳自訂圖示
    • 勾選 full screen 以抑制提示使用者開啟 app 的訊息

僅限 tvOS： 若符合下列任一情況，請在 Jamf Pro 中另建一個 app 記錄：

  • 現有的 Jamf Return to Service app 記錄使用「Make available in Self Service」的派送方式。tvOS 需要「Install Automatically/Prompt Users to Install」。
  • 現有的 Jamf Return to Service app 記錄建立於 Jamf Return to Service 2.5.0 之前。在 v2.5.0 之前，tvOS 不受支援，且該 app 記錄僅啟用 iOS/iPadOS 支援。

在清除後的 Setup Assistant 流程期間，請勿點按遙控器，並等待主畫面出現。重新啟動後最多可能需要 3 分鐘才會完成。

若返回主畫面後遙控器尚未與 Apple TV 配對，請在遙控器靠近 Apple TV 時，同時按下 menu 與音量增大（+）按鈕。

現在已準備好體驗零接觸的 return to service！

啟用終端使用者工作流程（Legacy 實作）

API Integration

  1. Create API Role

    在 Settings > System > API Roles and Clients 中：

    • 選取 API Roles 分頁
    • 按一下 + New 按鈕
    • 將 Display name 設為「Return to Service」
    • 選取下列權限：
      • Read iOS Configuration Profiles
      • Send Mobile Device Remote Wipe Command
      • View MDM command information in Jamf Pro API
      • Read Mobile Devices
    • 按一下 Save

  2. Create API Client

    在 Settings > System > API Roles and Clients 中：

    • 選取 API Clients 分頁
    • 按一下 + New 按鈕
    • 將 Display name 設為「Return to Service」
    • 選取上一步驟建立的 API Role
    • 選取 "Enable API Client" 按鈕
    • 按一下 Save
    • 按一下 Generate client secret 按鈕
    • 按一下 create secret 按鈕
    • 複製／儲存 client ID 與 client secret 以供稍後使用
    • 按一下 Close

網路組態描述檔

  1. 建立或使用含有你上線網路 Wi-Fi 酬載的現有組態描述檔
  2. 記下瀏覽器網址列所顯示 URL 中的組態描述檔 ID（僅使用 ID，非完整 URL）： https://yourinstance.jamfcloud.com/iOSConfigurationProfiles.html?id=18&o=r 在此範例中，ID 為 18。

注意： app 的預設行為是在整個 setup assistance 與註冊過程中，持續保留 Return to Service 的網路組態描述檔。用於 Return to Service 的網路組態描述檔執行個體將為 unmanaged。任何 managed 網路組態描述檔都會優先於 unmanaged 組態描述檔。可使用附錄 A 所列的 managed app config 索引鍵 rts_wifi_removal_seconds 移除該 unmanaged 描述檔。

Managed App Configuration

  1. 替換下列範本中的下列索引鍵：

    <dict>
  <key>JPS_URL</key>
  <string>$JPS_URL</string>
  <key>JSSID</key>
  <string>$JSSID</string>
  <key>MANAGEMENTID</key>
  <string>$MANAGEMENTID</string>
  <key>client_id</key>
  <string>ENTER_YOUR_CLIENT_ID_HERE</string>
  <key>client_secret</key>
  <string>ENTER_YOUR_CLIENT_SECRET_HERE</string>
  <key>rts_wifi_config_profile_id</key>
  <string>ENTER_YOUR_WIFI_CONFIG_PROFILE_ID_HERE</string>
</dict>
    App Config Key Value
    client_id 前一步驟儲存的 Client ID
    client_secret 前一步驟儲存的 Client Secret
    rts_wifi_config_profile_id 上方記下之含 Wi-Fi 酬載的組態描述檔 ID

  2. 儲存 managed app config 以供稍後使用。

App 記錄組態

  1. 使用 Volume Purchasing 流程將 Return to Service app 派送至 Jamf Pro。
  2. 若未自動建立，請將 app 新增至 Jamf Pro app 目錄並完成下列項目，然後儲存：
    • General
    • Scope
    • Managed Distribution —— 勾選 Assign Content Purchased in Volume
    • App Configuration —— 複製上方的 managed app config
  3. （iOS/iPadOS 選用） 部署 Web Clip 以支援自訂圖示與顯示名稱：
    • Label： 主畫面上的自訂顯示名稱
    • URL： return-to-service://
    • Icon： 上傳自訂圖示
    • 勾選 full screen 以抑制提示使用者開啟 app 的訊息

僅限 tvOS： 若符合下列任一情況，請在 Jamf Pro 中重複上方步驟 2 另建一個 app 記錄：

  • 現有的 Jamf Return to Service app 記錄使用「Make available in Self Service」的派送方式。tvOS 需要「Install Automatically/Prompt Users to Install」。
  • 現有的 Jamf Return to Service app 記錄建立於 Jamf Return to Service 2.5.0 之前。在 v2.5.0 之前，tvOS 不受支援，且該 app 記錄僅啟用 iOS/iPadOS 支援。

在清除後的 Setup Assistant 流程期間，請勿點按遙控器，並等待主畫面出現。重新啟動後最多可能需要 3 分鐘才會完成。

若返回主畫面後遙控器尚未與 Apple TV 配對，請在遙控器靠近 Apple TV 時，同時按下 menu 與音量增大（+）按鈕。

現在已準備好體驗零接觸的 return to service！

附錄 A-1：Managed App Configuration（Legacy 實作）

Key/Value 對照表

注意： 所有值的類型皆為 string

Key Value 說明
JPS_URL $JPS_URL Jamf Pro Server 執行個體 URL
JSSID $JSSID 執行 app 之裝置的 JSSID
MANAGEMENTID $MANAGEMENTID 執行 app 之裝置的 MANAGEMENTID
client_id <API Client ID> API Integration 的 Client ID
client_secret <API Client secret> API Integration 的 Client Secret
rts_wifi_config_profile_id <config profile id> 內含一個以上供 return to service 使用之 Wi-Fi 酬載的組態描述檔
rts_header_label （選用）預設為「Return to Service」 顯示在畫面頂端的文字
rts_reset_label （選用）預設為「Tap Button to Reset」 提示開始的文字
rts_cancel_label （選用）預設為「Tap Button to Cancel」 提示取消的文字
rts_access_passcode （選用）預設為 ""（空白） 2.4.7 版新增。設為英數字元值，即可啟用使用 app 所需的密碼要求
rts_countdown_time （選用）預設為 "5"（秒） 2.4.8 版新增。裝置被清除前可供取消的秒數
rts_wifi_removal_seconds （選用）預設為 "0"（秒） 2.4.10 版新增。Return to Service 期間所用的組態描述檔在裝置上被移除前的秒數
rts_app_preservation （選用）預設為 "no" 3.0.0 版新增。設為 "yes" 以啟用 app preservation。裝置首次成功註冊後，後續的 Return to Service 事件將從裝置上的快照安裝範圍內的 managed apps。請參閱附錄 F
rts_no_wifi （選用）預設為 "no" 3.1.1 版新增。設為 "yes" 以支援行動網路或乙太網路連線的裝置，並忽略 rts_wifi_config_profile_id

完整範本

<dict>
  <key>JPS_URL</key>
  <string>$JPS_URL</string>
  <key>JSSID</key>
  <string>$JSSID</string>
  <key>MANAGEMENTID</key>
  <string>$MANAGEMENTID</string>
  <key>client_id</key>
  <string>ENTER_YOUR_CLIENT_ID_HERE</string>
  <key>client_secret</key>
  <string>ENTER_YOUR_CLIENT_SECRET_HERE</string>
  <key>rts_wifi_config_profile_id</key>
  <string>ENTER_YOUR_WIFI_CONFIG_PROFILE_ID_HERE</string>
  <key>rts_header_label</key>
  <string>Return to Service</string>
  <key>rts_reset_label</key>
  <string>Tap Button to Reset</string>
  <key>rts_cancel_label</key>
  <string>Tap Button to Cancel</string>
  <key>rts_access_passcode</key>
  <string></string>
  <key>rts_countdown_time</key>
  <string>5</string>
  <key>rts_wifi_removal_seconds</key>
  <string>0</string>
  <key>rts_app_preservation</key>
  <string>no</string>
</dict>

附錄 A-2：Managed App Configuration（Recommended 實作）

Key/Value 對照表

注意： 所有值的類型皆為 string

Key Value 說明
JPS_URL $JPS_URL Jamf Pro Server 執行個體 URL
JSSID $JSSID 執行 app 之裝置的 JSSID
OAUTH_AUTH_CODE $OAUTH_AUTH_CODE 必要
APP_CONFIG_REINSTALL_CODE $APP_CONFIG_REINSTALL_CODE 與 OAUTH_AUTH_CODE 一併必要
rts_header_label （選用）預設為「Return to Service」 顯示在畫面頂端的文字
rts_reset_label （選用）預設為「Tap Button to Reset」 提示開始的文字
rts_cancel_label （選用）預設為「Tap Button to Cancel」 提示取消的文字
rts_access_passcode （選用）預設為 ""（空白） 2.4.7 版新增。設為英數字元值，即可啟用使用 app 所需的密碼要求
rts_countdown_time （選用）預設為 "5"（秒） 2.4.8 版新增。裝置被清除前可供取消的秒數

完整範本

<dict>
  <key>JPS_URL</key>
  <string>$JPS_URL</string>
  <key>JSSID</key>
  <string>$JSSID</string>
  <key>OAUTH_AUTH_CODE</key>
  <string>$OAUTH_AUTH_CODE</string>
  <key>APP_CONFIG_REINSTALL_CODE</key>
  <string>$APP_CONFIG_REINSTALL_CODE</string>
  <key>rts_header_label</key>
  <string>Return to Service</string>
  <key>rts_reset_label</key>
  <string>Tap Button to Reset</string>
  <key>rts_cancel_label</key>
  <string>Tap Button to Cancel</string>
  <key>rts_access_passcode</key>
  <string></string>
  <key>rts_countdown_time</key>
  <string>5</string>
</dict>

附錄 B：啟用 Jamf Pro 主控台工作流程（目標裝置）

需求

  • 已成功設定並測試終端使用者工作流程
  • Jamf Return to Service app 已派送至目標裝置

Jamf Pro 組態範例

  1. 修改 Managed App Configuration

    若尚未包含，請將下列內容新增至 Jamf Return to Service managed app configuration：

    <key>rts_auto</key>
<string>yes</string>

  2. Re-enrollment 設定

    在 Settings > Global > Re-enrollment 中：

    若未勾選，請按一下 Edit，選取 "Clear extension attribute values on computers and mobile devices"，然後按一下 Save。

  3. 新增 Extension Attribute

    在 Settings > Device Management > Extension Attributes 中：

    • 按一下 + New 按鈕
    • 將 Display Name 設為「Return to Service」
    • 將 Input Type 設為 Pop-Up Menu
    • 按一下 + Add 按鈕。新增「Start」作為選項
    • 按一下 + Add 按鈕。新增「Cancel」作為選項
    • 按一下 Save
    • 按一下 Save

  4. 新增 Smart Device Group

    在 Mobile Devices > Smart Device Groups 中：

    • 按一下 + New 按鈕
    • 選取 Mobile Device Group 分頁
    • 將 Display Name 設為「Return to Service」
    • 選取 Criteria 分頁
    • 按一下 + Add 按鈕，並按一下 Show Advanced Criteria 按鈕
    • 選擇「Return to Service」
    • 將 Operator 設為「is」，並將值設為「Start」
    • 按一下 + Add 按鈕
    • 選擇「App Name」
    • 將 Operator 設為「has」，並將值設為「Return to Service」
    • 按一下 Save

  5. 建立 Single App Mode 組態描述檔

    在 Mobile Devices > Configuration Profiles 中：

    • 按一下 + New 按鈕
    • 選取 General
    • 將 Name 設為「Single App Mode (Return to Service)」
    • 從酬載清單選取「Single App Mode」，並按一下 Configure 按鈕
    • 從「Lock to App」彈出式選單選取「Jamf Return to Service」
    • 選取 Scope 分頁
    • 按一下 + Add 按鈕
    • 選取「Mobile Device Groups」分頁
    • 在「Return to Service」群組名稱旁按一下 Add 按鈕
    • 按一下 Save

傳送至行動裝置

在目標行動裝置記錄中，執行下列 3 個步驟：

  1. 在 Inventory 分頁：General 中按一下 Edit 按鈕
  2. 從「Return to Service」彈出式選單按一下 Start
  3. 按一下 Save 按鈕

Jamf Return to Service app 會自動在目標裝置上啟動，並執行 Return to Service，無需任何使用者互動。

附錄 C：啟用 Jamf Pro 主控台工作流程（Mass Action）

需求

  • 已成功設定並測試終端使用者工作流程
  • Jamf Return to Service app 已派送至目標裝置
  • 於重新註冊期間，能清除或設定裝置 Building 或 Department 屬性

Jamf Pro 組態範例

注意： 下列組態範例使用已清除的 extension attribute 作為觸發 Return to Service 的屬性。

  1. 修改 Managed App Configuration

    若尚未包含，請將下列內容新增至 Jamf Return to Service managed app configuration：

    <key>rts_auto</key>
<string>yes</string>

  2. Re-enrollment 設定

    在 Settings > Global > Re-enrollment 中：

    若未勾選，請按一下 Edit，選取 "Clear user and location information on mobile devices and computers"，然後按一下 Save。

    注意： 於註冊期間設定 building 或 department 屬性的其他選項，包括在 prestage enrollment 中設定或使用 inventory preload。

  3. 將 Return to Service 新增至屬性

    在 Settings > Network > Departments 中：

    • 按一下 + New 按鈕。將 Display Name 設為「Return to Service」。按一下 Save
    • 按一下返回箭頭
    • 按一下 + New 按鈕。將 Display Name 設為「Cancel」。按一下 Save

  4. 新增 Smart Device Group

    在 Mobile Devices > Smart Device Groups 中：

    • 按一下 + New 按鈕
    • 選取 Mobile Device Group 分頁
    • 將 Display Name 設為「Return to Service」
    • 選取 Criteria 分頁
    • 按一下 + Add 按鈕
    • 選擇「Department」
    • 將 Operator 設為「is」，並將值設為「Start」
    • 按一下 + Add 按鈕
    • 選擇「App Name」
    • 將 Operator 設為「has」，並將值設為「Return to Service」
    • 按一下 Save

  5. 建立 Single App Mode 組態描述檔

    在 Mobile Devices > Configuration Profiles 中：

    • 按一下 + New 按鈕
    • 選取 General
    • 將 Name 設為「Single App Mode (Return to Service)」
    • 從酬載清單選取「Single App Mode」，並按一下 Configure 按鈕
    • 從「Lock to App」彈出式選單選取「Jamf Return to Service」
    • 選取 Scope 分頁
    • 按一下 + Add 按鈕
    • 選取「Mobile Device Groups」分頁
    • 在「Return to Service」群組名稱旁按一下 Add 按鈕
    • 按一下 Save

對 Mobile Device Group 執行 Mass Action

選取目標 Smart device group：

  1. 按一下 View 按鈕，並按一下 Action 按鈕
  2. 按一下 Next 按鈕（「Edit the Building and Department」為預設動作）
  3. 從 Department 彈出式選單選擇「Return to Service」
  4. 按一下 Next 按鈕，並按一下 Done 按鈕

Jamf Return to Service app 會自動在目標裝置上啟動，並執行 Return to Service，無需任何使用者互動。

附錄 D：啟用 Auto Return to Service Healthcare Listener 工作流程（Auto RtS）搭配 inventory preload

需求

  • 已成功設定並測試終端使用者工作流程
  • Jamf Return to Service app 已派送至目標裝置
  • 於重新註冊期間，能使用 inventory preload 設定裝置 extension attribute
  • 已設定並組態 Jamf Healthcare Listener

Jamf Pro 組態範例

  1. 修改 Managed App Configuration

    若尚未包含，請將下列內容新增至 Jamf Return to Service managed app configuration：

    <key>rts_auto</key>
<string>yes</string>

  2. 新增 Extension Attribute

    在 Settings > Device Management > Extension Attributes 中：

    • 按一下 + New 按鈕
    • 將 Display Name 設為「Auto Return to Service」
    • 將 Description 設為「Extension attribute for Jamf Healthcare Listener to automatically launch Return to Service app」
    • 將 Data Type 設為 String
    • 將 Inventory Display 設為 Extension Attributes
    • 將 Input type 設為 Pop-up Menu
    • 選取 + Add 按鈕。輸入「Ready」
    • 在 Pop-up Menu 選項中按一下 Save
    • 在右下角按一下 Save

  3. 新增 Smart Device Group

    在 Mobile Devices > Smart Device Groups 中：

    • 按一下 + New 按鈕
    • 選取 Mobile Device Group 分頁
    • 將 Display Name 設為「Auto Return to Service」
    • 選取 Criteria 分頁
    • 按一下 + Add 按鈕
    • 選擇你先前建立的「Auto Return to Service」extension attribute
    • 將 Operator 設為「is」，並將值保留空白
    • 按一下 + Add 按鈕
    • 選擇「App Name」
    • 將 Operator 設為「has」，並將值設為「Return to Service」
    • 按一下 Save

  4. 建立 Single App Mode 組態描述檔

    在 Mobile Devices > Configuration Profiles 中：

    • 按一下 + New 按鈕
    • 選取 General
    • 將 Name 設為「Single App Mode (Return to Service)」
    • 從酬載清單選取「Single App Mode」，並按一下 Configure 按鈕
    • 從「Lock to App」彈出式選單選取「Jamf Return to Service」
    • 選取 Scope 分頁
    • 按一下 + Add 按鈕
    • 選取「Mobile Device Groups」分頁
    • 在「Auto Return to Service」群組名稱旁按一下 Add 按鈕
    • 按一下 Save

  5. 建立 Healthcare Listener 規則

    在 Settings > Server > Infrastructure Managers 中：

    注意： 若你的環境中已設定 Healthcare Listener 以清除裝置，則必須以下列規則取代現有的 discharge/transfer 規則。

    • 選取你的 Healthcare Listener。選取 Edit。按一下 + Add 按鈕
    • 建立你自訂的 Display Name（範例：A03 - Auto Return to Service）
    • Set Remote Command： Clear Extension Attribute
    • Set Mobile Device Extension Attribute： Auto Return to Service
    • Select ADT message to automatically run rule（範例：Patient Discharge: A03 / Patient Transfer: A02）
    • 按一下 Save

    注意： 若病患裝置上強制執行密碼（不常見），請另建一條規則，於 ADT 事件時發出 clear passcode 遠端指令。

  6. 為病患裝置新增 Inventory Preload

    在 Settings > Global > Inventory Preload 中：

    若你已設定 inventory preload，請修改範本以新增名為 EA Auto Return To Service 的欄位（必須與先前建立的 extension attribute 相符）。

    • 將「Auto Return to Service」中的狀態設為 Ready
    • 選取 File Upload 並上傳 inventory preload 範本

手動測試 Auto Return to Service 工作流程

在目標行動裝置記錄中，執行下列 3 個步驟：

  1. 在 Inventory 分頁：Extension Attributes 中按一下 Edit 按鈕
  2. 從「Auto Return to Service」彈出式選單選取 <Blank>
  3. 按一下 Save 按鈕

Jamf Return to Service app 會自動在目標裝置上啟動，並執行 Return to Service，無需任何使用者互動。

附錄 E：啟用 Auto Return to Service Healthcare Listener 工作流程（Auto RtS）不搭配 inventory preload

需求

  • 已成功設定並測試終端使用者工作流程
  • Jamf Return to Service app 已派送至目標裝置
  • 於重新註冊期間請勿清除 extension attributes
  • 已設定並組態 Jamf Healthcare Listener

Jamf Pro 組態範例

  1. 修改 Managed App Configuration

    若尚未包含，請將下列內容新增至 Jamf Return to Service managed app configuration：

    <key>JSSID</key>
<string>$JSSID</string>
<key>rts_auto</key>
<string>yes</string>
<key>rts_hcl</key>
<string>yes</string>
<key>rts_hcl_ea_name</key>
<string>Auto Return to Service</string>
<key>rts_hcl_ea_value</key>
<string>Ready</string>

  2. 修改 API Role

    將下列權限新增至 Return to Service API Role：

    • Update Mobile Devices

  3. 新增 Extension Attribute

    在 Settings > Device Management > Extension Attributes 中：

    • 按一下 + New 按鈕
    • 將 Display Name 設為「Auto Return to Service」
    • 將 Description 設為「Extension attribute for Jamf Healthcare Listener to automatically launch Return to Service app」
    • 將 Data Type 設為 String
    • 將 Inventory Display 設為 Extension Attributes
    • 將 Input type 設為 Pop-up Menu
    • 選取 + Add 按鈕。輸入「Ready」
    • 在 Pop-up Menu 選項中按一下 Save
    • 在右下角按一下 Save

  4. 新增 Smart Device Group

    在 Mobile Devices > Smart Device Groups 中：

    • 按一下 + New 按鈕
    • 選取 Mobile Device Group 分頁
    • 將 Display Name 設為「Auto Return to Service」
    • 選取 Criteria 分頁
    • 按一下 + Add 按鈕
    • 選擇你先前建立的「Auto Return to Service」extension attribute
    • 將 Operator 設為「is」，並將值保留空白
    • 按一下 + Add 按鈕
    • 選擇「App Name」
    • 將 Operator 設為「has」，並將值設為「Return to Service」
    • 按一下 Save

  5. 建立 Single App Mode 組態描述檔

    在 Mobile Devices > Configuration Profiles 中：

    • 按一下 + New 按鈕
    • 選取 General
    • 將 Name 設為「Single App Mode (Return to Service)」
    • 從酬載清單選取「Single App Mode」，並按一下 Configure 按鈕
    • 從「Lock to App」彈出式選單選取「Jamf Return to Service」
    • 選取 Scope 分頁
    • 按一下 + Add 按鈕
    • 選取「Mobile Device Groups」分頁
    • 在「Auto Return to Service」群組名稱旁按一下 Add 按鈕
    • 按一下 Save

  6. 建立 Healthcare Listener 規則

    在 Settings > Server > Infrastructure Managers 中：

    注意： 若你的環境中已設定 Healthcare Listener 以清除裝置，則必須以下列規則取代現有的 discharge/transfer 規則。

    • 選取你的 Healthcare Listener。選取 Edit。按一下 + Add 按鈕
    • 建立你自訂的 Display Name（範例：A03 - Auto Return to Service）
    • Set Remote Command： Clear Extension Attribute
    • Set Mobile Device Extension Attribute： Auto Return to Service
    • Select ADT message to automatically run rule（範例：Patient Discharge: A03 / Patient Transfer: A02）
    • 按一下 Save

    注意： 若病患裝置上強制執行密碼（不常見），請另建一條規則，於 ADT 事件時發出 clear passcode 遠端指令。

手動測試 Auto Return to Service 工作流程

在目標行動裝置記錄中，執行下列 3 個步驟：

  1. 在 Inventory 分頁：Extension Attributes 中按一下 Edit 按鈕
  2. 從「Auto Return to Service」彈出式選單選取 <Blank>
  3. 按一下 Save 按鈕

Jamf Return to Service app 會自動在目標裝置上啟動，並執行 Return to Service，無需任何使用者互動。

附錄 F：啟用 App Preservation（Legacy 實作）

需求

  • iOS/iPadOS 26.0 以上
  • Jamf Pro 11.20 以上

Jamf Pro 組態範例

  1. 修改 Managed App Configuration

    若尚未包含，請將下列內容新增至 Jamf Return to Service managed app configuration：

    <key>rts_app_preservation</key>
<string>yes</string>
<key>JSSID</key>
<string>$JSSID</string>

  2. 修改 API Role

    若尚未包含，請將下列權限新增至 Return to Service API Role：

    • Read Mobile Devices

  3. 啟用 PreStage

    • 勾選 Allow use of the Return to Service option during device reset
    • 選取 Wi-Fi 組態描述檔
    • 勾選 Preserve managed apps
    • 將裝置設定範圍至 PreStage

    注意： app 會使用 managed app config 中所定義的 Wi-Fi 組態描述檔，而非 PreStage 中所定義的描述檔。PreStage 中所定義的描述檔必須僅包含一個 Wi-Fi 酬載，且不含其他任何酬載。

  4. 初始 Return to Service

    • 從 app 啟動 Return to Service
    • Jamf Pro 會託管 bootstrap token 並為 app preservation 準備裝置

  5. 初始之後的 Return to Service

    • 從 app 啟動 Return to Service
    • 若裝置上有快照，範圍內的 managed apps 將從裝置上的快照安裝，而非從網路安裝

法律

這對您有幫助嗎？