Anleitungen

Was ist Assigner?

Assigner ist Teil der Jamf Mobile Assist-App und ermöglicht die schnelle Einrichtung und Konfiguration von iOS- und iPadOS-Geräten zur gemeinsamen Nutzung. Ein Benutzer nimmt einfach ein Gerät auf, authentifiziert sich, scannt einen Code oder gibt andere vom Administrator definierte Informationen ein, um seine Rolle oder seinen Standort zu identifizieren. Assigner konfiguriert das Gerät dann für seine Anforderungen. Wenn der Benutzer fertig ist, tippt er einfach auf eine Schaltfläche in derselben App, um diese Auswahl vom Gerät zu löschen.

Ab Mobile Assist Version 1.9.0 wurde Assigner neu gestaltet, um einen höheren Grad an Anpassung zu ermöglichen und Administratoren die Möglichkeit zu geben, die Kriterien, die festlegen, wie Assigner Geräte Benutzern zuweist, granularer zu gestalten.

Zu den Aktualisierungen dieser Version gehören:

• Kachelbasierter Benutzerzuweisungs-Arbeitsablauf
• Aktivieren/Deaktivieren jeder Kachel im Arbeitsablauf
• Anpassen aller Aspekte jeder Kachel, einschließlich Farben, Text, Symbolen, Eingabemethode (z. B. Kamera zum Scannen der Eingabe verwenden, manuell tippen, aus Dropdown-Menüs auswählen)
• Anpassen aller Farben für App und Text, einschließlich der Verwendung von einfarbigen Hintergründen oder Verläufen
• Anpassen des Brandings mit einem Firmenlogo über eine URL zum Bild
• All dies über einen in die App integrierten Designer Mode, der automatisch die App Config erstellt, die Sie in Jamf Pro verwenden, um Assigner auf allen Ihren Geräten zu konfigurieren

Wie funktioniert Assigner?

Auf einer sehr hohen Ebene übernimmt Assigner Informationen, die ein Benutzer in ein iOS-Gerät eingibt, und schreibt sie in Jamf Pro, wo diese Informationen verwendet werden, um Smart-Group-Mitgliedschaften zur Bereitstellung von Konfigurationen und Apps zu bestimmen.

Welche Datenpunkte werden in Jamf Pro geschrieben?

Im Geräteinventar-Datensatz werden die folgenden Elemente mit Assigner geschrieben:

• Username
• Extension Attribute 1 (vom Administrator definiert)
• Extension Attribute 2 (vom Administrator definiert)
• Building (vom Administrator definiert)
• Department (vom Administrator definiert)

Zuweisungs-Arbeitsablauf / Kacheln

Assigner nutzt einen kachelbasierten Zuweisungs-Arbeitsablauf. Jede der 5 Kacheln kann angepasst werden, um den Anforderungen einer Vielzahl von Organisationen in verschiedenen Branchen gerecht zu werden. Darüber hinaus können praktisch alle Aspekte der App angepasst werden, von Text, Farben, Symbolen, Menüs, Eingabemethoden bis hin zum Branding-Logo.

Der Benutzer durchläuft die Kacheln, indem er entweder Informationen manuell eingibt, aus Dropdown-Menüs auswählt oder Text / QR-Codes mit der Gerätekamera scannt.

Wenn ein Benutzer den Arbeitsablauf erfolgreich abschließt, erhält er eine Bestätigung, und seine Konfigurationen / Apps werden automatisch bereitgestellt. Die Assigner-App zeigt dann eine Meldung an, dass das Gerät derzeit zugewiesen ist und über die Reset-Schaltfläche wieder aufgehoben werden kann.

Erforderliche Ersteinrichtung

Um von der Mobile Assist-App aus auf Assigner zuzugreifen, müssen Sie zunächst die folgenden Schritte ausführen.

Jamf Mobile Assist-App über Jamf Pro installieren

1. Verteilen Sie die App über den Volume-Purchasing-Arbeitsablauf an Jamf Pro
2. Fügen Sie Jamf Mobile Assist zum Jamf Pro-App-Katalog hinzu, falls nicht automatisch erstellt
   • Aktivieren Sie Assign Content Purchased in Volume im Tab Managed Distribution
   • Legen Sie zu diesem Zeitpunkt keinen Scope fest und lassen Sie die App Configuration leer
3. Notieren Sie sich die App-Datensatz-ID in der URL, die in der Adressleiste des Browsers angezeigt wird, als Referenz für die nächsten Schritte: https://yourinstance.jamfcloud.com/mobileDeviceApps.html?id=18&o=r In diesem Beispiel ist die ID 18.

Assigner mit integriertem Tool aktivieren (Jamf App Wizard)

Als Nächstes muss Assigner so konfiguriert werden, dass er in Jamf Pro funktioniert. Die Mobile Assist-App enthält ein Tool namens Jamf App Wizard. Dieses Tool richtet automatisch die erforderliche API Role und den erforderlichen Client ein und erstellt die Linked App Integration von Assigner.

1. Legen Sie den Scope von Mobile Assist auf ein Gerät fest, auf das Sie Zugriff haben. Fügen Sie keine App Configurations hinzu.

2. Starten Sie Mobile Assist auf diesem Gerät. Wenn keine App Config vorhanden ist, wird der Jamf App Wizard automatisch geöffnet. Sie können auch die folgenden App-Config-Schlüssel verwenden, um den Wizard zu einem beliebigen Zeitpunkt nach der Bereitstellung zu öffnen:

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

3. Melden Sie sich mit einem Konto mit Administratorberechtigungen bei Ihrer Jamf Pro-Instanz an.

4. Nach Abschluss des Ladevorgangs werden alle Mobilgeräte-Apps in Ihrer Instanz angezeigt. Suchen Sie den Eintrag für Jamf Mobile Assist. Hinweis: Wenn Sie mehrere Einträge haben, verwenden Sie die ID aus Schritt 3 oben als Referenz.

5. Tippen Sie auf die App, um Details anzuzeigen. Wählen Sie in der App-Beschreibung Begin App Integration aus.

6. Führen Sie jeden Schritt im Assigner-Integrations-Arbeitsablauf aus:

   1. Bestätigen Sie, dass der Tab Assigner ausgewählt ist
   2. Geben Sie einen Namen für die API Role ein und klicken Sie dann auf Create API Role. Hinweis: Es wird ein Fehler zurückgegeben, wenn Sie einen bereits vorhandenen Namen eingeben.
   3. Geben Sie einen Namen für den API Client ein und klicken Sie dann auf Create API Client
   4. Confirm App Link Request: Überprüfen Sie die Namen und Objekt-IDs, die für diese Integration erstellt wurden
   5. Wenn alles gut aussieht, klicken Sie auf Complete App Link
   6. Bei Erfolg können Sie zum vorherigen Abschnitt zurückkehren, indem Sie zum Tab Navigation gehen und auf die Schaltfläche Return tippen
   7. Jetzt können Sie die Integration im Tab Current Integrations anzeigen

Erforderliche grundlegende App Config

Nachdem die obigen Schritte abgeschlossen sind, können Sie nun den Scope der App festlegen und die folgende temporäre App Config setzen, sodass Assigner aktiviert wird. Fügen Sie im Jamf Pro Mobile Device App-Datensatz für Jamf Mobile Assist diese temporäre App Config hinzu, um Assigner zu aktivieren:

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

• Kopieren Sie den obigen Code und navigieren Sie zur Mobile Assist-App (Devices > Mobile Device Apps > Jamf Mobile Assist > App Configuration)
• Klicken Sie auf Edit, fügen Sie den obigen Code ein und klicken Sie dann auf Save
• Nach Abschluss der obigen Schritte sollten Sie nun in der Lage sein, Mobile Assist auf einem Gerät zu öffnen, und Assigner wird automatisch gestartet

Designer Mode

Der Designer Mode ermöglicht es Ihnen, Ihren Assigner-Kachel-Arbeitsablauf direkt in der Assigner-App zu erstellen. Nach Abschluss können Sie die App-Config-XML exportieren und per AirDrop / Nachricht usw. an ein Gerät senden, auf dem Sie den Code aufrufen und in Jamf Pro einfügen können.

Designer Mode aufrufen

So rufen Sie den Designer Mode auf:

• Starten Sie Mobile Assist / Assigner
• Halten Sie das Logo oben in der Hauptansicht 5 Sekunden lang gedrückt. Ein Passphrase-Fenster wird angezeigt
• Die Standard-Passphrase lautet "admin" und kann im Designer Mode geändert werden

Assigner-Kacheln und Erscheinungsbild anpassen

Jede Assigner-Kachel kann angepasst werden, ebenso wie die Farben, der Text, die Symbole, die Eingabemethode und das in der App angezeigte Logo.

Kamera-Scan- / Formulareingabemodus

Die Auswahl einer Modusoption bewirkt Folgendes:

Form & Scan

• Der Kamerascanner ist aktiviert und ermöglicht dem Benutzer, die Gerätekamera zum Scannen von Codes und Text zu verwenden
• Wenn aktiviert, können Sie von einer Kachel aus scannen, die das Scan-Symbol anzeigt

Form

• Der Kamerascanner ist nicht aktiviert, und alle Felder müssen manuell eingegeben werden

Login-Kachel (Kachel 1)

Diese Kachel kann so konfiguriert werden, dass ein Benutzer sich gegenüber Jamf Pro authentifizieren muss (Jamf Pro-Konto oder LDAP), und geht nicht weiter, wenn keine korrekten Anmeldedaten eingegeben werden.

Hinweis: Wenn der Scanner deaktiviert ist, wird diese Kachel mit einer Benutzername-/Passwort-Konfiguration angezeigt. Wenn der Scanner aktiviert ist, wird das Passwortfeld nicht angezeigt.

Konfigurieren Sie diese Kachel wie folgt:

Enabled — Kachel im Arbeitsablauf aktivieren oder deaktivieren

Title — Ändern Sie den Text des Kacheltitels

Icon — Ändern Sie das Symbol neben dem Titel. Sie können jedes verfügbare Bild in der Vorschau anzeigen, indem Sie zum Ende des Designer Mode scrollen und auf "Browse all images" tippen

Preview Tile — Tippen Sie hier, um eine Vorschau Ihres Designs anzuzeigen

Extension-Attribute-Kacheln (Kacheln 2–5)

Diese Kacheln schreiben in Mobile Device Extension Attributes in Jamf Pro, indem sie es dem Benutzer ermöglichen, aus einer Dropdown-Liste auszuwählen oder Text direkt zu scannen/einzugeben. Stellen Sie sicher, dass Sie die gewünschte Anzahl von Extension Attributes mit einem Input Type von Text Field erstellt haben.

Konfigurieren Sie diese Kacheln wie folgt:

Enabled — Kachel im Arbeitsablauf aktivieren oder deaktivieren

Input

• Menu: Ermöglicht Benutzern die Auswahl von Elementen aus einer Dropdown-Liste
• Text: Ermöglicht Benutzern das Scannen oder manuelle Eingeben von Werten

Title — Geben Sie hier den exakten Namen des Extension Attribute ein

Icon — Ändern Sie das Symbol neben dem Titel

Menu — Geben Sie die Elemente, aus denen der Benutzer im Dropdown-Menü auswählen soll, als kommagetrennte Werte ein (z. B.: Element 1, Element 2, Element 3). Hinweis: Input muss auf Menu gesetzt sein. Wichtig: Drücken Sie Return auf der Tastatur, um zu bestätigen.

Building- und Department-Kacheln (Kacheln 6–7)

Die letzten beiden Kacheln schreiben in die Attribute Building und Department des Gerätedatensatzes. Dem Benutzer wird ein Dropdown mit den verfügbaren Building- und/oder Department-Auswahlmöglichkeiten angezeigt.

Konfigurieren Sie diese Kacheln wie folgt:

Enabled — Kachel im Arbeitsablauf aktivieren oder deaktivieren

Title — Kann für Building oder Department nicht geändert werden

Icon — Ändern Sie das Symbol neben dem Titel

Menu — Geben Sie die Elemente, aus denen der Benutzer im Dropdown-Menü auswählen soll, als kommagetrennte Werte ein. Für Building und Department müssen Sie diese Namenskonvention befolgen:

• ObjectID:Name, ObjectID:Name, ObjectID:Name (wobei ObjectID die Jamf Pro-ID für das Building oder Department und Name der Name des Building oder Department ist)
• Um die Jamf Pro-ID eines Building oder Department zu erhalten, gehen Sie zu Jamf Pro > Settings > Network > (Buildings oder Departments) > wählen Sie ein Element aus > lesen Sie die URL für dieses Element — die ID ist die nachgestellte Zahl
• Wenn Sie beispielsweise ein Building namens "New York" haben, wird beim Klicken darauf https://myinstance.jamfcloud.com/view/settings/network-organization/buildings/3 angezeigt. Um es in Assigner hinzuzufügen, verwenden Sie 3:New York
• Wichtig: Drücken Sie Return auf der Tastatur, um zu bestätigen

Textfarbschema

Diese Werte werden verwendet, um die Farbe des Textes zu ändern (entweder hell oder dunkel), damit er mit jeder Farbe funktioniert, die Sie für die Kacheln und den Hintergrund der App gewählt haben.

Headings Text — Legt die Farbe des Textes unter dem Logo fest. Der Text selbst kann unter Other Text Values > Title geändert werden

Tile Text — Legt die Farbe von Text und Symbol in Kacheln fest

Button Text — Legt die Farbe des Textes in Schaltflächen fest (z. B. Submit/Reset, Scan, Dropdown-Menüs)

Weitere Textwerte

Hier können Sie den Inhalt des Textes ändern, der in nicht kachelbasierten Teilen der App angezeigt wird.

Title — Legt den Text fest, der unter dem Branding-Logo erscheint

Reset Button — Legt den Text auf der Schaltfläche fest, die verwendet wird, um die Gerätezuweisung zurückzusetzen, nachdem sie zugewiesen wurde

Assignment Complete Line 1 — Legt die erste Textzeile fest, die nach erfolgreicher Zuweisung erscheint. Dies ersetzt die Kachelansicht

Assignment Complete Line 2 — Legt die zweite Textzeile fest, die nach erfolgreicher Zuweisung erscheint. Dies ersetzt die Kachelansicht

Branding-Bild-Link

Legt das Branding-Bild fest, das oben auf dem Hauptbildschirm angezeigt wird, unter Verwendung einer URL.

Branding Image Link — Geben Sie die URL eines Branding-Bildes ein, das Sie für die App verwenden möchten. Das Bild erscheint sofort im Bereich darunter. Wenn der Link nicht funktioniert oder das Bild anderweitig nicht angezeigt werden kann, werden automatisch ein Platzhalterbild und Text angewendet. Stellen Sie sicher, dass Sie die Bildgröße und den Abstand auf dem Assigner-Hauptbildschirm testen.

Hintergrundfarbschema

Hier können Sie die Gesamtfarbe der App, Kacheln und Schaltflächen usw. festlegen. Zusätzlich können Sie den Hintergrund entweder auf einen Verlauf oder eine Volltonfarbe setzen.

Background — Legt das Farbschema für Gradient oder Fill (Vollton) für die App fest

• Wenn Gradient ausgewählt ist, werden die Farben 1–3 in der gesamten App verwendet, wobei Color 1 oben im Hintergrund, Color 2 in der Mitte und Color 3 unten erscheint
• Wenn Fill ausgewählt ist, wird Color 1 für den Hintergrund verwendet und Color 2 wird nicht verwendet

Color 1: Top Gradient / Fill — Oberer Hintergrundverlauf, wenn Gradient aktiviert ist, Hintergrundfüllung, wenn Fill aktiviert ist

Color 2: Mid Gradient — Mittlerer Hintergrundverlauf, wenn Gradient aktiviert ist

Color 3: Bottom Gradient / Buttons

• Unterer Hintergrundverlauf, wenn Gradient aktiviert ist
• Legt die Farbe aller Schaltflächen und der Zuweisungs-Bestätigungsanimation fest
• Legt die Kachelfarbe fest (der obere Streifen / Rand der Kachel hat 100 % Farbdeckkraft, während der Rest der Kachel eine dynamische Deckkraft von Color 3 hat, die sich je nach Hintergrund und Fortschritt des Kachel-Arbeitsablaufs ändert)

Designer-Mode-Passphrase

Dies ändert die Standard-Passphrase des Designer Mode. Stellen Sie sicher, dass Sie diese Einstellung sofort bei der Konfiguration von Assigner ändern.

Alle Bilder durchsuchen

Klicken Sie auf diese Schaltfläche, um eine Liste aller Symbole anzuzeigen, die Sie zur Anpassung jeder Kachel verwenden können. Beachten Sie, dass die Liste extrem umfangreich ist, aber jedes Symbol in Ihrem Design verwendet werden kann.

App Config anzeigen und exportieren

Nach Abschluss Ihres Designs können Sie die App-Config-XML anzeigen und exportieren. Diese gelangt in den Mobile Assist-Datensatz in Jamf Pro und konfiguriert alle Geräte, auf denen Assigner läuft, gemäß den im Designer Mode vorgenommenen Anpassungen.

View App Config — Um die XML anzuzeigen, tippen Sie auf View App Config.

Copy / Share App Config — Um diese App Config so zu exportieren, dass sie in Jamf Pro gespeichert werden kann, tippen Sie auf Copy / Share App Config und wählen Sie dann eine Freigabemethode aus, um die Konfiguration zu senden.

App Config

Nach der Konfiguration von Assigner über den Designer Mode verfügen Sie über eine vollständige App Config, die in Jamf Pro eingefügt werden muss. Diese konfiguriert alle Geräte, auf denen Assigner läuft, gemäß der im Designer Mode beschriebenen Anpassung. Nachdem Sie die App Config aus dem Designer Mode exportiert haben, kopieren Sie sie und führen Sie die folgenden Schritte aus.

App Config zu Jamf Pro hinzufügen

Nachdem der App-Config-Code in Ihre Zwischenablage kopiert wurde, melden Sie sich bei Ihrer Jamf Pro-Instanz an und führen Sie Folgendes aus:

• Gehen Sie zu Devices > Mobile Device Apps > Jamf Mobile Assist > App Configuration > Edit
• Fügen Sie die App Config im Preferences-Fenster ein
• Klicken Sie auf Save

Anhang A - App-Config-Referenz

Das Folgende ist die Vorlage zur Konfiguration von Assigner. Diese wird zu Informationszwecken bereitgestellt, da der Designer Mode von Assigner diese automatisch für Sie erstellt.

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

Key/Value-Referenztabelle

Hinweis: Alle Werte sind vom Typ string

Rechtliches

• Nutzungsvereinbarung: Application End User License Agreement
• Datenschutzrichtlinie: Jamf Privacy Policy