관리형 앱 구성

MDM 서비스에서 제공하는 Apple 표준 관리형 앱 구성 채널로 Vylos의 동작을 구성합니다.

배포 단계

Vylos(io.cbnventures.vylos)를 관리형 앱으로 설치하거나 할당합니다.
MDM 서비스에서 앱 구성 사전을 만듭니다.
관리할 제한, 환경설정 및 조직 정보 키만 추가합니다.
사전을 대상 기기 또는 사용자에게 할당합니다.
Vylos를 실행하거나 다시 전면으로 전환한 다음 관리형 구성에서 값을 확인합니다.

선택적 환경설정 키를 제거하면 해당 설정을 사용자가 다시 제어할 수 있습니다. 사전 전체를 제거하면 다음 새로고침 때 Vylos가 관리형 앱 구성을 비활성화합니다.

전달 요구 사항

관리형 앱 구성은 MDM이 Vylos 앱(io.cbnventures.vylos)에 할당하는 사전입니다. Vylos는 Apple의 표준 위치인 com.apple.configuration.managed에서 이 사전을 읽습니다.

이 사전은 설치 가능한 .mobileconfig 파일이 아니며, 기기에서 프로파일을 열어 삽입할 수 없습니다. 관리형 VPN 터널을 설치하려면 .mobileconfig 프로파일을 사용하십시오.

MDM 제품에 따라 이 기능을 관리형 앱 구성, 앱 구성, 사용자 설정 앱 설정 또는 관리형 앱 설정이라고 부를 수 있습니다. iOS, macOS 또는 visionOS가 사전을 전달하려면 먼저 Vylos를 관리형 앱으로 설치하거나 할당해야 합니다.

지원되는 키

제한

키	유형	기본값	용도
`allowManualTunnels`	부울	`true`	사용자 생성 터널과 해당 터널의 생성, 수정 또는 활성화 작업을 허용합니다.
`allowSettings`	부울	`true`	Vylos 설정에 접근하도록 허용합니다.
`blockJailbrokenDevices`	부울	`false`	iOS에서 탈옥이 감지되면 Vylos 전체의 실행을 차단합니다.

각 제한의 전체 동작은 제한 관리를, 전체 차단 시행 흐름은 탈옥 정책 시행을 참조하십시오.

관리형 환경설정

키	유형	허용되는 값	효과
`notificationsEnabled`	부울	`true`, `1`, `false` 또는 `0`	Vylos 알림 기본 스위치와 네 가지 연결 끊김 알림을 모두 재정의합니다. 이 설정은 Apple 시스템 알림 권한을 부여하지 않습니다. 관리자가 알림을 켜고 앱 내 설정 접근을 금지했다면 Vylos가 홈 화면에서 권한을 요청합니다.
`appearance`	문자열	`system`, `light` 또는 `dark`	iOS와 macOS에서 지정한 모양을 강제합니다. visionOS는 관리자가 확인할 수 있도록 전달된 값을 표시하지만, 시스템의 적응형 글래스 모양을 계속 사용합니다.
`appIcon`	문자열	`default`, `midnight`, `slate`, `steel`, `ocean`, `carbon`, `arctic`, `ember`, `forest` 또는 `obsidian`	iOS에서 대체 앱 아이콘을 강제합니다. macOS와 visionOS는 관리자가 확인할 수 있도록 전달된 값을 표시하지만 앱 아이콘을 바꾸지는 않습니다.

Vylos는 사용자가 이전에 선택한 값을 보존했다가 관리자가 해당 재정의를 제거하면 복원합니다. 선택적 키가 없거나 형식이 잘못된 경우 다른 관리형 키가 유효하더라도 해당 환경설정은 계속 사용자가 제어합니다.

언어는 Vylos의 관리형 환경설정이 아닙니다. 사용자와 관리자는 운영 체제의 앱별 언어 제어 기능으로 앱 언어를 선택합니다.

앱 보호, 앱 아이콘, 모양 및 알림의 관리형 환경설정을 보여 주는 Vylos 설정

조직 정보

키	유형	표시 이름
`companyName`	문자열	회사
`contactEmail`	문자열	이메일
`contactPhone`	문자열	전화
`contactAddress`	문자열	주소

Vylos는 앞뒤 공백을 제거하고 비어 있는 조직 정보 값은 표시하지 않습니다. 제공된 값은 관리형 구성에 표시되어 사용자가 앱의 관리 주체와 지원 연락처를 알 수 있습니다.

부울 값

MDM 제품마다 구성 값을 직렬화하는 방식이 다르므로 Vylos는 부울, 숫자 또는 문자열을 허용합니다. Vylos는 각 값을 문자열로 변환하고 앞뒤 공백을 제거한 뒤 대소문자를 구분하지 않고 비교합니다.

true와 1은 참을 의미합니다.
false와 0은 거짓을 의미합니다.
제한 키가 없으면 문서에 표시된 기본값을 사용합니다.
환경설정 재정의가 없거나 형식이 잘못되면 사용자 설정을 계속 사용합니다.

예를 들어 " False ", "FALSE" 및 숫자 0은 모두 거짓으로 해석됩니다. "yes" 같은 값은 형식이 잘못되었으며 해당 키를 자동으로 활성화하지 않습니다.

구성 우선순위

유효한 관리형 환경설정 키가 있는 동안에는 해당 수동 설정을 재정의합니다. Vylos는 사용자의 선택을 덮어쓰지 않고 별도로 보관합니다.

각 제한은 서로 독립적으로 평가됩니다. 관리형 키 하나를 제공해도 생략한 다른 키의 기본값은 바뀌지 않습니다.

비어 있지 않은 관리형 구성이 있으면 Vylos의 내장 앱 잠금 인증 단계를 건너뜁니다. 관리형 제한은 계속 적용됩니다. allowManualTunnels=false는 사용자 생성 터널을 일시 중지하고 저장된 단축어를 거부하며, allowSettings=false는 설정 접근을 계속 차단합니다.

새로고침 시점

Vylos는 앱을 실행할 때와 장면이 전면으로 돌아오거나 활성 상태가 될 때 관리형 사전을 읽습니다. 사전을 제거하면 다음 새로고침 때 사용자 제어 환경설정이 복원됩니다.

이 시점은 터널 상태와 통계 새로고침과는 별개입니다. 관리형 터널이 Vylos에 나타난 후 열려 있는 세부 정보 화면은 사용자 생성 터널과 마찬가지로 실시간 통계를 매초 새로고침합니다. Apple이 자체 일정에 따라 관리형 프로파일을 게시하므로 새로 설치하거나 교체한 VPN 프로파일은 조금 뒤에 나타날 수 있습니다. 관리형 터널 배포를 참조하십시오.

전체 예제

다음 속성 목록 사전을 MDM의 앱 구성 편집기에 붙여 넣거나 키-값 양식에 같은 키를 입력하십시오.

xml

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>allowManualTunnels</key>
    <false/>
    <key>allowSettings</key>
    <false/>
    <key>blockJailbrokenDevices</key>
    <true/>
    <key>notificationsEnabled</key>
    <true/>
    <key>appearance</key>
    <string>dark</string>
    <key>appIcon</key>
    <string>ocean</string>
    <key>companyName</key>
    <string>Example Company</string>
    <key>contactEmail</key>
    <string>[email protected]</string>
    <key>contactPhone</key>
    <string>+1 (212) 555-0100</string>
    <key>contactAddress</key>
    <string>100 Example Street, New York, NY</string>
</dict>
</plist>

이 예제는 다음 정책을 적용합니다.

키	예제 값	Vylos에서의 결과
`allowManualTunnels`	`false`	사용자 생성 터널을 숨기고 일시 중지하며 사용을 막습니다. 관리형 터널은 계속 사용할 수 있습니다.
`allowSettings`	`false`	앱 내 설정 영역을 차단합니다.
`blockJailbrokenDevices`	`true`	iOS에서 탈옥이 감지되면 Vylos와 해당 터널을 차단합니다.
`notificationsEnabled`	`true`	Vylos 알림의 기본 설정과 네 가지 알림 유형을 모두 켭니다.
`appearance`	`dark`	iOS와 macOS에서 다크 모드를 강제합니다. visionOS는 값을 기록하지만 시스템의 적응형 글라스를 계속 사용합니다.
`appIcon`	`ocean`	iOS에서 Ocean 아이콘을 선택합니다. macOS와 visionOS는 관리형 값만 표시합니다.
`companyName`	`Example Company`	관리형 구성에 관리 조직의 이름을 표시합니다.
`contactEmail`	`[email protected]`	조직의 지원 이메일을 표시합니다.
`contactPhone`	`+1 (212) 555-0100`	조직의 지원 전화번호를 표시합니다.
`contactAddress`	예제 주소	조직의 우편 주소를 표시합니다.

조직에서 제어하지 않을 선택적 키는 제거하십시오. 환경설정을 사용자 제어로 돌리기 위해 빈 문자열을 보내지 말고 키 자체를 제거하십시오.

MDM 키-값 편집기

위에 표시된 키의 철자와 값 유형을 정확히 사용하십시오. 예를 들어 MDM이 형식 지정 필드를 지원한다면 allowSettings를 텍스트 "false"가 아닌 부울 값으로 추가하십시오. Vylos는 값을 다르게 직렬화하는 콘솔을 위해 문서에 표시된 문자열 및 숫자 형식의 부울 값도 허용합니다.

사용자에게 표시되는 내용

구성이 활성화되면 관리형 구성에 조직 정보가 먼저 표시되고, 제공된 제한과 관리형 환경설정이 이어집니다. 이 화면은 정보 제공용이며 사용자는 관리형 값을 변경할 수 없습니다.

조직 연락처, 제한 및 관리형 환경설정이 표시된 활성 관리형 구성 정보 화면

사전이 없을 때는 앱 보호 설정에서 관리형 앱 구성에 대하여를 열 수 있습니다. 이 화면에 '비활성'이 표시되더라도 VPN 구성 프로파일이 없다는 뜻은 아닙니다. 두 배포 채널은 서로 독립적입니다.