> ## 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 integrācija

> Savienojiet Living Security ar Slack, lai nosūtītu apmācību paziņojumus, drošības brīdinājumus un Playbook atjauninājumus uz savu darbvietu.

Slack integrācija ļauj Living Security sūtīt paziņojumus tieši uz jūsu Slack darbvietu. Informējiet lietotājus par piešķirtajām apmācībām (Training), brīdiniet drošības komandas par riska notikumiem un informējiet vadītājus par komandas progresu.

<Note>
  Lai iestatītu Nudge un Playbook piegādi, sāciet sadaļā **Settings → Communications → Channels** un noklikšķiniet uz kartītes **Slack**. Šajā lapā aprakstīta pamatā esošā Slack lietotnes konfigurācija.
</Note>

## Priekšnosacījumi

Pirms Slack integrācijas konfigurēšanas pārliecinieties, ka jums ir:

* Slack darbvietas administratora vai lietotņu instalēšanas atļaujas
* Piekļuve Slack API portālam [api.slack.com](https://api.slack.com)
* Living Security administratora tiesības

## Slack lietotnes izveide

<Steps>
  <Step title="Izveidojiet jaunu Slack lietotni">
    1. Atveriet [api.slack.com/apps](https://api.slack.com/apps)
    2. Noklikšķiniet uz **Create New App**
    3. Atlasiet **From scratch**
    4. Ievadiet lietotnes nosaukumu (piemēram, "Living Security")
    5. Atlasiet savu darbvietu
    6. Noklikšķiniet uz **Create App**

    <Check>
      Jūsu lietotne tiek parādīta Slack API informācijas panelī.
    </Check>
  </Step>

  <Step title="Konfigurējiet OAuth tvērumus">
    1. Kreisajā sānjoslā noklikšķiniet uz **OAuth & Permissions**
    2. Ritiniet līdz sadaļai **Bot Token Scopes**
    3. Pievienojiet šādus tvērumus:

    | Tvērums | Mērķis |
    | - | - |
    | `chat:write` | Ziņojumu sūtīšana uz kanāliem |
    | `chat:write.public` | Ziņojumu sūtīšana uz kanāliem, tiem nepievienojoties |
    | `users:read` | Lietotāja informācijas meklēšana |
    | `users:read.email` | Lietotāju saskaņošana pēc e-pasta adreses |

    <Tip>
      Pievienojiet tikai tos tvērumus, kas nepieciešami jūsu organizācijai. Jo mazāk tvērumu, jo labāka drošība.
    </Tip>
  </Step>

  <Step title="Instalējiet lietotni savā darbvietā">
    1. Ritiniet līdz **OAuth & Permissions** sākumam
    2. Noklikšķiniet uz **Install to Workspace**
    3. Pārskatiet atļaujas un noklikšķiniet uz **Allow**

    <Check>
      Tiek parādīts **Bot User OAuth Token**, kas sākas ar `xoxb-`.
    </Check>
  </Step>

  <Step title="Iegūstiet parakstīšanas noslēpumu">
    1. Kreisajā sānjoslā noklikšķiniet uz **Basic Information**
    2. Ritiniet līdz sadaļai **App Credentials**
    3. Nokopējiet **Signing Secret**

    <Warning>
      Glabājiet parakstīšanas noslēpumu slepenībā. Nekādā gadījumā nedalieties ar to publiskās repozitorijās vai žurnālos.
    </Warning>
  </Step>
</Steps>

## Akreditācijas datu pievienošana pakalpojumā Living Security

<Steps>
  <Step title="Pārejiet uz Outbound Integrations">
    Atveriet **Settings → Integrations → Outbound** un noklikšķiniet uz kartītes **Slack**.
  </Step>

  <Step title="Pievienojiet savus akreditācijas datus">
    Noklikšķiniet uz **Add Credential** un ievadiet:

    <ParamField body="botToken" type="string" required>
      Jūsu Bot User OAuth Token, kas sākas ar `xoxb-`. Atrodams sadaļā **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      Jūsu lietotnes Signing Secret. Atrodams sadaļā **Basic Information → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Neobligāts. Nepieciešams tikai Socket Mode savienojumiem. Sākas ar `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Neobligāts. Šī akreditācijas datu komplekta viegli atpazīstams nosaukums (piemēram, "Production Slack").
    </ParamField>
  </Step>

  <Step title="Saglabājiet un pārbaudiet">
    Noklikšķiniet uz **Save**. Akreditācijas dati tiek parādīti jūsu sarakstā ar statusu **active**.

    <Check>
      Jūsu Slack integrācija tagad ir savienota un gatava paziņojumu sūtīšanai.
    </Check>
  </Step>
</Steps>

## Paziņojumu veidi

Pēc savienošanas Living Security var sūtīt uz Slack šādu veidu paziņojumus:

| Paziņojums | Apraksts |
| - | - |
| Apmācību piešķiršana | Brīdina lietotājus, kad tiek piešķirta jauna apmācība (Training) |
| Apmācību atgādinājumi | Atgādina lietotājiem par tuvojošamies termiņiem |
| Pabeigšanas apstiprinājumi | Apstiprina, ka apmācība (Training) ir pabeigta |
| Drošības brīdinājumi | Paziņo drošības komandām par riska notikumiem |
| Playbook kopsavilkumi | Sūta periodiskus Playbook snieguma atjauninājumus |

## Problēmu novēršana

<AccordionGroup>
  <Accordion title="Ziņojumi neparādās kanālos">
    * Pārbaudiet, vai bots ir uzaicināts kanālā (`/invite @YourBotName`)
    * Pārbaudiet, vai ir pievienots tvērums `chat:write.public`, lai varētu publicēt publiskos kanālos, tiem nepievienojoties
    * Pārliecinieties, ka kanāla ID ir pareizs (izmantojiet kanāla ID, nevis nosaukumu)
  </Accordion>

  <Accordion title="Nederīga pilnvaras kļūda">
    * Pārliecinieties, ka esat nokopējis pilnu pilnvaru (token), kas sākas ar `xoxb-`
    * Pārbaudiet, vai lietotne joprojām ir instalēta jūsu darbvietā
    * Pārbaudiet, vai pilnvara nav ģenerēta no jauna (tādā gadījumā tā jāatjaunina Living Security)
  </Accordion>

  <Accordion title="Pieprasījumu ierobežošana">
    Slack ierobežo API pieprasījumus. Ja redzat pieprasījumu ierobežojuma kļūdas:

    * Samaziniet paziņojumu biežumu
    * Apvienojiet vairākus paziņojumus apkopojuma ziņojumos
    * Sazinieties ar atbalsta dienestu, ja jums ir liels apjoms
  </Accordion>
</AccordionGroup>

## Labākā prakse

<Tip>
  Izveidojiet atsevišķu Slack kanālu Living Security paziņojumiem (piemēram, `#security-training`), lai brīdinājumi būtu sakārtoti un vispārējos kanālos būtu mazāk trokšņa.
</Tip>

* Izmantojiet jēgpilnus akreditācijas datu nosaukumus, ja pārvaldāt vairākas darbvietas
* Regulāri pārbaudiet, kuri kanāli saņem paziņojumus
* Lielam brīdinājumu apjomam iestatiet paziņojumu apkopojumus atsevišķu ziņojumu vietā
* Reizi ceturksnī pārskatiet Slack lietotnes atļaujas un noņemiet neizmantotos tvērumus

## Saistītie materiāli

<CardGroup cols={2}>
  <Card title="E-pasta integrācija" icon="envelope" href="/lv/integrations/outbound/email">
    Konfigurējiet e-pastu kā piegādes kanālu.
  </Card>

  <Card title="Teams integrācija" icon="microsoft" href="/lv/integrations/outbound/teams">
    Konfigurējiet Microsoft Teams kā piegādes kanālu.
  </Card>

  <Card title="Saziņas žurnāls" icon="clock-rotate-left" href="/lv/features/communications/log">
    Izsekojiet Slack piegādes statusam un vēsturei.
  </Card>

  <Card title="Kā iestatīt jaunu integrāciju" icon="plug" href="/lv/integrations/managing/setup">
    Vispārīgs integrācijas iestatīšanas ceļvedis.
  </Card>
</CardGroup>


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