가이드

Assigner란?

Assigner는 Jamf Mobile Assist 앱의 일부로, 공유 사용 iOS 및 iPadOS 디바이스의 빠른 설정 및 구성을 지원합니다. 사용자는 단순히 디바이스를 집어 들고, 인증하고, 코드를 스캔하거나, 관리자가 정의한 기타 정보를 입력하여 자신의 역할이나 위치를 식별합니다. 그런 다음 Assigner는 사용자의 요구에 맞게 디바이스를 구성합니다. 작업이 완료되면 같은 앱에서 버튼을 눌러 디바이스에서 해당 선택 사항을 지우기만 하면 됩니다.

Mobile Assist 버전 1.9.0부터 Assigner는 더 높은 수준의 사용자 지정을 허용하고, 관리자가 Assigner가 디바이스를 사용자에게 할당하는 방식을 정의하는 기준을 보다 세밀하게 지정할 수 있도록 재설계되었습니다.

이 버전의 업데이트에는 다음이 포함됩니다.

• 타일 기반 사용자 할당 워크플로
• 워크플로에서 모든 타일 활성화/비활성화
• 색상, 텍스트, 아이콘, 입력 방법(예: 카메라를 사용한 스캔 입력, 수동 입력, 드롭다운 메뉴에서 선택)을 포함한 각 타일의 모든 측면 사용자 지정
• 단색 배경 또는 그라데이션 사용을 포함한 앱 및 텍스트의 모든 색상 사용자 지정
• 이미지에 대한 URL을 통해 회사 로고로 브랜딩 사용자 지정
• 앱에 내장되어 있으며 모든 디바이스에서 Assigner를 구성하는 데 Jamf Pro에서 사용할 App Config를 자동으로 생성하는 Designer Mode에서 위의 모든 작업 수행

Assigner는 어떻게 작동하나요?

매우 높은 수준에서 보면, Assigner는 사용자가 iOS 디바이스에 입력한 정보를 가져와 Jamf Pro에 기록하며, 여기서 해당 정보는 구성 및 앱을 배포하기 위한 Smart Group 멤버십을 결정하는 데 사용됩니다.

Jamf Pro에는 어떤 데이터 항목이 기록되나요?

디바이스 인벤토리 레코드에서 Assigner를 통해 다음 항목이 기록됩니다.

• Username
• Extension Attribute 1(관리자 정의)
• Extension Attribute 2(관리자 정의)
• Building(관리자 정의)
• Department(관리자 정의)

할당 워크플로 / 타일

Assigner는 타일 기반 할당 워크플로를 사용합니다. 5개 타일 각각은 다양한 산업 분야의 광범위한 조직의 요구에 맞게 사용자 지정할 수 있습니다. 또한 텍스트, 색상, 아이콘, 메뉴, 입력 방법, 브랜딩 로고 등 앱의 거의 모든 측면을 사용자 지정할 수 있습니다.

사용자는 정보를 수동으로 입력하거나, 드롭다운 메뉴에서 선택하거나, 디바이스 카메라를 사용하여 텍스트 / QR 코드를 스캔하며 타일을 진행합니다.

사용자가 워크플로를 성공적으로 완료하면 확인이 제공되고 구성 / 앱이 자동으로 배포됩니다. 그런 다음 Assigner 앱은 디바이스가 현재 할당되어 있으며 Reset 버튼을 사용하여 할당을 해제할 수 있다는 메시지를 표시합니다.

초기 필수 설정

Mobile Assist 앱에서 Assigner에 액세스하려면 먼저 다음 단계를 완료해야 합니다.

Jamf Pro를 통해 Jamf Mobile Assist 앱 설치

1. Volume Purchasing 워크플로를 사용하여 Jamf Pro에 앱 배포
2. 자동으로 생성되지 않은 경우 Jamf Pro 앱 카탈로그에 Jamf Mobile Assist 추가
   • Managed Distribution 탭에서 Assign Content Purchased in Volume 선택
   • 현재는 범위를 지정하지 말고 App Configuration을 비워 두세요
3. 다음 단계에서 참조할 수 있도록 브라우저 주소 표시줄에 표시된 URL에서 앱 레코드 ID를 기록해 두세요. https://yourinstance.jamfcloud.com/mobileDeviceApps.html?id=18&o=r 이 예시에서 ID는 18입니다.

내장 도구로 Assigner 활성화(Jamf App Wizard)

다음으로 Assigner가 Jamf Pro에서 작동하도록 구성해야 합니다. Mobile Assist 앱에는 Jamf App Wizard라는 도구가 포함되어 있습니다. 이 도구는 필요한 API Role 및 Client를 자동으로 설정하고 Assigner의 Linked App Integration을 생성합니다.

1. Mobile Assist를 액세스할 수 있는 디바이스로 범위 지정. App Configuration을 추가하지 마세요.

2. 이 디바이스에서 Mobile Assist를 실행합니다. App Config가 없으면 Jamf App Wizard가 자동으로 열립니다. 배포 후 언제든지 다음 App Config 키를 사용하여 마법사를 열 수도 있습니다.

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

3. Administrator 권한이 있는 계정을 사용하여 Jamf Pro 인스턴스에 로그인합니다.

4. 로딩이 완료되면 인스턴스의 모든 모바일 디바이스 앱이 표시됩니다. Jamf Mobile Assist 항목을 찾습니다. 참고: 항목이 여러 개인 경우 위 3단계의 ID를 참조로 사용하세요.

5. 앱을 탭하여 세부 정보를 봅니다. 앱 설명에서 Begin App Integration을 선택합니다.

6. Assigner Integration 워크플로의 각 단계를 완료합니다.

   1. Assigner 탭이 선택되어 있는지 확인
   2. API Role의 이름을 입력한 다음 Create API Role 클릭. 참고: 이미 존재하는 이름을 입력하면 오류가 반환됩니다.
   3. API Client의 이름을 입력한 다음 Create API Client 클릭
   4. Confirm App Link Request: 이 통합을 위해 생성된 이름과 객체 ID 검토
   5. 모든 것이 정상으로 보이면 Complete App Link 클릭
   6. 성공하면 Navigation 탭으로 이동하여 Return 버튼을 탭하여 이전 섹션으로 돌아갈 수 있습니다.
   7. 이제 Current Integrations 탭에서 통합을 볼 수 있습니다.

기본 필수 App Config

위 단계를 완료하면 이제 앱의 범위를 지정하고 Assigner가 활성화되도록 다음 임시 App Config를 설정할 수 있습니다. Jamf Mobile Assist에 대한 Jamf Pro Mobile Device App 레코드에서 이 임시 App Config를 추가하여 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>

• 위 코드를 복사하고 Mobile Assist 앱으로 이동합니다(Devices > Mobile Device Apps > Jamf Mobile Assist > App Configuration)
• Edit를 클릭하고 위 코드를 붙여넣은 다음 Save 클릭
• 위 단계를 완료하면 이제 디바이스에서 Mobile Assist를 열 수 있으며 Assigner가 자동으로 실행됩니다.

Designer Mode

Designer Mode를 사용하면 Assigner 앱 내에서 직접 Assigner 타일 워크플로를 구축할 수 있습니다. 완료되면 App Config XML을 내보내고 이를 AirDrop / 메시지 등으로 디바이스에 전송하여 코드에 액세스하고 Jamf Pro에 붙여넣을 수 있습니다.

Designer Mode 진입

Designer Mode에 진입하려면:

• Mobile Assist / Assigner 실행
• 메인 보기 상단의 로고를 5초 동안 길게 누릅니다. 암호 창이 나타납니다.
• 기본 암호는 "admin"이며 Designer Mode에서 변경할 수 있습니다.

Assigner 타일 및 외관 사용자 지정

각 Assigner 타일은 물론 앱에 표시되는 색상, 텍스트, 아이콘, 입력 방법, 로고도 사용자 지정할 수 있습니다.

카메라 스캔 / 양식 입력 모드

모드 옵션을 선택하면 다음이 수행됩니다.

Form & Scan

• 카메라 스캐너가 활성화되어 사용자가 디바이스 카메라를 사용하여 코드와 텍스트를 스캔할 수 있습니다.
• 활성화되면 스캔 아이콘을 표시하는 타일에서 스캔할 수 있습니다.

Form

• 카메라 스캐너가 활성화되지 않으며 모든 필드를 수동으로 입력해야 합니다.

로그인 타일(타일 1)

이 타일은 사용자가 Jamf Pro(Jamf Pro 계정 또는 LDAP)에 대해 인증하도록 요구하도록 구성할 수 있으며, 올바른 자격 증명이 입력되지 않으면 더 이상 진행되지 않습니다.

참고: 스캐너가 비활성화된 경우 이 타일은 사용자 이름 / 암호 구성으로 표시됩니다. 스캐너가 활성화된 경우 암호 필드가 표시되지 않습니다.

이 타일을 다음과 같이 구성합니다.

Enabled — 워크플로에서 타일 활성화 또는 비활성화

Title — 타일 제목의 텍스트 변경

Icon — 제목 옆의 아이콘 변경. Designer Mode 하단으로 스크롤하여 **"Browse all images"**를 탭하면 사용 가능한 모든 이미지를 미리 볼 수 있습니다.

Preview Tile — 여기를 탭하여 디자인 미리 보기

Extension Attribute 타일(타일 2~5)

이러한 타일은 사용자가 드롭다운 목록에서 선택하거나 텍스트를 직접 스캔/입력할 수 있게 하여 Jamf Pro의 Mobile Device Extension Attributes에 기록합니다. Input Type이 Text Field인 원하는 수의 Extension Attribute를 생성했는지 확인하세요.

이러한 타일을 다음과 같이 구성합니다.

Enabled — 워크플로에서 타일 활성화 또는 비활성화

Input

• Menu: 사용자가 드롭다운 목록에서 항목을 선택하도록 허용
• Text: 사용자가 값을 스캔하거나 수동으로 입력하도록 허용

Title — 여기에 Extension Attribute의 정확한 이름 입력

Icon — 제목 옆의 아이콘 변경

Menu — 드롭다운 메뉴에서 사용자가 선택할 항목을 쉼표로 구분된 값으로 입력합니다(예: Item 1, Item 2, Item 3). 참고: Input을 Menu로 설정해야 합니다. 중요: 커밋하려면 키보드에서 return을 누르세요.

Building 및 Department 타일(타일 6~7)

마지막 두 타일은 디바이스 레코드의 Building 및 Department 속성에 기록합니다. 사용자에게 사용 가능한 Building 및/또는 Department 선택 항목의 드롭다운이 표시됩니다.

이러한 타일을 다음과 같이 구성합니다.

Enabled — 워크플로에서 타일 활성화 또는 비활성화

Title — Building 또는 Department에 대해서는 변경할 수 없음

Icon — 제목 옆의 아이콘 변경

Menu — 드롭다운 메뉴에서 사용자가 선택할 항목을 쉼표로 구분된 값으로 입력합니다. Building 및 Department의 경우 다음 명명 규칙을 따라야 합니다.

• ObjectID:Name, ObjectID:Name, ObjectID:Name(여기서 ObjectID는 Building 또는 Department의 Jamf Pro ID이고 Name은 Building 또는 Department의 이름입니다)
• Building 또는 Department의 Jamf Pro ID를 얻으려면 Jamf Pro > Settings > Network > (Buildings 또는 Departments) > 항목 선택 > 해당 항목의 URL 읽기로 이동합니다 — ID는 뒤에 오는 숫자입니다.
• 예를 들어 "New York"이라는 Building이 있는 경우 이를 클릭하면 https://myinstance.jamfcloud.com/view/settings/network-organization/buildings/3이 표시됩니다. Assigner에 추가하려면 3:New York을 사용합니다.
• 중요: 커밋하려면 키보드에서 return을 누르세요.

텍스트 색 구성표

이러한 값은 앱의 타일 및 배경에 대해 선택한 색상과 어울리도록 텍스트 색상(밝음 또는 어두움)을 변경하는 데 사용됩니다.

Headings Text — 로고 아래에 있는 텍스트의 색상 설정. 텍스트 자체는 Other Text Values > Title에서 변경할 수 있습니다.

Tile Text — 타일의 텍스트 및 아이콘 색상 설정

Button Text — 버튼의 텍스트 색상 설정(예: Submit/Reset, 스캔, 드롭다운 메뉴)

기타 텍스트 값

여기서 앱의 타일이 아닌 부분에 표시되는 텍스트의 내용을 변경할 수 있습니다.

Title — 브랜딩 로고 아래에 나타나는 텍스트 설정

Reset Button — 디바이스 할당 후 이를 재설정하는 데 사용되는 버튼의 텍스트 설정

Assignment Complete Line 1 — 할당이 성공한 후 나타나는 첫 번째 텍스트 줄 설정. 이는 타일 보기를 대체합니다.

Assignment Complete Line 2 — 할당이 성공한 후 나타나는 두 번째 텍스트 줄 설정. 이는 타일 보기를 대체합니다.

브랜딩 이미지 링크

URL을 사용하여 메인 화면 상단에 표시되는 브랜딩 이미지를 설정합니다.

Branding Image Link — 앱에 사용하려는 브랜딩 이미지의 URL을 입력합니다. 이미지가 아래 공간에 즉시 나타납니다. 링크가 작동하지 않거나 이미지가 표시될 수 없는 경우 자리 표시자 이미지와 텍스트가 자동으로 적용됩니다. 메인 Assigner 화면에서 이미지 크기와 간격을 테스트해야 합니다.

배경 색 구성표

여기서 앱, 타일, 버튼 등의 전체 색상을 설정할 수 있습니다. 또한 배경을 그라데이션 또는 단색으로 설정할 수 있습니다.

Background — 앱에 대한 Gradient 또는 Fill(단색) 배경 색 구성표 설정

• Gradient를 선택하면 앱 전체에서 Colors 1~3이 사용되며 Color 1은 배경 상단, Color 2는 중간, Color 3은 하단에 나타납니다.
• Fill을 선택하면 Color 1이 배경에 사용되고 Color 2는 사용되지 않습니다.

Color 1: Top Gradient / Fill — Gradient가 활성화된 경우 배경 상단 그라데이션, Fill이 활성화된 경우 배경 채우기

Color 2: Mid Gradient — Gradient가 활성화된 경우 배경 중간 그라데이션

Color 3: Bottom Gradient / Buttons

• Gradient가 활성화된 경우 배경 하단 그라데이션
• 모든 버튼 및 할당 확인 애니메이션의 색상 설정
• 타일 색상 설정(타일의 상단 줄무늬 / 테두리는 100% 색상 불투명도이고 나머지 타일은 배경 및 타일 워크플로 진행 상황에 따라 변하는 Color 3의 동적 불투명도임)

Designer Mode 암호

이는 기본 Designer Mode 암호를 변경합니다. Assigner를 구성할 때 이 설정을 즉시 변경해야 합니다.

Browse All Images

이 버튼을 클릭하면 각 타일을 사용자 지정하는 데 사용할 수 있는 모든 아이콘 목록을 볼 수 있습니다. 목록이 매우 크지만 디자인에 모든 아이콘을 사용할 수 있습니다.

App Config 보기 및 내보내기

디자인을 완료한 후 App Config XML을 보고 내보낼 수 있습니다. 이는 Jamf Pro의 Mobile Assist 레코드에 들어가며 Designer Mode에서 수행한 사용자 지정에 따라 Assigner를 실행하는 모든 디바이스를 구성합니다.

View App Config — XML을 보려면 View App Config를 탭합니다.

Copy / Share App Config — Jamf Pro에 저장할 수 있도록 이 App Config를 내보내려면 Copy / Share App Config를 탭한 다음 공유 방법을 선택하여 구성을 보냅니다.

App Config

Designer Mode를 통해 Assigner를 구성한 후에는 Jamf Pro에 들어가야 하는 완전한 App Config가 생성됩니다. 이는 Designer Mode에 설명된 사용자 지정에 따라 Assigner를 실행하는 모든 디바이스를 구성합니다. Designer Mode에서 App Config를 내보낸 후 이를 복사하고 다음 단계를 수행합니다.

Jamf Pro에 App Config 추가

App Config 코드를 클립보드에 복사한 상태로 Jamf Pro 인스턴스에 로그인하고 다음을 수행합니다.

• Devices > Mobile Device Apps > Jamf Mobile Assist > App Configuration > Edit로 이동
• Preferences 창에 App Config 붙여넣기
• Save 클릭

부록 A - App Config 참조

다음은 Assigner를 구성하기 위한 템플릿입니다. Assigner의 Designer Mode가 이를 자동으로 생성하므로 정보 제공 목적으로 제공됩니다.

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

키/값 참조 표

참고: 모든 값은 string 유형입니다.

법적 고지

• 사용 계약: Application End User License Agreement
• 개인정보 처리방침: Jamf Privacy Policy