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

> Koble Living Security til Slack for å sende varsler om opplæring, sikkerhetsvarsler og Playbook-oppdateringer til arbeidsområdet ditt.

Slack-integrasjonen gjør det mulig for Living Security å sende varsler direkte til Slack-arbeidsområdet deres. Varsle brukere om tildelt opplæring, varsle sikkerhetsteam om risikohendelser, og hold ledere oppdatert om teamets fremdrift.

<Note>
  For oppsett av levering av Nudge og Playbook, start på **Innstillinger → kommunikasjon → Channels** og klikk på kortet **Slack**. Denne siden omhandler den underliggende konfigurasjonen av Slack-appen.
</Note>

## Forutsetninger

Før dere konfigurerer Slack-integrasjonen, må dere ha følgende på plass:

* Administratortilgang til Slack-arbeidsområdet eller tillatelse til å installere apper
* Tilgang til Slack API-portalen på [api.slack.com](https://api.slack.com)
* Administratorrettigheter i Living Security

## Opprette en Slack-app

<Steps>
  <Step title="Opprett en ny Slack-app">
    1. Gå til [api.slack.com/apps](https://api.slack.com/apps)
    2. Klikk på **Create New App**
    3. Velg **From scratch**
    4. Angi et appnavn (for eksempel «Living Security»)
    5. Velg arbeidsområdet deres
    6. Klikk på **Create App**

    <Check>
      Appen vises i Slack API-dashbordet.
    </Check>
  </Step>

  <Step title="Konfigurer OAuth-scopes">
    1. Klikk på **OAuth & Permissions** i sidemenyen til venstre
    2. Rull ned til **Bot Token Scopes**
    3. Legg til følgende scopes:

    | Scope | Formål |
    | - | - |
    | `chat:write` | Sende meldinger til kanaler |
    | `chat:write.public` | Sende meldinger til kanaler uten å bli med i dem |
    | `users:read` | Slå opp brukerinformasjon |
    | `users:read.email` | Matche brukere etter e-postadresse |

    <Tip>
      Legg bare til de scopene organisasjonen deres trenger. Færre scopes gir bedre sikkerhet.
    </Tip>
  </Step>

  <Step title="Installer appen i arbeidsområdet">
    1. Rull til toppen av **OAuth & Permissions**
    2. Klikk på **Install to Workspace**
    3. Gå gjennom tillatelsene og klikk på **Allow**

    <Check>
      Et **Bot User OAuth Token** vises, og det begynner med `xoxb-`.
    </Check>
  </Step>

  <Step title="Hent signeringshemmeligheten">
    1. Klikk på **Basic Information** i sidemenyen til venstre
    2. Rull ned til **App Credentials**
    3. Kopier **Signing Secret**

    <Warning>
      Hold signeringshemmeligheten privat. Del den aldri i offentlige repositorier eller logger.
    </Warning>
  </Step>
</Steps>

## Legge til legitimasjon i Living Security

<Steps>
  <Step title="Gå til utgående integrasjoner">
    Gå til **Innstillinger → Integrasjoner → utgående** og klikk på kortet **Slack**.
  </Step>

  <Step title="Legg til legitimasjonen">
    Klikk på **Add Credential** og angi følgende:

    <ParamField body="botToken" type="string" required>
      Bot User OAuth Token, som begynner med `xoxb-`. Finnes under **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      Signeringshemmeligheten (Signing Secret) til appen. Finnes under **Basic Information → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Valgfritt. Kreves kun for tilkoblinger med Socket Mode. Begynner med `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Valgfritt. Et beskrivende navn på denne legitimasjonen (for eksempel «Production Slack»).
    </ParamField>
  </Step>

  <Step title="Lagre og verifiser">
    Klikk på **Lagre**. Legitimasjonen vises i listen med statusen **aktiv**.

    <Check>
      Slack-integrasjonen er nå tilkoblet og klar til å sende varsler.
    </Check>
  </Step>
</Steps>

## Varseltyper

Når integrasjonen er tilkoblet, kan Living Security sende følgende varseltyper til Slack:

| Varsel | Beskrivelse |
| - | - |
| Tildelt opplæring | Varsler brukere når ny opplæring er tildelt |
| Påminnelser om opplæring | Minner brukere om kommende frister |
| Bekreftelser på fullføring | Bekrefter at opplæring er fullført |
| Sikkerhetsvarsler | Varsler sikkerhetsteam om risikohendelser |
| Playbook-oppsummeringer | Sender periodiske oppdateringer om Playbook-resultater |

## Feilsøking

<AccordionGroup>
  <Accordion title="Meldinger vises ikke i kanaler">
    * Kontroller at boten er invitert til kanalen (`/invite @YourBotName`)
    * Kontroller at scopet `chat:write.public` er lagt til for å kunne poste i offentlige kanaler uten å bli med i dem
    * Bekreft at kanal-ID-en er riktig (bruk kanal-ID, ikke navn)
  </Accordion>

  <Accordion title="Feil om ugyldig token">
    * Kontroller at du har kopiert hele tokenet, som begynner med `xoxb-`
    * Kontroller at appen fortsatt er installert i arbeidsområdet
    * Sjekk om tokenet er generert på nytt (da må det oppdateres i Living Security)
  </Accordion>

  <Accordion title="Begrensning av forespørselsfrekvens">
    Slack begrenser antall API-forespørsler. Hvis du ser feil knyttet til frekvensbegrensning:

    * Reduser hyppigheten på varsler
    * Slå sammen flere varsler til samlemeldinger
    * Kontakt support ved bruksscenarioer med høyt volum
  </Accordion>
</AccordionGroup>

## Beste praksis

<Tip>
  Opprett en dedikert Slack-kanal for varsler fra Living Security (for eksempel `#security-training`) for å holde varslene organisert og redusere støy i generelle kanaler.
</Tip>

* Bruk beskrivende navn på legitimasjon når dere administrerer flere arbeidsområder
* Gå regelmessig gjennom hvilke kanaler som mottar varsler
* Sett opp samlevarsler i stedet for enkeltmeldinger ved varsler med høyt volum
* Gå gjennom tillatelsene til Slack-appen hvert kvartal, og fjern scopes som ikke brukes

## Relatert

<CardGroup cols={2}>
  <Card title="E-postintegrasjon" icon="envelope" href="/no/integrations/outbound/email">
    Konfigurer e-post som leveringskanal.
  </Card>

  <Card title="Teams-integrasjon" icon="microsoft" href="/no/integrations/outbound/teams">
    Konfigurer Microsoft Teams som leveringskanal.
  </Card>

  <Card title="Kommunikasjonslogg" icon="clock-rotate-left" href="/no/features/communications/log">
    Følg med på leveringsstatus og historikk for Slack.
  </Card>

  <Card title="Slik setter du opp en ny integrasjon" icon="plug" href="/no/integrations/managing/setup">
    Generell veiledning for oppsett av integrasjoner.
  </Card>
</CardGroup>


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