Handleidingen

Wat is Assigner?

Assigner maakt deel uit van de Jamf Mobile Assist-app en maakt de snelle installatie en configuratie van gedeeld gebruikte iOS- en iPadOS-apparaten mogelijk. Een gebruiker pakt eenvoudigweg een apparaat op, authenticeert, scant een code of voert andere door de beheerder gedefinieerde informatie in om zijn rol of locatie te identificeren. Assigner configureert het apparaat vervolgens voor hun behoeften. Wanneer ze klaar zijn, tikken ze eenvoudigweg op een knop in dezelfde app om die keuzes van het apparaat te wissen.

Vanaf Mobile Assist-versie 1.9.0 is Assigner opnieuw ontworpen om een grotere mate van maatwerk mogelijk te maken, en om beheerders de mogelijkheid te bieden om nauwkeuriger te bepalen aan de hand van welke criteria Assigner apparaten aan gebruikers toewijst.

Updates in deze versie omvatten:

• Op tegels gebaseerde toewijzingswerkstroom voor gebruikers
• Elke tegel in de werkstroom in-/uitschakelen
• Alle aspecten van elke tegel aanpassen, inclusief kleuren, tekst, iconen, invoermethode (bijv. de camera gebruiken om invoer te scannen, handmatig typen, kiezen uit dropdownmenu's)
• Alle kleuren voor de app en tekst aanpassen, inclusief het gebruik van effen achtergronden of gradiënten
• Branding aanpassen met een bedrijfslogo via een URL naar de afbeelding
• Al het bovenstaande doen vanuit een Designer Mode die in de app is ingebouwd en automatisch de App Config aanmaakt die je in Jamf Pro gebruikt om Assigner op al je apparaten te configureren

Hoe werkt Assigner?

Op zeer hoog niveau neemt Assigner informatie die een gebruiker in een iOS-apparaat invoert en schrijft deze naar Jamf Pro, waar die informatie wordt gebruikt om Smart Group-lidmaatschappen te bepalen voor het implementeren van configuraties en apps.

Welke datapunten worden weggeschreven in Jamf Pro?

In het apparaatinventarisrecord worden de volgende items met Assigner weggeschreven:

• Username
• Extension Attribute 1 (door de beheerder gedefinieerd)
• Extension Attribute 2 (door de beheerder gedefinieerd)
• Building (door de beheerder gedefinieerd)
• Department (door de beheerder gedefinieerd)

Toewijzingswerkstroom / Tegels

Assigner maakt gebruik van een op tegels gebaseerde toewijzingswerkstroom. Elk van de 5 tegels kan worden aangepast aan de behoeften van een breed scala aan organisaties in verschillende sectoren. Bovendien kunnen vrijwel alle aspecten van de app worden aangepast, van tekst, kleuren, iconen, menu's, invoermethoden tot brandinglogo.

De gebruiker doorloopt de tegels door informatie handmatig te typen, uit dropdownmenu's te selecteren of tekst / QR-codes te scannen met de apparaatcamera.

Wanneer een gebruiker de werkstroom succesvol voltooit, ontvangt hij een bevestiging en worden zijn configuraties / apps automatisch geïmplementeerd. De Assigner-app toont vervolgens een bericht dat het apparaat momenteel is toegewezen en kan worden ontwezen met de Reset-knop.

Vereiste eerste installatie

Om Assigner vanuit de Mobile Assist-app te openen, moet je eerst de volgende stappen voltooien.

Installeer de Jamf Mobile Assist-app via Jamf Pro

1. Distribueer de app naar Jamf Pro met behulp van de Volume Purchasing-werkstroom
2. Voeg Jamf Mobile Assist toe aan de Jamf Pro-appcatalogus als deze niet automatisch is aangemaakt
   • Vink Assign Content Purchased in Volume aan op het tabblad Managed Distribution
   • Beperk het bereik nog niet en laat de App Configuration op dit moment leeg
3. Noteer de app-record-ID in de URL die in de adresbalk van de browser wordt weergegeven, ter referentie in de volgende stappen: https://yourinstance.jamfcloud.com/mobileDeviceApps.html?id=18&o=r In dit voorbeeld is de ID 18.

Schakel Assigner in met het ingebouwde hulpmiddel (Jamf App Wizard)

Vervolgens moet Assigner worden geconfigureerd om in Jamf Pro te werken. De Mobile Assist-app bevat een hulpmiddel genaamd Jamf App Wizard. Dit hulpmiddel stelt automatisch de vereiste API Role en Client in, en maakt Assigner's Linked App Integration aan.

1. Beperk het bereik van Mobile Assist tot een apparaat waar je toegang toe hebt. Voeg geen App Configurations toe.

2. Start Mobile Assist op dit apparaat. Wanneer er geen App Config aanwezig is, opent de Jamf App Wizard automatisch. Je kunt ook de volgende App Config-sleutels gebruiken om de Wizard op elk moment na de implementatie te openen:

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

3. Log met een account met beheerdersprivileges in op je Jamf Pro-instance.

4. Nadat het laden is voltooid, worden alle mobiele apparaat-apps in je instance weergegeven. Zoek het item voor Jamf Mobile Assist. Opmerking: als je meerdere items hebt, gebruik dan de ID uit stap 3 hierboven als referentie.

5. Tik op de app om de details te bekijken. Selecteer in de app-beschrijving Begin App Integration.

6. Voltooi elke stap in de Assigner Integration-werkstroom:

   1. Bevestig dat het Assigner-tabblad is geselecteerd
   2. Voer een naam in voor de API Role en klik vervolgens op Create API Role. Opmerking: er wordt een fout geretourneerd als je een naam invoert die al bestaat.
   3. Voer een naam in voor de API Client en klik vervolgens op Create API Client
   4. Confirm App Link Request: controleer de namen en object-ID's die voor deze integratie zijn aangemaakt
   5. Als alles er goed uitziet, klik je op Complete App Link
   6. Als dit lukt, kun je terugkeren naar het vorige gedeelte door naar het Navigation-tabblad te gaan en op de knop Return te tikken
   7. Nu kun je de integratie bekijken op het Current Integrations-tabblad

Basaal vereiste App Config

Nu de bovenstaande stappen zijn voltooid, kun je het bereik van de app instellen en de volgende tijdelijke App Config instellen zodat Assigner wordt geactiveerd. Voeg in het Jamf Pro Mobile Device App-record voor Jamf Mobile Assist deze tijdelijke App Config toe om Assigner in te schakelen:

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

• Kopieer de bovenstaande code en navigeer naar de Mobile Assist-app (Devices > Mobile Device Apps > Jamf Mobile Assist > App Configuration)
• Klik op Edit, plak de bovenstaande code en klik vervolgens op Save
• Nu de bovenstaande stappen zijn voltooid, zou je Mobile Assist op een apparaat moeten kunnen openen en zal Assigner automatisch starten

Designer Mode

Met Designer Mode kun je je Assigner-tegelwerkstroom rechtstreeks vanuit de Assigner-app bouwen. Wanneer je klaar bent, kun je de App Config-XML exporteren en deze via AirDrop / Message enz. verzenden naar een apparaat waar je de code kunt openen en in Jamf Pro kunt plakken.

Designer Mode openen

Om Designer Mode te openen:

• Start Mobile Assist / Assigner
• Houd het logo bovenaan de hoofdweergave 5 seconden lang ingedrukt. Er verschijnt een wachtwoordvenster
• Het standaardwachtwoord is "admin" en kan worden gewijzigd in Designer Mode

Assigner-tegels en uiterlijk aanpassen

Elke Assigner-tegel kan worden aangepast, evenals de kleuren, tekst, iconen, invoermethode en het logo dat in de app wordt weergegeven.

Camera Scan / Form Entry-modus

Het selecteren van een modusoptie doet het volgende:

Form & Scan

• De camerascanner is ingeschakeld en stelt de gebruiker in staat om de apparaatcamera te gebruiken om codes en tekst te scannen
• Wanneer ingeschakeld, kun je scannen vanaf een tegel die het scanicoon weergeeft

Form

• De camerascanner is niet ingeschakeld en alle velden moeten handmatig worden ingevoerd

Login-tegel (Tegel 1)

Deze tegel kan worden geconfigureerd om te vereisen dat een gebruiker zich authenticeert bij Jamf Pro (Jamf Pro-account of LDAP) en gaat niet verder als de juiste inloggegevens niet worden ingevoerd.

Opmerking: Als de scanner is uitgeschakeld, wordt deze tegel weergegeven met een configuratie voor gebruikersnaam / wachtwoord. Als de scanner is ingeschakeld, wordt het wachtwoordveld niet weergegeven.

Configureer deze tegel als volgt:

Enabled — Schakel de tegel in of uit in de werkstroom

Title — Wijzig de tekst van de titel van de tegel

Icon — Wijzig het icoon naast de titel. Je kunt elke beschikbare afbeelding bekijken door naar de onderkant van Designer Mode te scrollen en op "Browse all images" te tikken

Preview Tile — Tik hier om je ontwerp te bekijken

Extension Attribute-tegels (Tegels 2–5)

Deze tegels schrijven naar Mobile Device Extension Attributes in Jamf Pro door de gebruiker in staat te stellen uit een dropdownlijst te selecteren of tekst rechtstreeks te scannen/in te voeren. Zorg ervoor dat je het gewenste aantal Extension Attributes hebt aangemaakt met een Input Type van Text Field.

Configureer deze tegels als volgt:

Enabled — Schakel de tegel in of uit in de werkstroom

Input

• Menu: Sta gebruikers toe items uit een dropdownlijst te selecteren
• Text: Sta gebruikers toe waarden te scannen of handmatig in te voeren

Title — Voer hier de exacte naam van het Extension Attribute in

Icon — Wijzig het icoon naast de titel

Menu — Voer de items in die je de gebruiker uit het dropdownmenu wilt laten selecteren als door komma's gescheiden waarden (bijv.: Item 1, Item 2, Item 3). Opmerking: Input moet zijn ingesteld op Menu. Belangrijk: Druk op return op het toetsenbord om te bevestigen.

Building- en Department-tegels (Tegels 6–7)

De laatste twee tegels schrijven naar de attributen Building en Department van het apparaatrecord. De gebruiker krijgt een dropdown met beschikbare Building- en/of Department-selecties te zien.

Configureer deze tegels als volgt:

Enabled — Schakel de tegel in of uit in de werkstroom

Title — Kan niet worden gewijzigd voor Building of Department

Icon — Wijzig het icoon naast de titel

Menu — Voer de items in die je de gebruiker uit het dropdownmenu wilt laten selecteren als door komma's gescheiden waarden. Voor Building en Department moet je deze naamgevingsconventie volgen:

• ObjectID:Name, ObjectID:Name, ObjectID:Name (waarbij ObjectID de Jamf Pro-ID is voor de Building of het Department en Name de naam is van de Building of het Department)
• Om de Jamf Pro-ID van een Building of Department te verkrijgen, ga je naar Jamf Pro > Settings > Network > (Buildings of Departments) > selecteer een item > lees de URL voor dat item — de ID is het volgnummer
• Als je bijvoorbeeld een Building hebt met de naam "New York", geeft het klikken daarop https://myinstance.jamfcloud.com/view/settings/network-organization/buildings/3 weer. Om deze in Assigner toe te voegen, gebruik je 3:New York
• Belangrijk: Druk op return op het toetsenbord om te bevestigen

Tekstkleurenschema

Deze waarden worden gebruikt om de kleur van tekst te wijzigen (ofwel licht of donker) zodat deze werkt met elke kleur die je hebt gekozen voor de tegels en achtergrond van de app.

Headings Text — Stelt de kleur in van de tekst onder het logo. De tekst zelf kan worden gewijzigd in Other Text Values > Title

Tile Text — Stelt de kleur in van de tekst en het icoon in tegels

Button Text — Stelt de kleur in van de tekst in knoppen (bijv. Submit/Reset, scan, dropdownmenu's)

Andere tekstwaarden

Hier kun je de inhoud wijzigen van de tekst die wordt weergegeven in de niet-tegelonderdelen van de app.

Title — Stelt de tekst in die onder het brandinglogo verschijnt

Reset Button — Stelt de tekst in op de knop die wordt gebruikt om de apparaattoewijzing te resetten nadat deze is toegewezen

Assignment Complete Line 1 — Stelt de eerste regel tekst in die verschijnt nadat de toewijzing is gelukt. Dit vervangt de tegelweergave

Assignment Complete Line 2 — Stelt de tweede regel tekst in die verschijnt nadat de toewijzing is gelukt. Dit vervangt de tegelweergave

Brandingafbeeldingslink

Stelt de brandingafbeelding in die bovenaan het hoofdscherm wordt weergegeven met behulp van een URL.

Branding Image Link — Voer de URL in van een brandingafbeelding die je voor de app wilt gebruiken. De afbeelding verschijnt onmiddellijk in de ruimte eronder. Als de link niet werkt of de afbeelding anderszins niet kan worden weergegeven, worden automatisch een placeholderafbeelding en -tekst toegepast. Zorg ervoor dat je de afbeeldingsgrootte en -afstand op het hoofdscherm van Assigner test.

Achtergrondkleurenschema

Hier kun je de algehele kleur van de app, tegels en knoppen enz. instellen. Bovendien kun je de achtergrond instellen op een gradiënt of effen kleur.

Background — Stelt een Gradient- of Fill (effen) achtergrondkleurenschema in voor de app

• Als Gradient is geselecteerd, worden Colors 1–3 in de hele app gebruikt, waarbij Color 1 bovenaan de achtergrond verschijnt, Color 2 in het midden en Color 3 onderaan
• Als Fill is geselecteerd, wordt Color 1 gebruikt voor de achtergrond en wordt Color 2 niet gebruikt

Color 1: Top Gradient / Fill — Bovenste gradiënt van de achtergrond als Gradient is ingeschakeld, achtergrondvulling als Fill is ingeschakeld

Color 2: Mid Gradient — Middelste gradiënt van de achtergrond als Gradient is ingeschakeld

Color 3: Bottom Gradient / Buttons

• Onderste gradiënt van de achtergrond als Gradient is ingeschakeld
• Stelt de kleur in van alle knoppen en de toewijzingsbevestigingsanimatie
• Stelt de tegelkleur in (de bovenste streep / rand van de tegel heeft 100% kleurdekking, terwijl de rest van de tegel een dynamische dekking van Color 3 heeft, die verandert afhankelijk van de achtergrond en de voortgang van de tegelwerkstroom)

Designer Mode-wachtwoord

Dit wijzigt het standaard Designer Mode-wachtwoord. Zorg ervoor dat je deze instelling onmiddellijk wijzigt bij het configureren van Assigner.

Browse All Images

Klik op deze knop om een lijst te bekijken van elk icoon dat je kunt gebruiken om elke tegel aan te passen. Merk op dat de lijst extreem groot is, maar elk icoon kan in je ontwerp worden gebruikt.

App Config bekijken en exporteren

Nadat je je ontwerp hebt voltooid, kun je de App Config-XML bekijken en exporteren. Deze gaat naar het Mobile Assist-record in Jamf Pro en configureert alle apparaten die Assigner uitvoeren volgens de aanpassingen die in Designer Mode zijn gedaan.

View App Config — Om de XML te bekijken, tik je op View App Config.

Copy / Share App Config — Om deze App Config te exporteren zodat deze in Jamf Pro kan worden opgeslagen, tik je op Copy / Share App Config en selecteer je vervolgens een deelmethode om de configuratie te verzenden.

App Config

Nadat je Assigner via Designer Mode hebt geconfigureerd, heb je een complete App Config die in Jamf Pro moet worden geplaatst. Deze configureert alle apparaten die Assigner uitvoeren volgens het maatwerk dat in Designer Mode is beschreven. Nadat je de App Config uit Designer Mode hebt geëxporteerd, kopieer je deze en voer je de volgende stappen uit.

App Config toevoegen aan Jamf Pro

Nu de App Config-code naar je klembord is gekopieerd, log je in op je Jamf Pro-instance en voer je het volgende uit:

• Ga naar Devices > Mobile Device Apps > Jamf Mobile Assist > App Configuration > Edit
• Plak de App Config in het Preferences-venster
• Klik op Save

Appendix A - App Config-referentie

Het volgende is de template voor het configureren van Assigner. Dit wordt voor informatieve doeleinden verstrekt, aangezien de Designer Mode van Assigner dit automatisch voor je aanmaakt.

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

Sleutel/waarde-referentietabel

Opmerking: Alle waarden zijn van het type string

Juridisch

• Use Agreement: Application End User License Agreement
• Privacy Policy: Jamf Privacy Policy