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

# OneLogin을 사용한 Single Sign-On(SAML)

> OneLogin과 Iru Endpoint 간 SAML 기반 SSO를 구성합니다. OneLogin에서 SAML 애플리케이션을 생성하고 관리자 인증을 위한 사용자 속성을 매핑합니다.

### OneLogin SAML 통합 정보

Iru Endpoint의 OneLogin을 사용한 Single Sign-On(SAML)을 사용하면 OneLogin 자격 증명으로 Iru Endpoint에 접근하는 사용자를 위해 OneLogin과의 SAML 기반 SSO 통합을 설정할 수 있습니다.

#### 작동 방식

OneLogin SAML 통합을 사용하면 사용자가 기존 OneLogin 자격 증명으로 Iru Endpoint에 인증할 수 있습니다. 구성이 완료되면 사용자는 Single Sign-On 환경을 통해 Iru Endpoint에 접근할 수 있습니다.

이 통합은 Iru Endpoint와 OneLogin 간에 신뢰 관계를 설정하여 작동하며, OneLogin은 ID 공급자(IdP), Iru Endpoint는 서비스 공급자(SP) 역할을 합니다. 사용자가 Iru Endpoint에 접근하려고 하면 인증을 위해 OneLogin으로 리디렉션되고, 로그인에 성공하면 OneLogin은 사용자의 신원을 확인하는 SAML 어설션을 Iru Endpoint로 다시 보냅니다. SSO는 [Iru Endpoint 웹 앱](/ko/endpoint/getting-started/foundation/admins-and-access) 로그인 및 [Automated Device Enrollment 시 인증 요구](/ko/endpoint/enrollment/configure-require-authentication-for-enrollment)에 사용할 수 있습니다.

<Tabs>
  <Tab title="Iru 웹 앱 구성">
    ### SAML 연결 설정

    <Note>
      OneLogin에 필요한 구성 정보를 얻으려면 먼저 Iru Endpoint에서 초기 설정을 완료해야 합니다. Entity ID와 ACS URL을 복사한 후 [**OneLogin 구성**](#onelogin-configuration) 탭으로 전환하여 [**OneLogin 애플리케이션 구성**](#configuring-onelogin-application)을 계속 진행하세요.
    </Note>

    <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="인증 방법 선택">
        인증 방법으로 **SAML**을 선택합니다.
      </Step>

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

      <Step title="구성 정보">
        **구성 정보** 섹션이 아직 펼쳐져 있지 않으면 선택합니다.
      </Step>

      <Step title="Service Provider Entity ID 복사">
        나중에 사용할 수 있도록 **Service provider entity ID**를 텍스트 문서에 복사합니다. OneLogin 구성에 필요합니다.
      </Step>

      <Step title="ACS URL 복사">
        나중에 사용할 수 있도록 **Assertion consumer service (ACS) URL**을 텍스트 문서에 복사합니다. OneLogin 구성에 필요합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/iru-support-google-saml_11-08-26.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=7d56d5b22f71fb05dd59c83555c02430" alt="Configuration Information, Service provider entity ID 및 Assertion consumer service (ACS) URL" width="2166" height="940" data-path="assets/media/images/iru-support-google-saml_11-08-26.png" />
        </Frame>
      </Step>

      <Step title="탭 열어 두기">
        Iru Endpoint 구성 모달을 열어 둔 상태에서 [**OneLogin 구성**](#onelogin-configuration) 탭으로 전환하여 [**OneLogin 애플리케이션 구성**](#configuring-onelogin-application)을 계속 진행합니다.
      </Step>
    </Steps>

    ### Iru Endpoint SAML 연결 구성

    <Note>
      OneLogin 구성을 완료한 후 여기로 돌아와 Iru Endpoint에서 [**Iru Endpoint SAML 연결 구성**](#configuring-iru-endpoint-saml-connection)을 마무리하세요. OneLogin의 Single Sign-on URL, IdP Entity ID 및 인증서가 필요합니다.
    </Note>

    <Steps>
      <Step title="Iru Endpoint로 돌아가기">
        Iru Endpoint의 Custom SAML 모달로 돌아갑니다.
      </Step>

      <Step title="IdP 속성 설정">
        **IdP attribute**를 **제목**으로 설정합니다.
      </Step>

      <Step title="속성 이름 설정">
        **Attribute name**은 비워 둡니다.
      </Step>

      <Step title="사용자 속성 설정">
        **User attribute**를 \*\*User Principal Name (UPN)\*\*으로 설정합니다.
      </Step>

      <Step title="IdP Entity ID 추가">
        OneLogin에서 복사한 **Issuer URL**을 **IdP Entity ID** 필드에 붙여 넣습니다.
      </Step>

      <Step title="Sign In URL 구성">
        OneLogin에서 복사한 **SAML 2.0 Endpoint (HTTP)** URL을 **IdP Single Sign-on URL** 필드에 붙여 넣습니다.
      </Step>

      <Step title="인증서 업로드">
        앞서 다운로드한 OneLogin 인증서를 업로드합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/rklQKFJvStbahPGs/assets/media/images/onelogin-saml_15-50-39.png?fit=max&auto=format&n=rklQKFJvStbahPGs&q=85&s=8448c85032eb37ca87f0580c582046c0" alt="Iru Endpoint에서 OneLogin 인증서 업로드" width="1336" height="620" data-path="assets/media/images/onelogin-saml_15-50-39.png" />
        </Frame>
      </Step>

      <Step title="Protocol Binding 설정">
        **Protocol Binding**을 **HTTP-POST**로 설정합니다.
      </Step>

      <Step title="요청 알고리즘 설정">
        **Request Algorithm**이 **RSA-SHA256**으로 설정되어 있는지 확인합니다.
      </Step>

      <Step title="다이제스트 알고리즘 설정">
        **Sign Request Algorithm Digest**가 **SHA256**으로 설정되어 있는지 확인합니다.
      </Step>

      <Step title="Sign Request 활성화">
        **Sign Request**가 활성화되어 있는지 확인합니다.
      </Step>

      <Step title="응답 서명 확인 설정">
        **Response Signature Verification**을 **Assertion**으로 설정합니다.
      </Step>

      <Step title="Destination 설정">
        **Destination** 필드는 비워 둡니다.
      </Step>

      <Step title="허용된 서명 알고리즘 설정">
        **Allowed Signature Algorithm**을 **RSA-SHA256**으로 설정합니다.
      </Step>

      <Step title="허용된 다이제스트 알고리즘 설정">
        **Allowed Digest Algorithm**을 **SHA256**으로 설정합니다.
      </Step>

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

        <Frame>
          <img src="https://mintcdn.com/iru/rklQKFJvStbahPGs/assets/media/images/onelogin-saml_6-04-14.png?fit=max&auto=format&n=rklQKFJvStbahPGs&q=85&s=0c9a311a61ea63a12ffd53e6c6e5a165" alt="Iru Endpoint SAML 구성 Save" width="1336" height="724" data-path="assets/media/images/onelogin-saml_6-04-14.png" />
        </Frame>
      </Step>
    </Steps>

    ### 테넌트 인증 허용

    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="테스트 사용자 추가">
        **New User**를 선택하여 Iru Endpoint의 **Admin Team**에 테스트 사용자를 추가합니다.
      </Step>

      <Step title="사용자 정보 구성">
        해당하는 사용자 정보를 모두 입력합니다. 이 사용자는 OneLogin에 존재해야 하며 OneLogin 테넌트의 Iru Endpoint SSO 앱에 할당되어 있어야 합니다.
      </Step>

      <Step title="사용자 제출">
        **제출**을 선택합니다.
      </Step>

      <Step title="초대 창 닫기">
        초대가 제출되면 Invite User 창을 닫습니다.
      </Step>

      <Step title="액세스 페이지 새로 고침">
        Iru Endpoint의 Access 페이지를 새로 고칩니다. 추가한 사용자가 표시되어야 합니다.
      </Step>

      <Step title="SSO 로그인 테스트">
        사용자의 이메일로 이동하여 초대를 수락하고 새 SAML SSO 연결로 로그인합니다.
      </Step>
    </Steps>
  </Tab>

  <Tab title="OneLogin 구성">
    <Note>
      OneLogin 구성을 시작하기 전에 [**Iru 웹 앱 구성**](#iru-web-app-configuration) 탭에서 [**SAML 연결 설정**](#setting-up-the-saml-connection)을 완료하여 Service Provider Entity ID와 ACS URL을 가져오세요. OneLogin 애플리케이션을 구성하려면 이 값들이 필요합니다.
    </Note>

    ### OneLogin 애플리케이션 구성

    <Steps>
      <Step title="새 애플리케이션 생성">
        OneLogin에서 **Add SAML Custom Connector (Advanced)** 앱을 사용하여 새 앱을 생성합니다. 다음으로 이동합니다.

        ```
        https://{YourSubdomain}.onelogin.com/apps/new/110016
        ```
      </Step>

      <Step title="이름 설정">
        **이름**을 설정합니다.
      </Step>

      <Step title="포털 표시 여부 설정">
        앱을 포털에 표시할지 여부를 설정합니다.
      </Step>

      <Step title="아이콘 설정">
        앱의 **아이콘**을 설정합니다.
      </Step>

      <Step title="설명 설정">
        **설명**을 설정합니다.
      </Step>

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

        <Frame>
          <img src="https://mintcdn.com/iru/rklQKFJvStbahPGs/assets/media/images/onelogin-saml_15-18-35.png?fit=max&auto=format&n=rklQKFJvStbahPGs&q=85&s=504786fc7a868ad8db4554879821eba2" alt="OneLogin 앱 이름, 포털 표시 여부, 아이콘, 설명 및 Save" width="2412" height="1848" data-path="assets/media/images/onelogin-saml_15-18-35.png" />
        </Frame>
      </Step>

      <Step title="구성 탭 열기">
        **구성** 탭을 선택합니다.
      </Step>

      <Step title="Entity ID 구성">
        **Iru Entity ID**(Service provider entity ID)를 **Audience (EntityID)** 필드에 붙여 넣습니다.
      </Step>

      <Step title="ACS URL 구성">
        **Iru ACS URL**(Assertion consumer service URL)을 **Recipient**, **ACS (Consumer) URL Validator**, **ACS (Consumer) URL** 필드에 붙여 넣습니다.

        <Frame>
          <img src="https://mintcdn.com/iru/rklQKFJvStbahPGs/assets/media/images/onelogin-saml_15-24-05.png?fit=max&auto=format&n=rklQKFJvStbahPGs&q=85&s=f8053e77ebc64aa33ad16a1c040bf487" alt="OneLogin Configuration Audience Entity ID Recipient ACS URL" width="2112" height="1544" data-path="assets/media/images/onelogin-saml_15-24-05.png" />
        </Frame>
      </Step>

      <Step title="SAML Initiator 구성">
        **SAML initiator**를 **OneLogin**으로 설정합니다.
      </Step>

      <Step title="Name ID Format 설정">
        **SAML nameID format**을 **이메일**로 설정합니다.
      </Step>

      <Step title="Issuer Type 설정">
        **SAML issuer type**을 **Generic**으로 설정합니다.
      </Step>

      <Step title="Signature Element 설정">
        **SAML signature element**를 **Assertion**으로 설정합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/RojwfOtw4zjvTAlh/assets/media/images/onelogin-saml_15-28-40.png?fit=max&auto=format&n=RojwfOtw4zjvTAlh&q=85&s=812f19ce26ece8473f0704cf03a9d640" alt="OneLogin SAML initiator, nameID format, issuer, signature Assertion" width="2000" height="1102" data-path="assets/media/images/onelogin-saml_15-28-40.png" />
        </Frame>
      </Step>

      <Step title="Parameters 구성">
        **Parameters** 탭을 선택합니다.
      </Step>

      <Step title="Name ID">
        **Name ID** 값이 **이메일**로 설정되어 있는지 확인합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/rklQKFJvStbahPGs/assets/media/images/onelogin-saml_15-31-07.png?fit=max&auto=format&n=rklQKFJvStbahPGs&q=85&s=3dcb042ba602fa2a40dc6dff316b93ea" alt="Email로 설정된 OneLogin Parameters Name ID" width="2120" height="1114" data-path="assets/media/images/onelogin-saml_15-31-07.png" />
        </Frame>
      </Step>

      <Step title="SSO 설정 구성">
        **SSO** 탭을 선택합니다.
      </Step>

      <Step title="SAML Signature Algorithm 설정">
        **SAML Signature Algorithm**을 **SHA-256**으로 설정합니다.
      </Step>

      <Step title="Issuer URL 복사">
        **Issuer URL**을 복사하여 저장합니다. 이 값을 Iru Endpoint의 **IdP Entity ID** 필드에 붙여 넣게 됩니다.
      </Step>

      <Step title="SAML Endpoint URL 복사">
        **SAML 2.0 Endpoint (HTTP)** URL을 복사하여 저장합니다. 이 값은 Iru 구성의 **IdP Single Sign-on URL**에 사용됩니다.
      </Step>

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

        <Frame>
          <img src="https://mintcdn.com/iru/rklQKFJvStbahPGs/assets/media/images/onelogin-saml_15-34-47.png?fit=max&auto=format&n=rklQKFJvStbahPGs&q=85&s=0625d1a0ae5f769aad2ff9a32afd4872" alt="OneLogin SSO 탭 Issuer URL SAML 2.0 Endpoint Save" width="2294" height="1480" data-path="assets/media/images/onelogin-saml_15-34-47.png" />
        </Frame>
      </Step>

      <Step title="SSO 탭">
        **SSO** 탭을 선택합니다.
      </Step>

      <Step title="인증서 보기">
        **View Details**를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/rklQKFJvStbahPGs/assets/media/images/onelogin-saml_15-46-02.png?fit=max&auto=format&n=rklQKFJvStbahPGs&q=85&s=e1ab542c0df31d0ec81dfd6ed696dfd0" alt="인증서에 대한 OneLogin SSO 탭 View Details" width="2242" height="1240" data-path="assets/media/images/onelogin-saml_15-46-02.png" />
        </Frame>
      </Step>

      <Step title="인증서 다운로드">
        **다운로드**를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/rklQKFJvStbahPGs/assets/media/images/onelogin-saml_15-42-34.png?fit=max&auto=format&n=rklQKFJvStbahPGs&q=85&s=86eb1bc3bc6942e76acb4c74ab352317" alt="OneLogin 인증서 다운로드" width="2056" height="2024" data-path="assets/media/images/onelogin-saml_15-42-34.png" />
        </Frame>
      </Step>

      <Step title="사용자 탭 열기">
        **사용자** 탭을 선택합니다.
      </Step>

      <Step title="사용자 할당">
        애플리케이션에 사용자를 할당하고 **저장**을 선택한 다음 탭을 닫습니다.
      </Step>
    </Steps>

    <Note>
      OneLogin 구성을 완료한 후 [**Iru 웹 앱 구성**](#iru-web-app-configuration) 탭으로 돌아가 [**Iru Endpoint SAML 연결 구성**](#configuring-iru-endpoint-saml-connection)을 계속 진행하여 OneLogin에서 복사한 SSO URL, Entity ID 및 인증서로 SAML 연결 설정을 마무리하세요.
    </Note>
  </Tab>
</Tabs>