Jamf Concepts
Guías

Guías

Jamf Return to Service

~25 min read
¿Fue útil?

Introducción

Antes de que Return to Service de Apple estuviera disponible con iOS/iPadOS 17 y tvOS 18, cuando se borraba un dispositivo a través de Jamf Pro, el proceso de reinscripción requería que el usuario seleccionara manualmente el idioma y la ubicación y volviera a conectar el dispositivo al Wi-Fi antes de continuar con los pasos del Asistente de Configuración. Con Return to Service, Jamf Pro puede enviar un comando de borrado que incluye opciones adicionales para proporcionar los ajustes de Wi-Fi, de modo que el usuario no necesite volver a conectarse manualmente al Wi-Fi, además de seleccionar automáticamente el idioma y la ubicación.

Este nuevo flujo de trabajo mejora la experiencia del usuario de modo que, tras un borrado desde Jamf Pro, el usuario regresa a la pantalla de inicio sin pasos manuales adicionales.

Experiencia del usuario final en iOS/iPadOS: Un toque → Sin toques → Pantalla de inicio

Experiencia del usuario final en tvOS: Dos clics → Sin clics → Pantalla de inicio

Experiencia del usuario final

Inicie la app, toque el botón de restablecimiento con 5 segundos disponibles para cancelar y, a continuación, el dispositivo volverá al servicio, de vuelta a la pantalla de inicio, sin ninguna interacción.

Experiencia del usuario final en iOS/iPadOS: Un toque → Sin toques → Pantalla de inicio

Experiencia del usuario final en tvOS: Dos clics → Sin clics → Pantalla de inicio

IMPORTANTE: Nueva opción de implementación

La app Jamf Return to Service ofrece dos opciones de implementación a partir de la versión 3.1.3, denominadas Legacy y Recommended. Recommended introduce un método más seguro para acceder a Jamf Pro desde la app móvil nativa. Jamf recomienda que todas las nuevas instalaciones implementen Recommended. Aunque no es obligatorio, Jamf recomienda que las implementaciones Legacy existentes migren a la implementación Recommended.

Requisitos

iPad y iPhone

  • iOS/iPadOS 17 o posterior
  • Jamf Pro 10.50.0 o posterior (solo para la implementación Legacy)
  • Jamf Pro 11.24.1 o posterior (solo para la implementación Recommended)

Apple TV

  • tvOS 18 o posterior
  • Jamf Pro 11.13.0 o posterior (solo para la implementación Legacy)
  • Jamf Pro 11.24.1 o posterior (solo para la implementación Recommended)

Todos los dispositivos:

  • Dispositivo con alcance en la Inscripción de PreStage (Inscripción Automatizada de Dispositivos)

Limitaciones

  • El Bloqueo de activación debe estar desactivado (solo para la implementación Legacy)
  • No se admite la personalización de la inscripción para la inscripción anterior ni para la siguiente
  • No se admite Requerir credenciales para la inscripción
  • No se admiten las redes 802.1x ni las basadas en certificados para la inscripción
  • No se recomiendan las redes con portales cautivos (redes de invitados)

Habilitar el flujo de trabajo del usuario final (implementación Recommended)

Nota: Los siguientes pasos deben completarse en el orden exacto que se indica a continuación.

Perfil de configuración de Wi-Fi

  • Cree o utilice un perfil de configuración existente que contenga las cargas útiles de Wi-Fi de su red de incorporación

Nota: No se admiten las redes 802.1x ni las basadas en certificados para la inscripción. No se recomiendan las redes con portales cautivos (redes de invitados).

Habilitar PreStage

  • Marque Allow use of the Return to Service option during device reset
  • Seleccione el perfil de configuración de Wi-Fi
  • Marque Preserve managed apps (opcional)

Nota: Una vez que un dispositivo se inscribe a través de PreStage con Preserve managed apps habilitado, el sistema operativo del dispositivo no puede actualizarse de forma remota ni por iniciativa del usuario hasta que el dispositivo se inscriba posteriormente a través de PreStage sin Preserve managed apps marcado.

  • Defina el alcance de los dispositivos a PreStage

Nota: No se admite la personalización de la inscripción para la inscripción anterior ni para la siguiente. No se admite Requerir credenciales para la inscripción.

Configuración inicial del registro de la app

  1. Distribuya la app Return to Service a Jamf Pro mediante el flujo de trabajo de Compras por Volumen
  2. Añada Jamf Return to Service al catálogo de apps de Jamf Pro si no se crea automáticamente
    • Distribución gestionada: marque Assign Content Purchased in Volume
    • No defina el alcance y deje en blanco la configuración gestionada de la app por el momento
    • Haga clic en Save
  3. Anote el ID del registro de la app en la URL que se muestra en la barra de direcciones del navegador: https://yourserver.jamfcloud.com/mobileDeviceApps.html?id=18&o=r

Integración de la API de la app vinculada

  1. Crear rol de la API

    • En Settings > System > API Roles and Clients, seleccione la pestaña API Roles
    • Haga clic en el botón + New
    • Establezca el nombre visible en "Return to Service"
    • Seleccione el siguiente privilegio y haga clic en Save:
      • Send Mobile Device Remote Wipe Command

  2. Crear cliente de la API

    • En Settings > System > API Roles and Clients, seleccione la pestaña API Clients
    • Haga clic en el botón + New
    • Establezca el nombre visible en "Return to Service"
    • Seleccione el rol de la API creado en el paso anterior
    • Seleccione el botón "Enable API Client" y haga clic en Save

  3. Anote el ID del registro del cliente de la API en la URL que se muestra en la barra de direcciones del navegador: https://yourserver.jamfcloud.com/view/settings/system-settings/apiroles-and-clients/api-clients/5

    Nota: No genere un secreto de cliente.

  4. Utilice la API de Jamf Pro para vincular Jamf Return to Service al cliente de la API creado anteriormente

    Utilice una credencial de cliente con el privilegio "Create API Integrations" para solicitar un token de portador. Consulte la documentación de Autenticación y Autorización para obtener más detalles.

    A. Solicitar el token de portador. Modifique yourserver.jamfcloud.com, your_client_id y your_client_secret con los valores guardados de la credencial de cliente con el privilegio "Create API Integrations".

    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. Vincular la app. Modifique el nombre de la instancia de JPS y los 2 ID guardados de Configuración inicial del registro de la app (paso 3) e Integración de la API de la app vinculada (paso 3) anteriores.

    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"]
  }
}
'

Completar la configuración del registro de la app

  1. Edite el registro de la app Jamf Return to Service

  2. Defina el alcance

  3. Añada lo siguiente a la Configuración de la app:

    <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. (Opcional en iOS/iPadOS) Implemente un Web Clip para admitir un icono y un nombre visible personalizados:

    • Label: nombre visible personalizado en la pantalla de inicio
    • URL: return-to-service://
    • Icon: cargue un icono personalizado
    • Marque full screen para suprimir el aviso al usuario para abrir la app

Solo tvOS: Cree otro registro de app en Jamf Pro si se aplica alguna de las siguientes situaciones:

  • El registro de app de Jamf Return to Service existente utiliza el método de distribución "Make available in Self Service". tvOS requiere "Install Automatically/Prompt Users to Install".
  • El registro de app de Jamf Return to Service existente se creó antes de Jamf Return to Service 2.5.0. Antes de la v2.5.0, tvOS no era compatible y el registro de app solo estaba habilitado para la compatibilidad con iOS/iPadOS.

Durante el flujo del Asistente de Configuración tras el borrado, no haga clic en el mando y espere a que aparezca la pantalla de inicio. Puede tardar hasta 3 minutos en completarse tras el reinicio.

Si el mando no está emparejado con el Apple TV tras regresar a la pantalla de inicio, pulse simultáneamente los botones de menú y subir volumen (+) mientras el mando está cerca del Apple TV.

¡Ya está listo para experimentar Return to Service sin intervención!

Habilitar el flujo de trabajo del usuario final (implementación Legacy)

Integración de la API

  1. Crear rol de la API

    En Settings > System > API Roles and Clients:

    • Seleccione la pestaña API Roles
    • Haga clic en el botón + New
    • Establezca el nombre visible en "Return to Service"
    • Seleccione los siguientes privilegios:
      • Read iOS Configuration Profiles
      • Send Mobile Device Remote Wipe Command
      • View MDM command information in Jamf Pro API
      • Read Mobile Devices
    • Haga clic en Save

  2. Crear cliente de la API

    En Settings > System > API Roles and Clients:

    • Seleccione la pestaña API Clients
    • Haga clic en el botón + New
    • Establezca el nombre visible en "Return to Service"
    • Seleccione el rol de la API creado en el paso anterior
    • Seleccione el botón "Enable API Client"
    • Haga clic en Save
    • Haga clic en el botón Generate client secret
    • Haga clic en el botón create secret
    • Copie/guarde el ID de cliente y el secreto de cliente para usarlos más adelante
    • Haga clic en Close

Perfil de configuración de red

  1. Cree o utilice un perfil de configuración existente que contenga la carga útil de Wi-Fi de su red de incorporación
  2. Anote el ID del perfil de configuración en la URL que se muestra en la barra de direcciones del navegador (solo se utiliza el ID, no la URL completa): https://yourinstance.jamfcloud.com/iOSConfigurationProfiles.html?id=18&o=r En este ejemplo, el ID es 18.

Nota: El comportamiento predeterminado de la app es mantener el perfil de configuración de red de Return to Service durante el asistente de configuración y la inscripción. La instancia del perfil de configuración de red utilizada para Return to Service será no gestionada. Cualquier perfil de configuración de red gestionado tendrá prioridad sobre el perfil de configuración no gestionado. El perfil no gestionado se puede eliminar utilizando la clave de configuración gestionada de la app rts_wifi_removal_seconds que se indica en el Apéndice A.

Configuración gestionada de la app

  1. Sustituya las siguientes claves en la plantilla que aparece a continuación:

    <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>
    Clave de configuración de la app Valor
    client_id ID de cliente guardado en un paso anterior
    client_secret Secreto de cliente guardado en un paso anterior
    rts_wifi_config_profile_id ID del perfil de configuración con la carga útil de Wi-Fi indicada anteriormente

  2. Guarde la configuración gestionada de la app para usarla más adelante.

Configuración del registro de la app

  1. Distribuya la app Return to Service a Jamf Pro mediante el flujo de trabajo de Compras por Volumen.
  2. Añada la app al catálogo de apps de Jamf Pro si no se creó automáticamente y complete lo siguiente, luego guarde:
    • General
    • Alcance
    • Distribución gestionada — Marque Assign Content Purchased in Volume
    • Configuración de la app — Copie la configuración gestionada de la app anterior
  3. (Opcional en iOS/iPadOS) Implemente un Web Clip para admitir un icono y un nombre visible personalizados:
    • Label: nombre visible personalizado en la pantalla de inicio
    • URL: return-to-service://
    • Icon: cargue un icono personalizado
    • Marque full screen para suprimir el aviso al usuario para abrir la app

Solo tvOS: Cree otro registro de app repitiendo el paso 2 anterior en Jamf Pro si se aplica alguna de las siguientes situaciones:

  • El registro de app de Jamf Return to Service existente utiliza el método de distribución "Make available in Self Service". tvOS requiere "Install Automatically/Prompt Users to Install".
  • El registro de app de Jamf Return to Service existente se creó antes de Jamf Return to Service 2.5.0. Antes de la v2.5.0, tvOS no era compatible y el registro de app solo estaba habilitado para la compatibilidad con iOS/iPadOS.

Durante el flujo del Asistente de Configuración tras el borrado, no haga clic en el mando y espere a que aparezca la pantalla de inicio. Puede tardar hasta 3 minutos en completarse tras el reinicio.

Si el mando no está emparejado con el Apple TV tras regresar a la pantalla de inicio, pulse simultáneamente los botones de menú y subir volumen (+) mientras el mando está cerca del Apple TV.

¡Ya está listo para experimentar Return to Service sin intervención!

Apéndice A-1: Configuración gestionada de la app (implementación Legacy)

Pares clave/valor

Nota: Todos los valores son de tipo string

Clave Valor Descripción
JPS_URL $JPS_URL URL de la instancia del servidor de Jamf Pro
JSSID $JSSID JSSID del dispositivo que ejecuta la app
MANAGEMENTID $MANAGEMENTID MANAGEMENTID del dispositivo que ejecuta la app
client_id <ID del cliente de la API> ID de cliente de la integración de la API
client_secret <secreto del cliente de la API> Secreto de cliente de la integración de la API
rts_wifi_config_profile_id <id del perfil de configuración> Perfil de configuración que contiene 1 o más cargas útiles de Wi-Fi utilizadas para Return to Service
rts_header_label (opcional) El valor predeterminado es "Return to Service" Texto que se muestra en la parte superior de la pantalla
rts_reset_label (opcional) El valor predeterminado es "Tap Button to Reset" Texto que solicita iniciar
rts_cancel_label (opcional) El valor predeterminado es "Tap Button to Cancel" Texto que solicita cancelar
rts_access_passcode (opcional) El valor predeterminado es "" (en blanco) Novedad en la versión 2.4.7. Configúrelo con un valor alfanumérico para habilitar el requisito de código de acceso para usar la app
rts_countdown_time (opcional) El valor predeterminado es "5" (en segundos) Novedad en la versión 2.4.8. Número de segundos disponibles para cancelar antes de que se borre el dispositivo
rts_wifi_removal_seconds (opcional) El valor predeterminado es "0" (en segundos) Novedad en la versión 2.4.10. Número de segundos antes de que el perfil de configuración utilizado durante Return to Service se elimine del dispositivo
rts_app_preservation (opcional) El valor predeterminado es "no" Novedad en la versión 3.0.0. Configúrelo en "yes" para habilitar la conservación de apps. Tras la primera inscripción correcta del dispositivo, los siguientes eventos de Return to Service instalarán las apps gestionadas dentro del alcance a partir de una instantánea en el dispositivo. Consulte el Apéndice F
rts_no_wifi (opcional) El valor predeterminado es "no" Novedad en la versión 3.1.1. Configúrelo en "yes" para admitir dispositivos conectados por red móvil o Ethernet e ignorar rts_wifi_config_profile_id

Plantilla completa

<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>

Apéndice A-2: Configuración gestionada de la app (implementación Recommended)

Pares clave/valor

Nota: Todos los valores son de tipo string

Clave Valor Descripción
JPS_URL $JPS_URL URL de la instancia del servidor de Jamf Pro
JSSID $JSSID JSSID del dispositivo que ejecuta la app
OAUTH_AUTH_CODE $OAUTH_AUTH_CODE Obligatorio
APP_CONFIG_REINSTALL_CODE $APP_CONFIG_REINSTALL_CODE Obligatorio junto con OAUTH_AUTH_CODE
rts_header_label (opcional) El valor predeterminado es "Return to Service" Texto que se muestra en la parte superior de la pantalla
rts_reset_label (opcional) El valor predeterminado es "Tap Button to Reset" Texto que solicita iniciar
rts_cancel_label (opcional) El valor predeterminado es "Tap Button to Cancel" Texto que solicita cancelar
rts_access_passcode (opcional) El valor predeterminado es "" (en blanco) Novedad en la versión 2.4.7. Configúrelo con un valor alfanumérico para habilitar el requisito de código de acceso para usar la app
rts_countdown_time (opcional) El valor predeterminado es "5" (en segundos) Novedad en la versión 2.4.8. Número de segundos disponibles para cancelar antes de que se borre el dispositivo

Plantilla completa

<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>

Apéndice B: Habilitar el flujo de trabajo de la consola de Jamf Pro (dispositivo de destino)

Requisitos

  • Flujo de trabajo del usuario final configurado y probado correctamente
  • App Jamf Return to Service distribuida a los dispositivos de destino

Ejemplo de configuración de Jamf Pro

  1. Modificar la configuración gestionada de la app

    Añada lo siguiente a la configuración gestionada de la app Jamf Return to Service si no está presente:

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

  2. Ajuste de reinscripción

    En Settings > Global > Re-enrollment:

    Si no está marcado, haga clic en Edit, seleccione "Clear extension attribute values on computers and mobile devices" y, a continuación, haga clic en Save.

  3. Añadir atributo de extensión

    En Settings > Device Management > Extension Attributes:

    • Haga clic en el botón + New
    • Establezca el nombre visible en "Return to Service"
    • Establezca el tipo de entrada en Pop-Up Menu
    • Haga clic en el botón + Add. Añada "Start" como opción
    • Haga clic en el botón + Add. Añada "Cancel" como opción
    • Haga clic en Save
    • Haga clic en Save

  4. Añadir grupo inteligente de dispositivos

    En Mobile Devices > Smart Device Groups:

    • Haga clic en el botón + New
    • Seleccione la pestaña Mobile Device Group
    • Establezca el nombre visible en "Return to Service"
    • Seleccione la pestaña Criteria
    • Haga clic en el botón + Add y haga clic en el botón Show Advanced Criteria
    • Elija "Return to Service"
    • Establezca el operador en "is" y el valor en "Start"
    • Haga clic en el botón + Add
    • Elija "App Name"
    • Establezca el operador en "has" y el valor en "Return to Service"
    • Haga clic en Save

  5. Crear perfil de configuración de Modo de app única

    En Mobile Devices > Configuration Profiles:

    • Haga clic en el botón + New
    • Seleccione General
    • Establezca el nombre en "Single App Mode (Return to Service)"
    • Seleccione "Single App Mode" de la lista de cargas útiles y haga clic en el botón Configure
    • Seleccione "Jamf Return to Service" en el menú desplegable "Lock to App"
    • Seleccione la pestaña Scope
    • Haga clic en el botón + Add
    • Seleccione la pestaña "Mobile Device Groups"
    • Haga clic en el botón Add junto al nombre del grupo "Return to Service"
    • Haga clic en Save

Enviar al dispositivo móvil

En el registro del dispositivo móvil de destino, realice los siguientes 3 pasos:

  1. Haga clic en el botón Edit en la pestaña Inventario: General
  2. Haga clic en Start en el menú desplegable "Return to Service"
  3. Haga clic en el botón Save

La app Jamf Return to Service se iniciará automáticamente en el dispositivo de destino y ejecutará Return to Service sin ninguna interacción del usuario.

Apéndice C: Habilitar el flujo de trabajo de la consola de Jamf Pro (acción masiva)

Requisitos

  • Flujo de trabajo del usuario final configurado y probado correctamente
  • App Jamf Return to Service distribuida a los dispositivos de destino
  • Durante la reinscripción, la capacidad de borrar o establecer el atributo Building o Department del dispositivo

Ejemplo de configuración de Jamf Pro

Nota: El siguiente ejemplo de configuración utiliza un atributo de extensión borrado como el atributo para desencadenar Return to Service.

  1. Modificar la configuración gestionada de la app

    Añada lo siguiente a la configuración gestionada de la app Jamf Return to Service si no está presente:

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

  2. Ajuste de reinscripción

    En Settings > Global > Re-enrollment:

    Si no está marcado, haga clic en Edit, seleccione "Clear user and location information on mobile devices and computers" y, a continuación, haga clic en Save.

    Nota: Otras opciones para establecer los atributos de building o department durante la inscripción incluyen configurarlos en la inscripción de prestage o en la precarga de inventario.

  3. Añadir Return to Service al atributo

    En Settings > Network > Departments:

    • Haga clic en el botón + New. Establezca el nombre visible en "Return to Service". Haga clic en Save
    • Haga clic en la flecha atrás
    • Haga clic en el botón + New. Establezca el nombre visible en "Cancel". Haga clic en Save

  4. Añadir grupo inteligente de dispositivos

    En Mobile Devices > Smart Device Groups:

    • Haga clic en el botón + New
    • Seleccione la pestaña Mobile Device Group
    • Establezca el nombre visible en "Return to Service"
    • Seleccione la pestaña Criteria
    • Haga clic en el botón + Add
    • Elija "Department"
    • Establezca el operador en "is" y el valor en "Start"
    • Haga clic en el botón + Add
    • Elija "App Name"
    • Establezca el operador en "has" y el valor en "Return to Service"
    • Haga clic en Save

  5. Crear perfil de configuración de Modo de app única

    En Mobile Devices > Configuration Profiles:

    • Haga clic en el botón + New
    • Seleccione General
    • Establezca el nombre en "Single App Mode (Return to Service)"
    • Seleccione "Single App Mode" de la lista de cargas útiles y haga clic en el botón Configure
    • Seleccione "Jamf Return to Service" en el menú desplegable "Lock to App"
    • Seleccione la pestaña Scope
    • Haga clic en el botón + Add
    • Seleccione la pestaña "Mobile Device Groups"
    • Haga clic en el botón Add junto al nombre del grupo "Return to Service"
    • Haga clic en Save

Acción masiva sobre el grupo de dispositivos móviles

Seleccione el grupo inteligente de dispositivos de destino:

  1. Haga clic en el botón View y haga clic en el botón Action
  2. Haga clic en el botón Next ("Edit the Building and Department" es la acción predeterminada)
  3. Elija "Return to Service" en el menú desplegable Department
  4. Haga clic en el botón Next y haga clic en el botón Done

La app Jamf Return to Service se iniciará automáticamente en los dispositivos de destino y ejecutará Return to Service sin ninguna interacción del usuario.

Apéndice D: Habilitar el flujo de trabajo de escucha sanitaria de Auto Return to Service (Auto RtS) con precarga de inventario

Requisitos

  • Flujo de trabajo del usuario final configurado y probado correctamente
  • App Jamf Return to Service distribuida a los dispositivos de destino
  • Durante la reinscripción, la capacidad de establecer el atributo de extensión del dispositivo mediante la precarga de inventario
  • Jamf Healthcare Listener instalado y configurado

Ejemplo de configuración de Jamf Pro

  1. Modificar la configuración gestionada de la app

    Añada lo siguiente a la configuración gestionada de la app Jamf Return to Service si no está presente:

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

  2. Añadir atributo de extensión

    En Settings > Device Management > Extension Attributes:

    • Haga clic en el botón + New
    • Establezca el nombre visible en "Auto Return to Service"
    • Establezca la descripción en "Extension attribute for Jamf Healthcare Listener to automatically launch Return to Service app"
    • Establezca el tipo de datos en String
    • Establezca la visualización del inventario en Extension Attributes
    • Establezca el tipo de entrada en Pop-up Menu
    • Seleccione el botón + Add. Escriba "Ready"
    • Haga clic en Save en la opción del menú desplegable
    • Haga clic en Save en la esquina inferior derecha

  3. Añadir grupo inteligente de dispositivos

    En Mobile Devices > Smart Device Groups:

    • Haga clic en el botón + New
    • Seleccione la pestaña Mobile Device Group
    • Establezca el nombre visible en "Auto Return to Service"
    • Seleccione la pestaña Criteria
    • Haga clic en el botón + Add
    • Elija el atributo de extensión "Auto Return to Service" que creó anteriormente
    • Establezca el operador en "is" y deje el valor en blanco
    • Haga clic en el botón + Add
    • Elija "App Name"
    • Establezca el operador en "has" y el valor en "Return to Service"
    • Haga clic en Save

  4. Crear perfil de configuración de Modo de app única

    En Mobile Devices > Configuration Profiles:

    • Haga clic en el botón + New
    • Seleccione General
    • Establezca el nombre en "Single App Mode (Return to Service)"
    • Seleccione "Single App Mode" de la lista de cargas útiles y haga clic en el botón Configure
    • Seleccione "Jamf Return to Service" en el menú desplegable "Lock to App"
    • Seleccione la pestaña Scope
    • Haga clic en el botón + Add
    • Seleccione la pestaña "Mobile Device Groups"
    • Haga clic en el botón Add junto al nombre del grupo "Auto Return to Service"
    • Haga clic en Save

  5. Crear regla de Healthcare Listener

    En Settings > Server > Infrastructure Managers:

    Nota: Si Healthcare Listener ya está configurado en su entorno para borrar dispositivos, debe sustituir las reglas existentes de alta/traslado por las siguientes.

    • Seleccione su Healthcare Listener. Seleccione Edit. Haga clic en el botón + Add
    • Cree un nombre visible de su elección (Ejemplo: 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 (Ejemplo: Patient Discharge: A03 / Patient Transfer: A02)
    • Haga clic en Save

    Nota: Si se aplican códigos de acceso en los dispositivos de los pacientes (no es habitual), cree otra regla para emitir un comando remoto de borrado de código de acceso en el evento ADT.

  6. Añadir precarga de inventario para dispositivos de pacientes

    En Settings > Global > Inventory Preload:

    Si ya tiene la precarga de inventario configurada, modifique su plantilla para añadir una columna llamada EA Auto Return To Service (debe coincidir con el atributo de extensión creado anteriormente).

    • Establezca el estado en "Auto Return to Service" en Ready
    • Seleccione File Upload y cargue la plantilla de precarga de inventario

Probar manualmente el flujo de trabajo de Auto Return to Service

En el registro del dispositivo móvil de destino, realice los siguientes 3 pasos:

  1. Haga clic en el botón Edit en la pestaña Inventario: Extension Attributes
  2. Seleccione <Blank> en el menú desplegable "Auto Return to Service"
  3. Haga clic en el botón Save

La app Jamf Return to Service se iniciará automáticamente en el dispositivo de destino y ejecutará Return to Service sin ninguna interacción del usuario.

Apéndice E: Habilitar el flujo de trabajo de escucha sanitaria de Auto Return to Service (Auto RtS) sin precarga de inventario

Requisitos

  • Flujo de trabajo del usuario final configurado y probado correctamente
  • App Jamf Return to Service distribuida a los dispositivos de destino
  • NO borre los atributos de extensión durante la reinscripción
  • Jamf Healthcare Listener instalado y configurado

Ejemplo de configuración de Jamf Pro

  1. Modificar la configuración gestionada de la app

    Añada lo siguiente a la configuración gestionada de la app Jamf Return to Service si no está presente:

    <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. Modificar el rol de la API

    Añada el siguiente privilegio al rol de la API de Return to Service:

    • Update Mobile Devices

  3. Añadir atributo de extensión

    En Settings > Device Management > Extension Attributes:

    • Haga clic en el botón + New
    • Establezca el nombre visible en "Auto Return to Service"
    • Establezca la descripción en "Extension attribute for Jamf Healthcare Listener to automatically launch Return to Service app"
    • Establezca el tipo de datos en String
    • Establezca la visualización del inventario en Extension Attributes
    • Establezca el tipo de entrada en Pop-up Menu
    • Seleccione el botón + Add. Escriba "Ready"
    • Haga clic en Save en la opción del menú desplegable
    • Haga clic en Save en la esquina inferior derecha

  4. Añadir grupo inteligente de dispositivos

    En Mobile Devices > Smart Device Groups:

    • Haga clic en el botón + New
    • Seleccione la pestaña Mobile Device Group
    • Establezca el nombre visible en "Auto Return to Service"
    • Seleccione la pestaña Criteria
    • Haga clic en el botón + Add
    • Elija el atributo de extensión "Auto Return to Service" que creó anteriormente
    • Establezca el operador en "is" y deje el valor en blanco
    • Haga clic en el botón + Add
    • Elija "App Name"
    • Establezca el operador en "has" y el valor en "Return to Service"
    • Haga clic en Save

  5. Crear perfil de configuración de Modo de app única

    En Mobile Devices > Configuration Profiles:

    • Haga clic en el botón + New
    • Seleccione General
    • Establezca el nombre en "Single App Mode (Return to Service)"
    • Seleccione "Single App Mode" de la lista de cargas útiles y haga clic en el botón Configure
    • Seleccione "Jamf Return to Service" en el menú desplegable "Lock to App"
    • Seleccione la pestaña Scope
    • Haga clic en el botón + Add
    • Seleccione la pestaña "Mobile Device Groups"
    • Haga clic en el botón Add junto al nombre del grupo "Auto Return to Service"
    • Haga clic en Save

  6. Crear regla de Healthcare Listener

    En Settings > Server > Infrastructure Managers:

    Nota: Si Healthcare Listener ya está configurado en su entorno para borrar dispositivos, debe sustituir las reglas existentes de alta/traslado por las siguientes.

    • Seleccione su Healthcare Listener. Seleccione Edit. Haga clic en el botón + Add
    • Cree un nombre visible de su elección (Ejemplo: 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 (Ejemplo: Patient Discharge: A03 / Patient Transfer: A02)
    • Haga clic en Save

    Nota: Si se aplican códigos de acceso en los dispositivos de los pacientes (no es habitual), cree otra regla para emitir un comando remoto de borrado de código de acceso en el evento ADT.

Probar manualmente el flujo de trabajo de Auto Return to Service

En el registro del dispositivo móvil de destino, realice los siguientes 3 pasos:

  1. Haga clic en el botón Edit en la pestaña Inventario: Extension Attributes
  2. Seleccione <Blank> en el menú desplegable "Auto Return to Service"
  3. Haga clic en el botón Save

La app Jamf Return to Service se iniciará automáticamente en el dispositivo de destino y ejecutará Return to Service sin ninguna interacción del usuario.

Apéndice F: Habilitar la conservación de apps (implementación Legacy)

Requisitos

  • iOS/iPadOS 26.0 o posterior
  • Jamf Pro 11.20 o posterior

Ejemplo de configuración de Jamf Pro

  1. Modificar la configuración gestionada de la app

    Añada lo siguiente a la configuración gestionada de la app Jamf Return to Service si no está presente:

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

  2. Modificar el rol de la API

    Añada el siguiente privilegio al rol de la API de Return to Service si no está presente:

    • Read Mobile Devices

  3. Habilitar PreStage

    • Marque Allow use of the Return to Service option during device reset
    • Seleccione el perfil de configuración de Wi-Fi
    • Marque Preserve managed apps
    • Defina el alcance de los dispositivos a PreStage

    Nota: La app utilizará el perfil de configuración de Wi-Fi definido en la configuración gestionada de la app y NO el perfil definido en PreStage. El perfil definido en PreStage solo debe contener una carga útil de Wi-Fi y ninguna otra carga útil.

  4. Return to Service inicial

    • Inicie Return to Service desde la app
    • Jamf Pro depositará en custodia el token de arranque (bootstrap token) y preparará el dispositivo para la conservación de apps

  5. Return to Service tras el inicial

    • Inicie Return to Service desde la app
    • Las apps gestionadas dentro del alcance se instalarán a partir de la instantánea en el dispositivo, si está presente, en lugar de desde la red

Legal

¿Fue útil?