> ## 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 -integraation käyttöönotto

> Yhdistä Google Workspace Living Securityyn käyttäjien elinkaaren, kirjautumisten, MFA:n, hallinnollisen toiminnan ja tietosuojatoiminnan seurantaa varten.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Aiheeseen liittyvät resurssit</h2>
    <ul>
      <li>
        <a href="/fi/signals/data-sources">Lue, miten integraatioiden data muuttuu Human Risk Management -signaaleiksi</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Tutustu Living Securityn integraatioihin</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Avaa Living Security Platform</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Pyydä Living Securityn demo</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Syötä tunnistetiedot Living Security Platformissa">
    <p>
      Tämän vaiheen suorittaa henkilö, jolla on Living Securityn käyttöoikeus – ohjelman omistaja tai
      järjestelmänvalvoja, jos hänet on kutsuttu (delegoitu käyttöönotto).
    </p>
    <ol>
      <li>
        Siirry kohtaan <strong>Asetukset → Integraatiot → Luettelo</strong>, etsi{' '}
        <strong>{tile}</strong>-kortti ja valitse <strong>Liitä</strong>.
      </li>
      <li>
        Täytä alla olevat kentät ja valitse sitten <strong>Liitä</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Tämä opas on tarkoitettu {system}-järjestelmänne ylläpitäjälle.</strong> Se käsittelee API-tunnistetietojen luomista {system}-järjestelmässä, mikä edellyttää ylläpitäjän käyttöoikeuksia {system}-järjestelmään – ei Living Security Platformiin.
    </p>
    <p>
      Jos olette Living Securityn <strong>ohjelman omistaja</strong> ettekä ylläpidä {system}-järjestelmää,
      lähettäkää tämä sivu sille, joka sitä ylläpitää. Kyseinen henkilö suorittaa osan A ja luovuttaa tunnistetiedot teille
      (tai syöttää ne suoraan, jos olette kutsuneet hänet alustalle).
      {recommendDelegated && <>
          {' '}Koska asetusten yhteydessä syntyy arkaluonteista avainaineistoa, suosittelemme
          {' '}<strong>delegoitua käyttöönottoa</strong>, jotta salaisuutta ei koskaan lähetetä takaisin teille.
        </>}
    </p>
  </Note>;

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

## Mitä tämä integraatio tuottaa

Google Workspace voi tuottaa normalisoitua tietoa käyttäjien elinkaaresta, kirjautumisista, MFA:sta, hallinnollisesta toiminnasta ja tietosuojatoiminnasta. Tarkastettuja esimerkkejä ovat:

* `account.compromised` — tili merkitty vaarantuneeksi
* `data.sensitive.downloaded` — lataa arkaluonteisia tietoja
* `auth.login.unusual` — kirjautuu epätavallisissa olosuhteissa

Katso, [miten integraatiotiedoista muodostuu signaaleja](/fi/signals/data-sources).

## Mitä Living Security tarvitsee

| Tunnistetieto | Kuvaus |
| - | - |
| **Palvelutilin avain** | Erillisen Google Cloud -palvelutilin JSON-avain. |
| **Delegoitu järjestelmänvalvoja** | Google Workspace -järjestelmänvalvojan sähköpostiosoite, jonka identiteettiä palvelutili voi käyttää. |

Ota Admin SDK -rajapinnat käyttöön ja valtuuta vain ne oikeudet (scopes), joita yhteys lukee:

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

## Käyttöönotto

<Steps>
  <Step title="Luo Google Cloud -palvelutili">
    Luo erillinen palvelutili, ota käyttöön koko toimialueen delegointi (domain-wide delegation) ja lataa tilin JSON-avain. Säilytä avain turvallisesti.
  </Step>

  <Step title="Valtuuta koko toimialueen delegointi">
    Avaa Google Admin Consolessa **Security → Access and data control → API controls → Manage Domain Wide Delegation**. Lisää palvelutilin numeerinen asiakastunnus (client ID) ja yllä mainitut kolme vain luku -oikeutta.
  </Step>

  <Step title="Valitse delegoitu järjestelmänvalvoja">
    Valitse aktiivinen Workspace-järjestelmänvalvoja, jolla on oikeus lukea hakemistoa, roolimäärityksiä ja auditointiraportteja. Living Security käyttää tätä identiteettiä vain delegoituihin API-lukuihin.
  </Step>

  <ConnectInPlatform tile="Google Workspace Admin">
    Lataa tai liitä palvelutilin tunnistetiedot pyydettäessä ja syötä delegoidun järjestelmänvalvojan sähköpostiosoite.
  </ConnectInPlatform>
</Steps>

## Tarkistus ja vianmääritys

Varmista, että yhteys pystyy lukemaan yhden hakemiston käyttäjän ja viimeaikaisen kirjautumistoiminnan. Googlen mukaan uusien koko toimialueen delegointien voimaantulo voi kestää jonkin aikaa.

<AccordionGroup>
  <Accordion title="unauthorized_client">
    Varmista, että koko toimialueen delegoinnissa käytetään palvelutilin numeerista asiakastunnusta (client ID), ei sen sähköpostiosoitetta, ja että kaikki kolme oikeutta vastaavat täsmälleen.
  </Accordion>

  <Accordion title="Hakemisto toimii, mutta roolimääritykset puuttuvat">
    Lisää `admin.directory.rolemanagement.readonly` delegointimääritykseen ja varmista, että delegoitu järjestelmänvalvoja voi tarkastella roolimäärityksiä.
  </Accordion>

  <Accordion title="Raportit ovat tyhjiä">
    Varmista, että Admin Reports API on otettu käyttöön ja että delegoidulla järjestelmänvalvojalla on pääsy Workspace-vuokraajan auditointiraportointiin.
  </Accordion>
</AccordionGroup>

Toimittajan omat tiedot löytyvät [Googlen koko toimialueen delegointia koskevasta oppaasta](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.