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

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

> Google Workspace와 Iru Endpoint 간 SAML 기반 SSO를 구성합니다. Google 관리 콘솔에서 SAML 앱을 설정하고 로그인을 위한 사용자 속성을 매핑합니다.

### Google Workspace SAML 통합 정보

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

#### 작동 방식

사용자가 Iru Endpoint에 접근하려고 하면 인증을 위해 Google Workspace로 리디렉션됩니다. 인증에 성공하면 Google Workspace는 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>
      Google Workspace에 필요한 구성 정보를 얻으려면 먼저 Iru Endpoint에서 초기 설정을 완료해야 합니다. Entity ID와 ACS URL을 복사한 후 [**Google Workspace 구성**](#google-workspace-configuration) 탭으로 전환하여 [**Google Workspace 애플리케이션 구성**](#configuring-google-workspace-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**를 텍스트 문서에 복사합니다. Google Workspace 구성에 필요합니다.
      </Step>

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

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

    ### Iru Endpoint SAML 연결 구성

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

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

      <Step title="사용자 일치">
        **User Matching** 섹션까지 아래로 스크롤합니다.
      </Step>

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

      <Step title="속성 이름 설정">
        **Attribute name**을 **email**로 설정합니다.
      </Step>

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

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/iru-support-google-saml_11-27-41.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=4cbca1474cdb1bacd0395dede4186ac8" alt="User Principal Name UPN으로 설정된 Iru Endpoint User attribute" width="1734" height="484" data-path="assets/media/images/iru-support-google-saml_11-27-41.png" />
        </Frame>
      </Step>

      <Step title="ID 공급자">
        **ID 공급자** 섹션까지 아래로 스크롤합니다.
      </Step>

      <Step title="IdP Entity ID 추가">
        Google Workspace에서 복사한 **Entity ID**를 **IdP Entity ID** 필드에 붙여 넣습니다.
      </Step>

      <Step title="IdP Single Sign-in URL 추가">
        Google Workspace에서 복사한 **IdP Single Sign-in URL**을 붙여 넣습니다.
      </Step>

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

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/iru-support-google-saml_11-35-42.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=49298bf3e5d179e6a1b35e0847154f73" alt="Iru Endpoint에서 Google Workspace 인증서 업로드" width="1994" height="760" data-path="assets/media/images/iru-support-google-saml_11-35-42.png" />
        </Frame>
      </Step>

      <Step title="요청 구성">
        **Request Configuration** 섹션까지 아래로 스크롤합니다.
      </Step>

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

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

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

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

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/iru-support-google-saml_11-41-47.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=7d781df5dfb962542c6dd819292a1b2c" alt="Request Configuration에서 활성화된 Sign SAML Authentication Request" width="2018" height="538" data-path="assets/media/images/iru-support-google-saml_11-41-47.png" />
        </Frame>
      </Step>

      <Step title="응답 검증">
        **Response Validation** 섹션까지 아래로 스크롤합니다.
      </Step>

      <Step title="응답 서명 확인 설정">
        **Response Signature Verification**을 **Response**로 설정합니다.
      </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/Qq59wQ8jCPy0XJe9/assets/media/images/iru-support-google-saml_11-46-41.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=2d685d24dd8af4065224a6e27705dfe8" alt="Iru Endpoint의 SAML 구성 Save 버튼" width="2006" height="634" data-path="assets/media/images/iru-support-google-saml_11-46-41.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="사용자 정보 입력">
        해당하는 사용자 정보를 모두 입력합니다. 이 사용자는 Google Workspace에 존재해야 하며 Google Workspace 테넌트의 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>
  </Tab>

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

    ### Google Workspace 애플리케이션 구성

    <Steps>
      <Step title="Google 관리 콘솔 열기">
        새 브라우저 탭에서 Google Workspace 관리자 계정으로 [admin.google.com](https://admin.google.com)에 로그인합니다.
      </Step>

      <Step title="메뉴 열기">
        왼쪽 상단의 메뉴 기호를 선택합니다.
      </Step>

      <Step title="앱으로 이동">
        **앱**을 선택합니다.
      </Step>

      <Step title="Web and Mobile Apps 선택">
        **Web and mobile apps**를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/iru-support-google-saml_13-01-38.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=b0358ffb20054e99d6234e69d585e840" alt="Google 관리 콘솔 Apps Web and mobile apps" width="3618" height="1812" data-path="assets/media/images/iru-support-google-saml_13-01-38.png" />
        </Frame>
      </Step>

      <Step title="새 앱 추가">
        **Add app** 드롭다운을 선택합니다.
      </Step>

      <Step title="Custom SAML App 선택">
        **Add custom SAML app**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/iru-support-google-saml_13-09-57.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=2a08d502ec6a6eae2ec4981dc8aa0844" alt="Add custom SAML app이 있는 Google Workspace Add app 드롭다운" width="3618" height="1720" data-path="assets/media/images/iru-support-google-saml_13-09-57.png" />
        </Frame>
      </Step>

      <Step title="앱 세부 정보 구성">
        App details 페이지에서 다음을 수행합니다.

        1. **App name**을 설정합니다.
        2. 선택적으로 **설명**을 추가합니다.
        3. 선택적으로 **App icon**을 업로드합니다.
        4. **계속**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/iru-support-google-saml_13-15-43.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=95aee60e7567459733a0fb7c0c3e1347" alt="App name, Description 및 Continue가 있는 Google Workspace SAML 앱 세부 정보" width="1992" height="1766" data-path="assets/media/images/iru-support-google-saml_13-15-43.png" />
        </Frame>
      </Step>

      <Step title="Google ID 공급자 세부 정보 복사">
        Google Identity Provider Details 페이지에서 \*\*Option 2: Copy the SSO URL, entity ID, and certificate.\*\*를 사용합니다.

        1. **SSO URL**을 복사하여 나중에 사용할 수 있도록 텍스트 문서에 저장합니다. Iru 웹 앱 구성을 완료하는 데 필요합니다.
        2. **Entity ID**를 복사하여 나중에 사용할 수 있도록 텍스트 문서에 저장합니다. Iru Endpoint의 **IdP Entity ID** 필드에 붙여 넣게 됩니다.
        3. **인증서**를 다운로드하여 저장합니다. Iru 웹 앱 구성을 완료하는 데 필요합니다.
        4. **계속**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/iru-support-google-saml_13-17-01.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=cbc64dbfb64fee7b87a431f4c7b43c3d" alt="SSO URL, Entity ID, Certificate 및 Continue가 있는 Google Identity Provider Details" width="1992" height="2192" data-path="assets/media/images/iru-support-google-saml_13-17-01.png" />
        </Frame>
      </Step>

      <Step title="서비스 공급자 세부 정보 구성">
        Service Provider Details 페이지에서 다음을 수행합니다.

        1. ACS URL 필드에 Iru 웹 앱 구성에서 복사한 **Iru Endpoint Assertion Consumer Service URL**을 붙여 넣습니다.
        2. Iru 웹 앱 구성에서 복사한 Iru Endpoint Entity ID를 **Entity ID** 필드에 붙여 넣습니다.
        3. **Signed response** 옵션이 선택되어 있는지 확인합니다.
        4. Name ID Format을 **EMAIL**로 설정합니다.
        5. NameID에 **Basic Information > Primary email**이 선택되어 있는지 확인합니다.
        6. **CONTINUE**를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/iru-support-google-saml_13-21-59.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=9b5f11a0cd4ad2b0bdd90bb8d81f53a8" alt="ACS URL, Entity ID, Signed response 및 CONTINUE가 있는 Google Service Provider Details" width="1992" height="1932" data-path="assets/media/images/iru-support-google-saml_13-21-59.png" />
        </Frame>
      </Step>

      <Step title="속성 매핑 구성">
        Attribute Mapping 페이지에서 다음을 수행합니다.

        1. **ADD MAPPING**을 선택합니다.
        2. **Basic information** 드롭다운 메뉴에서 **Primary email** 속성을 선택합니다.
        3. **App attributes** 필드에 **email**을 입력합니다.
        4. **Finish**를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/iru-support-google-saml_13-25-56.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=f0ca3c14befa7d32501960a139150471" alt="ADD MAPPING, Primary email 및 Finish가 있는 Google Attribute Mapping" width="1992" height="1744" data-path="assets/media/images/iru-support-google-saml_13-25-56.png" />
        </Frame>
      </Step>

      <Step title="사용자 접근 구성">
        표시되는 앱 페이지의 User Access에서 서비스가 켜져 있고 사용자 그룹 또는 조직 단위가 선택되어 있는지 확인합니다.

        1. **OFF for everyone**으로 표시되면 사용자 접근 패널의 펼침 삼각형을 선택하여 앱에 사용자 그룹 또는 조직 단위를 할당합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/iru-support-google-saml_13-29-40.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=1cc17e959f7d8b7e217a08af4d9faaa5" alt="그룹 또는 OU를 할당하기 위한 Google Workspace 앱 User Access 펼침" width="2460" height="1326" data-path="assets/media/images/iru-support-google-saml_13-29-40.png" />
        </Frame>

        2. 선택적으로 서비스를 활성화할 그룹 또는 조직 단위를 선택합니다(기본적으로 모든 조직 단위가 표시됩니다).
        3. 서비스 상태를 **ON for everyone**으로 설정합니다.
        4. **저장**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/Qq59wQ8jCPy0XJe9/assets/media/images/iru-support-google-saml_13-33-58.png?fit=max&auto=format&n=Qq59wQ8jCPy0XJe9&q=85&s=7be7cae58eff5ea8d206a46b4c610dbd" alt="Google Workspace User Access ON for everyone 및 Save" width="2398" height="1348" data-path="assets/media/images/iru-support-google-saml_13-33-58.png" />
        </Frame>
      </Step>
    </Steps>

    <Note>
      Iru Endpoint 속성 매핑에 대한 자세한 내용은 [SAML 기반 Single Sign-on](/ko/endpoint/integrations/single-sign-on-integrations/saml-based-single-sign-on) 지식 베이스 문서의 필수 클레임 속성 섹션을 참조하세요.
    </Note>

    <Note>
      Google Workspace 구성을 완료한 후 **Iru 웹 앱 구성** 탭으로 돌아가 Google Workspace에서 복사한 SSO URL, Entity ID 및 인증서를 사용하여 SAML 연결 설정을 마무리하세요.
    </Note>
  </Tab>
</Tabs>

## 고려 사항

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

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

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

**속성 매핑**: 올바른 속성 매핑은 사용자 인증 및 프로필 동기화를 성공적으로 수행하는 데 매우 중요합니다.