> ## Documentation Index
> Fetch the complete documentation index at: https://docs.iru.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Custom Apps 개요
> Mac 및 Windows용 Iru Endpoint의 Custom Apps 개요입니다. 지원되는 패키지 형식, 설치 스크립트, 배포 옵션 및 버전 관리에 대해 알아봅니다.
Custom App Library Item은 Mac 컴퓨터와 Windows 컴퓨터에서 사용할 수 있습니다
Iru Endpoint를 사용하면 등록된 기기에 사용자 지정 애플리케이션을 업로드하고 배포할 수 있습니다. Mac 컴퓨터에는 **Mac Custom App** Library Item을, Windows 컴퓨터에는 **Windows Custom App** Library Item을 사용하십시오. 두 항목 모두 기기당 한 번 설치할지 앱을 지속적으로 적용할지 선택할 수 있으며, 최대 **5 GB**의 업로드 크기를 지원합니다.
### Custom Apps란 무엇입니까?
Custom Apps는 Library에서 업로드하고 구성하는 설치 프로그램 기반 Library Item입니다. Blueprint에 할당하여 Mac 또는 Windows 컴퓨터에 배포합니다. 옵션에는 기기당 한 번 설치, 지속적 적용, 또는 (Mac에서) Self Service에서 앱 제공이 있습니다.
### 플랫폼별
아래에서 플랫폼을 선택하여 설치 프로그램 유형, 구성 옵션 및 단계별 안내를 확인하십시오.
**Mac Custom App** Library Item을 사용하면 Mac 컴퓨터에 사용자 지정 애플리케이션(PKG, DMG, ZIP)을 배포할 수 있습니다. 설치 프로그램을 업로드하고, 감사 및 설치 옵션(설치 전후 스크립트 포함)을 구성한 다음, Library Item을 Blueprint에 할당합니다. Self Service를 통해 앱을 제공하거나 체크인 시 자동으로 적용할 수 있습니다. 아래 섹션에서는 지원되는 설치 프로그램 유형, 실행 옵션, 스크립트, Self Service 및 문제 해결에 대해 설명합니다.
### 설치 프로그램
Iru Endpoint는 Mac용으로 여러 설치 프로그램 유형을 지원합니다:
* **.PKG**: Iru Endpoint는 압축된 PKG 및 MPKG 파일을 지원합니다.
* **.ZIP**: ZIP 파일의 경우 콘텐츠를 압축 해제할 위치를 지정할 수 있습니다.
* **.DMG**: DMG 파일은 /Applications 폴더에 추출됩니다. DMG에 PKG가 포함되어 있으면 먼저 PKG를 추출하여 대신 업로드하십시오.
Iru Endpoint의 최대 파일 업로드 크기는 5 GB입니다.
### 설치 옵션
#### 실행 빈도
배포하려는 앱에 따라 Iru Endpoint가 앱을 한 번 설치할지, 아니면 지속적으로 모니터링하여 설치 상태를 보장할지 지정할 수 있습니다.
* **기기당 한 번 설치**: Iru Endpoint가 Custom App을 한 번 설치합니다. 앱이 Mac에서 제거되어도 자동으로 다시 설치되지 않습니다. 지속적으로 실행되면 안 되는 소프트웨어 패치에 사용하십시오.
* 설치 전 스크립트가 실패하면 Iru Agent는 Custom App 설치를 시도하지 않으며, 다음 체크인 시 이 Custom App Library Item을 다시 실행합니다.
* 설치 후 스크립트가 실패하면 Custom App 설치 성공 여부와 관계없이 Iru Agent는 다음 체크인 시 이 Custom App Library Item을 다시 실행합니다.
* **Audit and enforce**: Iru Endpoint는 첫 설치 전을 포함하여 매 체크인 시 감사 스크립트를 실행하고 통과(종료 코드 0)하는지 확인합니다. 감사 스크립트가 0 이외의 코드로 종료되면 Iru Endpoint가 애플리케이션을 자동으로 다시 설치합니다.
* **Self Service에서 온디맨드 설치**: 이 항목은 Self Service에서 선택적 설치로만 제공됩니다. 실행 후 **Install** 버튼이 **Reinstall**로 바뀝니다.
#### 감사 스크립트 고려 사항
감사 스크립트를 사용하면 통과 기준을 직접 제어할 수 있습니다. 앱이 특정 위치에 있어야 합니까? 특정 체크섬을 가져야 합니까? 특정 버전이어야 합니까? 감사 스크립트로 이 모든 것을 확인할 수 있습니다.
예: 이 감사 스크립트는 앱이 있는지 확인하고, 없으면 Iru에 재설치를 요청합니다.
```bash audit-app-presence.sh icon="terminal" lines theme={null}
#!/bin/bash
APPPATH="/Applications/zoom.us.app"
if [ -e "$APPPATH" ]; then
exit 0
else
exit 1
fi
```
설치된 앱의 특정 버전을 적용하려면 [Iru Support GitHub](https://github.com/kandji-inc/support/)에서 제공하는 [Minimum Enforced Version 스크립트](https://github.com/kandji-inc/support/blob/main/Scripts/audit-enforce-scripts/minimum_enforced_version.zsh)를 사용하십시오.
#### 설치 전 및 설치 후 스크립트
설치 전 및 설치 후 스크립트를 사용하면 Custom Apps의 설치 프로세스를 사용자 지정할 수 있습니다. 설치 전 스크립트를 사용하여 대체되는 다른 앱을 제거할 수 있습니다. 설치 후 스크립트로는 방금 설치된 Custom App을 구성할 수 있습니다.
#### Self Service 고려 사항
Custom Apps를 Self Service와 함께 사용할 때 중요한 고려 사항이 있습니다.
* Custom App의 적용 옵션이 **설치 및 지속 적용** 또는 **기기당 한 번 설치**로 설정된 경우에도 이 항목을 Self Service에 표시할 수 있습니다. 사용자가 소프트웨어를 다시 설치해야 할 때 유용합니다.
* Custom App의 **Enforcement** 옵션이 **Self Service에서 온디맨드 설치**로 설정된 경우, 사용자가 Self Service에서 설치할 때까지 앱이 설치되지 않습니다.
* Self Service를 통해 설치하면 최신 버전의 앱이 설치됩니다.
* **Self Service에서 온디맨드 설치**로 설정된 경우 Iru Endpoint는 App Store 라이선스가 아닌 앱의 관리를 자동으로 인수합니다(번들 ID가 Apps and Books 버전과 일치하는 경우). 전역 또는 앱별 업데이트 설정이 준수됩니다.
#### 재시작
일부 애플리케이션은 올바르게 작동하려면 설치 후 재부팅이 필요합니다. Iru Endpoint는 올바른 작동을 보장하기 위해 재시작을 트리거할 수 있습니다. Custom App 설치 후 Iru Endpoint가 컴퓨터를 재시작하도록 하려면 **설치 성공 후 재시작** 상자를 선택하십시오.
재시작 전에 사용자에게 30분 카운트다운이 제공됩니다.
#### Liftoff 설정
Mac Custom App 하단에서 **Advanced Settings**를 펼칩니다. **Liftoff 설정**에서 **이 Library Item 처리**을 찾을 수 있습니다. 이 설정은 [Iru Liftoff](/ko/endpoint/library/library-items-profiles/configure-the-liftoff-library-item)를 기준으로 앱이 설치되는 시점을 선택합니다. Automated Device Enrollment 및 수동 등록에 적용됩니다.
* **During Liftoff** (기본값): Custom App이 Liftoff 중에 처리되며, 처리가 완료될 때까지 Liftoff가 완료되지 않습니다. **Liftoff에서 숨기기**를 선택하지 않으면 Install 화면에 표시됩니다.
* **Liftoff에서 숨기기**: 선택하면 이 Library Item은 Liftoff 중에 계속 처리되지만 Install 화면에는 표시되지 않습니다. 처리되는 동안 Liftoff 화면 하단에 \*\*계속하기 전에 추가로 필요한 구성을 처리하는 중…\*\*라고 표시됩니다. 이 설정은 순서에 영향을 주지 않습니다.
* **Friendly name** (선택 사항): 지정하면 Liftoff에 Library Item **이름** 대신 이 이름이 표시됩니다. Iru Agent는 체크인 중에 여전히 **이름** 기준으로 Library Item의 순서를 정합니다.
* **Liftoff 이후**: Custom App이 Liftoff 중에 처리되지 않으며 Install 화면에 표시되지 않습니다. 이후 에이전트 체크인 시 설치됩니다.
이 Custom App이 [Automated Device Enrollment Library Item](/ko/endpoint/enrollment/apple/configuring-apple-enrollment#install-library-items-during-setup-assistant)의 **설정 지원 중에 Library Items 설치**에도 포함되어 있으면 Setup Assistant 중에 계속 설치됩니다. **이 Library Item 처리**은 해당 설치를 변경하지 않습니다.
#### 상태
Custom App Library Item의 상태 탭에는 앱 설치를 대기 중인 Mac 기기, 설치에 성공한 기기, 설치 문제로 **오류** 상태인 기기가 표시됩니다. **오류** 상태는 알림을 생성합니다. 자세한 내용은 [Global Alerts](/ko/endpoint/devices/global-alerts) 지원 문서를 참조하십시오.
### 단계별 지침
단계별 지침은 [Mac Custom App Library Item 구성](/ko/endpoint/library/library-items-profiles/configure-the-custom-apps-library-item)을 참조하십시오.
### 문제 해결
zip 파일에 패키지가 포함되어 있고 Custom App 설치 과정에서 Mac에 Gatekeeper 경고 알림이 표시되면, 설치 파일을 zip으로 압축하여 Iru에 업로드하기 전에 터미널 세션에서 패키지에 대해 다음 명령을 실행하여 격리(quarantine) 비트를 제거하십시오.
```bash clear-quarantine.sh icon="terminal" theme={null}
xattr -dr com.apple.quarantine "/path/to/package.pkg"
```
**Windows Custom App** Library Item을 사용하면 Windows 컴퓨터에서 Windows 애플리케이션(MSI, EXE)을 배포하고 관리할 수 있습니다. 압축된 설치 프로그램을 업로드하고, 설치 및 제거 명령을 구성하고, 감지 로직을 정의한 다음, Library Item을 Blueprint에 할당합니다. 압축된 설치 프로그램에는 단일 파일 또는 파일 디렉터리가 포함될 수 있습니다. 온라인 기기의 경우 15분 이내에 적용이 시작됩니다. 모든 설치 프로그램은 System 컨텍스트에서 실행됩니다. 아래 섹션에서는 설치 프로그램, 적용 및 감지 설정, 명령, 아키텍처, 보안 및 문제 해결에 대해 설명합니다.
Iru 시스템 트레이 **업데이트** 목록 및 [실행 중인 앱을 먼저 닫아야 하는 경우](/ko/endpoint/library/library-items-profiles/user-experience-with-windows-apps#when-an-app-must-close)를 포함하여 보류 중인 **Auto App** 또는 **Windows Custom App** 업데이트가 있을 때 최종 사용자에게 표시되는 내용은 [Windows 앱 사용자 경험](/ko/endpoint/library/library-items-profiles/user-experience-with-windows-apps#app-updates-in-the-iru-system-tray)을 참조하십시오.
### 설치 프로그램
설치 프로그램(MSI 또는 EXE)과 지원 파일 또는 폴더가 포함된 **.zip** 파일을 업로드합니다. 설치 명령이 실행되기 전에 설치 프로그램이 기기에 다운로드되어 로컬에서 압축 해제되므로, 실행 시점의 네트워크 가용성에 의존하지 않습니다. 업로드는 재개할 수 있으며, 네트워크 중단이 발생하면 중단된 지점부터 업로드가 이어집니다.
Iru Endpoint의 최대 파일 업로드 크기는 5 GB입니다.
### 설치 옵션
대상 기기에서 Iru가 앱을 적용하는 방식을 제어합니다.
* **기기당 한 번 설치**: Iru가 앱이 아직 없는 기기에 앱을 설치합니다. 설치 후 사용자가 수동으로 앱을 제거해도 Iru는 다시 설치하지 않습니다.
* **설치 및 지속 적용** (기본값): Iru가 앱을 설치하고, 이후 체크인 시 앱이 제거되었거나 없는 것으로 감지되면 다시 설치합니다.
### 적용 기간
이 버전의 앱을 즉시 적용할지 유예 기간 후에 적용할지 제어합니다. **Enforcement deadline**을 다음 중 하나로 설정합니다:
* **Immediately** (기본값): 할당 후 가능한 한 빨리 앱이 적용됩니다. 온라인 기기의 경우 15분 이내에 새 설치가 시작됩니다.
* **By enforcement deadline**: 앱이 열려 있지 않으면 적용 기한까지 설치를 시도합니다. 기한이 되면 아직 설치하지 않은 기기에서 설치가 필수가 됩니다.
**By enforcement deadline**을 선택하면 두 개의 추가 필드가 나타납니다:
* **Enforcement after version is saved**: Library Item이 저장된 후 적용이 시작되기까지의 기간입니다. 기본값: **2 weeks**.
* **Enforcement deadline time**: 기한 날짜에 적용이 시작되는 시각입니다. 기본값: **12:00 PM (Noon)**.
### 애플리케이션 세부 정보
* **게시자**: 애플리케이션을 제작한 조직 또는 개인입니다.
* **이름**: 애플리케이션의 표시 이름입니다. Library 및 기기 상태 보기에 표시됩니다.
* **버전**: 이 릴리스의 앱 버전 문자열입니다. 자유 형식 텍스트이며, 시맨틱 버전 관리에 따라 검증되지 않습니다.
* **App icon**: Library에서 앱을 나타낼 `.png` 이미지를 업로드합니다. 파일을 업로드 영역으로 끌어다 놓거나 **choose file**을 선택합니다.
* **Upload app**: 설치 프로그램과 지원 파일 또는 폴더가 포함된 `.zip` 파일을 업로드합니다. 파일을 업로드 영역으로 끌어다 놓거나 **choose file**을 선택합니다.
* zip에는 설치 프로그램(MSI, EXE)과 설치 명령이 참조하는 모든 파일이 포함되어야 합니다.
* 콘텐츠가 기기에서 압축 해제된 후 설치 명령의 상대 경로가 올바르게 해석되도록 zip을 구성하십시오.
### 감지 로직
감지 로직은 애플리케이션이 기기에 있는지 Iru에 알려 줍니다. 하나 이상의 감지 방법이 필요합니다. Iru는 에이전트가 체크인할 때 감지를 실행하여 앱을 설치해야 하는지 또는 이미 있는지 확인합니다.
**Detection logic rules** 드롭다운에서 감지 유형을 선택합니다. 옵션은 위에서 아래로 **MSI**, **File**, **Folder**, **Registry** 순으로 표시됩니다.
#### MSI
Product Code로 특정 MSI 패키지가 설치되어 있는지 감지합니다.
* **MSI product code**: 중괄호로 묶은 GUID 형식의 패키지 Product Code입니다(`{XXXXXXXX-XXXX-XXXX-XXXX-XXXXXXXXXXXX}`). Web App에서 형식을 검증합니다. MSI 속성이나 제품 문서에서 코드를 확인하십시오.
* **Check MSI product version**: **아니요**이면 Product Code만 평가됩니다. **예**이면 **equals** 또는 **is greater than or equal to** 연산자와 입력한 버전 문자열을 사용하여 설치된 제품 버전도 비교합니다.
#### File
지정한 경로의 파일을 사용하여 감지합니다.
* **Path to file**: 파일 이름을 포함한 파일의 전체 경로입니다(예: `C:\Program Files\YourApp\YourApp.exe`).
* **Detection method**: 파일 평가 방법을 선택합니다:
* **File exists**: 지정한 경로에서 파일이 발견되면 통과합니다.
* **File does not exist**: 파일이 발견되지 않으면 통과합니다. 제거 감지에 사용합니다.
* **버전**: 파일 버전이 비교 조건을 충족하면 통과합니다. 연산자를 **equals** 또는 **is greater than or equal to**로 설정한 다음 버전 문자열을 입력합니다.
* **Size in MB**: 파일 크기(MB)가 비교 조건을 충족하면 통과합니다. 연산자를 **equals** 또는 **is greater than or equal to**로 설정한 다음 크기를 입력합니다.
#### Folder
지정한 경로의 폴더를 사용하여 감지합니다.
* **Path to folder**: 폴더가 있어야 하는 전체 디렉터리 경로입니다(예: `C:\Program Files\YourApp`).
* **탐지 방법**:
* **Folder exists**: 지정한 경로에서 폴더가 발견되면 통과합니다.
* **Folder does not exist**: 폴더가 발견되지 않으면 통과합니다.
#### Registry
레지스트리 키 또는 값을 기준으로 앱을 감지합니다.
* **Key path**: 필수입니다. 확인할 전체 레지스트리 경로입니다(예: `HKLM\SOFTWARE\YourApp`). 경로는 대소문자를 구분하지 않습니다.
* **값**: 키 내의 선택적 레지스트리 값 이름입니다.
* **탐지 방법**:
* **Key exists**: 키가 있으면 통과합니다. **값**을 입력한 경우 해당 키 아래에 값이 있어야 합니다.
* **String comparison**: 키의 값이 입력한 문자열과 일치하면 통과합니다.
### 열린 앱 감지를 위한 실행 파일
* 필드당 하나의 실행 파일 이름을 입력합니다(예: `yourapp.exe`). Iru는 설치 또는 제거가 실행될 때 이러한 프로세스를 확인하여 사용자에게 종료하라는 메시지를 표시할 수 있도록 합니다.
* 필요한 경우 **추가**를 사용하여 행을 추가하고 삭제 컨트롤로 행을 제거합니다.
* 최대 100개의 실행 파일을 입력할 수 있습니다.
### 명령
Web App에서는 이를 **Install command line parameters** 및 **Uninstall command line parameters**로 표시합니다. 자동(silent) 설치 및 자동 제거 명령줄을 입력합니다.
**설치 명령**
애플리케이션을 자동으로 설치하는 데 사용되는 전체 명령줄입니다. MSI 패키지의 경우 표준 자동 설치는 다음과 같습니다:
```powershell icon="terminal" theme={null}
msiexec /i yourapp.msi /qn
```
설치 프로그램의 zip 안에 지원 파일이나 폴더가 포함된 경우 상대 경로를 사용하여 참조하십시오. 예:
```powershell icon="terminal" theme={null}
msiexec /i lance.msi TRANSFORMS=".\mytransforms\transform.mst" /qn
```
msiexec를 직접 호출하는 대신 zip 안의 PowerShell 스크립트를 실행할 수 있습니다. 스크립트는 설치 프로그램을 자동으로 실행해야 합니다.
```powershell icon="terminal" theme={null}
.\installapp.ps1
```
**제거 명령**
애플리케이션을 제거하는 데 사용되는 전체 명령줄입니다. MSI 패키지의 경우:
```powershell icon="terminal" theme={null}
msiexec /x {ProductCode} /qn
```
설치 또는 제거 명령의 설치 프로그램, 제거 프로그램 또는 스크립트 경로에 공백이 포함된 경우 해당 경로를 큰따옴표로 묶으십시오(예: `"my installer.exe"`).
### 아키텍처
**Architecture**에서 설치 프로그램에 대해 **x64** 또는 **arm64**를 선택합니다. MSI 메타데이터를 사용할 수 있는 경우 Iru가 올바른 값을 자동으로 감지하려고 시도합니다. 저장하기 전에 선택 사항을 확인하거나 재정의하십시오.
### 적용 동작
* 온라인 기기의 경우 할당 후 **15분** 이내에 적용이 시작됩니다. 새 설치의 경우 해당 시간 내에 다운로드 프로세스가 시작되며, 설치 시간은 파일 크기와 기기 성능에 따라 다릅니다.
* 설치 또는 제거가 실패하면 Iru가 15분마다 재시도합니다.
* 서버의 파일이 변경되지 않는 한 재시도 시 설치 프로그램을 다시 다운로드하지 않습니다.
* Library Item을 제거하거나 Blueprint 할당을 제거해도 기기에서 앱이 제거되지 **않습니다**. 앱은 기기에 남아 있으며, 적용만 중지됩니다.
설치 또는 제거 실패로 Iru Endpoint에서 알림이 생성되는 경우 자세한 내용은 [Global Alerts](/ko/endpoint/devices/global-alerts) 지원 문서를 참조하십시오.
### 보안
* **해시 검증**: Iru는 설치 명령을 실행하기 전에 설치 프로그램의 SHA-256 해시를 검증합니다. 해시가 일치하지 않으면 설치가 즉시 실패합니다.
* **암호화된 전송**: 설치 프로그램 파일은 HTTPS를 통해 전송됩니다. Library Item의 대상인 기기만 설치 프로그램을 다운로드할 수 있습니다.
### 고려 사항
* Library Item을 제거하거나 Blueprint 할당을 제거해도 앱은 제거되지 않습니다. 앱은 기기에 남아 있으며 더 이상 적용되지 않습니다.
* 설치 프로그램 zip은 실행 전에 기기에서 압축 해제됩니다. 설치 명령의 상대 경로가 zip 내부의 폴더 구조와 일치하는지 확인하십시오.
* 여러 앱이 동시에 기기를 대상으로 하는 경우 적용이 대기열에 추가됩니다. 15분 SLO는 대기열의 첫 번째 앱이 다운로드를 시작하는 시점에 적용됩니다.
### 모범 사례
MSI 기반 설치 프로그램의 경우 Product Code는 설치 경로와 관계없이 설치된 패키지를 식별합니다.
Iru에 업로드하기 전에 테스트 기기에서 설치 및 제거 명령을 수동으로 실행하십시오. 한 설치 프로그램 유형에서 작동하는 자동 플래그가 다른 유형에서는 작동하지 않을 수 있으므로 기기군에 배포하기 전에 검증하십시오.
설치 명령이 상대 경로를 사용하여 지원 파일을 참조하는 경우 zip 폴더 구조가 해당 경로와 정확히 일치하는지 확인하십시오. 일치하지 않으면 설치가 실패합니다.
전체 기기군으로 확장하기 전에 테스트 기기가 포함된 소규모 Blueprint에 Library Item을 할당하십시오. 설치, 감지 및 보고가 모두 예상대로 작동하는지 확인하십시오.
지나치게 광범위한 감지 규칙(예: 여러 앱이 공유하는 폴더 확인)은 오탐을 유발할 수 있습니다. 감지에는 사용 가능한 가장 구체적인 방법을 사용하십시오.
### 단계별 지침
단계별 지침은 [Windows Custom App Library Item 구성](/ko/endpoint/library/library-items-profiles/configure-the-windows-custom-app-library-item)을 참조하십시오.
### 문제 해결
**가능한 원인:**
* Library Item이 기기의 Blueprint에 할당되지 않음
* 대상 기기가 최근에 체크인하지 않음
**해결 방법:**
* Library Item이 올바른 Blueprint에 할당되어 있고 대상 기기가 지난 15분 이내에 체크인했는지 확인하십시오
* 기기별 상태 보기에서 종료 코드 또는 오류 메시지를 확인하십시오
기기별 상태 보기에서 종료 코드를 검토하십시오. 일반적인 MSI 종료 코드는 다음과 같습니다:
* **1603**: 일반 오류로, 앱이 이미 실행 중이거나 디스크 공간이 부족하거나 권한 문제로 인해 발생하는 경우가 많습니다.
* **1618**: 다른 설치가 이미 진행 중입니다. 에이전트가 재시도합니다.
* **1638**: 더 최신 버전의 앱이 이미 설치되어 있습니다. 감지 로직과 업그레이드 경로를 검토하십시오.
**가능한 원인:**
* 감지 규칙이 실제 설치 상태와 일치하지 않음
* 잘못된 Product Code, 경로 또는 레지스트리 값
**해결 방법:**
* MSI 패키지의 경우 Product Code가 올바른지 확인하십시오
* 파일 또는 레지스트리 감지의 경우 설치 후 표시되는 경로와 값을 정확히 확인하십시오
### 관련 문서
Mac Custom Apps(PKG, DMG, ZIP) 단계별 설정
Windows Custom Apps(MSI, EXE) 단계별 설정
Library Item을 선별, 생성 및 관리하고 Blueprint에 추가합니다
Self Service용 Library Item 구성(macOS)
Custom Apps 또는 기타 Library Item에서 문제가 보고될 때 Iru Endpoint가 알림을 표시하는 방식을 구성합니다