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

# JumpCloud를 사용한 Single Sign-On(SAML)

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

### JumpCloud SAML 통합 정보

Iru Endpoint의 JumpCloud SAML 통합을 사용하면 JumpCloud 자격 증명으로 Iru Endpoint에 접근하는 사용자를 위해 JumpCloud와의 SAML 기반 SSO 통합을 설정할 수 있습니다.

#### 작동 방식

사용자가 Iru Endpoint에 접근하려고 하면 인증을 위해 JumpCloud로 리디렉션됩니다. 인증에 성공하면 JumpCloud는 SAML 어설션을 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)에 사용할 수 있습니다.

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

    <Note>
      JumpCloud에 필요한 구성 정보를 얻으려면 먼저 Iru Endpoint에서 초기 설정을 완료해야 합니다. Entity ID와 ACS URL을 복사한 후 [**JumpCloud 애플리케이션 구성**](#jumpcloud-application-configuration) 탭으로 전환하여 [**JumpCloud 애플리케이션 구성하기**](#configuring-jumpcloud-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**를 텍스트 문서에 복사합니다. JumpCloud 구성에 필요합니다.
      </Step>

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

        <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 구성 모달을 열어 둔 상태에서 [**JumpCloud 애플리케이션 구성**](#jumpcloud-application-configuration) 탭으로 전환하여 [**JumpCloud 애플리케이션 구성하기**](#configuring-jumpcloud-application)를 계속 진행합니다.
      </Step>
    </Steps>

    ### Iru Endpoint SAML 연결 구성

    <Note>
      JumpCloud 애플리케이션 구성을 완료한 후 여기로 돌아와 Iru Endpoint에서 [**Iru Endpoint SAML 연결 구성**](#configuring-iru-endpoint-saml-connection)을 마무리하세요. JumpCloud의 Sign-in 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)\*\*으로 설정합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_16-30-02.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=2930827accee0a59fec9a95d0d0e229f" alt="User Principal Name UPN으로 설정된 Iru Endpoint User attribute" width="1430" height="652" data-path="assets/media/images/jumpcloud-saml_16-30-02.png" />
        </Frame>
      </Step>

      <Step title="IdP Entity ID 추가">
        앞서 JumpCloud에서 생성한 고유한 **IdP Entity ID**를 Iru Endpoint의 **IdP Entity ID** 필드에 붙여 넣습니다.
      </Step>

      <Step title="Sign-in URL 추가">
        JumpCloud에서 복사한 **Sign-in URL**을 붙여 넣습니다: [https://sso.jumpcloud.com/saml2/iru](https://sso.jumpcloud.com/saml2/iru).
      </Step>

      <Step title="인증서 업로드">
        JumpCloud에서 다운로드한 **인증서**를 업로드합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_16-36-10.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=0ea6278256adeaad609bd62437d01a53" alt="Iru Endpoint에서 JumpCloud 인증서 업로드" width="1428" height="960" data-path="assets/media/images/jumpcloud-saml_16-36-10.png" />
        </Frame>
      </Step>

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

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

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

      <Step title="요청 서명 활성화">
        **Sign SAML Authentication Request**가 활성화되어 있는지 확인합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/oTTnm7ow-OS4GUo-/assets/media/images/jumpcloud-saml_16-38-11.png?fit=max&auto=format&n=oTTnm7ow-OS4GUo-&q=85&s=06715218d2f70099cc56b97e0e00f680" alt="활성화된 Iru Endpoint Sign SAML Authentication Request" width="1426" height="744" data-path="assets/media/images/jumpcloud-saml_16-38-11.png" />
        </Frame>
      </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**을 **SHA-256**으로 설정합니다.
      </Step>

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

        <Frame>
          <img src="https://mintcdn.com/iru/oTTnm7ow-OS4GUo-/assets/media/images/jumpcloud-saml_16-44-23.png?fit=max&auto=format&n=oTTnm7ow-OS4GUo-&q=85&s=68fd7c47e1bd1da4f940d962f5ba82de" alt="Iru Endpoint SAML 구성 Save" width="1424" height="820" data-path="assets/media/images/jumpcloud-saml_16-44-23.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="Admin Team에 사용자 추가">
        **New User**를 선택하여 Iru Endpoint의 **Admin Team**에 사용자를 추가합니다.
      </Step>

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

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

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

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

      <Step title="SSO 로그인 테스트">
        사용자의 이메일을 확인하고 초대를 수락한 다음 새 SAML SSO 연결로 Iru Endpoint에 로그인합니다.
      </Step>
    </Steps>

    ## 고려 사항

    **보안**: JumpCloud 테넌트에 SAML 인증을 위한 적절한 보안 정책이 구성되어 있는지 확인하세요.

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

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

    **인증서 관리**: SSO 기능을 유지하려면 인증서 만료 날짜를 추적하고 제때 갱신하세요.
  </Tab>

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

    ### JumpCloud 애플리케이션 구성하기

    <Steps>
      <Step title="JumpCloud 콘솔 접속">
        [JumpCloud Admin Portal](https://console.jumpcloud.com/login/admin)에 로그인합니다.
      </Step>

      <Step title="SSO Applications 선택">
        왼쪽 탐색 모음의 **액세스** 섹션에서 **SSO Applications**를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/oTTnm7ow-OS4GUo-/assets/media/images/jumpcloud-saml_5-21-55.png?fit=max&auto=format&n=oTTnm7ow-OS4GUo-&q=85&s=f7708ec0e1ae7e3f5dcaec6428b5fc74" alt="JumpCloud Access SSO Applications" width="2578" height="1218" data-path="assets/media/images/jumpcloud-saml_5-21-55.png" />
        </Frame>
      </Step>

      <Step title="새 애플리케이션 생성">
        **+ Add New Application** 버튼을 선택하거나, 첫 번째 애플리케이션인 경우 **Get Started**를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/g5XvVqFV1vl7oJEO/assets/media/images/jumpcloud-saml_15-28-24.png?fit=max&auto=format&n=g5XvVqFV1vl7oJEO&q=85&s=cefd69a5e6fee0b13808c37f73907ddf" alt="JumpCloud Add New Application 또는 Get Started" width="2640" height="1332" data-path="assets/media/images/jumpcloud-saml_15-28-24.png" />
        </Frame>
      </Step>

      <Step title="Custom Application 선택">
        화면 하단의 Custom Application 타일에서 **선택**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_15-33-34.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=dc8dff89a3338d1727068b7b43fbad96" alt="JumpCloud Custom Application Select" width="2208" height="1920" data-path="assets/media/images/jumpcloud-saml_15-33-34.png" />
        </Frame>
      </Step>

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

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_15-35-33.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=e7bad43912d016318135ec2f29e2ec96" alt="JumpCloud Next" width="2296" height="1318" data-path="assets/media/images/jumpcloud-saml_15-35-33.png" />
        </Frame>
      </Step>

      <Step title="SSO 옵션 구성">
        \*\*Manage Single Sign-On (SSO)\*\*를 선택합니다.
      </Step>

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

      <Step title="설정 계속">
        **다음**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_15-37-06.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=bfdc004631fb375a88bc5d5bd3f9eec5" alt="JumpCloud Manage SSO Configure SSO with SAML Next" width="2208" height="1978" data-path="assets/media/images/jumpcloud-saml_15-37-06.png" />
        </Frame>
      </Step>

      <Step title="일반 정보 구성">
        **Enter** **General Info** 탭에서 다음을 수행합니다.

        1. **Display Label**의 이름을 추가합니다.
        2. 원하는 경우 **설명**을 추가합니다.
        3. **Display Portal Image**로 색상 표시기를 선택하거나 로고를 업로드합니다.
        4. 선택적으로 User Portal에 애플리케이션을 표시하도록 선택합니다.
        5. **Advanced Settings** 옆의 펼침 삼각형을 펼칩니다.
        6. **SSO IdP URL** 필드에 **iru**를 입력합니다. 전체 URL은 [https://sso.jumpcloud.com/saml2/iru가](https://sso.jumpcloud.com/saml2/iru가) 되어야 합니다.
        7. **Save Application**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_15-41-18.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=e67cf0dd5522297d4ae042b701f23eba" alt="JumpCloud General Info Display Label SSO IdP URL iru Save Application" width="2206" height="2056" data-path="assets/media/images/jumpcloud-saml_15-41-18.png" />
        </Frame>
      </Step>

      <Step title="애플리케이션 구성">
        애플리케이션이 저장되면 **Configure Application**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_15-48-22.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=e53e69d74b3e62bb5c7cdbbac8cafe31" alt="JumpCloud Configure Application" width="2300" height="1476" data-path="assets/media/images/jumpcloud-saml_15-48-22.png" />
        </Frame>
      </Step>

      <Step title="SSO 설정 구성">
        구성 모달의 **SSO** 탭에서 다음을 수행합니다.

        1. **IdP Entity ID**의 경우 고유한 Entity ID(예: `iru-saml-jumpcloud`)를 만들어 **IdP Entity ID** 필드에 입력합니다. 나중에 Iru Endpoint에서 사용할 수 있도록 이 고유한 IdP Entity ID를 저장해 두세요.
        2. 앞서 저장한 Iru Endpoint의 **Entity ID**를 복사하여 JumpCloud의 **SP Entity ID** 필드에만 붙여 넣습니다(IdP Entity ID 필드에 붙여 넣지 마세요).

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_15-52-36.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=827bcbe6ba57a72a3bbd16f2708b11af" alt="JumpCloud SSO 탭 IdP Entity ID 및 SP Entity ID" width="2620" height="2340" data-path="assets/media/images/jumpcloud-saml_15-52-36.png" />
        </Frame>

        3. 앞서 저장한 Iru Endpoint의 **Assertion Consumer Service URL**을 복사하여 **ACS URL** 필드에 붙여 넣습니다.
        4. **SAML Subject NameID**는 **email**로 설정된 상태로 둡니다.
        5. **SAML Subject NameID-Format** 필드의 드롭다운 메뉴에서 **urn:oasis:names:tc:SAML:1.1:nameid-format:emailAddress**를 선택합니다.
        6. **Signature Algorithm**을 **RSA-SHA256**으로 설정합니다.
        7. **Sign** 섹션에서 **Assertion**을 선택합니다.
        8. **IDP URL**이 [https://sso.jumpcloud.com/saml2/iru인지](https://sso.jumpcloud.com/saml2/iru인지) 확인합니다. 그렇지 않으면 통합을 삭제하고 새로 생성해야 합니다. 나중에 Iru Endpoint에서 사용할 수 있도록 이 URL을 복사하여 저장합니다.
        9. **저장**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_15-59-45.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=3c89fa68a4b6c780615b4fed7529f077" alt="JumpCloud SSO 탭 ACS URL NameID Signature Assertion Save" width="2592" height="2674" data-path="assets/media/images/jumpcloud-saml_15-59-45.png" />
        </Frame>
      </Step>

      <Step title="Action 메뉴 열기">
        오른쪽 상단의 **Action**을 선택합니다.
      </Step>

      <Step title="인증서 다운로드">
        **Download Certificate**를 선택합니다. 나중에 Iru Endpoint에서 사용됩니다.
      </Step>

      <Step title="User Groups 선택">
        **User Groups** 탭을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/jumpcloud-saml_16-13-53.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=db07abcec2abee78fd6b1161797e1e5f" alt="JumpCloud User Groups 탭" width="2674" height="1612" data-path="assets/media/images/jumpcloud-saml_16-13-53.png" />
        </Frame>
      </Step>

      <Step title="사용자 그룹 할당">
        SSO 애플리케이션에 사용자 그룹을 추가합니다. SSO 앱에 접근할 수 있는 사용자를 제한하려면 JumpCloud 콘솔에서 다른 사용자 그룹을 생성하여 SSO 앱에 할당하세요.

        <Frame>
          <img src="https://mintcdn.com/iru/g5XvVqFV1vl7oJEO/assets/media/images/jumpcloud-saml_16-20-10.png?fit=max&auto=format&n=g5XvVqFV1vl7oJEO&q=85&s=b8b22dcd8b19a017014563a63a15bd13" alt="JumpCloud에서 SSO 애플리케이션에 사용자 그룹 할당" width="2342" height="1296" data-path="assets/media/images/jumpcloud-saml_16-20-10.png" />
        </Frame>
      </Step>
    </Steps>

    <Note>
      JumpCloud 애플리케이션 구성을 완료한 후 **Iru 웹 앱 구성** 탭으로 돌아가 JumpCloud에서 복사한 Single Sign-on URL, IdP Entity ID 및 인증서를 사용하여 SAML 연결 설정을 마무리하세요.
    </Note>
  </Tab>
</Tabs>