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

# Platform Single Sign-On 구성

> Single Sign-On Extension Library Item에서 Platform SSO를 구성합니다. 인증 방법, 암호 정책, macOS 26 및 macOS 27 설정을 지정합니다.

<Callout icon="apple" color="#B84A7A" iconType="regular">Platform SSO는 Mac 컴퓨터에서 사용할 수 있습니다</Callout>

이러한 설정은 **Single Sign-On Extension** Library Item에 있으며, **확장 유형**이 **Redirect**인 경우에만 사용할 수 있습니다. 먼저 [Single Sign-On Extension Library Item 구성](/ko/endpoint/library/library-items-profiles/configure-the-single-sign-on-extension-library-item#redirect)에서 Library Item 이름, Blueprint 할당 및 Redirect 확장 설정을 구성하십시오.

## Platform SSO

Platform SSO는 Redirect 확장을 macOS 로그인 윈도우로 확장합니다. 사용자는 조직의 ID 공급자(IdP) 자격 증명으로 Mac의 잠금을 해제할 수 있습니다. 공유 Mac에서는 Platform SSO가 해당 자격 증명을 사용하여 로그인 윈도우에서 로컬 계정을 생성할 수 있습니다. **암호**는 IdP 암호와 로컬 계정 암호를 동기화된 상태로 유지합니다. **OpenID**는 **Allow web login password sync**가 **예**인 경우에만 이를 수행합니다. **User Secure Enclave Key** 및 **Smart Card**는 로컬 계정 암호를 변경하지 않습니다. 권한 및 로컬 그룹 멤버십을 관리할 수 있습니다. 로컬 계정이 없는 IdP 사용자는 권한 부여 프롬프트에서 해당 자격 증명을 사용할 수 있습니다.

<Warning>
  Platform SSO에는 Iru가 배포하는 Platform SSO 프로파일 페이로드 외에도 ID 공급자의 올바르게 구성된 Single Sign-On Extension 앱이 필요합니다.
</Warning>

<Steps>
  <Step title="Platform SSO 활성화">
    Platform SSO는 기본적으로 꺼져 있습니다. **Platform SSO**를 켭니다. macOS 14 Sonoma 이상에서 지원되며 호환되는 ID 공급자 앱 확장이 필요합니다.
  </Step>

  <Step title="인증 방법 선택">
    **인증 방법**을 선택합니다. SSO 확장이 선택한 방법을 지원해야 합니다.

    * **암호**
    * **사용자 Secure Enclave 키**
    * **스마트 카드**
    * **OpenID**

    OpenID는 macOS 27 이상에서 사용할 수 있습니다. Iru는 macOS 27 이전 버전을 실행하는 Mac 컴퓨터에 **OpenID**를 전송하지 않습니다. **FileVault 정책**, **Login policy** 및 **Unlock policy**는 **암호**에서만 표시됩니다. ID 공급자에서 요구하는 경우 다음 단계에서 **Registration token**을 입력합니다. 다른 방법의 경우 [Password 정책](#policies-for-password)을 건너뛰고 [권한 및 계정 설정](#permissions-and-account-settings)으로 계속 진행합니다.

    <Note>
      **OpenID**를 사용하려는 경우 ID 공급자에 문의하여 Platform SSO에서 OpenID를 지원하는지 확인하십시오.
    </Note>
  </Step>

  <Step title="등록 토큰 입력(선택 사항)">
    ID 공급자에서 요구하는 경우 **Registration token**을 입력합니다. Mac은 이 값을 사용하여 Platform SSO에 등록하며, ID 공급자와 SSO 확장이 지원하는 경우 자동 등록도 포함됩니다.
  </Step>
</Steps>

## Password 정책

**FileVault 정책**, **Login policy** 및 **Unlock policy**는 **인증 방법**이 **암호**인 경우에만 표시됩니다. 각각 macOS 15 이상에서 사용할 수 있으며 기본값은 **구성되지 않음**입니다. **User Secure Enclave Key**, **Smart Card** 또는 **OpenID**의 경우 [권한 및 계정 설정](#permissions-and-account-settings)으로 계속 진행합니다.

<Steps>
  <Step title="FileVault 정책 설정">
    **FileVault 정책**은 Apple silicon이 탑재된 Mac 컴퓨터에서 FileVault 잠금 해제 시 Platform SSO를 사용할 때 적용됩니다.

    * **구성되지 않음**: Iru는 이 설정을 전송하지 않습니다.
    * **Attempt authentication**: Mac이 ID 공급자로 인증을 시도합니다. Mac이 오프라인인 경우 사용자는 로컬 계정 암호를 사용할 수 있습니다.
    * **인증 필요**: 계속하려면 사용자가 ID 공급자로 인증해야 합니다.
  </Step>

  <Step title="로그인 정책 설정">
    **Login policy**는 로그인 윈도우에서 Platform SSO를 사용할 때 적용됩니다. **FileVault 정책**과 동일한 옵션을 사용합니다.
  </Step>

  <Step title="잠금 해제 정책 설정">
    **Unlock policy**는 화면 보호기 잠금 해제 시 Platform SSO를 사용할 때 적용됩니다. **FileVault 정책**과 동일한 옵션을 사용합니다.
  </Step>
</Steps>

## 권한 및 계정 설정

이러한 설정은 모든 **인증 방법**에 적용됩니다.

<Steps>
  <Step title="기존 사용자 권한 설정">
    **Existing user permissions**는 사용자가 인증할 때마다 계정에 적용되는 권한을 설정합니다. 기본값은 **구성되지 않음**입니다.

    * **구성되지 않음**
    * **표준**
    * **관리자**
    * **그룹**: 이 Library Item에서 나중에 구성하는 그룹을 사용합니다.
  </Step>

  <Step title="새 사용자 권한 설정">
    **New user permissions**는 로그인 시 새로 생성되는 계정에 적용되는 권한을 설정합니다. 기본값은 **구성되지 않음**입니다.

    * **구성되지 않음**
    * **표준**
    * **관리자**
    * **그룹**
    * **임시(인증된 게스트 모드)**
  </Step>

  <Step title="공유 기기 키 사용">
    Mac이 모든 사용자에 대해 동일한 서명 및 암호화 키를 사용해야 하는 경우 **Use shared device keys**를 선택합니다. 이는 ID 공급자 계정을 사용한 권한 부여 및 새 계정 생성에 필요합니다.

    **Use shared device keys**를 선택하면 다음 설정이 나타납니다.

    * **Allow authorization (with identity provider account)**: 사용자가 ID 공급자 자격 증명으로 시스템 권한 부여 프롬프트에 응답할 수 있습니다.
    * **Allow creation of new users at login window**: Mac이 로그인 윈도우에서 로컬 계정을 생성합니다. Mac은 온라인 상태여야 하고, FileVault가 잠금 해제된 상태로 로그인 윈도우에 있어야 하며, Iru에 해당 Mac에 대한 유효한 Bootstrap 토큰이 있어야 합니다.
  </Step>

  <Step title="증명에 기기 식별자 허용">
    Platform SSO 증명에 Mac UDID 및 일련 번호를 포함하려면 **Allow device identifiers in attestation**을 선택합니다. macOS 15.4 이상에서 사용할 수 있습니다.
  </Step>

  <Step title="계정 표시 이름 입력">
    **Account display name**은 알림 및 인증 요청에 표시되는 이름입니다. 조직 이름 또는 사용자가 알아볼 수 있는 다른 이름을 사용하십시오.
  </Step>

  <Step title="전체 로그인 요구 시간 설정">
    **Require full login after**는 Mac이 새로 고침 대신 전체 로그인을 요구하기까지의 시간(초)입니다. 기본값은 18시간(64800초)입니다. 최소값은 1시간(3600초)입니다.
  </Step>

  <Step title="계정 이름 및 전체 이름 설정">
    **Account name** 및 **전체 이름**은 새 사용자를 생성하거나 권한을 부여할 때 사용되는 ID 공급자 속성입니다.
  </Step>

  <Step title="관리자 그룹 추가">
    **관리자 그룹**은 관리자 접근에 사용되는 그룹입니다. macOS는 인증 중에 멤버십을 요청합니다. 각 그룹에 대해 **Add group**을 선택합니다.
  </Step>

  <Step title="추가 그룹 추가">
    **추가 그룹**은 아직 존재하지 않는 경우 로컬 그룹으로 생성되며 로컬 디렉토리에서 사용할 수 있습니다. 각 그룹에 대해 **Add group**을 선택합니다.
  </Step>

  <Step title="권한 부여 권한 추가">
    **Authorization rights**는 권한 부여 권한을 하나의 그룹에 매핑합니다. 각 권한은 한 번만 지정할 수 있으며 단일 그룹에 매핑됩니다. 예를 들어 프린터 관리를 그룹에 매핑합니다. 각 매핑에 대해 **Add group**을 선택합니다.
  </Step>

  <Step title="Platform SSO가 아닌 계정 추가">
    **Non Platform SSO accounts**는 **FileVault 정책**, **Login policy** 또는 **Unlock policy**의 적용을 받지 않는 로컬 계정입니다. 이러한 계정에는 Platform SSO 등록 메시지도 표시되지 않습니다. 각 계정에 대해 **추가**를 선택합니다.
  </Step>

  <Step title="Library Item 저장">
    설정 지원 중 등록을 사용하는 경우 저장하기 전에 [설정 지원 중 등록 활성화(macOS 26 이상)](#enable-registration-during-setup-assistant-macos-26-and-later)로 계속 진행합니다. **인증 방법**이 **OpenID**인 경우 저장하기 전에 [웹 로그인(macOS 27 이상)](#web-login-macos-27-and-later)을 구성합니다. 웹 로그인 URL이 하나 이상 필요합니다. 둘 다 해당하지 않으면 **저장**을 선택합니다.
  </Step>
</Steps>

## 설정 지원 중 등록 활성화(macOS 26 이상)

macOS 26부터 Platform SSO는 설정 지원 중에 실행될 수 있으므로 Mac이 등록 흐름의 초기에 ID 공급자에 등록할 수 있습니다. **Mac macOS 26 and later**에서 각 설정의 기본값은 **구성되지 않음**이며, 이는 Iru가 해당 설정을 전송하지 않음을 의미합니다. 다른 옵션은 **예** 및 **아니요**입니다.

<Steps>
  <Step title="Mac macOS 26 and later 섹션 열기">
    이 Library Item의 **Platform SSO** 섹션에서 **Mac macOS 26 and later**로 이동합니다.
  </Step>

  <Step title="설정 지원 중 등록 활성화 설정">
    설정 지원 중에 Platform SSO 등록을 시작해야 하는 경우 **Enable registration during Setup Assistant**에 대해 **예**를 선택합니다.
  </Step>

  <Step title="설정 지원 중 첫 번째 사용자 생성 설정">
    Mac이 Platform SSO를 사용하여 설정 지원 중에 첫 번째 로컬 계정을 생성해야 하는 경우 **Create first user during Setup Assistant**에 대해 **예**를 선택합니다.
  </Step>

  <Step title="프로필 사진 동기화 설정">
    Mac이 SSO 확장에서 사용자의 프로필 사진을 요청해야 하는 경우 **Synchronize profile picture**에 대해 **예**를 선택합니다.
  </Step>

  <Step title="Authenticated Guest Mode 빠른 로그인 활성화 설정">
    사용자가 ID 공급자 자격 증명으로 임시로 로그인하는 공유 Mac 컴퓨터에서는 **Enable Authenticated Guest Mode Quick Login**에 대해 **예**를 선택합니다. 일반적인 단일 사용자 Mac 컴퓨터의 경우 **구성되지 않음**으로 두거나 **아니요**를 선택합니다.
  </Step>

  <Step title="새 사용자 인증 방법 설정">
    **새 사용자 인증 방법**은 새로 생성된 계정에 사용할 수 있는 방법입니다. 원하는 조합을 선택할 수 있습니다.

    * **암호**
    * **스마트 카드**
    * **OpenID**

    OpenID는 macOS 27 이상에서 사용할 수 있습니다. Iru는 macOS 27 이전 버전을 실행하는 Mac 컴퓨터에 **OpenID**를 전송하지 않습니다. 모든 **인증 방법**과 함께 여기에 **OpenID**를 추가할 수 있습니다. 추가하면 **Mac macOS 27 and later**에 **웹 로그인 URL 허용 목록**이 표시됩니다.
  </Step>

  <Step title="Library Item 저장">
    **인증 방법**이 **OpenID**이거나 **새 사용자 인증 방법**에 **OpenID**가 포함된 경우 저장하기 전에 [웹 로그인(macOS 27 이상)](#web-login-macos-27-and-later)을 구성합니다. 웹 로그인 URL이 하나 이상 필요합니다. 해당 섹션에서 저장한 다음 Automated Device Enrollment를 위해 여기로 돌아옵니다. 그렇지 않으면 **저장**을 선택합니다.
  </Step>

  <Step title="Automated Device Enrollment 중 Platform SSO Library Items 설치">
    Automated Device Enrollment를 사용하는 Platform SSO에는 설정 지원 중에 설치할 **Single Sign-on Extension** Library Item과 ID 공급자의 SSO 확장 애플리케이션용 **Auto App** Library Item이 필요합니다. **Automated Device Enrollment** Library Item에서 **Mac**에 대해 **설정 지원 중에 Library Items 설치**를 켠 다음 해당 Library Items와 IdP가 이 흐름에 요구하는 기타 항목(예: **Login Window** Library Item)을 추가합니다. 자세한 내용은 [설정 지원 중 Library Items 설치](/ko/endpoint/enrollment/apple/configuring-apple-enrollment#install-library-items-during-setup-assistant)를 참조하십시오. 기기가 **Configuring**에서 멈춘 경우 [설정 지원에서 보류된 기기 수동 해제](/ko/endpoint/enrollment/apple/configuring-apple-enrollment#manually-release-devices-held-in-setup-assistant)를 참조하십시오.
  </Step>
</Steps>

## 웹 로그인(macOS 27 이상)

**Mac macOS 27 and later**는 두 가지 경우에 나타납니다.

**인증 방법**이 **OpenID**인 경우 **Allow web login password sync** 및 **웹 로그인 URL 허용 목록**이 나타납니다. **웹 로그인 URL 허용 목록**에는 URL이 하나 이상 필요합니다. **Allow web login password sync**는 선택 사항입니다.

**새 사용자 인증 방법**에 **OpenID**가 포함되어 있고 **인증 방법**이 **암호**, **User Secure Enclave Key** 또는 **Smart Card**인 경우 이 섹션에는 **웹 로그인 URL 허용 목록**만 표시됩니다. **추가**를 선택하고 웹 로그인 URL을 하나 이상 입력합니다.

<Steps>
  <Step title="웹 로그인 암호 동기화 허용 설정">
    **Allow web login password sync**는 **인증 방법**이 **OpenID**인 경우에만 나타납니다. 웹 로그인의 암호를 로컬 계정 암호와 동기화합니다. macOS 27 이상에서 사용할 수 있습니다. 기본값은 **구성되지 않음**입니다.

    * **구성되지 않음**: Iru는 이 설정을 전송하지 않습니다.
    * **예**: Mac이 웹 로그인 중에 암호를 감지하고 로컬 계정 암호와 동기화합니다.
    * **아니요**: Mac이 웹 로그인 암호를 로컬 계정 암호와 동기화하지 않습니다.
  </Step>

  <Step title="웹 로그인 URL 추가">
    **웹 로그인 URL 허용 목록**은 Mac이 Platform SSO 웹 보기에서 로드할 수 있는 호스트 집합입니다. 웹 로그인 URL이 하나 이상 필요합니다. **추가**를 선택한 다음 웹 로그인 URL을 입력합니다. `https://login.example.com`과 같이 스킴과 호스트를 포함합니다. 각 호스트에 대해 반복합니다. 와일드카드는 지원되지 않습니다.
  </Step>

  <Step title="Library Item 저장">
    **저장** 버튼을 선택합니다.
  </Step>
</Steps>

Microsoft Entra ID 관련 Library Items 및 값에 대해서는 [Entra ID로 Platform SSO 구성](/ko/endpoint/library/library-items-profiles/configure-the-platform-sso-with-microsoft-entra-id-library-item)을 참조하십시오.