Integration einrichten

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

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.

​

2. Anbieter verbinden

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

Wenn Sie sich an den Living Security Support wenden, geben Sie Organisation, Anbieter, Verbindungsnamen, Datenstrom, Zeitpunkt des letzten Laufs und die sichtbare Fehlermeldung an. Geben Sie keine Geheimnisse an.

​

Weiterführende Informationen