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

# Slack-integraatio

> Yhdistä Living Security Slackiin, jotta voit lähettää työtilaasi koulutusilmoituksia, tietoturvahälytyksiä ja toimintasuunnitelmien päivityksiä.

Slack-integraation avulla Living Security voi lähettää ilmoituksia suoraan Slack-työtilaanne. Voitte ilmoittaa käyttäjille koulutustehtävistä, hälyttää tietoturvatiimejä riskitapahtumista ja pitää esihenkilöt ajan tasalla tiimin edistymisestä.

<Note>
  Muistutusten ja toimintasuunnitelmien toimituksen määrittäminen aloitetaan kohdasta **Asetukset → Communications → kanavat** napsauttamalla **Slack**-korttia. Tällä sivulla käsitellään taustalla olevaa Slack-sovelluksen määritystä.
</Note>

## Edellytykset

Varmista ennen Slack-integraation määrittämistä, että sinulla on:

* Slack-työtilan järjestelmänvalvojan oikeudet tai sovelluksen asennusoikeudet
* Pääsy Slack API -portaaliin osoitteessa [api.slack.com](https://api.slack.com)
* Living Securityn järjestelmänvalvojan oikeudet

## Slack-sovelluksen luominen

<Steps>
  <Step title="Luo uusi Slack-sovellus">
    1. Siirry osoitteeseen [api.slack.com/apps](https://api.slack.com/apps)
    2. Napsauta **Create New App**
    3. Valitse **From scratch**
    4. Anna sovellukselle nimi (esim. "Living Security")
    5. Valitse työtilasi
    6. Napsauta **Create App**

    <Check>
      Sovelluksesi näkyy Slack API -kojelaudalla.
    </Check>
  </Step>

  <Step title="Määritä OAuth-oikeudet">
    1. Napsauta vasemmasta sivupalkista **OAuth & Permissions**
    2. Vieritä kohtaan **Bot Token Scopes**
    3. Lisää seuraavat oikeudet (scope):

    | Oikeus (scope) | Käyttötarkoitus |
    | - | - |
    | `chat:write` | Viestien lähettäminen kanaville |
    | `chat:write.public` | Viestien lähettäminen kanaville ilman liittymistä |
    | `users:read` | Käyttäjätietojen haku |
    | `users:read.email` | Käyttäjien täsmäyttäminen sähköpostiosoitteen perusteella |

    <Tip>
      Lisää vain ne oikeudet, joita organisaatiosi tarvitsee. Mitä vähemmän oikeuksia, sitä parempi tietoturva.
    </Tip>
  </Step>

  <Step title="Asenna sovellus työtilaasi">
    1. Vieritä **OAuth & Permissions** -sivun yläreunaan
    2. Napsauta **Install to Workspace**
    3. Tarkista oikeudet ja napsauta **Allow**

    <Check>
      Näkyviin tulee **Bot User OAuth Token**, joka alkaa merkkijonolla `xoxb-`.
    </Check>
  </Step>

  <Step title="Hae allekirjoitussalaisuus">
    1. Napsauta vasemmasta sivupalkista **Basic Information**
    2. Vieritä kohtaan **App Credentials**
    3. Kopioi **Signing Secret**

    <Warning>
      Pidä allekirjoitussalaisuus yksityisenä. Älä koskaan jaa sitä julkisissa tietovarastoissa tai lokeissa.
    </Warning>
  </Step>
</Steps>

## Tunnistetietojen lisääminen Living Securityyn

<Steps>
  <Step title="Siirry lähteviin integraatioihin">
    Siirry kohtaan **Asetukset → Integraatiot → Lähtevä** ja napsauta **Slack**-korttia.
  </Step>

  <Step title="Lisää tunnistetiedot">
    Napsauta **Add Credential** ja anna seuraavat tiedot:

    <ParamField body="botToken" type="string" required>
      Bot User OAuth Token, joka alkaa merkkijonolla `xoxb-`. Löytyy kohdasta **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      Sovelluksesi Signing Secret. Löytyy kohdasta **Basic Information → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Valinnainen. Vaaditaan vain Socket Mode -yhteyksissä. Alkaa merkkijonolla `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Valinnainen. Tunnistetiedolle annettava helposti tunnistettava nimi (esim. "Production Slack").
    </ParamField>
  </Step>

  <Step title="Tallenna ja varmista">
    Napsauta **Tallenna**. Tunnistetieto näkyy luettelossasi tilassa **aktiivinen**.

    <Check>
      Slack-integraatiosi on nyt yhdistetty ja valmis lähettämään ilmoituksia.
    </Check>
  </Step>
</Steps>

## Ilmoitustyypit

Yhdistämisen jälkeen Living Security voi lähettää Slackiin seuraavia ilmoitustyyppejä:

| Ilmoitus | Kuvaus |
| - | - |
| Koulutustehtävät | Ilmoittaa käyttäjille, kun heille on määritetty uusi koulutus |
| Koulutusmuistutukset | Muistuttaa käyttäjiä lähestyvistä määräajoista |
| Suorituksen vahvistukset | Vahvistavat, kun koulutus on suoritettu |
| Tietoturvahälytykset | Ilmoittavat tietoturvatiimeille riskitapahtumista |
| Toimintasuunnitelmien yhteenvedot | Lähettävät säännöllisiä päivityksiä toimintasuunnitelmien tuloksista |

## Vianmääritys

<AccordionGroup>
  <Accordion title="Viestit eivät näy kanavilla">
    * Varmista, että botti on kutsuttu kanavalle (`/invite @YourBotName`)
    * Tarkista, että oikeus `chat:write.public` on lisätty, jotta julkisille kanaville voi julkaista ilman liittymistä
    * Varmista, että kanavan tunnus on oikea (käytä kanavan tunnusta, ei nimeä)
  </Accordion>

  <Accordion title="Virheellinen tunnus -virhe">
    * Varmista, että kopioit koko tunnuksen, joka alkaa merkkijonolla `xoxb-`
    * Varmista, että sovellus on edelleen asennettuna työtilaasi
    * Tarkista, onko tunnus luotu uudelleen (vaatii päivityksen Living Securityssä)
  </Accordion>

  <Accordion title="Pyyntöjen rajoitus">
    Slack rajoittaa API-pyyntöjen määrää. Jos näet pyyntörajoitukseen liittyviä virheitä:

    * Vähennä ilmoitusten lähetystiheyttä
    * Yhdistä useita ilmoituksia koosteviesteiksi
    * Ota yhteyttä tukeen, jos käyttötapauksessa on suuret viestimäärät
  </Accordion>
</AccordionGroup>

## Parhaat käytännöt

<Tip>
  Luo Living Security -ilmoituksia varten oma Slack-kanava (esim. `#security-training`), jotta hälytykset pysyvät järjestyksessä ja yleisillä kanavilla on vähemmän kohinaa.
</Tip>

* Käytä kuvaavia tunnistetietojen nimiä, kun hallitset useita työtiloja
* Tarkista säännöllisesti, mitkä kanavat vastaanottavat ilmoituksia
* Käytä suuria määriä tuottavissa hälytyksissä yksittäisten viestien sijaan ilmoitusten koosteita
* Tarkista Slack-sovelluksen oikeudet neljännesvuosittain ja poista käyttämättömät oikeudet

## Aiheeseen liittyvää

<CardGroup cols={2}>
  <Card title="Sähköpostiintegraatio" icon="envelope" href="/fi/integrations/outbound/email">
    Määritä sähköposti toimituskanavaksi.
  </Card>

  <Card title="Teams-integraatio" icon="microsoft" href="/fi/integrations/outbound/teams">
    Määritä Microsoft Teams toimituskanavaksi.
  </Card>

  <Card title="Viestintäloki" icon="clock-rotate-left" href="/fi/features/communications/log">
    Seuraa Slack-toimitusten tilaa ja historiaa.
  </Card>

  <Card title="Uuden integraation määrittäminen" icon="plug" href="/fi/integrations/managing/setup">
    Integraatioiden yleinen määritysopas.
  </Card>
</CardGroup>


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