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

# Penyiapan integrasi Google Workspace

> Hubungkan Google Workspace ke Living Security untuk aktivitas siklus hidup pengguna, proses masuk, MFA, administratif, dan perlindungan data.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Sumber daya terkait</h2>
    <ul>
      <li>
        <a href="/id/signals/data-sources">Pelajari bagaimana data integrasi menjadi sinyal Human Risk Management</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Jelajahi integrasi Living Security</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Buka Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Minta demo Living Security</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Masukkan kredensial di Living Security Platform">
    <p>
      Dilakukan oleh pihak yang memiliki akses ke Living Security — pemilik program, atau admin
      sistem jika yang bersangkutan telah diundang (penyiapan terdelegasi).
    </p>
    <ol>
      <li>
        Buka <strong>Pengaturan → Integrasi → Katalog</strong>, temukan kartu{' '}
        <strong>{tile}</strong>, lalu klik <strong>Hubungkan</strong>.
      </li>
      <li>
        Isi kolom di bawah ini, lalu klik <strong>Hubungkan</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Panduan ini ditujukan bagi administrator {system} Anda.</strong> Panduan ini membahas pembuatan kredensial API
      di dalam {system}, yang memerlukan akses admin ke {system}, bukan ke
      Living Security Platform.
    </p>
    <p>
      Jika Anda adalah <strong>pemilik program</strong> Living Security dan tidak mengelola {system},
      kirimkan halaman ini kepada pihak yang mengelolanya. Mereka menyelesaikan Bagian A dan menyerahkan kembali kredensial tersebut kepada Anda
      (atau memasukkannya secara langsung jika Anda telah mengundang mereka ke dalam platform).
      {recommendDelegated && <>
          {' '}Karena proses penyiapan menghasilkan materi kunci yang sensitif, kami merekomendasikan jalur{' '}
          <strong>penyiapan terdelegasi</strong> agar secret tidak pernah dikirimkan kembali kepada Anda.
        </>}
    </p>
  </Note>;

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

## Kontribusi integrasi ini

Google Workspace dapat menyumbangkan aktivitas siklus hidup pengguna, proses masuk, MFA, administratif, dan perlindungan data yang telah dinormalisasi. Contoh yang telah ditinjau meliputi:

* `account.compromised` — akun ditandai sebagai telah disusupi
* `data.sensitive.downloaded` — mengunduh data sensitif
* `auth.login.unusual` — masuk dari konteks yang tidak biasa

Lihat [bagaimana data integrasi menjadi Sinyal](/id/signals/data-sources).

## Yang dibutuhkan Living Security

| Kredensial | Deskripsi |
| - | - |
| **Kunci akun layanan** | Kunci JSON untuk akun layanan Google Cloud khusus. |
| **Administrator yang didelegasikan** | Email administrator Google Workspace yang dapat ditiru (impersonate) oleh akun layanan. |

Aktifkan API Admin SDK dan otorisasikan hanya cakupan (scope) yang dibaca oleh koneksi:

* `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`

## Penyiapan

<Steps>
  <Step title="Buat akun layanan Google Cloud">
    Buat akun layanan khusus, aktifkan delegasi tingkat domain (domain-wide delegation), dan unduh kunci JSON-nya. Simpan kunci tersebut dengan aman.
  </Step>

  <Step title="Otorisasi delegasi tingkat domain">
    Di Google Admin Console, buka **Security → Access and data control → API controls → Manage Domain Wide Delegation**. Tambahkan client ID numerik milik akun layanan beserta ketiga cakupan hanya-baca di atas.
  </Step>

  <Step title="Pilih administrator yang didelegasikan">
    Pilih administrator Workspace aktif yang dapat membaca direktori, penetapan peran, dan laporan audit. Living Security menggunakan identitas ini hanya untuk pembacaan API yang didelegasikan.
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    Unggah atau tempel kredensial akun layanan sesuai petunjuk, lalu masukkan email administrator yang didelegasikan.
  </ConnectInPlatform>
</Steps>

## Verifikasi dan pemecahan masalah

Pastikan koneksi dapat membaca satu pengguna direktori dan aktivitas login terbaru. Google menyebutkan bahwa pemberian delegasi tingkat domain yang baru dapat memerlukan waktu untuk menyebar.

<AccordionGroup>
  <Accordion title="unauthorized_client">
    Pastikan delegasi tingkat domain menggunakan client ID numerik milik akun layanan, bukan alamat emailnya, dan bahwa ketiga cakupan sama persis.
  </Accordion>

  <Accordion title="Direktori berfungsi tetapi penetapan peran tidak ada">
    Tambahkan `admin.directory.rolemanagement.readonly` ke entri delegasi dan pastikan administrator yang didelegasikan dapat melihat penetapan peran.
  </Accordion>

  <Accordion title="Laporan kosong">
    Pastikan Admin Reports API telah diaktifkan dan administrator yang didelegasikan dapat mengakses pelaporan audit untuk tenant Workspace.
  </Accordion>
</AccordionGroup>

Untuk detail dari sisi vendor, lihat [panduan delegasi tingkat domain 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.