Przewodniki

Czym jest Assigner?

Assigner jest częścią aplikacji Jamf Mobile Assist i umożliwia szybką konfigurację oraz ustawienie współdzielonych urządzeń iOS i iPadOS. Użytkownik po prostu bierze urządzenie, uwierzytelnia się, skanuje kod lub wprowadza inne informacje zdefiniowane przez administratora, aby określić swoją rolę lub lokalizację. Assigner następnie konfiguruje urządzenie zgodnie z jego potrzebami. Po zakończeniu wystarczy dotknąć przycisku w tej samej aplikacji, aby usunąć te wybory z urządzenia.

Począwszy od Mobile Assist w wersji 1.9.0, Assigner został przeprojektowany, aby umożliwić większy zakres personalizacji, a także zapewnić administratorom możliwość bardziej szczegółowego definiowania kryteriów określających sposób przypisywania urządzeń do użytkowników przez Assigner.

Aktualizacje w tej wersji obejmują:

• Proces przypisywania użytkownika oparty na kafelkach
• Włączanie/wyłączanie dowolnego kafelka w procesie
• Personalizację wszystkich aspektów każdego kafelka, w tym kolorów, tekstu, ikon, metody wprowadzania danych (np. użycie aparatu do skanowania, ręczne wpisywanie, wybór z menu rozwijanego)
• Personalizację wszystkich kolorów aplikacji i tekstu, w tym użycie jednolitych teł lub gradientów
• Personalizację brandingu za pomocą logo firmy poprzez adres URL obrazu
• Wykonanie wszystkich powyższych czynności w trybie Designer Mode wbudowanym w aplikację, który automatycznie tworzy App Config używany w Jamf Pro do konfiguracji Assigner na wszystkich urządzeniach

Jak działa Assigner?

Z bardzo ogólnego punktu widzenia Assigner pobiera informacje wprowadzone przez użytkownika na urządzeniu iOS i zapisuje je w Jamf Pro, gdzie są one wykorzystywane do określenia przynależności do Smart Group w celu wdrożenia konfiguracji i aplikacji.

Jakie dane są zapisywane w Jamf Pro?

W rekordzie inwentarza urządzenia Assigner zapisuje następujące elementy:

• Username
• Extension Attribute 1 (zdefiniowany przez administratora)
• Extension Attribute 2 (zdefiniowany przez administratora)
• Building (zdefiniowany przez administratora)
• Department (zdefiniowany przez administratora)

Proces przypisywania / Kafelki

Assigner wykorzystuje proces przypisywania oparty na kafelkach. Każdy z 5 kafelków można dostosować do potrzeb szerokiego grona organizacji z różnych branż. Ponadto praktycznie każdy aspekt aplikacji można spersonalizować — od tekstu, kolorów, ikon, menu, metod wprowadzania danych po logo brandingowe.

Użytkownik przechodzi przez kafelki, ręcznie wpisując informacje, wybierając z menu rozwijanego lub skanując tekst / kody QR za pomocą aparatu urządzenia.

Gdy użytkownik pomyślnie ukończy proces, otrzymuje potwierdzenie, a jego konfiguracje / aplikacje są automatycznie wdrażane. Aplikacja Assigner wyświetla następnie komunikat, że urządzenie jest obecnie przypisane i można cofnąć jego przypisanie za pomocą przycisku Reset.

Wymagana konfiguracja początkowa

Aby uzyskać dostęp do Assigner z aplikacji Mobile Assist, musisz najpierw wykonać poniższe kroki.

Instalacja aplikacji Jamf Mobile Assist za pomocą Jamf Pro

1. Rozprowadź aplikację do Jamf Pro za pomocą procesu Volume Purchasing
2. Dodaj Jamf Mobile Assist do katalogu aplikacji Jamf Pro, jeśli nie został utworzony automatycznie
   • Zaznacz Assign Content Purchased in Volume na karcie Managed Distribution
   • Nie ustawiaj zakresu i pozostaw App Configuration puste na tym etapie
3. Zanotuj identyfikator rekordu aplikacji w adresie URL wyświetlanym w pasku adresu przeglądarki, aby wykorzystać go w kolejnych krokach: https://yourinstance.jamfcloud.com/mobileDeviceApps.html?id=18&o=r W tym przykładzie identyfikator to 18.

Włączanie Assigner za pomocą wbudowanego narzędzia (Jamf App Wizard)

Następnie Assigner musi zostać skonfigurowany do pracy w Jamf Pro. Aplikacja Mobile Assist zawiera narzędzie o nazwie Jamf App Wizard. Narzędzie to automatycznie skonfiguruje wymaganą rolę API i klienta, a także utworzy Linked App Integration dla Assigner.

1. Ustaw zakres Mobile Assist na urządzenie, do którego masz dostęp. Nie dodawaj żadnych App Configurations.

2. Uruchom Mobile Assist na tym urządzeniu. Gdy nie ma App Config, Jamf App Wizard otworzy się automatycznie. Możesz również użyć następujących kluczy App Config, aby otworzyć Wizard w dowolnym momencie po wdrożeniu:

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

3. Używając konta z uprawnieniami administratora, zaloguj się do swojej instancji Jamf Pro.

4. Po zakończeniu ładowania wyświetlą się wszystkie aplikacje urządzeń mobilnych w Twojej instancji. Znajdź wpis dla Jamf Mobile Assist. Uwaga: jeśli masz wiele wpisów, użyj identyfikatora z kroku 3 powyżej jako punktu odniesienia.

5. Dotknij aplikacji, aby wyświetlić szczegóły. W opisie aplikacji wybierz Begin App Integration.

6. Wykonaj każdy krok w procesie Assigner Integration:

   1. Potwierdź, że wybrana jest karta Assigner
   2. Wprowadź nazwę dla API Role, a następnie kliknij Create API Role. Uwaga: pojawi się błąd, jeśli wprowadzisz nazwę, która już istnieje.
   3. Wprowadź nazwę dla API Client, a następnie kliknij Create API Client
   4. Confirm App Link Request: przejrzyj nazwy i identyfikatory obiektów utworzone dla tej integracji
   5. Jeśli wszystko wygląda poprawnie, kliknij Complete App Link
   6. Jeśli operacja się powiedzie, możesz wrócić do poprzedniej sekcji, przechodząc do karty Navigation i dotykając przycisku Return
   7. Teraz możesz wyświetlić integrację na karcie Current Integrations

Podstawowy wymagany App Config

Po wykonaniu powyższych kroków możesz teraz ustawić zakres aplikacji i skonfigurować następujący tymczasowy App Config, aby aktywować Assigner. W rekordzie Mobile Device App w Jamf Pro dla Jamf Mobile Assist dodaj ten tymczasowy App Config, aby włączyć 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>

• Skopiuj powyższy kod i przejdź do aplikacji Mobile Assist (Devices > Mobile Device Apps > Jamf Mobile Assist > App Configuration)
• Kliknij Edit, wklej powyższy kod, a następnie kliknij Save
• Po wykonaniu powyższych kroków powinieneś być teraz w stanie otworzyć Mobile Assist na urządzeniu, a Assigner uruchomi się automatycznie

Designer Mode

Designer Mode umożliwia zbudowanie procesu kafelków Assigner bezpośrednio w aplikacji Assigner. Po zakończeniu możesz wyeksportować XML App Config i przesłać go przez AirDrop / Message itp. na urządzenie, na którym możesz uzyskać dostęp do kodu i wkleić go do Jamf Pro.

Wchodzenie do Designer Mode

Aby wejść do Designer Mode:

• Uruchom Mobile Assist / Assigner
• Naciśnij i przytrzymaj logo u góry głównego widoku przez 5 sekund. Pojawi się okno hasła
• Domyślne hasło to „admin" i można je zmienić w Designer Mode

Personalizacja kafelków i wyglądu Assigner

Każdy kafelek Assigner można dostosować, podobnie jak kolory, tekst, ikony, metodę wprowadzania danych i logo prezentowane w aplikacji.

Tryb skanowania aparatem / wprowadzania formularza

Wybór opcji trybu powoduje następujące działania:

Form & Scan

• Skaner aparatu jest włączony i umożliwia użytkownikowi użycie aparatu urządzenia do skanowania kodów i tekstu
• Gdy jest włączony, możesz skanować z kafelka, który wyświetla ikonę skanowania

Form

• Skaner aparatu nie jest włączony i wszystkie pola muszą być wprowadzane ręcznie

Kafelek logowania (kafelek 1)

Ten kafelek można skonfigurować tak, aby wymagał od użytkownika uwierzytelnienia się w Jamf Pro (konto Jamf Pro lub LDAP) i nie przejdzie dalej, jeśli nie zostaną wprowadzone prawidłowe poświadczenia.

Uwaga: Jeśli skaner jest wyłączony, ten kafelek wyświetli konfigurację username / password. Jeśli skaner jest włączony, pole password nie zostanie wyświetlone.

Skonfiguruj ten kafelek w następujący sposób:

Enabled — Włącza lub wyłącza kafelek z procesu

Title — Zmienia tekst tytułu kafelka

Icon — Zmienia ikonę obok tytułu. Możesz podejrzeć każdy dostępny obraz, przewijając do dołu Designer Mode i dotykając „Browse all images"

Preview Tile — Dotknij tutaj, aby podejrzeć swój projekt

Kafelki Extension Attribute (kafelki 2–5)

Te kafelki zapisują do Mobile Device Extension Attributes w Jamf Pro, umożliwiając użytkownikowi wybór z listy rozwijanej lub bezpośrednie skanowanie/wprowadzanie tekstu. Upewnij się, że utworzyłeś wybraną liczbę Extension Attributes z typem wprowadzania Text Field.

Skonfiguruj te kafelki w następujący sposób:

Enabled — Włącza lub wyłącza kafelek z procesu

Input

• Menu: Umożliwia użytkownikom wybór pozycji z listy rozwijanej
• Text: Umożliwia użytkownikom skanowanie lub ręczne wprowadzanie wartości

Title — Wprowadź tutaj dokładną nazwę Extension Attribute

Icon — Zmienia ikonę obok tytułu

Menu — Wprowadź pozycje, z których użytkownik ma wybierać w menu rozwijanym, jako wartości oddzielone przecinkami (np. Item 1, Item 2, Item 3). Uwaga: Input musi być ustawiony na Menu. Ważne: Naciśnij return na klawiaturze, aby zatwierdzić.

Kafelki Building i Department (kafelki 6–7)

Ostatnie dwa kafelki zapisują do atrybutów Building i Department rekordu urządzenia. Użytkownikowi zostanie przedstawione menu rozwijane dostępnych wyborów Building i/lub Department.

Skonfiguruj te kafelki w następujący sposób:

Enabled — Włącza lub wyłącza kafelek z procesu

Title — Nie można zmienić dla Building ani Department

Icon — Zmienia ikonę obok tytułu

Menu — Wprowadź pozycje, z których użytkownik ma wybierać w menu rozwijanym, jako wartości oddzielone przecinkami. Dla Building i Department musisz stosować następującą konwencję nazewnictwa:

• ObjectID:Name, ObjectID:Name, ObjectID:Name (gdzie ObjectID to identyfikator Jamf Pro dla Building lub Department, a Name to nazwa Building lub Department)
• Aby uzyskać identyfikator Jamf Pro dla Building lub Department, przejdź do Jamf Pro > Settings > Network > (Buildings lub Departments) > wybierz pozycję > odczytaj adres URL dla tej pozycji — identyfikatorem będzie końcowa liczba
• Na przykład, jeśli masz Building o nazwie „New York", kliknięcie na niego wyświetli https://myinstance.jamfcloud.com/view/settings/network-organization/buildings/3. Aby dodać w Assigner, użyj 3:New York
• Ważne: Naciśnij return na klawiaturze, aby zatwierdzić

Schemat kolorów tekstu

Te wartości służą do zmiany koloru tekstu (jasny lub ciemny), aby pasował do dowolnego koloru wybranego dla kafelków i tła aplikacji.

Headings Text — Ustawia kolor tekstu znajdującego się pod logo. Sam tekst można zmienić w Other Text Values > Title

Tile Text — Ustawia kolor tekstu i ikony w kafelkach

Button Text — Ustawia kolor tekstu w przyciskach (np. Submit/Reset, skanowanie, menu rozwijane)

Inne wartości tekstowe

Tutaj możesz zmienić treść tekstu wyświetlanego w częściach aplikacji niebędących kafelkami.

Title — Ustawia tekst wyświetlany pod logo brandingowym

Reset Button — Ustawia tekst na przycisku używanym do resetowania przypisania urządzenia po jego przypisaniu

Assignment Complete Line 1 — Ustawia pierwszą linię tekstu wyświetlaną po pomyślnym przypisaniu. Zastępuje ona widok kafelków

Assignment Complete Line 2 — Ustawia drugą linię tekstu wyświetlaną po pomyślnym przypisaniu. Zastępuje ona widok kafelków

Link do obrazu brandingowego

Ustawia obraz brandingowy wyświetlany u góry głównego ekranu za pomocą adresu URL.

Branding Image Link — Wprowadź adres URL obrazu brandingowego, którego chcesz użyć w aplikacji. Obraz pojawi się natychmiast w polu poniżej. Jeśli link nie działa lub obraz z innego powodu nie może zostać wyświetlony, automatycznie zostanie zastosowany obraz zastępczy i tekst. Pamiętaj, aby przetestować rozmiar i rozmieszczenie obrazu na głównym ekranie Assigner.

Schemat kolorów tła

Tutaj możesz ustawić ogólny kolor aplikacji, kafelków, przycisków itp. Dodatkowo możesz ustawić tło jako gradient lub jednolity kolor.

Background — Ustawia schemat kolorów tła Gradient lub Fill (jednolity) dla aplikacji

• Jeśli wybrano Gradient, kolory 1–3 są używane w całej aplikacji, przy czym Color 1 pojawia się u góry tła, Color 2 pośrodku, a Color 3 na dole
• Jeśli wybrano Fill, Color 1 jest używany dla tła, a Color 2 nie jest używany

Color 1: Top Gradient / Fill — Górny gradient tła, jeśli włączono Gradient, wypełnienie tła, jeśli włączono Fill

Color 2: Mid Gradient — Środkowy gradient tła, jeśli włączono Gradient

Color 3: Bottom Gradient / Buttons

• Dolny gradient tła, jeśli włączono Gradient
• Ustawia kolor wszystkich przycisków i animacji potwierdzenia przypisania
• Ustawia kolor kafelka (górny pasek / obramowanie kafelka ma 100% krycia koloru, podczas gdy reszta kafelka ma dynamiczne krycie Color 3, zmieniające się w zależności od tła i postępu procesu kafelka)

Hasło Designer Mode

Zmienia domyślne hasło Designer Mode. Pamiętaj, aby zmienić to ustawienie natychmiast podczas konfiguracji Assigner.

Browse All Images

Kliknij ten przycisk, aby wyświetlić listę wszystkich ikon, których możesz użyć do personalizacji każdego kafelka. Zwróć uwagę, że lista jest bardzo obszerna, ale w projekcie można użyć dowolnej ikony.

Wyświetlanie i eksportowanie App Config

Po ukończeniu projektu możesz wyświetlić i wyeksportować XML App Config. Trafi on do rekordu Mobile Assist w Jamf Pro i skonfiguruje wszystkie urządzenia z uruchomionym Assigner zgodnie z personalizacją wprowadzoną w Designer Mode.

View App Config — Aby wyświetlić XML, dotknij View App Config.

Copy / Share App Config — Aby wyeksportować ten App Config w celu zapisania go w Jamf Pro, dotknij Copy / Share App Config, a następnie wybierz metodę udostępniania do wysłania konfiguracji.

App Config

Po skonfigurowaniu Assigner za pomocą Designer Mode będziesz mieć kompletny App Config, który musi trafić do Jamf Pro. Skonfiguruje on wszystkie urządzenia z uruchomionym Assigner zgodnie z personalizacją opisaną w Designer Mode. Po wyeksportowaniu App Config z Designer Mode skopiuj go i wykonaj następujące kroki.

Dodawanie App Config do Jamf Pro

Mając kod App Config skopiowany do schowka, zaloguj się do swojej instancji Jamf Pro i wykonaj następujące czynności:

• Przejdź do Devices > Mobile Device Apps > Jamf Mobile Assist > App Configuration > Edit
• Wklej App Config w oknie Preferences
• Kliknij Save

Załącznik A - Odniesienie do App Config

Poniżej znajduje się szablon konfiguracji Assigner. Jest on dostarczany w celach informacyjnych, ponieważ Designer Mode w Assigner automatycznie tworzy go za Ciebie.

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

Tabela odniesienia Klucz/Wartość

Uwaga: Wszystkie wartości są typu string

Informacje prawne

• Umowa użytkowania: Application End User License Agreement
• Polityka prywatności: Jamf Privacy Policy