> ## 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를 사용한 Single Sign-on(Native)

> OAuth2 및 OpenID Connect를 사용하여 Iru Endpoint용 네이티브 Microsoft Entra ID SSO를 구성합니다. 관리자가 Microsoft Entra ID 자격 증명으로 원클릭 로그인할 수 있도록 합니다.

### Microsoft Entra ID Native 통합 정보

Iru Endpoint의 Microsoft Entra ID Native 통합을 사용하면 SSO를 위한 네이티브 Microsoft Entra ID 통합을 설정할 수 있습니다. 사용자는 OAuth2/OpenID Connect를 통해 Microsoft Entra ID 자격 증명으로 인증합니다.

#### 작동 방식

사용자가 Iru Endpoint에 접근하려고 하면 OAuth2/OpenID Connect 프로토콜을 사용한 인증을 위해 Microsoft Entra ID로 리디렉션됩니다. 인증에 성공하면 Microsoft Entra ID는 액세스 토큰을 Iru Endpoint로 다시 보내고, Iru Endpoint는 사용자의 신원을 검증하여 접근 권한을 부여합니다. SSO는 [Iru Endpoint 웹 앱](/ko/endpoint/getting-started/foundation/admins-and-access) 로그인 및 [Automated Device Enrollment 시 인증 요구](/ko/endpoint/enrollment/configure-require-authentication-for-enrollment)에 사용할 수 있습니다.

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

> 클라이언트 시크릿의 최대 수명은 24개월이므로, 이 문서에 설명된 방법 대신 [SAML 기반 Single Sign-On](/ko/endpoint/integrations/single-sign-on-integrations/single-sign-on-with-microsoft-entra-id-saml)을 구성하는 것이 좋습니다.

### 사전 요구 사항

시작하기 전에 다음을 확인하세요.

* Admin 또는 Account Owner로서 [Iru Endpoint 웹 앱에 대한 접근 권한](/ko/endpoint/getting-started/foundation/admins-and-access)
* 앱 등록을 생성할 수 있는 권한이 있는 Microsoft Entra ID 관리자 계정(예: Global Administrator, Application Administrator 또는 Cloud Application Administrator)

<Tabs>
  <Tab title="Iru 웹 앱 구성">
    ### Iru Endpoint 연결 구성

    Iru에서 연결을 구성하려면 다음 단계를 따르세요.

    <Steps>
      <Step title="계정 메뉴 버튼으로 이동">
        Iru Endpoint의 사이드바에서 [**계정 메뉴 버튼**](/ko/iru/platform-overview/account-menu)을 선택합니다.
      </Step>

      <Step title="인증 설정 접속">
        메뉴에서 **액세스** 옵션을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/8BYPjuKZa-zyEEf_/assets/media/images/iru-nav-access.png?fit=max&auto=format&n=8BYPjuKZa-zyEEf_&q=85&s=466fdf5fb47efd6bab8b450a5a1e8302" alt="Access 옵션이 강조 표시된 계정 메뉴 스크린샷" width="562" height="1040" data-path="assets/media/images/iru-nav-access.png" />
        </Frame>
      </Step>

      <Step title="관리자 및 인증 선택">
        **관리자 및 인증** 탭(기본적으로 선택됨)을 선택하고 **인증 방법**까지 아래로 스크롤합니다.
      </Step>

      <Step title="인증 방법 추가">
        **+ 인증 방법**를 선택합니다.
      </Step>

      <Step title="표시 이름 입력">
        SSO 연결의 표시 이름을 입력합니다.
      </Step>

      <Step title="인증 방법 선택">
        인증 방법으로 **Microsoft Entra ID**를 선택합니다.
      </Step>

      <Step title="연결 생성">
        **만들기**를 선택합니다.
      </Step>

      <Step title="Redirect URL 복사">
        나중에 사용할 수 있도록 **Redirect URL**을 텍스트 문서에 복사합니다. Microsoft Entra ID 구성에 필요합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_10-54-56.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=944f34794f4d9a91d0b2c90e23c3889d" alt="Entra ID용 Iru Endpoint Redirect URL 복사" width="1924" height="1638" data-path="assets/media/images/entra_native_10-54-56.png" />
        </Frame>
      </Step>

      <Step title="탭 열어 두기">
        Iru 웹 앱 구성 모달을 열어 둔 상태에서 **Microsoft Entra ID 구성** 탭으로 전환하여 계속 진행합니다.
      </Step>
    </Steps>

    구성을 완료하려면 다음 단계를 따르세요.

    <Info>
      Microsoft Entra ID 구성을 완료한 후 여기로 돌아와 Iru Endpoint에서 SSO 연결 설정을 마무리하세요. Microsoft Entra ID에서 복사한 Client ID와 Client secret이 필요합니다.
    </Info>

    <Steps>
      <Step title="디렉터리 도메인 입력">
        애플리케이션이 등록된 **Tenant ID**를 **Microsoft Entra ID Domain** 필드에 입력합니다. [Tenant ID를 찾는 방법은 Microsoft 문서](https://learn.microsoft.com/en-us/azure/cost-management-billing/manage/find-tenant-id-domain)를 참조하세요.
      </Step>

      <Step title="Client ID 입력">
        앞서 Microsoft Entra 관리 센터에서 복사한 **Client ID**를 입력합니다.
      </Step>

      <Step title="Client Secret 입력">
        앞서 Microsoft Entra 관리 센터에서 복사한 **Client Secret**을 입력합니다.
      </Step>

      <Step title="구성 저장">
        **저장**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_12-00-35.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=652ba4ba977cabe185b104cfd2913bbc" alt="Iru Endpoint Tenant ID Client ID Client Secret Save" width="1646" height="1640" data-path="assets/media/images/entra_native_12-00-35.png" />
        </Frame>
      </Step>

      <Step title="연결 승인">
        저장하면 **연결을 승인**하는 링크가 포함된 새 대화 상자가 표시됩니다. 도메인의 Microsoft Entra ID 관리자가 링크를 선택하고 이 프로세스를 완료하여 애플리케이션을 승인해야 합니다. 이 상자는 승인이 완료된 후에도 사라지지 않습니다.
      </Step>

      <Step title="승인 완료">
        새로 열린 창에서 로그인하고 **Accept**를 선택합니다.
      </Step>

      <Step title="승인 확인">
        **Accept**를 선택하면 승인 성공 페이지로 이동합니다.
      </Step>

      <Step title="설정 확인">
        이제 연결이 성공적으로 구성되었으며 활성화하고 테스트할 수 있습니다.
      </Step>
    </Steps>

    <Warning>
      "Failed to obtain access token" 오류가 발생하면 올바른 값 대신 시크릿 ID를 사용했기 때문일 수 있습니다.
    </Warning>

    ### 테넌트 인증 허용

    Iru Endpoint와 ID 공급자에서 SAML 연결을 구성한 후에는 테넌트 인증에 사용하도록 허용할 수 있습니다. 단계별 지침은 [Single Sign-on 지원 문서](/ko/endpoint/integrations/single-sign-on-integrations/single-sign-on)의 **테넌트 인증 허용 및 연결 관리** 섹션을 참조하세요.

    ### 도메인으로 인증 제한

    SAML 연결을 구성할 때 선택적으로 인증을 하나 이상의 도메인으로 제한할 수 있습니다. 이는 SSO 연결이 여러 도메인에 인증할 수 있는 경우에 유용합니다. Iru 테넌트에 대한 인증을 사용 가능한 도메인의 일부로 제한할 수 있습니다.

    ### Single Sign-On 강제 적용

    하나 이상의 Single Sign-on 연결을 구성한 후에는 Passkey, Google Social, Microsoft Social 연결을 비활성화할 수 있습니다. 이러한 연결을 비활성화하면 테넌트의 Iru Endpoint 관리자가 해당 방법으로 인증할 수 없게 됩니다. 단계별 지침은 [Single Sign-on 지원 문서](/ko/endpoint/integrations/single-sign-on-integrations/single-sign-on)를 참조하세요.

    ### 클라이언트 시크릿 갱신

    <Steps>
      <Step title="새 클라이언트 시크릿 생성">
        위의 **Microsoft Entra ID 구성** 탭에 있는 단계에 따라 새 클라이언트 시크릿을 생성합니다. "Certificates and Secrets 접속"부터 "시크릿 값 복사"까지의 단계를 완료하여 새 클라이언트 시크릿을 생성하고 값을 복사합니다.
      </Step>

      <Step title="관리자 및 인증으로 이동">
        값을 복사한 후 **Iru 웹 앱 구성** 탭으로 돌아가 **Iru Endpoint 연결 구성** 섹션의 1\~3단계를 따릅니다.
      </Step>

      <Step title="SSO 통합 선택">
        이 문서 앞부분에서 생성한 SSO 통합 옆의 줄임표를 선택합니다.
      </Step>

      <Step title="SSO 통합 편집">
        **편집**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_08-37-39.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=4ee6a9ed63ead1405c742d939bc4260d" alt="SSO 통합 옆의 Iru Endpoint 줄임표 Edit" width="2198" height="1648" data-path="assets/media/images/entra_native_08-37-39.png" />
        </Frame>
      </Step>

      <Step title="클라이언트 시크릿 편집">
        **Edit client secret** 버튼을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_08-43-21.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=a7c8aa2f5d98d61121a1878564b851cc" alt="Iru Endpoint Edit client secret 버튼" width="1730" height="1642" data-path="assets/media/images/entra_native_08-43-21.png" />
        </Frame>
      </Step>

      <Step title="클라이언트 시크릿 업데이트">
        앞서 복사한 새 **Client secret** 값을 붙여 넣습니다.
      </Step>

      <Step title="변경 사항 저장">
        **저장**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_08-46-11.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=7059a9ab71febe26517d39f8b0eee2ce" alt="클라이언트 시크릿 업데이트 후 Iru Endpoint Save" width="1702" height="1640" data-path="assets/media/images/entra_native_08-46-11.png" />
        </Frame>
      </Step>

      <Step title="구성 테스트">
        Iru Endpoint 웹 앱에 로그인하고 생성한 Native SSO 로그인 옵션을 선택하여 구성을 반드시 테스트하세요. 비공개 브라우저 창/시크릿 창에서 테스트하여 Iru Endpoint 웹 앱에 로그인할 수 있는지 확인하는 것이 좋습니다.
      </Step>

      <Step title="이전 시크릿 정리">
        그런 다음 선택적으로 Entra ID의 App registration에서 이전 클라이언트 시크릿을 삭제할 수 있습니다.
      </Step>
    </Steps>
  </Tab>

  <Tab title="Microsoft Entra ID 구성">
    ### Microsoft Entra ID 애플리케이션 설정

    <Note>
      Microsoft Entra ID 구성을 시작하기 전에 **Iru 웹 앱 구성** 탭에서 초기 설정을 완료하여 Redirect URL을 가져오세요. Microsoft Entra ID 애플리케이션을 구성하려면 이 값이 필요합니다.
    </Note>

    Microsoft Entra ID 애플리케이션을 구성하려면 다음 단계를 따르세요.

    <Steps>
      <Step title="Microsoft Entra 관리 센터 열기">
        [Microsoft Entra 관리 센터](https://entra.microsoft.com)에 로그인합니다.
      </Step>

      <Step title="Entra ID 섹션 펼치기">
        왼쪽 탐색 모음에서 **Entra ID** 섹션이 펼쳐져 있는지 확인합니다.
      </Step>

      <Step title="애플리케이션으로 이동">
        왼쪽 탐색 모음에서 **App registrations**를 선택합니다.
      </Step>

      <Step title="새 등록 생성">
        **+ New registration**을 선택하여 새 애플리케이션을 등록합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-10-59.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=fda999ea57500f53e90ef2df74b9fc7a" alt="Entra ID App registrations New registration" width="2750" height="1454" data-path="assets/media/images/entra_native_11-10-59.png" />
        </Frame>
      </Step>

      <Step title="애플리케이션 이름 지정">
        **이름** 필드에 애플리케이션 이름(예: "Iru Native SSO")을 지정합니다.
      </Step>

      <Step title="계정 유형 선택">
        "**지원되는 계정 유형**"에서 **Accounts in this organizational directory only**를 선택합니다.
      </Step>

      <Step title="Redirect URI 구성">
        **Redirect URI** 필드의 드롭다운 메뉴에서 **Web**을 선택합니다.
      </Step>

      <Step title="Redirect URI 입력">
        Iru 웹 앱 구성에서 복사한 전체 Redirect URL을 입력합니다(예: `https://vpriix.id.iru.com/federated-auth/oidc/callback`).
      </Step>

      <Step title="애플리케이션 등록">
        **등록**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-30-17.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=05f8f539e3144b5d1c2b069f3ee31d87" alt="Entra ID Name 지원되는 계정 유형 Redirect URI Register" width="2358" height="1634" data-path="assets/media/images/entra_native_11-30-17.png" />
        </Frame>
      </Step>

      <Step title="Client ID 복사">
        새 페이지에서 **Application (client) ID**를 복사하여 나중을 위해 저장합니다. 이 값은 Iru에서 **Client ID**로 사용됩니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-40-58.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=790029fe79b3f9dea7429be5d92d2c6b" alt="Entra ID Application client ID 복사" width="2716" height="1622" data-path="assets/media/images/entra_native_11-40-58.png" />
        </Frame>
      </Step>

      <Step title="Certificates and Secrets 접속">
        **Certificates and Secrets**를 선택합니다.
      </Step>

      <Step title="새 클라이언트 시크릿 생성">
        **New client secret**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-44-51.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=884d74d10d01813ce5fece20d2dbd1b0" alt="Entra ID Certificates and Secrets New client secret" width="2716" height="1528" data-path="assets/media/images/entra_native_11-44-51.png" />
        </Frame>
      </Step>

      <Step title="시크릿 세부 정보 구성">
        클라이언트 시크릿에 "Iru Native SSO"와 같은 **설명**을 지정합니다.
      </Step>

      <Step title="만료 설정">
        만료를 **24 months**로 설정합니다.
      </Step>

      <Step title="시크릿 추가">
        **추가**를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-47-12.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=532c64c0100928deb9ed852b02cfa0bf" alt="Entra ID Client secret Description expiration Add" width="1152" height="446" data-path="assets/media/images/entra_native_11-47-12.png" />
        </Frame>
      </Step>

      <Step title="시크릿 값 복사">
        클라이언트 시크릿의 **값**을 복사하여 나중을 위해 저장합니다. **클라이언트 시크릿 Value는 클라이언트 시크릿 ID와 다릅니다.**

        <Frame>
          <img src="https://mintcdn.com/iru/Gez-fJ-p5uwNt6_O/assets/media/images/entra_native_11-48-27.png?fit=max&auto=format&n=Gez-fJ-p5uwNt6_O&q=85&s=3d3cc4b5e7e7ddacaab50425208efc32" alt="Entra ID 클라이언트 시크릿 Value 복사" width="3020" height="1628" data-path="assets/media/images/entra_native_11-48-27.png" />
        </Frame>
      </Step>
    </Steps>

    <Note>
      Microsoft Entra ID 구성을 완료한 후 **Iru 웹 앱 구성** 탭으로 돌아가 Microsoft Entra ID에서 복사한 Client ID와 Client secret을 사용하여 SSO 연결 설정을 마무리하세요.
    </Note>
  </Tab>
</Tabs>

## 고려 사항

**보안**: Microsoft Entra ID 테넌트에 OAuth2/OpenID Connect 인증을 위한 적절한 보안 정책이 구성되어 있는지 확인하세요.

**클라이언트 시크릿 관리**: 클라이언트 시크릿은 24개월 후에 만료되므로 정기적으로 갱신해야 합니다. 장기적인 솔루션으로는 SAML 기반 SSO를 사용하는 것을 고려하세요.

**테스트**: 조직 전체에 배포하기 전에 항상 소규모 사용자 그룹으로 SSO 통합을 테스트하세요.

**사용자 관리**: SSO를 통해 성공적으로 인증하려면 사용자가 Microsoft Entra ID와 Iru Endpoint 모두에 존재해야 합니다.