macOS SSO 확장 문제 해결

Iru Access는 macOS SSO(Single Sign-On) 확장을 설치합니다. 이는 Iru 도메인에 대한 로그인을 가로채서 사용자가 기기 바인딩 자격 증명으로 로그인하도록 하는 Redirect 유형의 Extensible SSO 확장입니다. 이것이 작동하려면 macOS가 확장에 대한 연결된 도메인을 승인해야 하며, 이는 일반적으로 MDM이 Iru Access 구성 프로필의 일부로 푸시합니다. Mac에서 Iru Access가 로그인을 가로채지 않는 경우, 아래 검사를 통해 확장이 설치되고 로드되었는지, 그리고 연결된 도메인이 승인되었는지 순서대로 확인합니다. 이 검사는 Apple 자체 명령줄 도구를 사용하며 등록된 Mac에서 안전하게 실행할 수 있습니다.

기존 배포를 진단하는 용도로만 사용합니다. 구성 프로필, 앱 및 등록을 설정하려면 Iru Access 배포를 참조하세요.

아래에서 사용하는 값. N5M3B34269는 Iru의 Apple Team ID로, Iru Access MDM 프로필의 값과 동일하므로 Iru Access App ID는 항상 N5M3B34269.com.iru.Access입니다. yourcompany.id.iru.com은 조직의 Iru 로그인 도메인을 나타내며, 실제 출력에는 실제 도메인이 표시됩니다.

연결된 도메인이 승인되었는지 확인

SSO 확장이 작동하지 않는 가장 일반적인 원인은 macOS가 연결된 도메인을 승인하지 않은 것입니다. Mac의 모든 연결된 도메인 승인을 나열합니다.

sudo swcutil show

Service authsrv, Iru Access App ID N5M3B34269.com.iru.Access 및 Iru 로그인 도메인(연결에서 사용하는 도메인당 하나의 항목)이 있는 항목을 찾습니다.

--------------------------------------------------------------------------------
Service:              authsrv
App ID:               N5M3B34269.com.iru.Access
Domain:               yourcompany.id.iru.com
User Approval:        unspecified
Site/Fmwk Approval:   approved
Flags:                enterpriseManaged
Last Checked:         2026-05-24 21:27:52 +0000
Next Check:           2026-05-29 20:38:54 +0000
--------------------------------------------------------------------------------

확인할 사항:

**Site/Fmwk Approval: approved**가 중요한 줄입니다. 이는 Apple이 확장에 대한 도메인 연결을 검증했음을 의미합니다. denied 또는 항목이 없으면 연결이 아직 검증되지 않은 것입니다.

**Flags: enterpriseManaged**는 관리형 배포에서 예상되는 대로 MDM이 도메인을 푸시했음을 나타냅니다. 이것이 없으면 Associated Domains 페이로드가 포함된 구성 프로필이 이 Mac에 도달하지 않았을 수 있습니다.
연결에서 사용하는 Iru 도메인당 하나의 항목이 있어야 합니다(연결에 둘 이상이 포함될 수 있음). 도메인이 누락되었다면 프로필이 불완전한 것입니다.

확장이 설치되었는지 확인

macOS에 등록된 Iru Access 앱 확장을 나열합니다.

pluginkit -v -m

예를 들어 다음과 같이 SSO 확장이 나열되어야 합니다.

    com.iru.Access.SSOExtension(1.0)    8ACDABA9-0000-0000-0000-4E99DCF7F39D    /Applications/Iru Access.app/Contents/PlugIns/SSOExtension.appex

확인할 사항:

com.iru.Access.SSOExtension 줄이 있으면 확장이 등록된 것입니다.
줄이 전혀 없으면 Iru Access 앱이 설치되지 않았거나 확장이 아직 등록되지 않은 것입니다. 앱이 배포되었고 한 번 이상 실행되었는지 확인하세요.

시스템이 확장을 로드했는지 확인

시스템의 SSO 확장 관리자를 스트리밍하고 Iru Access가 로드되는지 확인합니다.

log stream --debug --predicate 'category contains "SOExtensionManager"'

정상적인 시스템은 Iru 확장이 로드된 것으로 기록합니다(다음과 유사한 출력).

AppSSOAgent: (AppSSO) [SOExtensionManager] loadedExtensionWithBundleIdentifer:
  com.iru.Access.SSOExtension => <SOExtension bundleID=com.iru.Access.SSOExtension,
  path=/Applications/Iru Access.app/Contents/PlugIns/SSOExtension.appex>

Mac에 설치된 다른 Single Sign-On 확장도 같은 목록에 표시됩니다. 여기서 중요한 것은 com.iru.Access.SSOExtension입니다.

승인 및 로그인 활동을 실시간으로 관찰

승인이 늦게 적용되거나 로그인이 가로채지지 않을 때 두 가지 실시간 스트림이 도움이 됩니다.연결된 도메인 검사: macOS가 도메인 승인을 예약하고 기록하는 것을 관찰합니다.

sudo swcutil watch --verbose

SSO 에이전트: 로그인 중에 확장을 실행하는 프로세스를 관찰합니다.

sudo log stream --debug --process AppSSOAgent

연결된 도메인이 아직 승인되지 않은 경우 에이전트는 다음과 같은 메시지를 기록하며, 이는 원인을 직접 가리킵니다.

com.iru.Access.SSOExtension hasAssociatedDomainsApproved = 0

Associated domain: validation failed for the SSO extension
com.iru.Access.SSOExtension because it has no approved associated domains; it will
be checked again when the extension is next used.

hasAssociatedDomainsApproved = 0은 도메인이 아직 승인되지 않았음을 의미합니다. 승인이 적용되면 이러한 오류가 중지되고 Iru 도메인에 대한 로그인을 Iru Access가 가로챕니다.

일반적인 원인 및 해결 방법

증상	가능한 원인	해결 방법
`swcutil show`에 `authsrv` 항목이 없음	Associated Domains 페이로드가 Mac에 도달하지 않음	MDM에서 Iru Access 구성 프로필을 다시 배포하고 기기로 범위가 지정되어 있는지 확인합니다.
항목은 있지만 `Site/Fmwk Approval`이 `approved`가 아님	macOS가 도메인 연결을 검증하지 않았거나 도메인이 잘못됨	도메인이 Iru 도메인과 정확히 일치하는지 확인하고, Mac이 네트워크를 통해 도메인에 접근할 수 있는지 확인한 다음, 로그인을 트리거하고 다시 확인합니다.
`Flags`에 `enterpriseManaged`가 없음	도메인이 MDM에서 푸시되지 않음	직접 구성한 프로필 대신 MDM에서 제공하는 프로필(관리형 배포)을 사용합니다.
AppSSOAgent에 `hasAssociatedDomainsApproved = 0`	도메인이 승인되지 않음	위의 연결된 도메인 승인 문제를 해결합니다. macOS는 주기적으로, 그리고 확장이 다음에 사용될 때 다시 확인합니다.
`pluginkit -v -m`에 확장이 없음	Iru Access가 설치되지 않았거나 실행된 적 없음	확장이 등록되도록 앱을 배포하고 한 번 실행합니다.

프로필을 수정한 후 승인이 항상 즉시 새로 고쳐지는 것은 아닙니다. Iru 도메인 중 하나에 로그인을 트리거하여 macOS가 다시 확인하도록 한 다음 sudo swcutil show를 다시 실행하세요.

다음 단계

Iru Access 배포

구성 프로필, 앱 및 등록을 설정합니다.

MDM 연결

프로필을 푸시하고 기기를 관리 대상으로 간주하게 하는 연결.

기기 신뢰

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

인증기

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

시작하기

디렉터리

애플리케이션

인증 및 정책

관리

아키텍처 및 보안

최종 사용자 가이드

macOS SSO 확장 문제 해결

일반적인 원인 및 해결 방법

다음 단계

Iru Access 배포

MDM 연결

기기 신뢰

인증기

​일반적인 원인 및 해결 방법

​다음 단계

Iru Access 배포

MDM 연결

기기 신뢰

인증기

일반적인 원인 및 해결 방법

다음 단계