Nastavení integrace Abnormal Security

Čím tato integrace přispívá

Abnormal Security může poskytovat normalizovaná data o e-mailových hrozbách, doručování, blokování a hlášení ze strany zaměstnanců. Mezi prověřené příklady patří:

phishing.real.blocked — skutečný phishing zablokovaný před doručením
phishing.real.delivered — skutečný phishing doručený do schránky
phishing.real.reported — nahlašuje skutečné phishingové e-maily

Tyto příklady ukazují typy normalizované aktivity, které může Living Security využívat. Viz jak se data z integrací mění na signály.

Co Living Security potřebuje

Přihlašovací údaj	Popis
Klíč API	Nosný token (bearer token) rozhraní REST API vygenerovaný v portálu Abnormal Portal
Regionální hostitel API	Název hostitele vašeho prostředí Abnormal Security

Rozsahy oprávnění: Vlastní přístup (Custom Access) s oprávněním Čtení pro Abuse Campaigns (AI Security Mailbox) a Threats Požadovaná role: Security Admin nebo Super Admin v Abnormal Security

Předpoklady

Pro vytváření a správu tokenů API musíte mít v Abnormal Security přístup Security Admin nebo Super Admin.

Část A — V Abnormal Security

Tyto kroky provádí váš správce Abnormal Security.

Přejděte do správy tokenů API

Přihlaste se do svého portálu Abnormal Security.
V levé navigaci klikněte na Nastavení a poté vyberte Integrace.

Nabídka Nastavení v Abnormal Security s možností Integrace

Na stránce Integrace sjeďte dolů do sekce API Token Management v dolní části.
Klikněte na + Create New Token.

Sekce API Token Management s tlačítkem Create New Token

Vyberte typ integrace

Jako typ integrace vyberte REST API a klikněte na Další.

Zvolte rozsah tokenu

Zvolte rozsah tokenu a klikněte na Další:

Zákazník (všichni stávající i budoucí tenanti) — Tuto možnost použijte, pokud váš účet Abnormal spravuje více tenantů. Tento token automaticky pokrývá všechny stávající i budoucí tenanty.
Tenant (jeden tenant) — Tuto možnost použijte, pokud chcete token omezit na jednoho konkrétního tenanta.

Pro většinu organizací s jedním tenantem Abnormal funguje kterákoli možnost. Pokud si nejste jisti, vyberte Zákazník.

Udělte požadovaný přístup

Vyberte Custom Access a povolte Čtení pro obě skupiny koncových bodů:

Skupina koncových bodů	Požadovaná úroveň přístupu
Abuse Campaigns (AI Security Mailbox)	Čtení
Threats	Čtení

Poté klikněte na Další.

Přístup Čtení vrací data o hrozbách a kampaních, která nejsou citlivá. Read Sensitive navíc zpřístupňuje osobní údaje (PII), přílohy a data zaměstnanců. Zápis odesílá akce nápravy. Udělte pouze Čtení, pokud váš případ použití výslovně nevyžaduje více.

Nakonfigurujte podrobnosti tokenu a seznam povolených IP adres

Vyplňte následující pole:

Token Name — Popisný název (např. Living Security Platform)
Popis — Volitelný kontext (např. Read access for Living Security HRM platform)
Token Expiry — Zvolte 90, 180 nebo 365 dní podle vaší rotační politiky. Nastavte si v kalendáři připomínku, abyste token obnovili před vypršením jeho platnosti.
IP Safelist — Zadejte rozsahy odchozích IP adres Living Security, každý do samostatné položky. Po každém klikněte na Přidat.

Seznam povolených IP adres je povinný. Abnormal Security odmítá všechny požadavky API z adres, které nejsou na seznamu povolených. Dialog připojení proběhne úspěšně, ale synchronizace dat bude končit chybou 401 Unauthorized, dokud nebudou správné IP adresy povoleny.

Poté klikněte na Další.

Zkontrolujte a vytvořte token

Zkontrolujte souhrn konfigurace tokenu a klikněte na Create Token.

Zkopírujte a uložte token

Token okamžitě zkopírujte a uložte jej na bezpečné místo (např. do trezoru hesel nebo správce tajných klíčů), poté klikněte na Hotovo.

Dialog pro zkopírování tokenu s vygenerovaným tokenem

Portál Abnormal Portal zobrazí hodnotu tokenu pouze jednou. Pokud stránku opustíte, aniž byste token zkopírovali, musíte vytvořit nový token a starý zrušit.

Zjistěte svého regionálního hostitele API

Určete správného hostitele API pro vaše prostředí Abnormal Security:

Prostředí	Regionální hostitel API
Výchozí (komerční USA)	`api.abnormalplatform.com`
EU	`eu.rest.abnormalsecurity.com`
FedRAMP	`rest.abnormalsecurity.us`

Zadejte pouze hostitele — bez předpony https:// a bez koncového lomítka.Pokud si nejste jisti, které prostředí vaše organizace používá, zkontrolujte adresu URL svého portálu Abnormal nebo kontaktujte svůj účetní tým Abnormal Security.

Část B — V Living Security Platform

Tento krok provádí vlastník programu, případně správce systému, pokud se používá delegované nastavení.

Nyní jste připojeni k Abnormal Security.

Řešení potíží

403 Forbidden — Nemáte oprávnění provést tuto akci

Tokenu chybí jedno nebo obě požadovaná přístupová oprávnění (Abuse Campaigns nebo Threats). Typ integrace, rozsah ani úroveň přístupu nelze po vytvoření tokenu změnit — musíte vytvořit nový token se správným nastavením a starý zrušit.

401 Unauthorized

Buď je token neplatný či jeho platnost vypršela, nebo IP adresa požadavku není na seznamu povolených. Zkontrolujte:

Token nebyl zrušen a jeho platnost nevypršela
Všechny čtyři odchozí IP adresy Living Security jsou na seznamu povolených

Pokud synchronizace dříve fungovaly, ale nyní končí chybou 401, mohly se odchozí IP adresy změnit — projděte si Konfigurace odchozích IP adres integrací a ověřte, že seznam povolených odpovídá.

Vypršení platnosti starších tokenů (30. dubna 2027)

Pokud má vaše organizace tokeny API vytvořené před zavedením samoobslužné správy tokenů, zobrazují se na nástěnce jako Legacy. Starší tokeny nadále fungují, ale nelze je obnovit — lze aktualizovat pouze jejich seznam povolených IP adres. Platnost všech starších tokenů automaticky vyprší 30. dubna 2027. Před tímto datem je naplánujte nahradit novými tokeny.

Integrace