Iru Access 배포

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

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

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

관리형 배포

등록된 기기가 기기 신뢰에서 관리 대상으로 간주되도록 MDM을 통해 Iru Access를 설치하고 구성합니다.

MDM 연결 생성

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

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

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

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

macOS

Iru Access 구성 프로필 배포

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

표시 프로필 직접 구성

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를 허용합니다.

Iru Access 앱 배포

Iru Endpoint 사용 시: Library의 Auto Apps에서 Mac용 Iru Access Auto App을 추가하고, Blueprint를 통해 할당하고, Mac 컴퓨터로 범위를 지정합니다. Auto Apps 개요를 참조하세요.다른 MDM 사용 시: macOS용 Iru Access를 다운로드하고, 패키지를 MDM에 업로드한 다음, Mac 컴퓨터로 범위를 지정합니다.

등록 스크립트 다운로드

Iru Support GitHub 저장소에서 Iru Access 관리형 등록 스크립트를 복사합니다.

스크립트 구성

파일 상단 근처의 USER INPUT 섹션에서 regToken을 MDM 연결의 클라이언트 시크릿으로, regTokenDomain을 기본 테넌트 도메인으로 설정합니다.

# USER INPUT
regToken="mdm-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
regTokenDomain="yourcompany.iru.com"

Iru Endpoint로 스크립트 배포

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

다른 MDM으로 스크립트 배포

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

iOS, iPadOS 및 visionOS

요구 사항

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

Iru Access 구성 프로필 배포

Iru Identity의 Policies → MDM Connections에서 + MDM Connection 왼쪽의 다운로드 버튼을 선택한 다음 iOS Profile을 선택합니다. 프로필을 기기에 배포합니다.

표시 프로필 직접 구성

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

Iru Access 앱 배포

MDM을 통해 App Store의 Iru Access를 관리형 앱으로 배포하고 기기로 범위를 지정합니다.

관리형 등록 구성

MDM에서 Iru Access(번들 ID com.iru.AccessMobile)에 관리형 앱 구성을 설정합니다. 두 개의 키를 설정합니다.

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

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

Managed app configuration (plist)

<dict>
    <key>mdmSecret</key>
    <string>mdm-REPLACE-WITH-MDM-CONNECTION-CLIENT-SECRET</string>
    <key>mdmSecretDomain</key>
    <string>yourcompany.iru.com</string>
</dict>

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

Iru Endpoint에서는 Iru Access App Store 앱의 Set app configuration을 통해 이 딕셔너리를 적용합니다. 배포 단계는 AppConfig 사용을 참조하세요.

Windows

요구 사항

Windows 11 24H2, 25H2 또는 26H2

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

Iru Access 앱 배포

Iru Endpoint 사용 시: Library의 Auto Apps에서 Windows용 Iru Access Auto App을 추가하고, Blueprint를 통해 할당하고, Windows 컴퓨터로 범위를 지정합니다. Auto Apps 개요를 참조하세요.다른 MDM 사용 시: Windows용 Iru Access를 다운로드하고, 패키지를 MDM에 업로드한 다음, Windows 컴퓨터로 범위를 지정합니다.

등록 스크립트 다운로드

Iru Support GitHub 저장소에서 Iru Access 관리형 등록 스크립트를 복사합니다.

Iru Endpoint로 스크립트 배포

Library에서 Windows Custom Script Library Item을 추가하고, 스크립트를 업로드한 다음, Iru Access 앱과 동일한 Blueprint를 통해 할당합니다. Command line parameters에서 클라이언트 시크릿과 기본 테넌트 도메인을 전달합니다.

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

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

Execute in을 64 bit로 설정합니다. Windows Custom Scripts는 할당 시 기기당 한 번 실행됩니다. Custom Scripts 개요 (Windows 탭)를 참조하세요.

다른 MDM으로 스크립트 배포

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

.\iru_access_managed_registration_windows.ps1 manage --secret <client-secret> --domain yourcompany.iru.com

확인 또는 교체(선택 사항)

시크릿이 저장되었는지 확인하거나 지우려면 관리자 권한 PowerShell 세션에서 인수와 함께 스크립트를 실행하세요. PowerShell을 관리자로 여는 방법은 Microsoft의 Getting Started with PowerShell을 참조하세요.

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

등록 완료

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

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

비관리형 배포

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

macOS

사용자와 macOS용 Iru Access를 공유하세요. 사용자가 다운로드하여 설치한 다음 초대를 통해 등록합니다. 단계별 안내는 Iru Access 설치를 참조하세요.

iOS, iPadOS 및 visionOS

사용자와 App Store의 Iru Access 또는 초대 링크를 공유하세요. 사용자가 앱을 설치한 다음 등록합니다. 요구 사항

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

단계별 안내는 Iru Access 설치를 참조하세요.

Windows

사용자와 Windows용 Iru Access를 공유하세요. 사용자가 다운로드하여 설치한 다음 초대를 통해 등록합니다. 요구 사항

Windows 11 24H2, 25H2 또는 26H2

단계별 안내는 Iru Access 설치를 참조하세요.

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

리소스

연결을 생성할 때 필요한 MDM 서버 세부 정보를 수집하려면 이미 MDM에 등록된 기기에서 이 도우미 스크립트를 실행하세요. 두 스크립트 모두 Iru Support GitHub 저장소에서 관리됩니다.

macOS: APNs topic 및 Check-in URL 수집

macOS Collect MDM details 스크립트는 등록된 Mac에서 APNs topic 및 MDM Check-in URL을 읽습니다.

Windows: Provider ID 및 Discovery service URL 수집

Windows Collect MDM details 스크립트는 등록된 Windows 컴퓨터에서 MDM 서버의 Provider ID 및 Discovery service URL을 읽습니다. PowerShell에서 실행하세요.

다음 단계

macOS SSO 확장 문제 해결

Mac에서 연결된 도메인 승인 및 확장 로드 문제를 진단합니다.

MDM 연결

기기를 관리 대상으로 간주하게 하는 연결을 설정하고 관리합니다.

기기 신뢰

관리되고 정상인 기기를 액세스 조건으로 요구합니다.

Iru Access 설치

개인 기기에서 Iru Access를 설정하기 위한 최종 사용자 안내.

인증기

Iru Access가 패스키와 함께 인증기로 작동하는 방식.

시작하기

디렉터리

애플리케이션

인증 및 정책

관리

아키텍처 및 보안

최종 사용자 가이드

Iru Access 배포

관리형 배포

MDM 연결 생성

macOS

iOS, iPadOS 및 visionOS

Windows

비관리형 배포

macOS

iOS, iPadOS 및 visionOS

Windows

리소스

다음 단계

macOS SSO 확장 문제 해결

MDM 연결

기기 신뢰

Iru Access 설치

인증기

​관리형 배포

​MDM 연결 생성

​macOS

​iOS, iPadOS 및 visionOS

​Windows

​비관리형 배포

​macOS

​iOS, iPadOS 및 visionOS

​Windows

​리소스

​다음 단계

macOS SSO 확장 문제 해결

MDM 연결

기기 신뢰

Iru Access 설치

인증기

관리형 배포

MDM 연결 생성

macOS

iOS, iPadOS 및 visionOS

Windows

비관리형 배포

macOS

iOS, iPadOS 및 visionOS

Windows

리소스

다음 단계