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

# Einrichtung der Adaptive-Security-Integration

> Verbinden Sie Adaptive Security mit der Living Security Platform, um Ergebnisse von Phishing-, Smishing- und Vishing-Simulationen sowie Ergebnisse von Security-Awareness-Schulungen für Ihre Belegschaft zu importieren.

export const PublicIntegrationNextSteps = () => <>
    <hr />
    <h2>Weiterführende Ressourcen</h2>
    <ul>
      <li>
        <a href="/de/signals/data-sources">Erfahren Sie, wie Daten aus Integrationen zu Signalen für das Human Risk Management werden</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/integrations">Living Security Integrationen entdecken</a>
      </li>
      <li>
        <a href="https://app.livingsecurity.ai/">Living Security Platform öffnen</a>
      </li>
      <li>
        <a href="https://www.livingsecurity.com/request-demo/">Living Security Demo anfordern</a>
      </li>
    </ul>
  </>;

export const ConnectInPlatform = ({tile, children}) => <Step title="Zugangsdaten in der Living Security Platform eingeben">
    <p>
      Wird von der Person durchgeführt, die über Living Security-Zugriff verfügt – dem Programmverantwortlichen oder dem Systemadministrator, sofern dieser eingeladen wurde (delegierte Einrichtung).
    </p>
    <ol>
      <li>
        Gehen Sie zu <strong>Einstellungen → Integrationen → Catalog</strong>, suchen Sie die Kachel{' '}
        <strong>{tile}</strong> und klicken Sie auf <strong>Verbinden</strong>.
      </li>
      <li>
        Füllen Sie die folgenden Felder aus und klicken Sie anschließend auf <strong>Verbinden</strong>.
      </li>
    </ol>
    {children}
  </Step>;

export const SystemAdminBanner = ({system, recommendDelegated}) => <Note>
    <p>
      <strong>Diese Anleitung richtet sich an Ihre {system}-Administratorin bzw. Ihren {system}-Administrator.</strong> Sie beschreibt das Erstellen von API-Zugangsdaten in {system}. Dafür ist Administratorzugriff auf {system} erforderlich – nicht auf die
      Living Security Platform.
    </p>
    <p>
      Wenn Sie als <strong>Programmverantwortlicher</strong> von Living Security {system} nicht selbst administrieren,
      leiten Sie diese Seite an die zuständige Person weiter. Diese führt Teil A durch und übergibt Ihnen die Zugangsdaten
      (oder gibt sie direkt ein, sofern Sie sie in die Plattform eingeladen haben).
      {recommendDelegated && <>
          {' '}Da bei der Einrichtung sensibles Schlüsselmaterial entsteht, empfehlen wir den Weg der{' '}
          <strong>delegierten Einrichtung</strong>, damit das Secret nie an Sie zurückgesendet wird.
        </>}
    </p>
  </Note>;

<SystemAdminBanner system="Adaptive Security" />

## Was diese Integration beiträgt

Adaptive Security kann Daten zur Belegschaft, zu Schulungen und zu Ergebnissen kanalübergreifender Simulationen beisteuern. Geprüfte Beispiele sind:

* `phishing.simulation.clicked` – hat auf eine simulierte E-Mail geklickt, ohne sie zu melden
* `phishing.simulation.credential.submitted` – hat Zugangsdaten auf einer simulierten Anmeldeseite eingegeben
* `phishing.simulation.attachment.opened` – hat einen Anhang einer simulierten E-Mail geöffnet
* `phishing.simulation.reported` – hat eine simulierte E-Mail gemeldet
* `smishing.simulation.replied` – hat auf eine simulierte Textnachricht geantwortet
* `vishing.simulation.succeeded` – ist der Aufforderung eines simulierten Anrufers nachgekommen
* `training.assigned` – wurde eine Sicherheitsschulung zugewiesen
* `training.completed` – hat eine Sicherheitsschulung abgeschlossen
* `training.past.due` – hat eine Schulungsfrist versäumt

Diese Beispiele zeigen die Arten normalisierter Aktivitäten, die Living Security verwenden kann. Weitere Informationen finden Sie unter [Wie Integrationsdaten zu Signalen werden](/de/signals/data-sources).

<Note>
  **Adaptive simuliert über drei Kanäle, und Living Security bewertet jeden Kanal separat.**
  Ergebnisse aus E-Mails werden als Phishing bewertet, Ergebnisse aus Textnachrichten als Smishing und Ergebnisse aus Telefonanrufen als Vishing. Eine Person, die auf eine simulierte E-Mail klickt, und eine Person, die auf eine simulierte Textnachricht antwortet, werden nicht als dasselbe Verhalten gemessen, da die jeweils getroffene Entscheidung eine andere ist.
</Note>

## Was Living Security benötigt

| Zugangsdaten | Beschreibung |
| - | - |
| **API-Token** | Ein API-Token von Adaptive Security. Living Security sendet es bei jeder Anfrage als Bearer-Token. |

**Erforderliche Rolle:** Ein Administrator in Ihrem Adaptive-Security-Konto mit Zugriff auf
**Settings → API**. Adaptive steuert den API-Zugriff über rollenbasierte Berechtigungen, daher muss das Token zu einer Rolle gehören, die Benutzer, Phishing und Schulungen lesen darf.

**Zugriff:** Nur Lesezugriff. Living Security liest ausschließlich Daten aus Adaptive Security und erstellt, ändert oder löscht niemals etwas in Ihrem Konto.

### Was Living Security abruft

| Daten | Detail |
| - | - |
| **Leute** | Ihr Adaptive-Benutzerverzeichnis: Name, E-Mail-Adresse, Abteilung, Berufsbezeichnung, Name und E-Mail-Adresse der Führungskraft, Standort, Division, Beschäftigungsstatus und Eintrittsdatum. |
| **E-Mail-Simulationen** | Pro Person und Simulation: wann die Nachricht zugestellt, geöffnet, angeklickt und beantwortet wurde, wann ihr Anhang geöffnet, ihr QR-Code gescannt oder Zugangsdaten eingegeben wurden oder wann sie gemeldet wurde. |
| **Textnachrichten-Simulationen** | Pro Person und Simulation: zugestellt, geöffnet, angeklickt, beantwortet, Zugangsdaten eingegeben oder gemeldet. |
| **Sprachanruf-Simulationen** | Pro Person und Simulation: der zugestellte Köder, die angerufene Nummer, ob die Person der Aufforderung des Anrufers nachgekommen ist und ob sie den Anruf gemeldet hat. |
| **Schulung** | Pro Person und Kampagne: wann die Person angemeldet wurde, wann die Schulung fällig war, wann sie begonnen und wann sie abgeschlossen wurde und ob die Person die Richtlinie der Kampagne bestätigt hat. |

<Note>
  **Telefonnummern werden nicht gespeichert.** Adaptive liefert im Benutzerdatensatz Büro- und Mobilnummern. Living Security verwirft beide, bevor etwas gespeichert wird, da keine Funktion von Living Security sie verwendet.
</Note>

<Note>
  **Der Risikowert von Adaptive wird erfasst, aber nie zur Bewertung herangezogen.** Adaptive berechnet pro Person einen
  `current_risk_score`. Living Security behält ihn, damit Sie beide Systeme direkt miteinander vergleichen können. Der Human Risk Index wird jedoch stets aus beobachtetem Verhalten mithilfe des veröffentlichten Modells von Living Security berechnet – niemals aus dem zusammengesetzten Wert eines anderen Anbieters.
</Note>

### Voraussetzungen

* Ein Adaptive-Security-Konto mit aktivierter API.
* Administratorzugriff auf [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com).
* E-Mail-Adressen der Benutzer in Adaptive, die mit den Adressen übereinstimmen, die Ihre anderen verbundenen Systeme verwenden. Über die E-Mail-Adresse ordnet Living Security einen Adaptive-Benutzer einer Person zu.

***

## Teil A – In Adaptive Security

*Diese Schritte führt Ihr Adaptive-Security-Administrator durch.*

<Steps>
  <Step title="API-Einstellungen öffnen">
    1. Melden Sie sich als Administrator bei [admin.adaptivesecurity.com](https://admin.adaptivesecurity.com) an.
    2. Gehen Sie zu **Settings → API**.
  </Step>

  <Step title="API-Token generieren">
    1. Generieren Sie ein neues API-Token.
    2. Vergeben Sie einen Namen, den Sie später wiedererkennen – zum Beispiel `Living Security`.
    3. Bestätigen Sie, dass die Rolle des Tokens Benutzer, Phishing-Kampagnen und Schulungskampagnen lesen darf.
    4. Kopieren Sie das Token.

    <Warning>
      Kopieren Sie das Token, bevor Sie die Seite verlassen. Wenn Ihr Adaptive-Konto für das Token ein Ablaufdatum festlegt, notieren Sie sich das Datum – nach Ablauf kann Living Security keine Daten mehr abrufen, und die Verbindung muss mit einem neuen Token aktualisiert werden.
    </Warning>
  </Step>
</Steps>

***

## Teil B – In der Living Security Platform

*Diesen Schritt führt der Programmverantwortliche durch, bei delegierter Einrichtung der Systemadministrator.*

<Steps>
  <ConnectInPlatform tile="Adaptive Security">
    | Feld | Wert |
    | - | - |
    | **API-Token** | Das Token, das Sie in Teil A generiert haben |
  </ConnectInPlatform>
</Steps>

Sie sind nun mit Adaptive Security verbunden.

***

## Wie oft Daten abgerufen werden

| Daten | Zeitplan |
| - | - |
| Leute | Alle 6 Stunden |
| Simulationsergebnisse (E-Mail, Textnachricht, Sprachanruf) | Alle 6 Stunden |
| Schulungsergebnisse | Alle 6 Stunden |

Die Reporting-API von Adaptive bietet keinen Filter für „Änderungen seit“. Daher liest Living Security jede Simulations- und Schulungskampagne, solange sie noch Ergebnisse liefert, und beendet das Lesen, sobald die Kampagne seit zwei Wochen geschlossen ist. Späte Klicks und späte Meldungen werden somit weiterhin erfasst, und abgeschlossene Kampagnen werden nicht endlos erneut gelesen.

<Note>
  Bei der ersten Verbindung eines großen Adaptive-Kontos kann es mehrere geplante Durchläufe dauern, bis alles gelesen ist. Jeder Durchlauf liest so viel wie möglich, und der nächste setzt dort fort, wo der vorherige aufgehört hat. Die Zahlen steigen daher im Laufe des ersten Tages oder der ersten zwei Tage an, statt auf einmal zu erscheinen.
</Note>

***

## Fehlerbehebung

<AccordionGroup>
  <Accordion title="401 Unauthorized">
    Das API-Token ist falsch, abgelaufen oder wurde widerrufen. Adaptive gibt bei diesem Fehler einen leeren Antworttext zurück, sodass keine weiteren Details vorliegen. Generieren Sie unter
    **Settings → API** ein neues Token und stellen Sie die Verbindung damit erneut her. Ein unvollständig kopiertes Token führt zum selben Fehler und ist die häufigste Ursache.
  </Accordion>

  <Accordion title="403 Forbidden">
    Das Token wurde authentifiziert, aber seine Rolle darf die angeforderten Daten nicht lesen. Das erneute Einfügen desselben Tokens hilft nicht. Prüfen Sie in Adaptive, ob die Rolle des Tokens Lesezugriff auf Benutzer, Phishing und Schulungen hat, oder stellen Sie ein Token aus einer Rolle aus, die darüber verfügt.
  </Accordion>

  <Accordion title="429 Too Many Requests">
    Adaptive hat die Verbindung aufgrund einer Ratenbegrenzung gedrosselt. Living Security beendet diesen Durchlauf und setzt beim nächsten geplanten Durchlauf an derselben Stelle fort, sodass keine Daten verloren gehen – die Zahlen steigen lediglich langsamer an. Wenn das über mehrere Tage anhält, wenden Sie sich an den Support von Adaptive Security und fragen Sie nach der Ratenbegrenzung, die für Ihr Konto gilt.
  </Accordion>

  <Accordion title="Leute werden angezeigt, aber keine Simulationsergebnisse">
    Prüfen Sie, ob die erwarteten Kampagnen tatsächlich durchgeführt wurden. Adaptive meldet Anmeldungen nur für Simulationen, die versendet wurden. Eine Kampagne mit dem Status **Entwurf** oder **Geplant** liefert daher nichts, bis sie versendet wird. Living Security liest diese Kampagnen bewusst nicht, damit das Anfragebudget für Kampagnen mit tatsächlichen Ergebnissen verwendet wird.
  </Accordion>

  <Accordion title="Sprachanruf- oder Textnachrichten-Simulationen fehlen">
    Living Security bestimmt den Kanal jedes Ergebnisses anhand des zugehörigen Szenarios. Wurde ein Szenario in Adaptive gelöscht, nachdem seine Simulation durchgeführt wurde, werden seine Ergebnisse dem E-Mail-Kanal zugeordnet, da sich der Kanal nicht mehr auslesen lässt. Sie vermeiden das, indem Sie nicht mehr genutzte Szenarien in Adaptive behalten, statt sie zu löschen.
  </Accordion>
</AccordionGroup>

<PublicIntegrationNextSteps />


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