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

# 페더레이션된 Entra ID 환경의 Passport

> Iru Endpoint와 함께 페더레이션된 Microsoft Entra ID 환경에서 Passport를 사용합니다. AD FS 및 타사 페더레이션 서비스에 대한 인증 흐름을 구성합니다.

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

<Note>
  Microsoft Entra ID는 Azure AD(Azure Active Directory)의 [새 이름](https://learn.microsoft.com/en-us/entra/fundamentals/new-name)입니다
</Note>

### 페더레이션된 Microsoft Entra ID 환경의 Passport 정보

페더레이션된 Microsoft Entra ID 환경의 Passport는 Entra ID가 외부 ID 공급자의 서비스 공급자(SP)인 경우에 적용됩니다. 인증 및 암호 검증이 Entra ID에 대해 올바르게 완료될 수 있도록 **Mac 로그인**과 **웹 로그인** 모두 추가 구성이 필요합니다.

<Card title="중요한 Entra ID Passport 업데이트" type="danger" icon="calendar-exclamation" iconType="solid">
  **2026년 6월 15일**부터 Microsoft Entra ID는 Passport 로그인에 대한 조건부 액세스를 다르게 처리합니다.

  * **Mac 로그인:** [Entra ID Passport Mac 로그인](/ko/endpoint/library/passport/microsoft-entra-id/configure-passport-with-microsoft-entra-id-mac-login#june-2026-conditional-access-change)을 참조하여 테넌트가 영향을 받는지, 그리고 해당 날짜 이전에 무엇을 업데이트해야 하는지 확인하세요.
  * **웹 로그인:** 웹 로그인을 사용하고 조건부 액세스에서 Passport를 MFA에서 제외하려는 경우에만 업데이트가 필요합니다. [Entra ID Passport 웹 로그인](/ko/endpoint/library/passport/microsoft-entra-id/configure-passport-with-microsoft-entra-id-web-login#june-2026-conditional-access-change)을 참조하세요.

  Microsoft는 [이 문서](https://learn.microsoft.com/en-us/entra/identity/conditional-access/concept-enforcement-resource-exclusions)에서 변경 사항을 설명합니다.
</Card>

### 작동 방식

사용자가 다른 IdP를 통해 페더레이션하는 경우에도 Passport는 여전히 Entra ID를 OIDC 기관으로 사용합니다. **Mac 로그인** 및 **웹 로그인**의 경우 [페더레이션 환경](https://learn.microsoft.com/en-us/entra/identity/hybrid/connect/whatis-fed)에서 암호 검증이 Entra ID에 대해 완료될 수 있도록 PowerShell을 사용하여 Entra ID에 [홈 영역 검색(HRD)](https://learn.microsoft.com/en-us/entra/identity/enterprise-apps/configure-authentication-for-federated-users-portal?pivots=powershell-hrd) 정책을 생성하세요.

### 사전 요구 사항

HRD 정책을 생성하기 전에 아래 사항을 모두 확인하세요. 이 문서는 페더레이션된 테넌트에서 **Mac 로그인** 또는 **웹 로그인**용으로 Entra ID와 함께 Passport를 사용하는 경우에 적용됩니다.

<CardGroup cols={2}>
  <Card title="Azure 및 Microsoft Entra ID" icon="cloud">
    * 활성 [Azure 구독](https://azure.microsoft.com/free/)(필요한 경우 무료 계정 생성).
    * 디렉터리 앱과 정책을 관리할 수 있는 사용자: **Global Administrator**, **Cloud Application Administrator**, **Application Administrator** 또는 **서비스 주체 소유자**.
  </Card>

  <Card title="Windows 및 PowerShell" icon="terminal">
    * 관리자 권한으로 **PowerShell**을 열 수 있는 Windows 또는 Windows Server 컴퓨터(물리적 또는 VM).
    * 최신 [미리 보기 빌드](https://learn.microsoft.com/en-us/powershell/azure/active-directory/install-adv2?view=azureadps-2.0#updating-the-azure-ad-module)의 [AzureADPreview](https://learn.microsoft.com/en-us/powershell/azure/active-directory/install-adv2?view=azureadps-2.0#installing-the-azure-ad-module) 설치. GA 모듈과 미리 보기 모듈은 동시에 실행할 수 없으므로 둘 다 있는 경우 먼저 [AzureAD 모듈을 제거](https://learn.microsoft.com/en-us/powershell/azure/uninstall-az-ps)하세요.
  </Card>

  <Card title="Passport를 위한 ID 동기화" icon="users">
    * Passport로 로그인하는 사용자는 로그인 경로를 지원하는 방식으로 Entra ID에 표시되어야 합니다.
    * **하이브리드 Active Directory:** 해당되는 경우 **암호 해시 동기화**와 함께 [Microsoft Entra Connect](https://learn.microsoft.com/en-us/entra/identity/hybrid/connect/how-to-connect-password-hash-synchronization)를 사용하세요.
    * **클라우드 페더레이션 IdP:** 페더레이션된 IdP의 사용자 이름과 암호가 ROPC 방식 로그인에 대해 예상대로 Entra ID에 도달하는지 확인하세요.
  </Card>

  <Card title="Passport가 이미 구성되어 있음" icon="apple">
    * 사용하는 인증 모드에 따라 [Microsoft Entra ID로 Passport 구성 - Mac 로그인](/ko/endpoint/library/passport/microsoft-entra-id/configure-passport-with-microsoft-entra-id-mac-login) 및/또는 [Microsoft Entra ID로 Passport 구성 - 웹 로그인](/ko/endpoint/library/passport/microsoft-entra-id/configure-passport-with-microsoft-entra-id-web-login)에 따라 생성한 Passport용 Entra ID 앱 등록(엔터프라이즈 애플리케이션).
    * 해당 Passport 배포에 대해 Iru Endpoint에서 [Passport Library Item 구성](/ko/endpoint/library/passport/configure-the-passport-library-item) 완료.
  </Card>
</CardGroup>

### 페더레이션 환경의 인증 흐름

아래 다이어그램은 Entra ID가 다른 ID 공급자(IdP)와 페더레이션된 서비스 공급자(SP) 역할을 할 때의 Passport 인증 흐름을 보여 줍니다.

<Frame>
  <img src="https://mintcdn.com/iru/4wJJk-urrjfBXzBY/assets/media/images/iru-entra-passport-auth-flow.png?fit=max&auto=format&n=4wJJk-urrjfBXzBY&q=85&s=a45eec5033d59bf210eb07861a2cfc53" alt="Entra ID가 다른 ID 공급자와 페더레이션된 경우의 Passport 인증 흐름" width="715" height="487" data-path="assets/media/images/iru-entra-passport-auth-flow.png" />
</Frame>

사용자가 Passport를 사용하여 인증을 시도하면 요청은 다음과 같이 진행됩니다.

<Steps>
  <Step title="Passport가 인증 요청 전송">
    Passport가 Microsoft Entra ID에 인증 요청을 보냅니다.
  </Step>

  <Step title="Microsoft Entra ID가 요청 전달">
    Microsoft Entra ID가 인증 요청을 페더레이션된 IdP로 전달합니다.
  </Step>

  <Step title="IdP가 요청 검증">
    IdP가 인증 요청을 검증하고 Microsoft Entra ID로 다시 보냅니다.
  </Step>

  <Step title="인증 실패">
    Microsoft Entra ID가 검증 결과를 받지만 이를 Passport로 전달할 이유가 없습니다. 인증 시도가 실패하고 Passport에 오류가 표시됩니다.
  </Step>
</Steps>

### HRD가 구성된 인증 흐름

아래 다이어그램은 Microsoft Entra ID에 홈 영역 검색 정책이 있는 경우의 Passport 인증 흐름을 보여 줍니다. 사용자가 Passport를 사용하여 인증을 시도하면 요청은 다음과 같이 진행됩니다.

<Frame>
  <img src="https://mintcdn.com/iru/4wJJk-urrjfBXzBY/assets/media/images/iru-entra-passport-auth-flow-hrd.png?fit=max&auto=format&n=4wJJk-urrjfBXzBY&q=85&s=554569a83d36ae3659518d0a1739c8ec" alt="홈 영역 검색 정책이 있는 Passport 인증 흐름" width="257" height="410" data-path="assets/media/images/iru-entra-passport-auth-flow-hrd.png" />
</Frame>

<Steps>
  <Step title="Passport가 인증 요청 전송">
    Passport가 Microsoft Entra ID에 인증 요청을 보냅니다.
  </Step>

  <Step title="Entra ID가 HRD 정책으로 검증">
    Entra ID가 HRD 정책을 사용하여 인증 요청을 검증하고 Passport에 사용자 인증 성공 응답을 보냅니다.
  </Step>
</Steps>

### HRD 정책 생성

<Note>
  Microsoft Entra ID와 함께 Passport를 사용하고 테넌트가 외부 IdP와 페더레이션된 경우 HRD 정책이 필요합니다. 이 요구 사항은 **Mac 로그인**과 **웹 로그인** 모두에 적용됩니다.
</Note>

<Steps>
  <Step title="Windows 컴퓨터 액세스">
    Windows 컴퓨터로 이동합니다.
  </Step>

  <Step title="관리자 권한으로 PowerShell 열기">
    관리자 권한으로 PowerShell을 엽니다.
  </Step>

  <Step title="Entra ID에 연결">
    **Connect-AzureAD** 명령으로 Entra ID 테넌트에 연결합니다. Entra ID 자격 증명을 입력하라는 웹 보기가 열립니다.
  </Step>

  <Step title="HRD 정책 생성">
    아래 명령으로 새 정책을 생성합니다. 이렇게 하면 페더레이션 환경에서 사용자가 사용자 이름과 암호로 Entra ID를 통해 특정 애플리케이션에 직접 인증할 수 있습니다. 환경에 기존 HRD 정책이 있는 경우 *DisplayName*을 **IruHRDPolicy**와 같은 이름으로 설정할 수 있습니다.

    ```powershell wrap lines icon="terminal" theme={null}
    New-AzureADPolicy -Definition @("{`"HomeRealmDiscoveryPolicy`":{`"AllowCloudPasswordValidation`":true}}") -DisplayName IruHRDPolicy -Type HomeRealmDiscoveryPolicy
    ```
  </Step>

  <Step title="정책 ObjectID 가져오기">
    **Get-AzureADPolicy** 명령을 실행하여 방금 생성한 정책을 나열하고 출력의 ID 열 아래에 표시된 *ObjectID* 문자열을 복사합니다.
  </Step>

  <Step title="서비스 주체 ObjectID 가져오기">
    **Get-AzureADServicePrincipal** 명령을 실행하여 서비스 주체(Azure 엔터프라이즈 애플리케이션) **ObjectID**를 가져옵니다.

    <Note>
      엔터프라이즈 애플리케이션의 이름을 알고 있는 경우 위 명령에 **-SearchString your\_app\_name\_here**를 추가할 수 있습니다. 예: **Get-AzureADServicePrincipal -SearchString "Iru Passport"**
    </Note>
  </Step>

  <Step title="HRD 정책에 애플리케이션 추가">
    다음 명령을 실행하여 Iru Passport 엔터프라이즈 애플리케이션을 HRD 정책에 추가합니다. \*\<ObjectID of the Service Principal>\*을 앞서 복사한 Iru 엔터프라이즈 앱 *ObjectID*로 바꿉니다. \*\<ObjectId of the Policy>\*를 앞서 복사한 HRD *ObjectID*로 바꿉니다.

    ```powershell wrap lines icon="terminal" theme={null}
    Add-AzureADServicePrincipalPolicy -Id <ObjectID of the Service Principal> -RefObjectId <ObjectId of the Policy>
    ```

    <Note>
      올바른 정책을 생성하지 않은 경우 아래 명령을 사용하여 제거한 후 다시 시도할 수 있습니다.
    </Note>

    ```powershell wrap lines icon="terminal" theme={null}
    Remove-AzureADServicePrincipalPolicy -id <ObjectId of the Service Principal> -PolicyId <ObjectId of the policy>
    ```
  </Step>

  <Step title="정책 할당 확인">
    \*\*Get-AzureADPolicyAppliedObject -id \<ObjectId of the Policy>\*\*로 할당된 앱을 확인합니다.
  </Step>

  <Step title="Azure에서 연결 해제">
    PowerShell 세션을 Azure에서 연결 해제하려면 **Disconnect-AzureAD**를 실행합니다.
  </Step>
</Steps>