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

# Passport로 암호 관리

> Iru Endpoint에서 Passport로 macOS 로컬 계정 암호를 관리합니다. IdP와의 암호 동기화 동작, 변경 워크플로 및 만료 처리를 이해합니다.

<Callout icon="apple" color="#B84A7A" iconType="regular">이 가이드는 Mac 컴퓨터에 적용됩니다</Callout>

### Passport를 사용한 암호 관리 정보

Passport 암호 관리는 Passport가 ID 공급자와 로컬 Mac 사용자 계정 간의 암호 동기화를 처리하는 방식을 말합니다. 여기에는 자동 암호 업데이트, 보안 저장소 및 암호 재설정 기능이 포함됩니다. 설정 및 Library Item 구성은 [Passport Library Item 구성](/ko/endpoint/library/passport/configure-the-passport-library-item)을 참조하세요.

### 작동 방식

Passport는 사용자 자격 증명을 안전하게 저장하고 ID 공급자(IdP)와 로컬 Mac 계정 간의 암호 변경을 자동으로 동기화할 수 있습니다. 사용자가 IdP 암호를 변경하면 Passport가 이 변경을 감지하고 로컬 Mac 암호를 업데이트하여 두 암호가 동기화된 상태를 유지하도록 합니다.

### 로그인, 진단 및 네트워크

<CardGroup cols={2}>
  <Card title="전체 이메일 주소로 로그인" icon="user">
    Passport 로그인 창에서는 세션이 로컬 인증 대신 IdP를 사용하도록 항상 사용자 이름 필드에 사용자의 전체 이메일 주소를 입력하세요. 로그인 창 및 표시 설정이 Passport와 상호 작용하는 방식은 [Passport 호환성](/ko/endpoint/library/passport/passport-compatibility-with-macos-and-iru-endpoint-features#login-window)을 참조하세요.
  </Card>

  <Card title="Passport 진단 사용" icon="display">
    사용자가 로그인할 수 없거나 암호 동기화가 잘못된 것 같으면 Mac에서 **Command-Shift-K-L**을 눌러 Iru Endpoint Passport 진단을 여세요. 이 패널에는 IdP에서 반환된 오류 메시지를 포함한 유용한 세부 정보가 표시됩니다.
  </Card>

  <Card title="네트워크 연결 확인" icon="wifi">
    Passport는 자격 증명을 검증하고 암호를 동기화하기 위해 IdP에 연결할 수 있어야 합니다. Passport 로그인 창을 사용자화할 때 필요한 경우 사용자가 Wi-Fi에 연결할 수 있도록 네트워크 관리자를 활성화하세요. 이 컨트롤은 macOS의 AirPort 보안 설정을 따릅니다.
  </Card>

  <Card title="Wi-Fi 제한 및 격리 테스트" icon="triangle-exclamation">
    Passport는 로그인 창 오른쪽 상단에 Wi-Fi 아이콘을 표시하며, 사용자는 이를 선택하여 암호로 보호된 네트워크에 연결할 수 있습니다. Passport는 종속 포털(captive portal), 클릭 동의 페이지 또는 해당 흐름에서 별도의 사용자 이름과 암호가 필요한 엔터프라이즈 802.1X 네트워크를 지원하지 않습니다. 네트워크 문제를 격리하려면 Passport 로그인 창에서 테스트하는 동안 모바일 핫스팟이나 유선 이더넷을 사용해 보세요. 로그인 창의 Wi-Fi에 대한 자세한 내용은 [Passport 호환성](/ko/endpoint/library/passport/passport-compatibility-with-macos-and-iru-endpoint-features#network-wi-fi)을 참조하세요.
  </Card>
</CardGroup>

### IdP에 성(familyName)이 있는지 확인

Passport에는 IdP 사용자 속성에 **familyName** 값이 필요합니다. 테스트에 사용하는 서비스 계정을 포함하여 Passport로 로그인하는 모든 계정에 **Last name** 또는 이에 상응하는 성 필드를 입력하세요.

### 암호 구성

#### 권장 암호 동기화 구성

사용자에게 가장 독립적인 경험을 제공하고 암호 관련 지원 요청을 줄이려면 Passport Library Item에서 다음을 구성하세요.

1. 암호 동기화를 활성화합니다. Passport가 IdP 암호와 로컬 암호를 자동으로 동기화할 수 있도록 Passport Library Item의 Access 섹션에서 **Store user password**를 **Securely store password**로 설정합니다. 동기화 작동 방식에 대한 자세한 내용은 [ID 공급자와의 암호 동기화](#password-syncing-with-the-identity-provider)를 참조하세요.
2. 로그인 창에서 암호 재설정 URL을 설정합니다. [로그인 창 사용자화](/ko/endpoint/library/passport/configure-the-passport-library-item#customize-login-window)에서 **Include password reset URL**을 구성하여 사용자가 지원팀에 문의하지 않고도 로그인 창이나 Iru Endpoint 메뉴 앱에서 IdP 암호를 재설정할 수 있도록 합니다.

각 설정을 개별적으로 활성화할 수 있지만 그러면 두 가지 동작을 모두 얻을 수는 없습니다. 암호 동기화만 사용하면 변경 사항이 자동으로 동기화되지만 사용자는 IdP URL을 사용하여 암호를 재설정할 수 없습니다. 암호 재설정 URL만 사용하면 사용자는 IdP 암호를 재설정할 수 있지만 로컬 Mac 암호는 동기화되지 않습니다.

#### Passport 및 암호 정책 충돌

<Warning>
  Passport가 포함된 모든 Blueprint에서 Passcode Library Item을 제거하는 것을 적극 권장합니다. 암호 요구 사항은 IdP에서 처리해야 하며, 그렇지 않으면 사용자에게 아래 오류가 표시될 수 있습니다. Passport 호환성에서 [자세히 알아보세요](/ko/endpoint/library/passport/passport-compatibility-with-macos-and-iru-endpoint-features#passcode).
</Warning>

Passcode 프로파일이 IdP보다 강력한 암호 요구 사항을 적용하는 경우 Passport 로그인 창에 다음 메시지가 표시됩니다.

<Callout icon="triangle-exclamation" color="#D97706" iconType="regular">
  **사용자에게 표시되는 메시지**

  The password you entered doesn't yet meet the passcode policy requirements for this Mac; please contact your IT administrator for help.

  이 Mac에는 정책이 적용된 이후 변경되거나 생성된 암호에 적용되는 로컬 암호 정책이 있습니다. 이는 Mac 암호 정책이 ID 공급자 암호 정책과 충돌할 때 흔히 발생합니다. 이 문제를 해결하려면 Passport도 포함된 모든 Blueprint에서 Passcode Library Item을 제거하세요.
</Callout>

### 암호 사용자 경험

#### 암호 변경 권장 순서

최상의 결과를 얻으려면 사용자는 다음 순서로 암호를 변경하거나 재설정해야 합니다.

1. 조직의 IdP에서 암호를 변경합니다.
2. [Passport 재설정 URL](/ko/endpoint/library/passport/configure-the-passport-library-item#customize-login-window)이 구성된 경우 사용자는 Iru Endpoint 메뉴 앱이나 Passport 로그인 창에서 IdP 암호를 재설정할 수 있습니다.
3. Passport가 로컬 Mac 암호를 일치하도록 동기화하게 합니다(Passport가 사용자에게 메시지를 표시하거나 자동으로 업데이트함).

#### Iru Endpoint 메뉴 앱에서 암호 재설정

사용자는 Iru Endpoint 메뉴에서 톱니바퀴 아이콘을 선택하고 **암호 재설정**... 옵션을 선택하여 IdP 암호를 재설정할 수 있습니다. 사용자는 Passport Library Item에 설정된 Passport 재설정 URL로 이동합니다.

* **요구 사항:** **암호 재설정**... 옵션은 사용자가 전체 이메일 주소로 로그인한 경우에만 표시됩니다.

사용자에게 단계를 안내하려면 Passport 사용자 경험 문서의 [메뉴 막대에서 암호 재설정(로그인한 상태)](/ko/endpoint/library/passport/user-experience-with-passport#reset-password-from-the-menu-bar-while-logged-in) 섹션을 공유하세요.

#### Passport 로그인 창에서 암호 재설정

Passport Library Item에 암호 재설정 URL이 구성된 경우, 사용자가 Passport(로컬) 로그인 창에서 잘못된 IdP 암호를 세 번 입력하면 Passport가 재설정 링크를 표시합니다.

* **요구 사항:** [로그인 창 사용자화](/ko/endpoint/library/passport/configure-the-passport-library-item#customize-login-window)에서 **Include password reset URL**이 활성화되어 있어야 합니다.

사용자에게 단계를 안내하려면 Passport 사용자 경험 문서의 [로그인 화면에서 암호 재설정](/ko/endpoint/library/passport/user-experience-with-passport#reset-password-at-the-login-screen) 섹션을 공유하세요.

### ID 공급자와의 암호 동기화

Passport Library Item의 [Access](/ko/endpoint/library/passport/configure-the-passport-library-item#access) 섹션에 있는 **Store user password** 설정은 Passport가 IdP 암호와 로컬 Mac 암호를 동기화하는 방식을 제어합니다. 두 옵션은 다음과 같이 동작합니다.

#### Securely Store Password

Passport는 자격 증명을 저장하며 로컬 암호를 IdP 암호와 자동으로 동기화할 수 있습니다.

* **로그아웃 상태:** 사용자가 IdP 암호를 변경한 후 Passport 로그인 창에서 로그인하면 Passport가 로컬 암호를 자동으로 일치하도록 업데이트합니다.
* **로그인 상태:** 사용자가 로그인한 상태에서 IdP 암호를 변경하면 Passport는 5분 이내에 메시지를 표시합니다. 사용자는 IdP 암호만 입력하면 되며 Passport가 로컬 암호를 업데이트합니다.

#### Do Not Store Password

Passport는 로컬 암호를 저장하지 않습니다. Passport가 동기화할 때마다 사용자가 로컬 암호를 제공해야 합니다.

* **로그아웃 상태:** 사용자가 IdP 암호를 변경한 후 Passport 로그인 창에서 로그인하면 Passport는 로컬 암호를 일치하도록 업데이트하기 전에 로컬 암호를 요청합니다.
* **로그인 상태:** 사용자가 로그인한 상태에서 IdP 암호를 변경하면 Passport는 5분 이내에 메시지를 표시하며, 사용자는 업데이트를 위해 로컬 암호와 IdP 암호를 모두 입력해야 합니다.
* **새 IdP 암호와 이전 로컬 암호로 로그인:** 사용자가 새 IdP 암호로 로그인했는데 로컬 암호가 일치하지 않으면 Passport는 이전 로컬 암호를 요청합니다. **Do not store password**를 사용하면 사용자는 두 암호를 모두 입력해야 합니다.

#### Okta와의 암호 동기화

Passport와 함께 Okta를 사용하는 경우 Passport OIDC 애플리케이션에서 **Refresh Token**을 다음과 같이 설정하세요.

* **Refresh Token 비활성화(권장):** **Store user password**가 **Securely store password**로 설정된 경우 사용합니다. Refresh Token을 활성화된 상태로 두면 사용자가 Mac에 로그인한 동안 Passport가 암호 업데이트 메시지를 표시하지 않습니다.
* **Refresh Token 활성화:** 로그인한 동안 사용자에게 자격 증명을 반복적으로 요청하는 것을 방지하기 위해 **Store user password**가 **Do not store password**로 설정된 경우에만 사용합니다.

설정 및 옵션은 [Okta를 사용한 Passport 구성](/ko/endpoint/library/passport/okta/passport-configuration-with-okta)을 참조하세요. 문제가 있는 경우 [Okta를 사용한 Passport 문제 해결](/ko/endpoint/library/passport/okta/passport-troubleshooting-with-okta)을 참조하세요.

### 시스템 설정에서 암호 변경

사용자가 시스템 설정에서 로컬로 암호를 변경하면 Passport와 동기화되지 않습니다. 그러면 Passport는 로컬 암호를 다시 동기화하기 위해 사용자에게 새 로컬 암호를 요청하며, 로컬 암호를 IdP와 일치하도록 설정합니다. Passport가 Mac과 암호를 동기화할 수 있도록 사용자는 IdP에서 암호를 변경해야 합니다.

사용자가 시스템 설정에서 암호를 변경하지 못하도록 하려면 [Apple Restrictions Library Item](/ko/endpoint/library/library-items-profiles/configure-the-restrictions-library-item)을 사용하고 [**Passcode & authentication**](/ko/endpoint/library/library-items-profiles/configure-the-restrictions-library-item#passcode-and-biometric-settings) 그룹에서 **Disallow passcode modification**을 활성화하세요. 이 제한이 적용되면 시스템 설정에서 사용자가 암호를 변경하는 옵션이 비활성화됩니다.

### 암호 확인 빈도

Passport는 5분마다, 그리고 로그인 창에서 온라인 로그인할 때마다 사용자의 암호를 확인합니다. 이러한 확인을 통해 로컬 계정 암호와 사용자의 IdP 암호가 동일한지 확인합니다. 동일하지 않으면 사용자에게 IdP 암호를 입력하라는 메시지가 표시됩니다.

### 문제 해결

<AccordionGroup>
  <Accordion title="사용자에게 암호 재설정이 표시되지 않음">
    **표시되는 내용:**

    사용자가 Passport 로그인 창이나 Iru Endpoint 메뉴 앱에서 IdP 암호를 재설정하는 방법을 찾을 수 없습니다.

    **조치 방법:**

    * [권장 암호 동기화 구성](#recommended-password-sync-configuration)을 따르세요. 필요에 따라 암호 동기화를 활성화하고 [로그인 창 사용자화](/ko/endpoint/library/passport/configure-the-passport-library-item#customize-login-window)에서 **Include password reset URL**을 설정합니다.
    * **FileVault 로그인 창**(디스크 잠금 해제 전)에서는 메뉴 앱과 Passport 재설정 URL을 사용할 수 없다는 점을 기억하세요. 사용자가 해당 화면에서 진행할 수 없는 경우 [FileVault 로그인 창에서 암호 재설정](#password-reset-at-the-filevault-login-window)을 사용하세요.
  </Accordion>

  <Accordion title="FileVault 로그인 창에서 암호 재설정">
    **표시되는 내용:**

    FileVault 사전 부팅 화면만 표시된 상태(전원을 켜거나 재시동한 후 일반 로그인 화면 전)에서 사용자가 암호를 재설정해야 합니다.

    **조치 방법:**

    * 시동 디스크가 아직 암호화되어 있고 Iru Endpoint와 Passport가 실행되지 않으므로 암호 재설정 URL과 메뉴 앱을 사용할 수 없습니다. [macOS 사용자 암호 재설정](/ko/endpoint/devices/device-actions/reset-a-macos-user-password)의 [FileVault 2가 활성화된 경우](/ko/endpoint/devices/device-actions/reset-a-macos-user-password#if-filevault-2-is-enabled) 단계에 따라 **FileVault 복구 키**로 잠금을 해제하고 로컬 암호를 재설정하세요.
    * 사용자가 Passport 로그인 창에 도달한 후 재설정 URL을 구성한 경우 이를 사용하여 IdP 암호를 맞출 수 있습니다. [Passport 로그인 창에서 암호 재설정](#password-reset-at-the-passport-login-window)을 참조하세요.
  </Accordion>
</AccordionGroup>