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

# Integration einrichten

> Bereiten Sie die Zugangsdaten des Anbieters vor, verbinden Sie ein unterstütztes System, aktivieren Sie die zugehörigen Datenströme und überprüfen Sie die erste erfolgreiche Synchronisierung.

Diese Anleitung beschreibt den allgemeinen Einrichtungsablauf für Integrationen, die unter **Einstellungen → Integrationen → Katalog** aufgeführt sind. Anbieterspezifische Felder, Berechtigungen und Authentifizierungsschritte entnehmen Sie der Einrichtungsanleitung, die auf der Katalogkarte des jeweiligen Anbieters verlinkt ist.

## Voraussetzungen

| Rolle | Verantwortung |
| - | - |
| [**Programmverantwortlicher**](/de/reference/glossary#programmverantwortlicher) | Wählt die Quelle aus, verbindet sie in Living Security, aktiviert Datenströme und überprüft das Ergebnis |
| [**Systemadministrator**](/de/reference/glossary#systemadministrator) | Erstellt oder genehmigt Zugangsdaten und Berechtigungsbereiche (Scopes) im Quellsystem |

Diese Rollen können von derselben Person wahrgenommen werden. Die Person, die die Zugangsdaten in Living Security eingibt, muss über eine Administratorrolle verfügen, die die Verwaltung von Integrationen erlaubt. Laden Sie keinen Administrator des Quellsystems allein in der Annahme in Living Security ein, es gebe eine eng begrenzte Einrichtungsrolle.

Vor dem Start:

* Wählen Sie die Living Security-Organisation und die Umgebung aus, zu der die Verbindung gehört.
* Öffnen Sie die Katalog-Anleitung des Anbieters und notieren Sie die erforderlichen Scopes, Weiterleitungs-URLs und Allowlist-Anforderungen.
* Verwenden Sie den von Ihrer Organisation genehmigten Prozess zum Austausch von Geheimnissen, wenn unterschiedliche Personen die Zugangsdaten erstellen und eingeben.
* Senden Sie niemals Passwörter, Client-Secrets, private Schlüssel oder Zugriffsschlüsselwerte per E-Mail oder in einem Support-Ticket.

## 1. Zugangsdaten des Anbieters vorbereiten

Öffnen Sie **Einstellungen → Integrationen → Katalog**, suchen Sie den Anbieter und lesen Sie dessen Einrichtungsanleitung, bevor Sie Zugangsdaten erstellen.

Die Authentifizierung beim Anbieter kann per OAuth-Zustimmung, API-Token, Client-ID und Client-Secret, Dienstkonto oder über eine andere vom Anbieter unterstützte Methode erfolgen. Erstellen Sie nur die Zugangsdaten und Scopes, die in der Anleitung des jeweiligen Anbieters genannt werden.

<Warning>
  Übernehmen Sie keine Berechtigungen von einem anderen Anbieter und vergeben
  Sie keine weitreichenden Schreibrechte „für alle Fälle“. Fehlende
  Berechtigungen führen in der Regel zu einem eindeutigen Fehler 401 oder 403,
  der sich beheben lässt; übermäßige Berechtigungen schaffen ein vermeidbares
  Risiko.
</Warning>

## 2. Anbieter verbinden

<Steps>
  <Step title="Katalog öffnen">
    Wechseln Sie zu **Einstellungen → Integrationen → Katalog** und wählen Sie den Anbieter aus.
  </Step>

  <Step title="Verbindung starten">
    Wählen Sie **Verbinden**. Durchlaufen Sie den OAuth-Ablauf oder geben Sie die
    im Verbindungsdialog abgefragten Felder ein. Die Anleitung des Anbieters
    erklärt, woher die einzelnen Werte stammen.
  </Step>

  <Step title="Authentifizierung abschließen">
    Bestätigen Sie gegebenenfalls den Zustimmungsbildschirm des Anbieters. Nach erfolgreicher Authentifizierung öffnet Living Security die neue Verbindung oder listet sie unter **Verbunden** auf.
  </Step>
</Steps>

Wenn der Anbieter die Authentifizierung ablehnt, brechen Sie den Vorgang ab und korrigieren Sie Zugangsdaten, Mandant, Region, Weiterleitungs-URL oder Berechtigungen im Quellsystem, bevor Sie fortfahren.

## 3. Datenströme aktivieren

Öffnen Sie die Verbindung unter **Einstellungen → Integrationen → Verbunden**. Living Security ermittelt die für diesen Anbieter verfügbaren Synchronisierungsvorlagen und listet sie als Datenströme auf.

1. Prüfen Sie Name und Zweck jedes Datenstroms.
2. Aktivieren Sie nur die Datenströme, die Ihr Programm benötigt.
3. Lassen Sie nicht benötigte Datenströme pausiert.
4. Verwenden Sie **Jetzt synchronisieren**, sofern verfügbar, um den ersten Lauf anzufordern.

Nicht jeder Anbieter bietet dieselben Datenströme oder Steuerungsmöglichkeiten für den Zeitplan. Richten Sie sich nach den Steuerelementen, die an der Verbindung angezeigt werden, und erwarten Sie keinen einheitlichen Assistenten für Häufigkeit, Umfang, Feldzuordnung, Entwurf oder Aktivierung.

## 4. Ersten Lauf überprüfen

Die erfolgreiche Authentifizierung der Verbindung allein belegt nicht, dass Daten fließen.

<Steps>
  <Step title="Zustand der Verbindung prüfen">
    Vergewissern Sie sich, dass die Verbindung fehlerfrei ist und keine erneute Autorisierung verlangt.
  </Step>

  <Step title="Zustand des Datenstroms prüfen">
    Vergewissern Sie sich, dass der benötigte Datenstrom aktiviert und nicht pausiert ist.
  </Step>

  <Step title="Letzten Lauf untersuchen">
    Öffnen Sie den Datenstrom, den Synchronisierungslink der Verbindung oder **Einstellungen** → **Integrationen** → **synchronisiert**. Warten Sie auf ein erfolgreiches Endergebnis und prüfen Sie Anbieterfehler und, sofern verfügbar, die Anzahl der Datensätze.
  </Step>

  <Step title="Nachgelagerte Daten bestätigen">
    Öffnen Sie den betreffenden Bereich in Living Security. Identitätsdaten sollten die erwarteten Personen und Identitäten in der Belegschaft erzeugen; Daten aus Sicherheitsquellen sollten in der Funktion erscheinen, die in der Dokumentation des jeweiligen Anbieters beschrieben ist.
  </Step>
</Steps>

Beim Onboarding werden die Aufgaben **Datenfluss der Identitätsdaten überprüfen** und **Datenfluss der Integrationsdaten überprüfen** in der Journey Map anhand der aufgenommenen Daten abgeschlossen. Ersetzen Sie diese Prüfergebnisse nicht durch eine gespeicherte Verbindung.

## Detailseite einer Synchronisierung

Unter **Einstellungen** → **Integrationen** → **synchronisiert** können Sie eine beliebige Synchronisierung öffnen, um ihre Konfiguration und den Laufverlauf an einer Stelle einzusehen.

Die Detailseite zeigt Folgendes:

| Abschnitt | Inhalt |
| - | - |
| **Kopfbereich** | Name der Synchronisierung, Statusanzeige und Integrationsanbieter |
| **Statistiken** | Modell, letzte Synchronisierung, abgeschlossene Läufe und Gesamtzahl der Datensätze |
| **Laufverlauf** | Letzte Läufe mit Status, Zeitangaben und Anzahl der Datensätze |
| **Aktionen** | **Aktualisieren**, **Pausieren** / **Lebenslauf** und **Jetzt synchronisieren** |

Verwenden Sie **Jetzt synchronisieren**, um einen sofortigen Lauf auszulösen, wenn die Synchronisierung aktiv ist. Pausierte Synchronisierungen müssen fortgesetzt werden, bevor neue geplante oder manuelle Läufe starten.

Sie können eine Synchronisierung auch über die Detailseite ihrer Verbindung öffnen, wenn die Integration aktive Datenströme auflistet.

## Vorgänge für Verbindungen

Die Detailseite der Verbindung bietet die Vorgänge, die von der jeweiligen Integration unterstützt werden:

| Vorgang | Auswirkung |
| - | - |
| **Jetzt synchronisieren** | Fordert einen sofortigen Lauf für den ausgewählten Datenstrom an |
| **Datenstrom pausieren** | Stoppt neue Läufe für diesen Datenstrom, die Verbindung bleibt erhalten |
| **Verbindung unterbrechen** | Stoppt unterstützte Verbindungsaktivitäten, ohne die Konfiguration zu löschen |
| **Lebenslauf** | Startet einen pausierten Datenstrom oder eine pausierte Verbindung neu |
| **Erneut autorisieren** | Wiederholt die Authentifizierung nach einer Änderung von Zugangsdaten oder Zustimmung |
| **Entfernen** | Löscht die Konfiguration der Verbindung nach Bestätigung |

Das Entfernen einer Verbindung ist nicht dasselbe wie das Löschen der bereits daraus aufgenommenen Daten. Lesen Sie die Anleitung des Anbieters oder wenden Sie sich an den Support, wenn das Verhalten bei der Datenaufbewahrung Ihre Entscheidung beeinflusst.

## Benutzerdefinierte Push-Quellen

Verwenden Sie **Benutzerdefinierte Push-Quelle**, wenn ein System Daten an Living Security sendet, anstatt über einen Katalog-Connector abgefragt zu werden.

1. Erstellen Sie die Quelle am Ende des **Katalogs**.
2. Öffnen Sie ihre Detailseite im Bereich für benutzerdefinierte Push-Quellen.
3. Wählen Sie den Ziel-Datenstrom aus.
4. Verwenden Sie **CSV hochladen** für einen manuellen Stapel oder **Per API senden** für einen automatisierten Sender.
5. Sehen Sie sich die Datei oder Nutzlast in der Vorschau an und prüfen Sie nach dem Senden den Laufverlauf der Quelle.

Den vollständigen Vertrag zu Endpunkt, Authentifizierung, Nutzlast, Wiederholungen und Verifizierung finden Sie unter [Custom Push Source API](/de/integrations/custom-push-source). Leiten Sie diese Details nicht aus einer älteren Unify-Integrationsanleitung ab.

Der Uploader auf der Quellen-Detailseite akzeptiert eine CSV-Quelldatei mit bis zu 100 MB. Vor dem Hochladen teilt das Dashboard sie clientseitig in Anfragen mit jeweils höchstens 10 MB und 10.000 Zeilen auf. Dieser quellenspezifische Uploader ist von der allgemeinen Seite **Integrationen → Hochladen** für Identitäts- und Aktivitätsvorlagen getrennt.

## Fehlerbehebung

| Symptom | Prüfung |
| - | - |
| `401 Unauthorized` | Wert der Zugangsdaten, Ablauf, Widerruf, Mandant des Anbieters und Status der erneuten Autorisierung |
| `403 Forbidden` | Erforderliche Rolle beim Anbieter, Scopes, Administratorzustimmung und Zugriffsrichtlinie des Quellsystems |
| Verbindung schlägt sofort fehl | Weiterleitungs-URL, Region, Quell-URL, Anforderungen an Netzwerk- oder IP-Allowlist |
| Verbindung ist fehlerfrei, es finden aber keine Läufe statt | Der erforderliche Datenstrom ist aktiviert und der Anbieter stellt diesen Datenstrom bereit |
| Erfolgreicher Lauf liefert keine Datensätze | Das Quellkonto sieht die erwartete Personengruppe und alle anbieterseitigen Filter sind korrekt |
| Daten erscheinen bei der falschen Person | Identitätsattribute und Aliasse sind über alle verbundenen Quellen hinweg konsistent |
| Daten werden nicht mehr aktualisiert | Datenstrom oder Verbindung ist pausiert, Zugangsdaten sind abgelaufen oder der letzte Lauf ist fehlgeschlagen |

Wenn Sie sich an den [Living Security Support](mailto:support@livingsecurity.com) wenden, geben Sie Organisation, Anbieter, Verbindungsnamen, Datenstrom, Zeitpunkt des letzten Laufs und die sichtbare Fehlermeldung an. Geben Sie keine Geheimnisse an.

## Weiterführende Informationen

<CardGroup cols={2}>
  <Card title="Übersicht über Integrationen" icon="grid-2" href="/de/integrations/overview">
    Referenz zu Verbunden, Katalog, synchronisiert, Aktionen und Hochladen.
  </Card>

  <Card title="Datenzuordnung" icon="arrows-left-right" href="/de/integrations/managing/data-mapping">
    Unterstützte Attribute und Zuordnungen, soweit verfügbar, im Überblick.
  </Card>

  <Card title="Lebenszyklus einer Integration" icon="route" href="/de/integrations/managing/lifecycle">
    Eine bestehende Integration bis zur erneuten Autorisierung oder Entfernung betreiben.
  </Card>

  <Card title="Onboarding für Administratoren" icon="circle-check" href="/de/getting-started/onboarding">
    Schließen Sie die Verifizierungsaufgaben für Identitäts- und Sicherheitsdaten ab.
  </Card>
</CardGroup>


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