> ## 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.

# Iru Access 배포

> Mac 컴퓨터, iPhone 기기, iPad 기기 및 Windows 컴퓨터가 관리 대상으로 인식되도록 MDM을 통해 Iru Access 앱을 배포합니다.

**Iru Access**는 각 사용자의 기기 바인딩 로그인 자격 증명을 보관하고
[기기 상태](/ko/identity/authentication/device-trust)를 보고합니다. 기기가
**관리 대상**으로 인식되는지 여부는 앱을 *어떻게* 제공하는지에 따라 결정됩니다.

* **관리형 배포:** MDM을 통해 설치 및 구성됩니다. Iru는 기기를 관리 대상으로
  인식하므로 **managed** 속성을 요구하는
  [인증 정책](/ko/identity/authentication/authentication-policies)이 충족됩니다.
* **비관리형 배포:** 사용자가 직접 설정하는 개인 또는 BYO 기기입니다. 작동하는
  인증기를 등록하고 상태 신호를 보고하지만 관리 대상으로 인식되지 **않으므로**,
  managed 속성을 요구하는 정책은 통과하지 못합니다.

<Note>
  두 경로 모두 사용자에게 작동하는 Iru Access 인증기를 제공하고 기기 상태를 보고합니다.
  유일한 차이점은 기기 신뢰 결정에서 기기가 **관리 대상**으로 간주되는지 여부입니다.
</Note>

## 관리형 배포

등록된 기기가 [기기 신뢰](/ko/identity/authentication/device-trust)에서 **관리 대상**으로
간주되도록 MDM을 통해 Iru Access를 설치하고 구성합니다.

### MDM 연결 생성

[MDM 연결](/ko/identity/authentication/mdm-connections)은 Iru가 MDM에 등록된 기기를
관리 대상으로 인식할 수 있게 해줍니다. Iru Identity와 함께 사용하는 각 MDM 인스턴스마다
하나씩 생성하세요.

1. Iru Identity에서 **Policies → MDM Connections**로 이동하여 **+ MDM Connection**을 선택합니다.
2. **Select a connection type**에서 하나를 선택합니다.
   * **Iru Endpoint 인스턴스**: Iru Endpoint 인스턴스에서 연결 필드를 미리 채웁니다.
   * **사용자 지정 MDM 연결**: 수동 입력으로 사용자 지정 MDM 연결을 생성합니다.
3. 연결에 **표시 이름**을 지정합니다. MDM 서버의 도메인을 권장합니다.
4. **플랫폼**을 선택합니다: Apple, Windows 또는 둘 다.
5. 플랫폼 세부 정보를 입력합니다.
   * **Apple:** MDM 서버의 **APNs topic** 및 **Check-in URL**.
   * **Windows:** MDM 서버의 **Provider ID** 및 **Discovery service URL**.

<Tip>
  해당 값을 잘 모르시나요? 이미 등록된 기기에서 실행하여 값을 읽을 수 있는 도우미
  스크립트는 [리소스](#resources)를 참조하세요.
</Tip>

연결이 생성된 후 아래의 각 플랫폼에 Iru Access를 배포합니다.

### macOS

<Steps>
  <Step title="Iru Access 구성 프로필 배포">
    Iru Identity의 **Policies → MDM Connections**에서 **+ MDM Connection** 왼쪽의 다운로드
    버튼을 선택한 다음 **macOS Profile**을 선택합니다. 프로필을 Mac 컴퓨터에 배포합니다.
    프로필에는 이미 Associated Domains 및 Single Sign-On 확장 설정(조직의 도메인이 채워진
    상태)이 포함되어 있으므로 직접 조합할 필요가 없습니다.

    <Expandable title="프로필 직접 구성">
      MDM이 업로드된 프로필 대신 기본 페이로드로 이를 구성하는 경우 다음을 복제하세요.
      `<your-iru-domain>`을 연결에서 사용하는 각 도메인으로 바꾸세요(연결에 둘 이상의
      도메인이 포함될 수 있음).

      * **Associated Domains:** 애플리케이션 식별자
        `N5M3B34269.com.iru.Access`, 각 도메인에 대해 `authsrv:<your-iru-domain>`의
        연결된 도메인.
      * **Single Sign-On 확장**(Extensible SSO, **Redirect** 유형):
        확장 식별자 `com.iru.Access.SSOExtension`, 팀 식별자 `N5M3B34269`, 그리고
        각 도메인에 대한 다음 리디렉션 URL 값:

        ```
        https://<your-iru-domain>/api/v1/saml/sso
        https://<your-iru-domain>/api/v1/oauth/authorize
        https://<your-iru-domain>/api/v1/saml/login
        ```
      * **관리되는 로그인 항목:** Iru Access 도우미, 백그라운드 서비스 및 업데이터가
        실행될 수 있도록 `com.iru.Access`, `com.iru.Access.IruDaemon`, `com.iru.Access.Menu`에
        대해 팀 식별자 `N5M3B34269`를 허용합니다.
    </Expandable>
  </Step>

  <Step title="Iru Access 앱 배포">
    **Iru Endpoint 사용 시:** Library의 **Auto Apps**에서 Mac용 **Iru Access** Auto App을
    추가하고, Blueprint를 통해 할당하고, Mac 컴퓨터로 범위를 지정합니다.
    [Auto Apps 개요](/ko/endpoint/library/auto-apps/auto-apps-overview)를 참조하세요.

    **다른 MDM 사용 시:**
    [macOS용 Iru Access](https://updater.iru.com/iru-access-macOS/download)를 다운로드하고,
    패키지를 MDM에 업로드한 다음, Mac 컴퓨터로 범위를 지정합니다.
  </Step>

  <Step title="등록 스크립트 다운로드">
    [Iru Support GitHub 저장소](https://github.com/kandji-inc/support/tree/main/Identity)에서
    [Iru Access 관리형 등록 스크립트](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-managed-registration/iru_access_managed_registration_macos.zsh)를
    복사합니다.
  </Step>

  <Step title="스크립트 구성">
    파일 상단 근처의 **USER INPUT** 섹션에서 `regToken`을 MDM 연결의 **클라이언트
    시크릿**으로, `regTokenDomain`을 **기본** 테넌트 도메인으로 설정합니다.

    ```zsh theme={null}
    # USER INPUT
    regToken="mdm-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    regTokenDomain="yourcompany.iru.com"
    ```
  </Step>

  <Step title="Iru Endpoint로 스크립트 배포">
    Library에서 **Mac Custom Script** Library Item을 추가하고, 수정한 스크립트를
    **감사 스크립트**에 붙여넣은 다음, Iru Access 앱과 동일한 Blueprint를 통해 할당합니다.
    Iru Access가 설치되고 시크릿이 저장될 때까지 각 체크인에서 스크립트가 재시도하도록
    **실행 빈도**를 **Run every 15 minutes**로 설정합니다. 스크립트는 멱등성이
    있으므로 덜 자주 실행하려면 **Run daily**도 사용할 수 있습니다.
    [Custom Scripts 개요](/ko/endpoint/library/library-items-profiles/custom-scripts-overview)
    (Mac 탭)를 참조하세요.
  </Step>

  <Step title="다른 MDM으로 스크립트 배포">
    플랫폼의 사용자 지정 스크립트 또는 정책 도구를 사용하여 수정한 스크립트를
    업로드합니다. 앱이 설치되면 새 기기가 시크릿을 받을 수 있도록 Iru Access 설치 후
    반복 일정으로 실행하세요.
  </Step>
</Steps>

### iOS, iPadOS 및 visionOS

**요구 사항**

* **iOS 및 iPadOS:** 기기에서 **18.4 이상**을 실행해야 합니다.
* **Apple Vision Pro:** Iru Access는 iPad 앱으로 설치됩니다.

<Steps>
  <Step title="Iru Access 구성 프로필 배포">
    Iru Identity의 **Policies → MDM Connections**에서 **+ MDM Connection** 왼쪽의 다운로드
    버튼을 선택한 다음 **iOS Profile**을 선택합니다. 프로필을 기기에 배포합니다.

    <Expandable title="프로필 직접 구성">
      * **Single Sign-On 확장**(Extensible SSO, **Redirect** 유형):
        확장 식별자 `com.iru.AccessMobile.SSOExtension`, 팀 식별자 `N5M3B34269`,
        그리고 각 도메인에 대한 다음 리디렉션 URL 값:

        ```
        https://<your-iru-domain>/api/v1/saml/sso
        https://<your-iru-domain>/api/v1/oauth/authorize
        ```
    </Expandable>
  </Step>

  <Step title="Iru Access 앱 배포">
    MDM을 통해 [App Store의 Iru Access](https://apps.apple.com/us/app/iru-access/id6752437810)를
    관리형 앱으로 배포하고 기기로 범위를 지정합니다.
  </Step>

  <Step title="관리형 등록 구성">
    MDM에서 Iru Access(번들 ID `com.iru.AccessMobile`)에 **관리형 앱 구성**을 설정합니다.
    두 개의 키를 설정합니다.

    * **`mdmSecret`**(String, 필수): MDM 연결의 **클라이언트 시크릿**.
    * **`mdmSecretDomain`**(String, 필수): **기본** 테넌트 도메인
      (예: `yourcompany.iru.com`).

    <Warning>
      `mdmSecretDomain`을 초대 링크에서 사용하는 `id.` 하위 도메인
      (`yourcompany.id.iru.com`)이 아닌 **기본** 도메인(`yourcompany.iru.com`)으로
      설정하세요. `id.` 하위 도메인이 포함되면 시크릿이 적용되지 않고 사용자가 직접
      입력해야 합니다.
    </Warning>

    ```xml Managed app configuration (plist) theme={null}
    <dict>
        <key>mdmSecret</key>
        <string>mdm-REPLACE-WITH-MDM-CONNECTION-CLIENT-SECRET</string>
        <key>mdmSecretDomain</key>
        <string>yourcompany.iru.com</string>
    </dict>
    ```

    <Note>
      이 구성을 사용하면 등록에 **자격 증명이 필요 없습니다**. 사용자는 시크릿을
      입력하거나, QR 코드를 스캔하거나, 수동 승인을 기다릴 필요가 없습니다. 사용자는
      여전히 **초대**(이메일로 받거나 관리 기기에 푸시하는 링크) 또는 앱 내 온보딩
      화면을 열고, **계속**을 탭한 다음, Face ID 또는 Touch ID로 확인합니다.
    </Note>

    Iru Endpoint에서는 Iru Access App Store 앱의 **Set app configuration**을 통해 이
    딕셔너리를 적용합니다. 배포 단계는
    [AppConfig 사용](/ko/endpoint/library/library-items-profiles/using-appconfig)을
    참조하세요.
  </Step>
</Steps>

### Windows

**요구 사항**

* **Windows 11 24H2, 25H2 또는 26H2**

Windows 배포는 두 부분으로 구성됩니다. MDM을 통해 **Iru Access**를 배포한 다음,
등록 스크립트로 각 Windows 컴퓨터에 MDM 연결의 **클라이언트 시크릿**을 저장합니다.
등록 시에는 여전히 사용자가 초대를 열고 **Windows Hello**로 확인해야 합니다.

<Steps>
  <Step title="Iru Access 앱 배포">
    **Iru Endpoint 사용 시:** Library의 **Auto Apps**에서 Windows용 **Iru Access** Auto
    App을 추가하고, Blueprint를 통해 할당하고, Windows 컴퓨터로 범위를 지정합니다.
    [Auto Apps 개요](/ko/endpoint/library/auto-apps/auto-apps-overview)를 참조하세요.

    **다른 MDM 사용 시:**
    [Windows용 Iru Access](https://updater.iru.com/iru-access-windows/download)를
    다운로드하고, 패키지를 MDM에 업로드한 다음, Windows 컴퓨터로 범위를 지정합니다.
  </Step>

  <Step title="등록 스크립트 다운로드">
    [Iru Support GitHub 저장소](https://github.com/kandji-inc/support/tree/main/Identity)에서
    [Iru Access 관리형 등록 스크립트](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-managed-registration/iru_access_managed_registration_windows.ps1)를
    복사합니다.
  </Step>

  <Step title="Iru Endpoint로 스크립트 배포">
    Library에서 **Windows Custom Script** Library Item을 추가하고, 스크립트를 업로드한
    다음, Iru Access 앱과 동일한 Blueprint를 통해 할당합니다.
    [**Command line parameters**](/ko/endpoint/library/library-items-profiles/custom-scripts-overview#command-line-parameters-optional)에서
    클라이언트 시크릿과 기본 테넌트 도메인을 전달합니다.

    ```
    manage --secret <client-secret> --domain yourcompany.iru.com
    ```

    <Warning>
      macOS 및 iOS와 동일한 값인 연결의 **클라이언트 시크릿**과 **기본** 테넌트 도메인
      (`yourcompany.iru.com`)을 사용하세요. 레지스트리에 직접 쓰는 대신 이 스크립트로
      클라이언트 시크릿을 저장하세요. 시크릿은 기기에 맞게 암호화되므로 원시 레지스트리나
      OMA-URI로 푸시한 값은 사용할 수 없습니다.
    </Warning>

    **Execute in**을 **64 bit**로 설정합니다. Windows Custom Scripts는 할당 시 기기당 한
    번 실행됩니다.
    [Custom Scripts 개요](/ko/endpoint/library/library-items-profiles/custom-scripts-overview)
    (Windows 탭)를 참조하세요.
  </Step>

  <Step title="다른 MDM으로 스크립트 배포">
    플랫폼에서 지원하는 스크립트 또는 PowerShell 정책 도구를 사용하여 스크립트를
    배포합니다. MDM이 허용하는 `manage --secret` 및 `--domain` 인수를 전달하고,
    스크립트가 `HKLM`에 쓸 수 있도록 관리자 권한으로 실행하세요.

    ```powershell theme={null}
    .\iru_access_managed_registration_windows.ps1 manage --secret <client-secret> --domain yourcompany.iru.com
    ```
  </Step>

  <Step title="확인 또는 교체(선택 사항)">
    시크릿이 저장되었는지 확인하거나 지우려면 관리자 권한 PowerShell 세션에서 인수와
    함께 스크립트를 실행하세요. PowerShell을 관리자로 여는 방법은 Microsoft의
    [Getting Started with PowerShell](https://learn.microsoft.com/en-us/powershell/scripting/learn/ps101/01-getting-started?view=powershell-7.5#starting-powershell-elevated-as-an-administrator)을
    참조하세요.

    ```powershell theme={null}
    # Verify: prints "<domain>:<hash>", never the secret itself
    .\iru_access_managed_registration_windows.ps1 manage --list

    # Rotate or remove
    .\iru_access_managed_registration_windows.ps1 manage --clear "yourcompany.iru.com"
    ```
  </Step>

  <Step title="등록 완료">
    앱이 배포되고 클라이언트 시크릿이 저장되면, 사용자는 **초대**를 열어 Iru Access를
    실행하고 **Windows Hello**로 확인합니다. 기기가 MDM에 등록되어 있고 저장된 클라이언트
    시크릿을 가지고 있으므로 Iru는 이를 **관리 대상**으로 인식합니다.
  </Step>
</Steps>

<Note>
  Iru Access는 처음 실행될 때 Windows에 **패스키 플러그인**을 자동으로 등록하며, 이후
  **Settings ▸ Accounts ▸ Passkeys ▸ Advanced options** 아래에 표시됩니다. 해당 토글을
  **켜는** 것은 Windows와 사용자의 권한입니다. 현재 MDM을 통해 중앙에서 강제로 켤 수
  없습니다. [최종 사용자 가이드](/ko/identity/end-user/installing-iru-access)에서 해당
  단계를 다룹니다.
</Note>

## 비관리형 배포

개인 기기 또는 BYOD 기기의 경우 MDM에서 구성할 것이 없습니다. 사용자가 Iru Access를
설치하고 초대를 통해 등록합니다.

### macOS

사용자와 [macOS용 Iru Access](https://updater.iru.com/iru-access-macOS/download)를
공유하세요. 사용자가 다운로드하여 설치한 다음 초대를 통해 등록합니다. 단계별 안내는
[Iru Access 설치](/ko/identity/end-user/installing-iru-access)를 참조하세요.

### iOS, iPadOS 및 visionOS

사용자와 [App Store의 Iru Access](https://apps.apple.com/us/app/iru-access/id6752437810)
또는 초대 링크를 공유하세요. 사용자가 앱을 설치한 다음 등록합니다.

**요구 사항**

* **iOS 및 iPadOS:** 기기에서 **18.4 이상**을 실행해야 합니다.
* **Apple Vision Pro:** App Store에서 iPad 앱으로 설치합니다.

단계별 안내는 [Iru Access 설치](/ko/identity/end-user/installing-iru-access)를
참조하세요.

### Windows

사용자와 [Windows용 Iru Access](https://updater.iru.com/iru-access-windows/download)를
공유하세요. 사용자가 다운로드하여 설치한 다음 초대를 통해 등록합니다.

**요구 사항**

* **Windows 11 24H2, 25H2 또는 26H2**

단계별 안내는 [Iru Access 설치](/ko/identity/end-user/installing-iru-access)를
참조하세요.

<Note>
  비관리형 기기도 작동하는 인증기를 등록하고 상태 신호를 보고하지만 관리 대상으로
  인식되지 **않습니다**. managed 속성을 요구하는 정책은 이러한 기기에서 통과하지
  못합니다. 해당 정책을 충족해야 하는 기기에는 **관리형 배포**를 사용하세요.
</Note>

## 리소스

연결을 생성할 때 필요한 MDM 서버 세부 정보를 수집하려면 이미 MDM에 등록된 기기에서
이 도우미 스크립트를 실행하세요. 두 스크립트 모두
[Iru Support GitHub 저장소](https://github.com/kandji-inc/support/tree/main/Identity)에서
관리됩니다.

<AccordionGroup>
  <Accordion title="macOS: APNs topic 및 Check-in URL 수집" icon="apple">
    [macOS Collect MDM details 스크립트](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-collect-mdm-details/collect_mdm_details_macos.zsh)는
    등록된 Mac에서 **APNs topic** 및 **MDM Check-in URL**을 읽습니다.
  </Accordion>

  <Accordion title="Windows: Provider ID 및 Discovery service URL 수집" icon="windows">
    [Windows Collect MDM details 스크립트](https://github.com/kandji-inc/support/blob/main/Identity/iru-access-collect-mdm-details/collect_mdm_details_windows.ps1)는
    등록된 Windows 컴퓨터에서 MDM 서버의 **Provider ID** 및 **Discovery service URL**을
    읽습니다. PowerShell에서 실행하세요.
  </Accordion>
</AccordionGroup>

## 다음 단계

<CardGroup cols={2}>
  <Card title="macOS SSO 확장 문제 해결" icon="bug" href="/ko/identity/authentication/troubleshoot-macos-sso">
    Mac에서 연결된 도메인 승인 및 확장 로드 문제를 진단합니다.
  </Card>

  <Card title="MDM 연결" icon="tower-broadcast" href="/ko/identity/authentication/mdm-connections">
    기기를 관리 대상으로 간주하게 하는 연결을 설정하고 관리합니다.
  </Card>

  <Card title="기기 신뢰" icon="laptop" href="/ko/identity/authentication/device-trust">
    관리되고 정상인 기기를 액세스 조건으로 요구합니다.
  </Card>

  <Card title="Iru Access 설치" icon="download" href="/ko/identity/end-user/installing-iru-access">
    개인 기기에서 Iru Access를 설정하기 위한 최종 사용자 안내.
  </Card>

  <Card title="인증기" icon="key" href="/ko/identity/authentication/authenticators">
    Iru Access가 패스키와 함께 인증기로 작동하는 방식.
  </Card>
</CardGroup>