Guides

Qu'est-ce qu'Assigner ?

Assigner fait partie de l'app Jamf Mobile Assist et permet la configuration et le paramétrage rapides d'appareils iOS et iPadOS à usage partagé. Un utilisateur prend simplement un appareil, s'authentifie, scanne un code ou saisit d'autres informations définies par l'administrateur afin d'identifier son rôle ou son emplacement. Assigner configure ensuite l'appareil selon ses besoins. Lorsqu'il a terminé, il lui suffit d'appuyer sur un bouton dans la même app pour effacer ces choix de l'appareil.

À partir de la version 1.9.0 de Mobile Assist, Assigner a été repensé pour permettre un plus grand degré de personnalisation, et pour offrir aux administrateurs la possibilité d'être plus précis avec les critères qui définissent la façon dont Assigner assigne les appareils aux utilisateurs.

Les nouveautés de cette version incluent :

• Flux d'assignation d'utilisateur basé sur des tuiles
• Activer/désactiver n'importe quelle tuile du flux
• Personnaliser tous les aspects de chaque tuile, y compris les couleurs, le texte, les icônes, la méthode de saisie (par ex. utiliser l'appareil photo pour scanner la saisie, saisir manuellement, choisir dans des menus déroulants)
• Personnaliser toutes les couleurs de l'app et du texte, y compris l'utilisation d'arrière-plans unis ou de dégradés
• Personnaliser l'image de marque avec un logo d'entreprise via une URL vers l'image
• Faire tout ce qui précède depuis un Designer Mode intégré à l'app, qui crée automatiquement l'App Config que vous utiliserez dans Jamf Pro pour configurer Assigner sur tous vos appareils

Comment fonctionne Assigner ?

D'un point de vue très général, Assigner prend les informations qu'un utilisateur saisit dans un appareil iOS et les écrit dans Jamf Pro, où ces informations servent à déterminer les appartenances aux Smart Groups pour déployer des configurations et des apps.

Quels points de données sont écrits dans Jamf Pro ?

Dans l'enregistrement d'inventaire de l'appareil, les éléments suivants sont écrits avec Assigner :

• Nom d'utilisateur
• Extension Attribute 1 (défini par l'administrateur)
• Extension Attribute 2 (défini par l'administrateur)
• Building (défini par l'administrateur)
• Department (défini par l'administrateur)

Flux d'assignation / Tuiles

Assigner utilise un flux d'assignation basé sur des tuiles. Chacune des 5 tuiles peut être personnalisée pour répondre aux besoins d'un large éventail d'organisations dans divers secteurs. De plus, pratiquement tous les aspects de l'app peuvent être personnalisés : texte, couleurs, icônes, menus, méthodes de saisie et logo de marque.

L'utilisateur progresse à travers les tuiles, soit en saisissant manuellement des informations, soit en sélectionnant dans des menus déroulants, soit en scannant du texte / des codes QR à l'aide de l'appareil photo de l'appareil.

Lorsqu'un utilisateur complète le flux avec succès, il reçoit une confirmation et ses configurations / apps sont automatiquement déployées. L'app Assigner affiche alors un message indiquant que l'appareil est actuellement assigné et peut être désassigné à l'aide du bouton Reset.

Configuration initiale requise

Pour accéder à Assigner depuis l'app Mobile Assist, vous devez d'abord effectuer les étapes suivantes.

Installer l'app Jamf Mobile Assist via Jamf Pro

1. Distribuez l'app à Jamf Pro à l'aide du flux Volume Purchasing
2. Ajoutez Jamf Mobile Assist au catalogue d'apps de Jamf Pro s'il n'est pas créé automatiquement
   • Cochez Assign Content Purchased in Volume dans l'onglet Managed Distribution
   • Ne définissez pas de portée et laissez l'App Configuration vide pour le moment
3. Notez l'ID de l'enregistrement de l'app dans l'URL affichée dans la barre d'adresse du navigateur pour référence dans les étapes suivantes : https://yourinstance.jamfcloud.com/mobileDeviceApps.html?id=18&o=r Dans cet exemple, l'ID est 18.

Activer Assigner avec l'outil intégré (Jamf App Wizard)

Ensuite, Assigner doit être configuré pour fonctionner dans Jamf Pro. L'app Mobile Assist contient un outil appelé Jamf App Wizard. Cet outil configurera automatiquement l'API Role et le Client requis, et créera la Linked App Integration d'Assigner.

1. Définissez la portée de Mobile Assist sur un appareil auquel vous avez accès. N'ajoutez aucune App Configuration.

2. Lancez Mobile Assist sur cet appareil. Lorsqu'aucun App Config n'est présent, Jamf App Wizard s'ouvre automatiquement. Vous pouvez également utiliser les clés App Config suivantes pour ouvrir le Wizard à tout moment après le déploiement :

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

3. À l'aide d'un compte disposant de privilèges d'administrateur, connectez-vous à votre instance Jamf Pro.

4. Une fois le chargement terminé, toutes les apps pour appareils mobiles de votre instance s'affichent. Trouvez l'entrée pour Jamf Mobile Assist. Remarque : si vous avez plusieurs entrées, utilisez l'ID de l'étape 3 ci-dessus comme référence.

5. Appuyez sur l'app pour afficher les détails. Dans la description de l'app, sélectionnez Begin App Integration.

6. Complétez chaque étape du flux d'intégration d'Assigner :

   1. Confirmez que l'onglet Assigner est sélectionné
   2. Saisissez un nom pour l'API Role puis cliquez sur Create API Role. Remarque : une erreur sera renvoyée si vous saisissez un nom qui existe déjà.
   3. Saisissez un nom pour l'API Client puis cliquez sur Create API Client
   4. Confirm App Link Request : vérifiez les noms et les ID d'objets qui ont été créés pour cette intégration
   5. Si tout semble correct, cliquez sur Complete App Link
   6. En cas de succès, vous pouvez revenir à la section précédente en accédant à l'onglet Navigation et en appuyant sur le bouton Return
   7. Vous pouvez maintenant afficher l'intégration dans l'onglet Current Integrations

App Config de base requis

Une fois les étapes ci-dessus terminées, vous pouvez maintenant définir la portée de l'app et configurer l'App Config temporaire suivant afin qu'Assigner soit activé. Dans l'enregistrement Mobile Device App de Jamf Pro pour Jamf Mobile Assist, ajoutez cet App Config temporaire pour activer 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>

• Copiez le code ci-dessus et accédez à l'app Mobile Assist (Devices > Mobile Device Apps > Jamf Mobile Assist > App Configuration)
• Cliquez sur Edit, collez le code ci-dessus puis cliquez sur Save
• Une fois les étapes ci-dessus terminées, vous devriez maintenant pouvoir ouvrir Mobile Assist sur un appareil et Assigner se lancera automatiquement

Designer Mode

Designer Mode vous permet de construire votre flux de tuiles Assigner directement depuis l'app Assigner. Une fois terminé, vous pouvez exporter l'App Config XML et l'envoyer par AirDrop / Message, etc. vers un appareil où vous pourrez accéder au code et le coller dans Jamf Pro.

Accéder à Designer Mode

Pour accéder à Designer Mode :

• Lancez Mobile Assist / Assigner
• Appuyez et maintenez le logo en haut de la vue principale pendant 5 secondes. Une fenêtre de phrase secrète apparaîtra
• La phrase secrète par défaut est « admin » et peut être modifiée dans Designer Mode

Personnaliser les tuiles et l'apparence d'Assigner

Chaque tuile Assigner peut être personnalisée, tout comme les couleurs, le texte, les icônes, la méthode de saisie et le logo présentés dans l'app.

Mode Camera Scan / Form Entry

La sélection d'une option de mode fait ce qui suit :

Form & Scan

• Le scanner par appareil photo est activé et permet à l'utilisateur d'utiliser l'appareil photo de l'appareil pour scanner des codes et du texte
• Lorsqu'il est activé, vous pouvez scanner depuis une tuile qui affiche l'icône de scan

Form

• Le scanner par appareil photo n'est pas activé et tous les champs doivent être saisis manuellement

Login Tile (Tuile 1)

Cette tuile peut être configurée pour exiger qu'un utilisateur s'authentifie auprès de Jamf Pro (compte Jamf Pro ou LDAP) et ne progressera pas plus loin si les identifiants corrects ne sont pas saisis.

Remarque : Si le scanner est désactivé, cette tuile présentera une configuration nom d'utilisateur / mot de passe. Si le scanner est activé, le champ mot de passe ne s'affichera pas.

Configurez cette tuile comme suit :

Enabled — Activer ou désactiver la tuile du flux

Title — Modifier le texte du titre de la tuile

Icon — Modifier l'icône à côté du titre. Vous pouvez prévisualiser toutes les images disponibles en faisant défiler jusqu'au bas de Designer Mode et en appuyant sur « Browse all images »

Preview Tile — Appuyez ici pour prévisualiser votre conception

Extension Attribute Tiles (Tuiles 2–5)

Ces tuiles écrivent dans les Mobile Device Extension Attributes de Jamf Pro en permettant à l'utilisateur de sélectionner dans une liste déroulante ou de scanner/saisir du texte directement. Assurez-vous d'avoir créé le nombre souhaité d'Extension Attributes avec un Input Type de Text Field.

Configurez ces tuiles comme suit :

Enabled — Activer ou désactiver la tuile du flux

Input

• Menu : Permet aux utilisateurs de sélectionner des éléments dans une liste déroulante
• Text : Permet aux utilisateurs de scanner ou de saisir manuellement des valeurs

Title — Saisissez le nom exact de l'Extension Attribute ici

Icon — Modifier l'icône à côté du titre

Menu — Saisissez les éléments parmi lesquels vous souhaitez que l'utilisateur choisisse dans le menu déroulant sous forme de valeurs séparées par des virgules (ex : Item 1, Item 2, Item 3). Remarque : Input doit être défini sur Menu. Important : Appuyez sur entrée sur le clavier pour valider.

Building and Department Tiles (Tuiles 6–7)

Les deux dernières tuiles écrivent dans les attributs Building et Department de l'enregistrement de l'appareil. L'utilisateur se verra présenter une liste déroulante des sélections Building et/ou Department disponibles.

Configurez ces tuiles comme suit :

Enabled — Activer ou désactiver la tuile du flux

Title — Ne peut pas être modifié pour Building ou Department

Icon — Modifier l'icône à côté du titre

Menu — Saisissez les éléments parmi lesquels vous souhaitez que l'utilisateur choisisse dans le menu déroulant sous forme de valeurs séparées par des virgules. Pour Building et Department, vous devez suivre cette convention de nommage :

• ObjectID:Name, ObjectID:Name, ObjectID:Name (où ObjectID est l'ID Jamf Pro du Building ou Department et Name est le nom du Building ou Department)
• Pour obtenir l'ID Jamf Pro d'un Building ou d'un Department, allez dans Jamf Pro > Settings > Network > (Buildings ou Departments) > sélectionnez un élément > lisez l'URL de cet élément — l'ID sera le numéro à la fin
• Par exemple, si vous avez un Building appelé « New York », le fait de cliquer dessus affichera https://myinstance.jamfcloud.com/view/settings/network-organization/buildings/3. Pour l'ajouter dans Assigner, utilisez 3:New York
• Important : Appuyez sur entrée sur le clavier pour valider

Text Color Scheme

Ces valeurs servent à modifier la couleur du texte (soit clair, soit foncé) pour qu'elle s'harmonise avec toute couleur que vous avez choisie pour les tuiles et l'arrière-plan de l'app.

Headings Text — Définit la couleur du texte situé sous le logo. Le texte lui-même peut être modifié dans Other Text Values > Title

Tile Text — Définit la couleur du texte et de l'icône dans les tuiles

Button Text — Définit la couleur du texte dans les boutons (par ex. Submit/Reset, scan, menus déroulants)

Other Text Values

Ici, vous pouvez modifier le contenu du texte qui s'affiche dans les portions non-tuiles de l'app.

Title — Définit le texte qui apparaît sous le logo de marque

Reset Button — Définit le texte du bouton utilisé pour réinitialiser l'assignation de l'appareil après son assignation

Assignment Complete Line 1 — Définit la première ligne de texte qui apparaît après une assignation réussie. Ceci remplace la vue en tuiles

Assignment Complete Line 2 — Définit la deuxième ligne de texte qui apparaît après une assignation réussie. Ceci remplace la vue en tuiles

Branding Image Link

Définit l'image de marque affichée en haut de l'écran principal à l'aide d'une URL.

Branding Image Link — Saisissez l'URL d'une image de marque que vous souhaitez utiliser pour l'app. L'image apparaîtra immédiatement dans l'espace ci-dessous. Si le lien ne fonctionne pas ou si l'image ne peut pas être affichée pour une autre raison, une image et un texte de substitution sont automatiquement appliqués. Assurez-vous de tester le dimensionnement et l'espacement de l'image sur l'écran principal d'Assigner.

Background Color Scheme

Ici, vous pouvez définir la couleur globale de l'app, des tuiles et des boutons, etc. De plus, vous pouvez définir l'arrière-plan sur un dégradé ou une couleur unie.

Background — Définit le schéma de couleurs d'arrière-plan Gradient (dégradé) ou Fill (uni) pour l'app

• Si Gradient est sélectionné, les couleurs 1 à 3 sont utilisées dans toute l'app, avec Color 1 apparaissant en haut de l'arrière-plan, Color 2 au milieu et Color 3 en bas
• Si Fill est sélectionné, Color 1 est utilisée pour l'arrière-plan et Color 2 n'est pas utilisée

Color 1: Top Gradient / Fill — Dégradé supérieur de l'arrière-plan si Gradient est activé, remplissage de l'arrière-plan si Fill est activé

Color 2: Mid Gradient — Dégradé central de l'arrière-plan si Gradient est activé

Color 3: Bottom Gradient / Buttons

• Dégradé inférieur de l'arrière-plan si Gradient est activé
• Définit la couleur de tous les boutons et de l'animation de confirmation d'assignation
• Définit la couleur de la tuile (la bande / bordure supérieure de la tuile est à 100 % d'opacité de couleur tandis que le reste de la tuile a une opacité dynamique de Color 3, changeant selon l'arrière-plan et la progression du flux de tuiles)

Designer Mode Passphrase

Ceci modifie la phrase secrète Designer Mode par défaut. Assurez-vous de modifier ce paramètre immédiatement lors de la configuration d'Assigner.

Browse All Images

Cliquez sur ce bouton pour afficher une liste de toutes les icônes que vous pouvez utiliser pour personnaliser chaque tuile. Notez que la liste est extrêmement longue, mais n'importe quelle icône peut être utilisée dans votre conception.

View & Export App Config

Après avoir terminé votre conception, vous pouvez afficher et exporter l'App Config XML. Celui-ci ira dans l'enregistrement Mobile Assist dans Jamf Pro et configurera tous les appareils exécutant Assigner selon les personnalisations effectuées dans Designer Mode.

View App Config — Pour afficher le XML, appuyez sur View App Config.

Copy / Share App Config — Pour exporter cet App Config afin qu'il puisse être enregistré dans Jamf Pro, appuyez sur Copy / Share App Config, puis sélectionnez une méthode de partage pour envoyer la configuration.

App Config

Après avoir configuré Assigner via Designer Mode, vous disposerez d'un App Config complet qui doit être placé dans Jamf Pro. Celui-ci configurera tous les appareils exécutant Assigner selon la personnalisation décrite dans Designer Mode. Après avoir exporté l'App Config depuis Designer Mode, copiez-le et effectuez les étapes suivantes.

Ajouter l'App Config à Jamf Pro

Une fois le code App Config copié dans votre presse-papiers, connectez-vous à votre instance Jamf Pro et effectuez ce qui suit :

• Allez dans Devices > Mobile Device Apps > Jamf Mobile Assist > App Configuration > Edit
• Collez l'App Config dans la fenêtre Preferences
• Cliquez sur Save

Annexe A - Référence App Config

Ce qui suit est le modèle de configuration d'Assigner. Il est fourni à titre informatif, car le Designer Mode d'Assigner le crée automatiquement pour vous.

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

Tableau de référence Clé/Valeur

Remarque : Toutes les valeurs sont de type string

Mentions légales

• Contrat d'utilisation : Application End User License Agreement
• Politique de confidentialité : Jamf Privacy Policy