> ## Documentation Index
> Fetch the complete documentation index at: https://docs.livingsecurity.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Google Workspace 연동 설정

> 사용자 수명 주기, 로그인, MFA, 관리 활동 및 데이터 보호 활동을 위해 Google Workspace를 Living Security에 연결합니다.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>관련 자료</h2>
    <ul>
      <li>
        <a href="/ko/signals/data-sources">연동 데이터가 Human Risk Management 신호로 변환되는 방식 알아보기</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Living Security 연동 살펴보기</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Living Security Platform 열기</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Living Security 데모 요청하기</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Living Security Platform에 자격 증명 입력">
    <p>
      Living Security 액세스 권한을 보유한 담당자(프로그램 소유자 또는 초대된 경우 시스템
      관리자(위임된 설정))가 완료합니다.
    </p>
    <ol>
      <li>
        <strong>설정 → 통합 → 카탈로그</strong>로 이동하여{' '}
        <strong>{tile}</strong> 타일을 찾은 다음 <strong>연결</strong>을 클릭합니다.
      </li>
      <li>
        아래 필드를 입력한 다음 <strong>연결</strong>을 클릭합니다.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>이 가이드는 {system} 관리자를 위한 문서입니다.</strong> {system} 내에서 API
      자격 증명을 생성하는 방법을 다루며, 이 작업에는 Living Security Platform이 아닌 {system}에 대한
      관리자 권한이 필요합니다.
    </p>
    <p>
      Living Security <strong>프로그램 소유자</strong>이면서 {system}을(를) 관리하지 않는 경우,
      이 페이지를 {system}을(를) 관리하는 담당자에게 전달하십시오. 담당자가 A부를 완료한 후 자격 증명을 귀하에게 전달하거나
      (플랫폼에 초대한 경우에는 담당자가 직접 입력할 수도 있습니다).
      {recommendDelegated && <>
          {' '}설정 과정에서 민감한 키 정보가 생성되므로, 시크릿이 귀하에게 전달되지 않도록{' '}
          <strong>위임 설정</strong> 방식을 권장합니다.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Google Workspace" recommendDelegated={true} />

## 이 연동이 제공하는 데이터

Google Workspace는 정규화된 사용자 수명 주기, 로그인, MFA, 관리 활동 및 데이터 보호 활동을 제공할 수 있습니다. 검토된 예시는 다음과 같습니다.

* `account.compromised` — 침해된 것으로 표시된 계정
* `data.sensitive.downloaded` — 민감한 데이터를 다운로드함
* `auth.login.unusual` — 비정상적인 환경에서 로그인함

[연동 데이터가 신호가 되는 방식](/ko/signals/data-sources)을 참조하십시오.

## Living Security에 필요한 정보

| 자격 증명 | 설명 |
| - | - |
| **서비스 계정 키** | 전용 Google Cloud 서비스 계정의 JSON 키입니다. |
| **위임된 관리자** | 서비스 계정이 가장(impersonate)할 수 있는 Google Workspace 관리자 이메일입니다. |

Admin SDK API를 활성화하고, 연결에서 읽는 범위(scope)만 승인하십시오.

* `https://www.googleapis.com/auth/admin.reports.audit.readonly`
* `https://www.googleapis.com/auth/admin.directory.user.readonly`
* `https://www.googleapis.com/auth/admin.directory.rolemanagement.readonly`

## 설정

<Steps>
  <Step title="Google Cloud 서비스 계정 생성">
    전용 서비스 계정을 생성하고 도메인 전체 위임을 활성화한 다음 JSON 키를 다운로드하십시오. 키는 안전하게 보관하십시오.
  </Step>

  <Step title="도메인 전체 위임 승인">
    Google Admin Console에서 **Security → Access and data control → API controls → Manage Domain Wide Delegation**을 여십시오. 서비스 계정의 숫자 클라이언트 ID와 위에 나열된 읽기 전용 범위 3개를 추가하십시오.
  </Step>

  <Step title="위임된 관리자 선택">
    디렉터리, 역할 할당 및 감사 보고서를 읽을 수 있는 활성 상태의 Workspace 관리자를 선택하십시오. Living Security는 이 ID를 위임된 API 읽기 용도로만 사용합니다.
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    안내에 따라 서비스 계정 자격 증명을 업로드하거나 붙여넣고, 위임된 관리자 이메일을 입력하십시오.
  </ConnectInPlatform>
</Steps>

## 확인 및 문제 해결

연결에서 디렉터리 사용자 한 명과 최근 로그인 활동을 읽을 수 있는지 확인하십시오. Google에 따르면 새로운 도메인 전체 위임 권한이 적용되기까지 시간이 걸릴 수 있습니다.

<AccordionGroup>
  <Accordion title="unauthorized_client">
    도메인 전체 위임에 서비스 계정의 이메일 주소가 아닌 숫자 클라이언트 ID가 사용되었는지, 그리고 3개의 범위가 모두 정확히 일치하는지 확인하십시오.
  </Accordion>

  <Accordion title="디렉터리는 작동하지만 역할 할당이 누락됨">
    위임 항목에 `admin.directory.rolemanagement.readonly`을(를) 추가하고, 위임된 관리자가 역할 할당을 볼 수 있는지 확인하십시오.
  </Accordion>

  <Accordion title="보고서가 비어 있음">
    Admin Reports API가 활성화되어 있는지, 그리고 위임된 관리자가 해당 Workspace 테넌트의 감사 보고서에 액세스할 수 있는지 확인하십시오.
  </Accordion>
</AccordionGroup>

공급업체 측 세부 정보는 [Google의 도메인 전체 위임 가이드](https://developers.google.com/identity/protocols/oauth2/service-account#delegatingauthority)를 참조하십시오.

<PublicIntegrationNextSteps />


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.