Skip to main content

​
Wat deze integratie bijdraagt

Adaptive Security kan gegevens over het personeelsbestand, trainingen en resultaten van simulaties via meerdere kanalen aanleveren. Beoordeelde voorbeelden zijn:
  • phishing.simulation.clicked — heeft op een gesimuleerde e-mail geklikt zonder deze te melden
  • phishing.simulation.credential.submitted — heeft inloggegevens ingevoerd op een gesimuleerde inlogpagina
  • phishing.simulation.attachment.opened — heeft een bijlage van een gesimuleerde e-mail geopend
  • phishing.simulation.reported — heeft een gesimuleerde e-mail gemeld
  • smishing.simulation.replied — heeft geantwoord op een gesimuleerd sms-bericht
  • vishing.simulation.succeeded — heeft gevolg gegeven aan een gesimuleerde beller
  • training.assigned — kreeg een securitytraining toegewezen
  • training.completed — heeft een securitytraining afgerond
  • training.past.due — heeft een trainingsdeadline gemist
Deze voorbeelden tonen de soorten genormaliseerde activiteit die Living Security kan gebruiken. Zie hoe integratiegegevens signalen worden.
Adaptive simuleert via drie kanalen en Living Security beoordeelt elk kanaal afzonderlijk. E-mailresultaten tellen mee als phishing, resultaten van sms-berichten als smishing en resultaten van telefoongesprekken als vishing. Iemand die op een gesimuleerde e-mail klikt en iemand die antwoordt op een gesimuleerd sms-bericht worden niet gemeten als hetzelfde gedrag, omdat de afweging die iemand daarbij maakt verschilt.

​
Wat Living Security nodig heeft

Vereiste rol: Een beheerder van uw Adaptive Security-account met toegang tot Settings → API. Adaptive regelt API-toegang via rolgebaseerde machtigingen, dus het token moet behoren bij een rol die gebruikers, phishing en training kan lezen. Toegang: Alleen-lezen. Living Security leest alleen uit Adaptive Security en maakt, wijzigt of verwijdert nooit iets in uw account.

​
Wat Living Security ophaalt

Telefoonnummers worden niet opgeslagen. Adaptive geeft kantoor- en mobiele nummers terug in het gebruikersrecord. Living Security verwijdert beide voordat er iets wordt opgeslagen, omdat geen enkele functie van Living Security ze gebruikt.
De eigen risicoscore van Adaptive wordt vastgelegd maar nooit gebruikt voor scoring. Adaptive berekent per persoon een current_risk_score. Living Security bewaart deze zodat u beide systemen naast elkaar kunt vergelijken, maar de Menselijke risico-index wordt altijd berekend op basis van waargenomen gedrag met behulp van het eigen gepubliceerde model van Living Security — nooit op basis van de samengestelde score van een andere leverancier.

​
Vereisten

  • Een Adaptive Security-account waarvoor de API is ingeschakeld.
  • Beheerderstoegang tot admin.adaptivesecurity.com.
  • E-mailadressen van gebruikers in Adaptive die overeenkomen met de adressen die uw andere gekoppelde systemen gebruiken. Living Security koppelt een Adaptive-gebruiker via het e-mailadres aan een persoon.

​
Deel A — In Adaptive Security

Uw Adaptive Security-beheerder voert deze stappen uit.
1

Open de API-instellingen

  1. Meld u als beheerder aan bij admin.adaptivesecurity.com.
  2. Ga naar Settings → API.
2

Genereer het API-token

  1. Genereer een nieuw API-token.
  2. Geef het een naam die u later herkent — bijvoorbeeld Living Security.
  3. Controleer of de rol van het token gebruikers, phishingcampagnes en trainingscampagnes kan lezen.
  4. Kopieer het token.
Kopieer het token voordat u de pagina verlaat. Als uw Adaptive-account een vervaldatum voor het token instelt, noteer dan de datum — Living Security kan na het verlopen geen gegevens meer ophalen en de koppeling moet dan worden bijgewerkt met een nieuw token.

​
Deel B — In het Living Security Platform

De programma-eigenaar voert deze stap uit, of de systeembeheerder bij gedelegeerde installatie.
U bent nu verbonden met Adaptive Security.

​
Hoe vaak gegevens worden opgehaald

De rapportage-API van Adaptive biedt geen filter voor “wat is er gewijzigd sinds”, dus Living Security leest elke simulatie- en trainingscampagne zolang er nog resultaten uit voortkomen, en stopt met lezen twee weken nadat de campagne is gesloten. Late klikken en late meldingen worden zo nog steeds vastgelegd, en afgeronde campagnes worden niet eindeloos opnieuw gelezen.
Een eerste koppeling met een groot Adaptive-account kan meerdere geplande uitvoeringen nodig hebben om alles in te lezen. Elke uitvoering leest zoveel mogelijk en de volgende gaat verder waar de vorige is gestopt, waardoor de aantallen gedurende de eerste dag of twee oplopen in plaats van in één keer te verschijnen.

​
Probleemoplossing

Het API-token is onjuist, verlopen of ingetrokken. Adaptive geeft bij deze fout een lege response body terug, dus er zijn geen verdere details te lezen. Genereer een nieuw token via Settings → API en maak opnieuw verbinding met dat token. Een gedeeltelijk gekopieerd token veroorzaakt dezelfde fout en is de meest voorkomende oorzaak.
Het token is geauthenticeerd, maar de bijbehorende rol kan de gevraagde gegevens niet lezen. Hetzelfde token opnieuw plakken helpt niet. Controleer in Adaptive of de rol van het token leestoegang heeft tot gebruikers, phishing en training, of geef een token uit vanuit een rol die dat wel heeft.
Adaptive heeft de verbinding beperkt via een rate limit. Living Security stopt die uitvoering en hervat op dezelfde plek bij de volgende geplande uitvoering, dus er gaan geen gegevens verloren — de aantallen lopen alleen langzamer op. Als dit dagenlang aanhoudt, neem dan contact op met de support van Adaptive Security om te vragen naar de rate limit die voor uw account geldt.
Controleer of de campagnes die u verwacht daadwerkelijk zijn uitgevoerd. Adaptive rapporteert inschrijvingen alleen voor simulaties die zijn verzonden, dus een campagne met de status Draft of Scheduled levert niets op totdat deze is verstuurd. Living Security leest die bewust niet, zodat het aantal verzoeken wordt besteed aan campagnes met daadwerkelijke resultaten.
Living Security bepaalt het kanaal van elk resultaat aan de hand van het bijbehorende scenario. Als een scenario in Adaptive is verwijderd nadat de simulatie is uitgevoerd, worden de resultaten vastgelegd onder het e-mailkanaal, omdat het kanaal niet meer kan worden gelezen. Dit voorkomt u door buiten gebruik gestelde scenario’s in Adaptive te bewaren in plaats van ze te verwijderen.