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

# Microsoft Entra ID

> 기본 제공 Microsoft Entra ID 연결 템플릿을 사용하여 사용자가 Microsoft 회사 또는 학교 계정으로 Iru Identity에 로그인할 수 있도록 합니다.

**Microsoft Entra ID**를 연결하면 사용자가 이미 보유한 Microsoft 회사 또는 학교
계정을 사용하여 Iru에 로그인하고 할당된 앱에 액세스할 수 있습니다. Iru는 표준
구성을 미리 채우는 **Microsoft Entra ID 템플릿**을 제공하므로 가장 빠르게 연결할 수
있는 공급자 중 하나입니다.

<Info>
  Iru Identity를 ID 공급자로 사용하는 대부분의 조직에서는 사용자가 패스키 또는
  Iru Access 앱으로 직접 로그인합니다. Iru Identity를 기본 ID 공급자가 아닌 Iru
  플랫폼에 대한 인증 계층으로 사용하거나 Iru Identity로의 마이그레이션을 쉽게 하려는
  경우 Microsoft Entra ID를 연결하세요. [페더레이션 인증](/ko/identity/connections/connections-overview)을 참조하세요.
</Info>

<Note>
  이 연결을 완료하려면 Iru 테넌트에 대한 관리자 액세스 권한과 Microsoft
  Entra 관리 센터에 대한 액세스 권한이 필요합니다.
</Note>

## 시작하기 전에

<Steps>
  <Step title="Microsoft Entra ID에 애플리케이션 등록">
    Microsoft Entra 관리 센터에서 Iru용 **애플리케이션을 등록**합니다. 이 연결에
    대해 Iru가 표시하는 **리디렉션 URI**를 웹 리디렉션 URI로 추가하고,
    **클라이언트 시크릿**을 생성한 다음, 표준 로그인 권한
    (`openid`, `profile`, `email`, `User.Read`)을 부여합니다. 테넌트에서 요구하는 경우
    관리자 동의를 부여합니다. Iru에 입력할 애플리케이션의 **클라이언트 ID**와
    **클라이언트 시크릿**, 그리고 Entra ID **도메인**(예: `contoso.onmicrosoft.com`)을
    기록해 두세요. Microsoft 포털은 변경될 수 있으므로 단계가 다른 경우 Microsoft의
    최신 문서를 따르세요.
  </Step>

  <Step title="로그인 도메인 확인">
    사용자가 로그인에 사용하는 이메일 **도메인**을 기록해 두세요. 해당 도메인의
    사용자만 연결을 사용하도록 연결을 이 도메인으로 제한할 수 있습니다.
  </Step>

  <Step title="사용자가 Iru에 존재하는지 확인">
    연결을 통한 로그인은 기존 Iru 사용자로 확인됩니다. 먼저 사용자를 추가하거나
    가져오세요. [사용자 가져오기](/ko/identity/directory/importing-users) 또는
    [Directory Sync](/ko/identity/directory/directory-sync)를 참조하세요.
  </Step>
</Steps>

## Microsoft Entra ID 연결

<Steps>
  <Step title="연결 추가">
    **Access → Authentication**에서 **인증 방법**을 추가하고
    **Microsoft Entra ID** 템플릿을 선택합니다. 템플릿을 사용하면 표준 설정이
    자동으로 채워집니다.
  </Step>

  <Step title="Entra ID 정보 입력">
    Microsoft Entra ID **도메인**과 등록한 애플리케이션의 **클라이언트 ID** 및
    **클라이언트 시크릿**을 입력합니다. Iru는 이 정보를 사용하여 Entra ID 테넌트와
    신뢰를 설정합니다.
  </Step>

  <Step title="연결의 용도 선택">
    연결의 **사용 사례**를 선택합니다: **최종 사용자 로그인**, **기기
    등록** 또는 둘 다. 대부분의 구성에서는 최종 사용자 로그인을 활성화합니다.
  </Step>

  <Step title="도메인으로 제한">
    특정 이메일 도메인의 사용자만 이 연결을 사용하도록 하려면
    **도메인 제한**을 활성화하고 해당 도메인을 추가하세요.
  </Step>

  <Step title="사용자 매칭 설정">
    Iru가 Microsoft 로그인을 Iru 사용자와 매칭하는 방식(UPN, 사용자 이름, 외부 ID
    또는 사용자 지정 속성)을 선택합니다. 모든 사용자에 대해 고유하고 안정적인 값을
    선택하세요.
  </Step>

  <Step title="연결 저장">
    저장한 다음 허용된 도메인에 이메일이 있는 테스트 사용자로 로그인하여
    Microsoft로의 핸드오프가 처음부터 끝까지 작동하는지 확인합니다.
  </Step>
</Steps>

<Warning>
  이 연결을 **기기 등록**에 사용하려면 먼저 **도메인 제한**을 활성화해야 할 수
  있습니다. 기기 등록 사용 사례를 켜기 전에 도메인을 구성하세요.
</Warning>

<Tip>
  연결을 광범위하게 배포하기 전에 한 명의 사용자로 테스트하세요. 로그인이 올바른
  사용자로 연결되지 않으면 **사용자 매칭** 선택을 다시 검토하세요. 매칭 값은 연결을
  사용하는 모든 사용자에 대해 존재하고 고유해야 합니다.
</Tip>

## 연결 후 로그인 작동 방식

누군가 로그인하면 Iru는 로그인을 Microsoft Entra ID에 넘기고, Entra ID가 사용자를
확인하며, Iru는 세션을 계속 진행한 후 액세스를 허용하기 전에 앱의
[인증 정책](/ko/identity/authentication/authentication-policies)을 평가합니다.
전체 내용은 [시스템 아키텍처](/ko/identity/getting-started/system-architecture)를 참조하세요.

## 관련 항목

<CardGroup cols={2}>
  <Card title="페더레이션 인증" icon="plug" href="/ko/identity/connections/connections-overview">
    사용 사례, 도메인 제한, 사용자 매칭을 한곳에서 설명합니다.
  </Card>

  <Card title="Google Workspace" icon="google" href="/ko/identity/connections/google-workspace">
    자체 템플릿으로 로그인용 Google Workspace를 연결합니다.
  </Card>

  <Card title="로그인 환경" icon="arrow-right-to-bracket" href="/ko/identity/authentication/sign-in-experience">
    사용자가 로그인할 때 표시되는 화면을 구성합니다.
  </Card>

  <Card title="사용자 지정 OIDC" icon="key" href="/ko/identity/connections/custom-oidc">
    템플릿이 없는 OpenID Connect 공급자를 연결합니다.
  </Card>
</CardGroup>