> ## 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(Native)

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

### Google Workspace Native 통합 정보

Iru Endpoint의 Google Workspace Native 통합을 사용하면 SSO를 위한 네이티브 Google Workspace 통합을 설정할 수 있습니다. 사용자는 사용자 지정 SAML 구성 없이 Google Workspace 자격 증명으로 인증합니다.

#### 작동 방식

사용자가 Iru Endpoint에 접근하려고 하면 OAuth2/OpenID Connect 프로토콜을 사용한 인증을 위해 Google Workspace로 리디렉션됩니다. 인증에 성공하면 Google Workspace는 액세스 토큰을 Iru Endpoint로 다시 보내고, Iru Endpoint는 사용자의 신원을 검증하여 플랫폼 접근 권한을 부여합니다.

<Warning>
  iOS 등록에 [Automated Device Enrollment 시 인증 요구](/ko/endpoint/enrollment/configure-require-authentication-for-enrollment)를 사용하고 Google Workspace를 ID 공급자로 사용하는 경우, Single Sign-On 항목은 [Custom SAML을 사용하여](/ko/endpoint/integrations/single-sign-on-integrations/single-sign-on-with-google-workspace-saml) 생성해야 합니다. 기본 제공 Google Workspace 통합은 지원되지 않습니다.
</Warning>

### 사전 요구 사항

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

* Admin 또는 Account Owner로서 [Iru Endpoint 웹 앱에 대한 접근 권한](/ko/endpoint/getting-started/foundation/admins-and-access)
* Google Workspace 구성 단계를 완료하기 위한 Google Workspace 최고 관리자 계정

<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="Google Workspace 선택">
        **Google Workspace**를 선택합니다.
      </Step>

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

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

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_09-32-18.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=8e9eb7c658d0c596801cb59a4e78a609" alt="Google Workspace용으로 복사할 Iru Endpoint SSO Redirect URL" width="1318" height="520" data-path="assets/media/images/google-native_09-32-18.png" />
        </Frame>
      </Step>

      <Step title="탭 열어 두기">
        Iru 웹 앱 구성 모달을 열어 둔 상태에서 [**Google Workspace 구성**](#google-workspace-configuration) 탭으로 전환하여 [**Google Workspace 애플리케이션 설정**](#setting-up-google-workspace-application)을 계속 진행합니다.
      </Step>
    </Steps>

    <Note>
      [**Google Workspace 구성**](#google-workspace-configuration)을 완료한 후 여기로 돌아와 Iru Endpoint에서 SSO 연결 설정을 마무리하세요. Google Workspace에서 복사한 Client ID와 Client secret이 필요합니다.
    </Note>

    ### Iru Endpoint 연결 완료

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

    <Steps>
      <Step title="Google Workspace 도메인 입력">
        Google Workspace의 **Google Workspace domain**을 입력합니다.
      </Step>

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

      <Step title="Client Secret 붙여 넣기">
        Google Workspace에서 복사한 **Client secret**을 **Client secret** 필드에 붙여 넣습니다.

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_10-05-01.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=ce0bce036daf3da619b3c8aa25745d8c" alt="Google Workspace용 Iru Endpoint Client secret 필드" width="2118" height="1646" data-path="assets/media/images/google-native_10-05-01.png" />
        </Frame>
      </Step>

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

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

    ### 테넌트 인증 허용

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

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

    OIDC 연결을 구성할 때 선택적으로 인증을 하나 이상의 도메인으로 제한할 수 있습니다. 이는 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)를 참조하세요.
  </Tab>

  <Tab title="Google Workspace 구성">
    ### Google Workspace 애플리케이션 설정

    <Note>
      Google Workspace 구성을 시작하기 전에 [**Iru 웹 앱 구성**](#iru-web-app-configuration) 탭의 [**Iru Endpoint 연결 구성**](#configuring-iru-endpoint-connection)에서 초기 설정을 완료하여 Redirect URL을 가져오세요. Google Workspace 애플리케이션을 구성하려면 이 값이 필요합니다.
    </Note>

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

    <Steps>
      <Step title="Google Cloud 콘솔 접속">
        [Google Cloud 콘솔](https://console.cloud.google.com/)에 **로그인**합니다.
      </Step>

      <Step title="프로젝트 생성">
        **Create project**를 선택합니다.

        **Create project**를 사용할 수 없는 경우 화면 왼쪽 상단의 프로젝트 선택기를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/HIaOdLmBHtAWalH0/assets/media/images/iru-google-native-sso-create-project-or-project-selector.png?fit=max&auto=format&n=HIaOdLmBHtAWalH0&q=85&s=b7dd8b28183ead2f419e234ae8ed2f46" alt="Create project 및 프로젝트 선택기가 표시된 Google Cloud APIs & Services 페이지" width="2300" height="886" data-path="assets/media/images/iru-google-native-sso-create-project-or-project-selector.png" />
        </Frame>
      </Step>

      <Step title="조직 및 새 프로젝트 선택">
        **Create project**를 선택한 경우 이 단계를 건너뜁니다. **Create project**를 사용할 수 없었던 경우 프로젝트 선택기에서 조직을 선택한 다음 **New project**를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/HIaOdLmBHtAWalH0/assets/media/images/iru-google-native-sso-select-org-and-new-project.png?fit=max&auto=format&n=HIaOdLmBHtAWalH0&q=85&s=3d441441c38efc5d951512896772c464" alt="조직이 선택되고 New project가 표시된 Google Cloud Select a resource 대화 상자" width="1584" height="600" data-path="assets/media/images/iru-google-native-sso-select-org-and-new-project.png" />
        </Frame>
      </Step>

      <Step title="프로젝트 세부 정보 구성">
        **Project name**을 입력합니다.
      </Step>

      <Step title="조직 선택">
        드롭다운 메뉴에서 **조직**을 선택합니다.
      </Step>

      <Step title="위치 선택">
        **Location**을 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_08-30-58.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=54f4d8f6168d88108d525e7efa484cc8" alt="Google API Console 프로젝트 Location 드롭다운" width="2598" height="874" data-path="assets/media/images/google-native_08-30-58.png" />
        </Frame>
      </Step>

      <Step title="프로젝트 생성">
        **만들기**를 선택합니다.
      </Step>

      <Step title="Credentials 접속">
        사이드바에서 **Credentials**를 선택합니다.
      </Step>

      <Step title="동의 화면 구성">
        클라이언트 ID를 처음 생성하는 경우 [동의 화면을 구성](https://support.google.com/googleapi/answer/6158849#zippy=%2Cuser-consent)하라는 메시지가 표시될 수도 있습니다.

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_08-45-03.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=3370df7712a2cd9e0d3d11cd3425bf17" alt="Google 동의 화면 구성 메시지" width="2888" height="1204" data-path="assets/media/images/google-native_08-45-03.png" />
        </Frame>
      </Step>

      <Step title="자격 증명 생성">
        창 오른쪽 상단 근처에서 **+ Create credentials**를 선택합니다.
      </Step>

      <Step title="OAuth Client ID 선택">
        표시되는 메뉴에서 **OAuth Client ID**를 선택합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_08-50-16.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=de24f6c68f2f98e2bad93052d10646c6" alt="Google Create credentials OAuth Client ID" width="2600" height="972" data-path="assets/media/images/google-native_08-50-16.png" />
        </Frame>
      </Step>

      <Step title="애플리케이션 유형 구성">
        "**Application Type**"에서 메뉴를 선택하고 "**Web application**"을 선택합니다.
      </Step>

      <Step title="OAuth 클라이언트 이름 지정">
        **이름** 필드에 OAuth 클라이언트의 **이름**을 입력합니다.
      </Step>

      <Step title="Authorized JavaScript Origins 구성">
        **Authorized JavaScript Origins**에는 [**Iru 웹 앱 구성**](#iru-web-app-configuration) 탭에서 복사한 Redirect URL의 도메인 부분만 사용합니다(예: `https://vpriix.id.iru.com`). 이 도메인은 각 Iru 테넌트마다 고유합니다.
      </Step>

      <Step title="Authorized Redirect URIs 구성">
        **Authorized redirect URIs**에는 [**Iru 웹 앱 구성**](#iru-web-app-configuration) 탭에서 복사한 전체 Redirect URL을 입력합니다(예: `https://vpriix.id.iru.com/federated-auth/oidc/callback`).

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_09-26-03.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=c5f3ce845da4a0d0ace07f6ab0d2829b" alt="Authorized redirect URIs 구성을 보여 주는 Google Workspace를 사용한 Single Sign-On(Native) 문서" width="3090" height="2136" data-path="assets/media/images/google-native_09-26-03.png" />
        </Frame>
      </Step>

      <Step title="OAuth 클라이언트 생성">
        **만들기**를 선택합니다.
      </Step>

      <Step title="Client ID 복사">
        **Client ID** 필드의 텍스트를 복사하여 나중에 사용할 수 있도록 저장합니다.
      </Step>

      <Step title="Client Secret 복사">
        **Client Secret** 필드의 텍스트를 복사하여 나중에 사용할 수 있도록 저장합니다.

        <Frame>
          <img src="https://mintcdn.com/iru/tdUGxmJrLWpxmPfN/assets/media/images/google-native_09-27-24.png?fit=max&auto=format&n=tdUGxmJrLWpxmPfN&q=85&s=dc6b3de9f1f68cacf3d4c0f3a4757584" alt="Google OAuth Client ID 및 Client Secret 필드" width="1112" height="1314" data-path="assets/media/images/google-native_09-27-24.png" />
        </Frame>
      </Step>

      <Step title="OK 선택">
        **OK**를 선택합니다.
      </Step>
    </Steps>

    <Note>
      Google Workspace 구성을 완료한 후 [**Iru 웹 앱 구성**](#iru-web-app-configuration) 탭으로 돌아가 [**Iru Endpoint 연결 완료**](#completing-the-iru-endpoint-connection)를 계속 진행하여 Google Workspace에서 복사한 Client ID와 Client secret으로 SSO 연결 설정을 마무리하세요.
    </Note>
  </Tab>
</Tabs>