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

# macOS SSO 확장 문제 해결

> Apple의 기본 제공 명령줄 도구를 사용하여 macOS의 Iru Access Single Sign-On 확장이 로그인을 가로채지 않는 이유를 진단합니다.

Iru Access는 macOS **SSO(Single Sign-On) 확장**을 설치합니다. 이는 Iru 도메인에 대한
로그인을 가로채서 사용자가 기기 바인딩 자격 증명으로 로그인하도록 하는 Redirect 유형의
Extensible SSO 확장입니다. 이것이 작동하려면 macOS가 확장에 대한 **연결된 도메인을
승인**해야 하며, 이는 일반적으로 MDM이 Iru Access 구성 프로필의 일부로 푸시합니다.

Mac에서 Iru Access가 로그인을 가로채지 않는 경우, 아래 검사를 통해 확장이 **설치**되고
**로드**되었는지, 그리고 **연결된 도메인이 승인**되었는지 순서대로 확인합니다. 이 검사는
Apple 자체 명령줄 도구를 사용하며 등록된 Mac에서 안전하게 실행할 수 있습니다.

<Note>
  기존 배포를 진단하는 용도로만 사용합니다. 구성 프로필, 앱 및 등록을 설정하려면
  [Iru Access 배포](/ko/identity/authentication/deploy-iru-access)를 참조하세요.
</Note>

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

<Steps>
  <Step title="연결된 도메인이 승인되었는지 확인">
    SSO 확장이 작동하지 않는 가장 일반적인 원인은 macOS가 **연결된 도메인**을 승인하지
    않은 것입니다. Mac의 모든 연결된 도메인 승인을 나열합니다.

    ```bash theme={null}
    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
    --------------------------------------------------------------------------------
    ```

    확인할 사항:

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

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

  <Step title="확장이 설치되었는지 확인">
    macOS에 등록된 Iru Access 앱 확장을 나열합니다.

    ```bash theme={null}
    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 앱이 설치되지 않았거나 확장이 아직 등록되지 않은
      것입니다. 앱이 배포되었고 한 번 이상 실행되었는지 확인하세요.
  </Step>

  <Step title="시스템이 확장을 로드했는지 확인">
    시스템의 SSO 확장 관리자를 스트리밍하고 Iru Access가 로드되는지 확인합니다.

    ```bash theme={null}
    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`입니다.
  </Step>

  <Step title="승인 및 로그인 활동을 실시간으로 관찰">
    승인이 늦게 적용되거나 로그인이 가로채지지 않을 때 두 가지 실시간 스트림이
    도움이 됩니다.

    **연결된 도메인 검사:** macOS가 도메인 승인을 예약하고 기록하는 것을 관찰합니다.

    ```bash theme={null}
    sudo swcutil watch --verbose
    ```

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

    ```bash theme={null}
    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가
    가로챕니다.
  </Step>
</Steps>

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

| 증상 | 가능한 원인 | 해결 방법 |
| - | - | - |
| `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가 설치되지 않았거나 실행된 적 없음 | 확장이 등록되도록 앱을 배포하고 한 번 실행합니다. |

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

## 다음 단계

<CardGroup cols={2}>
  <Card title="Iru Access 배포" icon="arrow-up-from-bracket" href="/ko/identity/authentication/deploy-iru-access">
    구성 프로필, 앱 및 등록을 설정합니다.
  </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="인증기" icon="key" href="/ko/identity/authentication/authenticators">
    Iru Access가 패스키와 함께 인증기로 작동하는 방식.
  </Card>
</CardGroup>