Guías

¿Qué es Assigner?

Assigner forma parte de la app Jamf Mobile Assist y permite la configuración e implementación rápidas de dispositivos iOS y iPadOS de uso compartido. Un usuario simplemente coge un dispositivo, se autentica, escanea un código o introduce otra información definida por el administrador para identificar su rol o ubicación. Assigner configura entonces el dispositivo según sus necesidades. Cuando termina, solo tiene que tocar un botón en la misma app para borrar esas opciones del dispositivo.

A partir de la versión 1.9.0 de Mobile Assist, Assigner se rediseñó para permitir un mayor grado de personalización, además de proporcionar a los administradores la capacidad de ser más granulares con los criterios que definen cómo Assigner asigna dispositivos a los usuarios.

Las actualizaciones de esta versión incluyen:

• Flujo de trabajo de asignación de usuarios basado en mosaicos
• Habilitar/deshabilitar cualquier mosaico del flujo de trabajo
• Personalizar todos los aspectos de cada mosaico, incluidos colores, texto, iconos y método de entrada (p. ej. usar la cámara para escanear la entrada, escribir manualmente, elegir en menús desplegables)
• Personalizar todos los colores de la app y del texto, incluido el uso de fondos sólidos o degradados
• Personalizar la marca con el logotipo de la empresa mediante una URL a la imagen
• Hacer todo lo anterior desde un Designer Mode integrado en la app que crea automáticamente la App Config que usará en Jamf Pro para configurar Assigner en todos sus dispositivos

¿Cómo funciona Assigner?

A muy alto nivel, Assigner toma la información que un usuario introduce en un dispositivo iOS y la escribe en Jamf Pro, donde esa información se utiliza para determinar la pertenencia a grupos inteligentes con el fin de implementar configuraciones y apps.

¿Qué puntos de datos se escriben en Jamf Pro?

En el registro de inventario del dispositivo, Assigner escribe los siguientes elementos:

• Nombre de usuario
• Extension Attribute 1 (definido por el administrador)
• Extension Attribute 2 (definido por el administrador)
• Building (definido por el administrador)
• Department (definido por el administrador)

Flujo de trabajo de asignación / mosaicos

Assigner utiliza un flujo de trabajo de asignación basado en mosaicos. Cada uno de los 5 mosaicos puede personalizarse para adaptarse a las necesidades de una amplia gama de organizaciones de diversos sectores. Además, prácticamente todos los aspectos de la app pueden personalizarse: texto, colores, iconos, menús, métodos de entrada y logotipo de marca.

El usuario avanza por los mosaicos, ya sea escribiendo información manualmente, seleccionando en menús desplegables o escaneando texto / códigos QR con la cámara del dispositivo.

Cuando un usuario completa correctamente el flujo de trabajo, recibe una confirmación y sus configuraciones / apps se implementan automáticamente. La app Assigner muestra entonces un mensaje indicando que el dispositivo está actualmente asignado y que puede desasignarse mediante el botón de reinicio.

Configuración inicial requerida

Para acceder a Assigner desde la app Mobile Assist, primero debe completar los siguientes pasos.

Instalar la app Jamf Mobile Assist mediante Jamf Pro

1. Distribuya la app a Jamf Pro mediante el flujo de trabajo de Volume Purchasing
2. Añada Jamf Mobile Assist al catálogo de apps de Jamf Pro si no se crea automáticamente
   • Marque Assign Content Purchased in Volume en la pestaña Managed Distribution
   • No aplique ámbito y deje la App Configuration en blanco por ahora
3. Anote el ID del registro de la app que aparece en la URL de la barra de direcciones del navegador para consultarlo en los siguientes pasos: https://yourinstance.jamfcloud.com/mobileDeviceApps.html?id=18&o=r En este ejemplo, el ID es 18.

Habilitar Assigner con la herramienta integrada (Jamf App Wizard)

A continuación, Assigner debe configurarse para funcionar en Jamf Pro. La app Mobile Assist contiene una herramienta llamada Jamf App Wizard. Esta herramienta configurará automáticamente el API Role y el Client requeridos, además de crear la Linked App Integration de Assigner.

1. Aplique el ámbito de Mobile Assist a un dispositivo al que tenga acceso. No añada ninguna App Configuration.

2. Inicie Mobile Assist en este dispositivo. Cuando no hay ninguna App Config presente, Jamf App Wizard se abrirá automáticamente. También puede usar las siguientes claves de App Config para abrir el asistente en cualquier momento tras la implementación:

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

3. Con una cuenta con privilegios de Administrator, inicie sesión en su instancia de Jamf Pro.

4. Una vez completada la carga, se mostrarán todas las apps de dispositivo móvil de su instancia. Busque la entrada de Jamf Mobile Assist. Nota: si tiene varias entradas, use el ID del Paso 3 anterior como referencia.

5. Toque la app para ver el detalle. En la descripción de la app, seleccione Begin App Integration.

6. Complete cada paso del flujo de trabajo de Assigner Integration:

   1. Confirme que la pestaña Assigner esté seleccionada
   2. Introduzca un nombre para el API Role y haga clic en Create API Role. Nota: se devolverá un error si introduce un nombre que ya existe.
   3. Introduzca un nombre para el API Client y haga clic en Create API Client
   4. Confirm App Link Request: revise los nombres y los ID de objeto que se han creado para esta integración
   5. Si todo parece correcto, haga clic en Complete App Link
   6. Si tiene éxito, puede volver a la sección anterior yendo a la pestaña Navigation y tocando el botón Return
   7. Ahora puede ver la integración en la pestaña Current Integrations

App Config básica requerida

Con los pasos anteriores completados, ahora puede aplicar el ámbito de la app y establecer la siguiente App Config temporal para que Assigner se active. En el registro de Mobile Device App de Jamf Pro para Jamf Mobile Assist, añada esta App Config temporal para habilitar Assigner:

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

• Copie el código anterior y vaya a la app Mobile Assist (Devices > Mobile Device Apps > Jamf Mobile Assist > App Configuration)
• Haga clic en Edit, pegue el código anterior y luego haga clic en Save
• Con los pasos anteriores completados, ahora debería poder abrir Mobile Assist en un dispositivo y Assigner se iniciará automáticamente

Designer Mode

Designer Mode le permite crear su flujo de trabajo de mosaicos de Assigner directamente desde la app Assigner. Al terminar, puede exportar el XML de la App Config y enviarlo por AirDrop / Mensaje, etc. a un dispositivo donde pueda acceder a él y pegar el código en Jamf Pro.

Acceder a Designer Mode

Para acceder a Designer Mode:

• Inicie Mobile Assist / Assigner
• Mantenga pulsado el logotipo de la parte superior de la vista principal durante 5 segundos. Aparecerá una ventana de frase de contraseña
• La frase de contraseña predeterminada es "admin" y puede cambiarse en Designer Mode

Personalizar los mosaicos y la apariencia de Assigner

Cada mosaico de Assigner puede personalizarse, al igual que los colores, el texto, los iconos, el método de entrada y el logotipo que se muestran en la app.

Modo de escaneo con cámara / entrada de formulario

Seleccionar una opción de modo hace lo siguiente:

Form & Scan

• El escáner de cámara está habilitado y permitirá al usuario usar la cámara del dispositivo para escanear códigos y texto
• Cuando está habilitado, puede escanear desde un mosaico que muestra el icono de escaneo

Form

• El escáner de cámara no está habilitado y todos los campos deben introducirse manualmente

Mosaico de inicio de sesión (Mosaico 1)

Este mosaico puede configurarse para requerir que un usuario se autentique contra Jamf Pro (cuenta de Jamf Pro o LDAP) y no avanzará si no se introducen las credenciales correctas.

Nota: Si el escáner está deshabilitado, este mosaico se presentará con una configuración de nombre de usuario / contraseña. Si el escáner está habilitado, el campo de contraseña no se mostrará.

Configure este mosaico de la siguiente manera:

Enabled — Habilita o deshabilita el mosaico del flujo de trabajo

Title — Cambia el texto del título del mosaico

Icon — Cambia el icono junto al título. Puede previsualizar todas las imágenes disponibles desplazándose hasta la parte inferior de Designer Mode y tocando "Browse all images"

Preview Tile — Toque aquí para previsualizar su diseño

Mosaicos de atributos de extensión (Mosaicos 2–5)

Estos mosaicos escriben en los Mobile Device Extension Attributes de Jamf Pro permitiendo al usuario seleccionar de una lista desplegable o escanear/introducir texto directamente. Asegúrese de haber creado el número deseado de atributos de extensión con un tipo de entrada de Text Field.

Configure estos mosaicos de la siguiente manera:

Enabled — Habilita o deshabilita el mosaico del flujo de trabajo

Input

• Menu: Permite a los usuarios seleccionar elementos de una lista desplegable
• Text: Permite a los usuarios escanear o introducir valores manualmente

Title — Introduzca aquí el nombre exacto del atributo de extensión

Icon — Cambia el icono junto al título

Menu — Introduzca los elementos que desea que el usuario seleccione en el menú desplegable como valores separados por comas (ej.: Item 1, Item 2, Item 3). Nota: Input debe estar configurado como Menu. Importante: Pulse return en el teclado para confirmar.

Mosaicos de Building y Department (Mosaicos 6–7)

Los dos últimos mosaicos escriben en los atributos Building y Department del registro del dispositivo. Al usuario se le presentará un menú desplegable de las selecciones de Building y/o Department disponibles.

Configure estos mosaicos de la siguiente manera:

Enabled — Habilita o deshabilita el mosaico del flujo de trabajo

Title — No puede cambiarse para Building o Department

Icon — Cambia el icono junto al título

Menu — Introduzca los elementos que desea que el usuario seleccione en el menú desplegable como valores separados por comas. Para Building y Department, debe seguir esta convención de nomenclatura:

• ObjectID:Name, ObjectID:Name, ObjectID:Name (donde ObjectID es el ID de Jamf Pro del Building o Department y Name es el nombre del Building o Department)
• Para obtener el ID de Jamf Pro de un Building o Department, vaya a Jamf Pro > Settings > Network > (Buildings o Departments) > seleccione un elemento > lea la URL de ese elemento — el ID será el número final
• Por ejemplo, si tiene un Building llamado "New York", al hacer clic en él se mostrará https://myinstance.jamfcloud.com/view/settings/network-organization/buildings/3. Para añadirlo en Assigner, use 3:New York
• Importante: Pulse return en el teclado para confirmar

Esquema de color del texto

Estos valores se usan para cambiar el color del texto (ya sea claro u oscuro) para que funcione con cualquier color que haya elegido para los mosaicos y el fondo de la app.

Headings Text — Establece el color del texto que aparece debajo del logotipo. El texto en sí puede cambiarse en Other Text Values > Title

Tile Text — Establece el color del texto y el icono de los mosaicos

Button Text — Establece el color del texto de los botones (p. ej. Submit/Reset, escanear, menús desplegables)

Otros valores de texto

Aquí puede cambiar el contenido del texto que se muestra en las partes de la app que no son mosaicos.

Title — Establece el texto que aparece debajo del logotipo de marca

Reset Button — Establece el texto del botón que se usa para reiniciar la asignación del dispositivo después de asignarlo

Assignment Complete Line 1 — Establece la primera línea de texto que aparece tras una asignación correcta. Esto reemplaza la vista de mosaicos

Assignment Complete Line 2 — Establece la segunda línea de texto que aparece tras una asignación correcta. Esto reemplaza la vista de mosaicos

Enlace de la imagen de marca

Establece la imagen de marca que se muestra en la parte superior de la pantalla principal mediante una URL.

Branding Image Link — Introduzca la URL de una imagen de marca que le gustaría usar para la app. La imagen aparecerá inmediatamente en el espacio de debajo. Si el enlace no funciona o la imagen no puede mostrarse por otro motivo, se aplican automáticamente una imagen y un texto de marcador de posición. Asegúrese de probar el tamaño y el espaciado de la imagen en la pantalla principal de Assigner.

Esquema de color del fondo

Aquí puede establecer el color general de la app, los mosaicos y los botones, etc. Además, puede establecer el fondo como un degradado o un color sólido.

Background — Establece el esquema de color de fondo Gradient (degradado) o Fill (sólido) de la app

• Si se selecciona Gradient, los colores 1–3 se usan en toda la app, con el Color 1 en la parte superior del fondo, el Color 2 en el medio y el Color 3 en la parte inferior
• Si se selecciona Fill, se usa el Color 1 para el fondo y no se usa el Color 2

Color 1: Top Gradient / Fill — Degradado superior del fondo si Gradient está habilitado, relleno del fondo si Fill está habilitado

Color 2: Mid Gradient — Degradado medio del fondo si Gradient está habilitado

Color 3: Bottom Gradient / Buttons

• Degradado inferior del fondo si Gradient está habilitado
• Establece el color de todos los botones y de la animación de confirmación de la asignación
• Establece el color del mosaico (la franja superior / borde del mosaico tiene una opacidad de color del 100 %, mientras que el resto del mosaico tiene una opacidad dinámica del Color 3, que cambia según el fondo y el progreso del flujo de trabajo del mosaico)

Frase de contraseña de Designer Mode

Esto cambia la frase de contraseña predeterminada de Designer Mode. Asegúrese de cambiar este ajuste inmediatamente al configurar Assigner.

Browse All Images

Haga clic en este botón para ver una lista de todos los iconos que puede usar para personalizar cada mosaico. Tenga en cuenta que la lista es extremadamente amplia, pero cualquier icono puede usarse en su diseño.

Ver y exportar la App Config

Tras completar su diseño, puede ver y exportar el XML de la App Config. Esto irá al registro de Mobile Assist en Jamf Pro y configurará todos los dispositivos que ejecutan Assigner de acuerdo con las personalizaciones realizadas en Designer Mode.

View App Config — Para ver el XML, toque View App Config.

Copy / Share App Config — Para exportar esta App Config de modo que pueda guardarse en Jamf Pro, toque Copy / Share App Config y, a continuación, seleccione un método de compartir para enviar la configuración.

App Config

Tras configurar Assigner mediante Designer Mode, tendrá una App Config completa que debe ir a Jamf Pro. Esto configurará todos los dispositivos que ejecutan Assigner de acuerdo con la personalización descrita en Designer Mode. Después de exportar la App Config desde Designer Mode, cópiela y realice los siguientes pasos.

Añadir la App Config a Jamf Pro

Con el código de la App Config copiado en el portapapeles, inicie sesión en su instancia de Jamf Pro y realice lo siguiente:

• Vaya a Devices > Mobile Device Apps > Jamf Mobile Assist > App Configuration > Edit
• Pegue la App Config en la ventana de Preferences
• Haga clic en Save

Apéndice A - Referencia de la App Config

La siguiente es la plantilla para configurar Assigner. Se proporciona con fines informativos, ya que Designer Mode de Assigner la crea automáticamente por usted.

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

Tabla de referencia de claves/valores

Nota: Todos los valores son del tipo string

Aspectos legales

• Acuerdo de uso: Application End User License Agreement
• Política de privacidad: Jamf Privacy Policy