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

# Integrace Slack

> Propojte Living Security se Slackem a odesílejte do svého pracovního prostoru oznámení o školení, bezpečnostní upozornění a aktualizace Playbooků.

Integrace Slack umožňuje službě Living Security odesílat oznámení přímo do vašeho pracovního prostoru Slack. Informujte uživatele o přidělených školeních, upozorňujte bezpečnostní týmy na rizikové události a udržujte manažery v obraze o pokroku jejich týmů.

<Note>
  Nastavení doručování Postrčení a Playbooků zahájíte v části **Nastavení → Komunikace → Kanály** kliknutím na kartu **Slack**. Tato stránka se věnuje podkladové konfiguraci aplikace Slack.
</Note>

## Předpoklady

Před konfigurací integrace Slack se ujistěte, že máte:

* oprávnění správce pracovního prostoru Slack nebo oprávnění k instalaci aplikací
* přístup k portálu Slack API na adrese [api.slack.com](https://api.slack.com)
* oprávnění správce v Living Security

## Vytvoření aplikace Slack

<Steps>
  <Step title="Vytvořte novou aplikaci Slack">
    1. Přejděte na [api.slack.com/apps](https://api.slack.com/apps)
    2. Klikněte na **Create New App**
    3. Vyberte **From scratch**
    4. Zadejte název aplikace (např. „Living Security“)
    5. Vyberte svůj pracovní prostor
    6. Klikněte na **Create App**

    <Check>
      Vaše aplikace se zobrazí na nástěnce Slack API.
    </Check>
  </Step>

  <Step title="Nakonfigurujte rozsahy OAuth">
    1. V levém postranním panelu klikněte na **OAuth & Permissions**
    2. Přejděte k části **Bot Token Scopes**
    3. Přidejte následující rozsahy:

    | Rozsah | Účel |
    | - | - |
    | `chat:write` | Odesílání zpráv do kanálů |
    | `chat:write.public` | Odesílání zpráv do kanálů bez připojení k nim |
    | `users:read` | Vyhledávání informací o uživatelích |
    | `users:read.email` | Párování uživatelů podle e-mailové adresy |

    <Tip>
      Přidejte pouze rozsahy, které vaše organizace potřebuje. Méně rozsahů znamená vyšší zabezpečení.
    </Tip>
  </Step>

  <Step title="Nainstalujte aplikaci do pracovního prostoru">
    1. Přejděte na začátek stránky **OAuth & Permissions**
    2. Klikněte na **Install to Workspace**
    3. Zkontrolujte oprávnění a klikněte na **Allow**

    <Check>
      Zobrazí se **Bot User OAuth Token** začínající `xoxb-`.
    </Check>
  </Step>

  <Step title="Získejte signing secret">
    1. V levém postranním panelu klikněte na **Basic Information**
    2. Přejděte k části **App Credentials**
    3. Zkopírujte **Signing Secret**

    <Warning>
      Signing secret uchovávejte v tajnosti. Nikdy jej nesdílejte ve veřejných repozitářích ani v protokolech.
    </Warning>
  </Step>
</Steps>

## Přidání přihlašovacích údajů do Living Security

<Steps>
  <Step title="Přejděte do odchozích integrací">
    Přejděte do **Nastavení → Integrace → Odchozí** a klikněte na kartu **Slack**.
  </Step>

  <Step title="Přidejte své přihlašovací údaje">
    Klikněte na **Add Credential** a zadejte:

    <ParamField body="botToken" type="string" required>
      Váš Bot User OAuth Token začínající `xoxb-`. Najdete jej v části **OAuth & Permissions**.
    </ParamField>

    <ParamField body="signingSecret" type="string" required>
      Signing Secret vaší aplikace. Najdete jej v části **Basic Information → App Credentials**.
    </ParamField>

    <ParamField body="appToken" type="string">
      Volitelné. Vyžaduje se pouze pro připojení v režimu Socket Mode. Začíná `xapp-`.
    </ParamField>

    <ParamField body="label" type="string">
      Volitelné. Popisný název tohoto přihlašovacího údaje (např. „Production Slack“).
    </ParamField>
  </Step>

  <Step title="Uložte a ověřte">
    Klikněte na **Uložit**. Přihlašovací údaj se zobrazí ve vašem seznamu se stavem **aktivní**.

    <Check>
      Vaše integrace Slack je nyní připojena a připravena odesílat oznámení.
    </Check>
  </Step>
</Steps>

## Typy oznámení

Po připojení může Living Security odesílat do Slacku následující typy oznámení:

| Oznámení | Popis |
| - | - |
| Přidělení školení | Upozornění uživatelů na nově přidělené školení |
| Připomenutí školení | Připomenutí blížících se termínů uživatelům |
| Potvrzení dokončení | Potvrzení dokončení školení |
| Bezpečnostní upozornění | Informování bezpečnostních týmů o rizikových událostech |
| Souhrny Playbooků | Odesílání pravidelných aktualizací o výkonu Playbooků |

## Řešení potíží

<AccordionGroup>
  <Accordion title="Zprávy se v kanálech nezobrazují">
    * Ověřte, že byl bot do kanálu pozván (`/invite @YourBotName`)
    * Zkontrolujte, zda je přidán rozsah `chat:write.public` pro odesílání do veřejných kanálů bez připojení k nim
    * Ověřte, že je ID kanálu správné (použijte ID kanálu, nikoli jeho název)
  </Accordion>

  <Accordion title="Chyba neplatného tokenu">
    * Ujistěte se, že jste zkopírovali celý token začínající `xoxb-`
    * Ověřte, že je aplikace stále nainstalována ve vašem pracovním prostoru
    * Zkontrolujte, zda token nebyl znovu vygenerován (vyžaduje aktualizaci v Living Security)
  </Accordion>

  <Accordion title="Omezení četnosti požadavků">
    Slack omezuje počet požadavků API. Pokud se zobrazí chyby omezení četnosti:

    * Snižte frekvenci oznámení
    * Sloučte více oznámení do souhrnných zpráv
    * Pro případy s vysokým objemem kontaktujte podporu
  </Accordion>
</AccordionGroup>

## Doporučené postupy

<Tip>
  Vytvořte vyhrazený kanál Slack pro oznámení z Living Security (např. `#security-training`), aby byla upozornění přehledná a ve společných kanálech nevznikal zbytečný šum.
</Tip>

* Při správě více pracovních prostorů používejte smysluplné popisky přihlašovacích údajů
* Pravidelně kontrolujte, které kanály oznámení přijímají
* U upozornění s vysokým objemem nastavte souhrnná oznámení namísto jednotlivých zpráv
* Čtvrtletně kontrolujte oprávnění aplikace Slack a odstraňte nepoužívané rozsahy

## Související

<CardGroup cols={2}>
  <Card title="Integrace e-mailu" icon="envelope" href="/cs/integrations/outbound/email">
    Nakonfigurujte e-mail jako kanál doručování.
  </Card>

  <Card title="Integrace Teams" icon="microsoft" href="/cs/integrations/outbound/teams">
    Nakonfigurujte Microsoft Teams jako kanál doručování.
  </Card>

  <Card title="Protokol komunikace" icon="clock-rotate-left" href="/cs/features/communications/log">
    Sledujte stav a historii doručování do Slacku.
  </Card>

  <Card title="Jak nastavit novou integraci" icon="plug" href="/cs/integrations/managing/setup">
    Obecný průvodce nastavením integrace.
  </Card>
</CardGroup>


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