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

> 페더레이션 인증 및 프로비저닝을 위한 기본 제공 연결 템플릿을 사용하여 사용자가 Google Workspace 계정으로 Iru Identity에 로그인할 수 있도록 합니다.

**Google Workspace**를 연결하면 사용자가 이미 보유한 Google 계정을 사용하여
Iru에 로그인하고 할당된 앱에 액세스할 수 있습니다. Iru는 표준 구성을 미리 채우는
**Google Workspace 템플릿**을 제공하므로 가장 빠르게 연결할 수 있는 공급자 중
하나입니다.

<Info>
  Iru Identity를 ID 공급자로 사용하는 대부분의 조직에서는 사용자가 패스키 또는
  Iru Access 앱으로 직접 로그인합니다. Iru Identity를 기본 ID 공급자가 아닌 Iru
  플랫폼에 대한 인증 계층으로 사용하거나 Iru Identity로의 마이그레이션을 쉽게 하려는
  경우 Google Workspace를 연결하세요. [페더레이션 인증](/ko/identity/connections/connections-overview)을 참조하세요.
</Info>

<Note>
  이 연결을 완료하려면 Iru 테넌트에 대한 관리자 액세스 권한과 Google Workspace
  조직의 Google 관리 콘솔에 대한 액세스 권한이 필요합니다.
</Note>

## 시작하기 전에

<Steps>
  <Step title="로그인 도메인 확인">
    사용자가 로그인에 사용하는 이메일 **도메인**(예:
    `yourcompany.com`)을 기록해 두세요. 해당 도메인의 사용자만 연결을 사용하도록
    연결을 이 도메인으로 제한할 수 있습니다.
  </Step>

  <Step title="Iru의 사용자 매칭 방식 결정">
    누군가 Google을 통해 로그인하면 Iru는 해당 사용자를 디렉터리의 사용자와
    매칭합니다. 매칭에 사용할 값(일반적으로 사용자의 이메일 또는 사용자 이름)을
    결정하세요. [사용자 매칭](/ko/identity/connections/connections-overview#what-you-configure-on-every-identity-provider-connection)을 참조하세요.
  </Step>

  <Step title="사용자가 Iru에 존재하는지 확인">
    연결을 통한 로그인은 기존 Iru 사용자로 확인됩니다. 먼저 사용자를 추가하거나
    가져오세요. [사용자 가져오기](/ko/identity/directory/importing-users) 또는
    [Directory Sync](/ko/identity/directory/directory-sync)를 참조하세요.
  </Step>
</Steps>

## Google Workspace 연결

<Steps>
  <Step title="연결 추가">
    **Access → Authentication**에서 **인증 방법**을 추가하고
    **Google Workspace** 템플릿을 선택합니다. 템플릿을 사용하면 표준 설정이
    자동으로 채워집니다.
  </Step>

  <Step title="Google에서 Iru 승인">
    안내에 따라 Google Workspace 조직에 대해 Iru를 승인합니다. 요청 시 Google
    **최고 관리자** 계정으로 로그인하고 표준 로그인 범위(`openid`, `email`,
    `profile`)에 동의합니다. 조직에서 자체 OAuth 클라이언트를 제공하는 경우 Google
    Cloud 콘솔에서 클라이언트를 생성하고, 이 연결에 대해 Iru가 표시하는 리디렉션
    URI를 추가한 다음, 클라이언트 ID와 시크릿을 Iru에 복사합니다. Google 콘솔 화면은
    변경될 수 있으므로 안내가 다른 경우 Google의 최신 문서를 따르세요.
  </Step>

  <Step title="연결의 용도 선택">
    연결의 **사용 사례**를 선택합니다: **최종 사용자 로그인**, **기기
    등록** 또는 둘 다. 대부분의 구성에서는 최종 사용자 로그인을 활성화합니다.
  </Step>

  <Step title="도메인으로 제한">
    특정 이메일 도메인의 사용자만 이 연결을 사용하도록 하려면
    **도메인 제한**을 활성화하고 해당 도메인을 추가하세요.
  </Step>

  <Step title="사용자 매칭 설정">
    Iru가 Google 로그인을 Iru 사용자와 매칭하는 방식(UPN, 사용자 이름, 외부 ID 또는
    사용자 지정 속성)을 선택합니다. 모든 사용자에 대해 고유하고 안정적인 값을
    선택하세요.
  </Step>

  <Step title="연결 저장">
    저장한 다음 허용된 도메인에 이메일이 있는 테스트 사용자로 로그인하여 Google로의
    핸드오프가 처음부터 끝까지 작동하는지 확인합니다.
  </Step>
</Steps>

<Tip>
  연결을 광범위하게 배포하기 전에 한 명의 사용자로 테스트하세요. 로그인이 올바른
  사용자로 연결되지 않으면 **사용자 매칭** 선택을 다시 검토하세요. 매칭 값은 연결을
  사용하는 모든 사용자에 대해 존재하고 고유해야 합니다.
</Tip>

## 연결 후 로그인 작동 방식

누군가 로그인하면 Iru는 로그인을 Google에 넘기고, Google이 사용자를 확인하며,
Iru는 세션을 계속 진행한 후 액세스를 허용하기 전에 앱의
[인증 정책](/ko/identity/authentication/authentication-policies)을 평가합니다.
전체 내용은 [시스템 아키텍처](/ko/identity/getting-started/system-architecture)를 참조하세요.

## 관련 항목

<CardGroup cols={2}>
  <Card title="페더레이션 인증" icon="plug" href="/ko/identity/connections/connections-overview">
    사용 사례, 도메인 제한, 사용자 매칭을 한곳에서 설명합니다.
  </Card>

  <Card title="Microsoft Entra ID" icon="microsoft" href="/ko/identity/connections/microsoft-entra-id">
    자체 템플릿으로 로그인용 Microsoft Entra ID를 연결합니다.
  </Card>

  <Card title="로그인 환경" icon="arrow-right-to-bracket" href="/ko/identity/authentication/sign-in-experience">
    사용자가 로그인할 때 표시되는 화면을 구성합니다.
  </Card>

  <Card title="사용자 지정 SAML" icon="shield-halved" href="/ko/identity/connections/custom-saml">
    템플릿이 없는 공급자를 연결합니다.
  </Card>
</CardGroup>