Docs on Omniac Business

Authentication

Thu, 05 Jan 2017 00:00:00 +0000

Unsere API unterstützt zwei Arten der Authentifizierung. API-Schlüssel sind einfach und unkompliziert zu verwenden, aber auch weniger sicher, da sie von Man-in-the-Middle-Angriffen betroffen sein können. Der sicherere Ansatz ist die Verwendung von OAuth mit Client Credential Flow. Auf diese Weise können wir Ihnen eine Identität bereitstellen oder auch Ihren Identitätsanbieter verwenden.

API Key

Um einen API-Schlüssel verwenden zu können, müssen wir diese Funktion in Ihrem Tenant aktivieren. Der bereitgestellte Schlüssel muss mit jeder Anfrage unter Verwendung des X-API-KEY-Headers gesendet werden.

Getting Started

Mon, 01 Jan 0001 00:00:00 +0000

In dieser Sektion werden die ersten Schritte mit omniac Business beschrieben, darunter das Starten der Überwachung eines Benutzers, das Abfragen von Warnmeldungen und das Abfragen von Benutzerdaten.

Alerts

Thu, 05 Jan 2017 00:00:00 +0000

Alerts sind Warnmeldungen, die von omniac Business generiert werden, wenn Datenleck-Vorfälle für bestimmte Attribute festgestellt werden. Diese Alerts sind für die Aufrechterhaltung der Sicherheit und Privatsphäre der Daten der Benutzer von entscheidender Bedeutung. Jeder Alert enthält Details zum Vorfall, einschließlich des betroffenen Attribut, der Quelle, Zeitpunkt des Vorfalls, einer Klassifizierung zur Kritikalität, einer kurzen Standardbeschreibung des Vorfalls und einer Handlungsempfehlung. Je nachdem, welche Details benötigt werden, kann der Alert-Payload angepasst werden.

Attribute

Thu, 05 Jan 2017 00:00:00 +0000

Attribute werden verwendet, um verschiedene personenbezogene Daten eines Benutzers anzulegen und zu überwachen. Jedes angelegte Attribut wird maskiert, gehasht und verschlüsselt gespeichert, um Datenschutz und Sicherheit zu gewährleisten. Es stehen bis zu 39 verschiedene Attribute zur Verfügung – eine detaillierte Liste finden Sie weiter unten. Die Pflege der Attribute erfolgt über den PUT-Endpunkt /attributes. Dabei werden alle Attribute durch die angegebenen ersetzt. Achten Sie daher darauf, auch die bestehenden Attribute mit anzugeben. Auf bestehende Attribute kann über den GET-Endpunkt /profile zugegriffen werden.

Beispiel Golang

Thu, 05 Jan 2017 00:00:00 +0000

Einführung und Projekteinrichtung

Go (Golang) ist eine statisch typisierte, kompilierte Programmiersprache, die von Google entwickelt wurde und für ihre Einfachheit, Effizienz und hervorragende Unterstützung von Parallelität bekannt ist, wodurch sie sich ideal für die Erstellung skalierbarer Webdienste, APIs und Microservices eignet. Um Projektabhängigkeiten in Go zu verwalten, verwenden Sie Go-Module. Sie können ein neues Go-Modul in Ihrem Projektverzeichnis initialisieren, indem Sie den Befehl go mod init <Modulname> ausführen, wobei <Modulname> in der Regel die URL Ihres Repositorys ist (z. B. github.com/Benutzername/Projekt). Dadurch wird eine go.mod-Datei erstellt, die Ihre Abhängigkeiten verfolgt. Wenn Sie Pakete importieren und go mod tidy ausführen, lädt Go automatisch die erforderlichen Abhängigkeiten herunter und verwaltet sie. Das Modulsystem von Go gewährleistet reproduzierbare Builds und eine ordnungsgemäße Versionsverwaltung. Sie können Ihr Projekt mit go build erstellen und es direkt mit go run main.go ausführen. Dieser Ansatz sorgt für eine gute Organisation Ihrer Projekte und gewährleistet eine konsistente Abhängigkeitsverwaltung in verschiedenen Umgebungen.

Beispiel Python

Thu, 05 Jan 2017 00:00:00 +0000

Einführung und Projekteinrichtung

Python ist eine vielseitige, weit verbreitete Programmiersprache, die für ihre Einfachheit und umfangreichen Bibliotheken geschätzt wird und sich ideal für Webentwicklung, Datenanalyse und Automatisierung eignet. Um projektspezifische Abhängigkeiten zu verwalten und Konflikte zu vermeiden, empfiehlt es sich, eine virtuelle Umgebung zu verwenden. Sie können eine solche Umgebung in Ihrem Projektverzeichnis erstellen, indem Sie den Terminalbefehl python -m venv .venv ausführen, wobei .venv der Name Ihres Umgebungsordners ist. Nach der Erstellung müssen Sie diese aktivieren. Unter Windows verwenden Sie „.venv\Scripts\activate“ und unter macOS oder Linux „source .venv/bin/activate“. Nach der Aktivierung ändert sich Ihre Eingabeaufforderung und zeigt den Namen der Umgebung an. Alle Pakete, die Sie mit „pip“ installieren, werden für dieses bestimmte Projekt isoliert. Wenn Sie fertig sind, geben Sie einfach „deactivate“ ein, um zu Ihrem globalen Python-Kontext zurückzukehren. Dieser Prozess sorgt dafür, dass Ihre Projekte übersichtlich und reproduzierbar bleiben.

Datenstrukturen

Thu, 05 Jan 2017 00:00:00 +0000

Grundlegende Datenstruktur

Thu, 05 Jan 2017 00:00:00 +0000

Hier finden Sie eine kurze einführende Darstellung der Datenstruktur. Jeder Tenant verfügt über mehrere Profile, innerhalb eines Profils gibt es eine Liste mit Attributen und Alerts.

- * tenant
  |- settings
  |
  |- profiles
     |- profile
     |  |- alerts
     |  |- attributes
     |
     |- profile
     |  |- alerts
     |  |- attributes

Profile

Thu, 05 Jan 2017 00:00:00 +0000

Ein Profil enthält alle Informationen zu einem bestimmten Benutzer innerhalb Ihres Tenants. Dieses Profil kombiniert eine Reihe von Attributen, die für einen Benutzer gespeichert wurden, und die ausgelösten Alerts bei festgestellten Datenleck-Vorfällen.

Das Erstellen eines Profils ist so einfach wie das Senden einer POST-Anfrage an den Profil-Endpunkt (/v1/profiles). Der gleiche Endpunkt akzeptiert auch Anfragen mit einer Profil-ID (/v1/profiles/{profileID}) mit den folgenden Methoden:

GET zum Abrufen eines Profils,
DELETE zum Entfernen eines Profils und
PUT zum Speichern neuer Attribute.

Ausführliche Informationen zu Anfragen und Antworten finden Sie in der OpenAPI-Spezifikation.

Tenants

Thu, 05 Jan 2017 00:00:00 +0000

Tenants sind einzelne Kunden oder Organisationen, die den omniac Business-Dienst nutzen. Jeder Tenant verfügt über eigene Benutzer, Daten und Konfigurationen, was eine maßgeschneiderte Sicherheitsüberwachung und -verwaltung ermöglicht. Der Zugriff auf Daten anderer Tenants ist nicht möglich, sodass die Informationen jedes Tenants privat und sicher bleiben.

Konfiguration

Zunächst wird Ihnen von omniac Business ein Tenant zur Verfügung gestellt. Sie oder ein Vertreter von omniac Business können den Tenant dann nach Ihren Bedürfnissen konfigurieren. Die Konfiguration umfasst:

Beispiel Java

Thu, 05 Jan 2017 00:00:00 +0000

Einführung und Projekteinrichtung

Java ist eine robuste, objektorientierte Programmiersprache, die für ihre Plattformunabhängigkeit und ihr starkes Typsystem bekannt ist und sich daher ideal für Unternehmensanwendungen, Webdienste und groß angelegte Systeme eignet. Um Projektabhängigkeiten zu verwalten und Prozesse effektiv zu erstellen, empfiehlt es sich, ein Build-Tool wie Maven oder Gradle zu verwenden. In dieser Anleitung verwenden wir Maven. Sie können ein neues Maven-Projekt erstellen, indem Sie in Ihrem Terminal mvn archetype:generate -DgroupId=com.example.omniac -DartifactId=omniac-client -DarchetypeArtifactId=maven-archetype-quickstart -DinteractiveMode=false ausführen. Dadurch wird eine Standard-Projektstruktur mit einer pom.xml-Datei für die Abhängigkeitsverwaltung erstellt. Navigieren Sie mit „cd omniac-client“ zu Ihrem Projektverzeichnis. Die Maven-Struktur speichert Ihren Quellcode in „src/main/java“ und Tests in „src/test/java“ und bietet so eine übersichtliche und gut organisierte Entwicklungsumgebung, die für IDEs und andere Entwickler leicht verständlich ist.

Beispiele

Thu, 05 Jan 2017 00:00:00 +0000

In diesem Abschnitt finden Sie einige Beispielimplementierungen. Wir bieten Beispiele für die Verwendung unserer API und auch für die Implementierung der Datenverarbeitung wie Hashing und Verschlüsselung.

OpenAPI Generator

Thu, 05 Jan 2017 00:00:00 +0000

OpenAPI Generator

Wir empfehlen, den offiziellen OpenAPI Generator zur Generierung des Client-Codes zu verwenden. Der Generator ist unter OpenAPI Generator zu finden. Er bietet verschiedene Optionen zur Generierung von Client-Bibliotheken in unterschiedlichen Programmiersprachen. Er generiert Code auf Basis der OpenAPI-Spezifikation, wie z.B. Funktionen zum Aufrufen der Endpunkte und Typen für die Request- und Response-Bodies.

Client Generation Schritte

Herunterladen der OpenAPI Spezifikation: Laden Sie die OpenAPI-Spezifikationsdatei für omniac Business herunter. Diese Datei liegt im YAML-Format vor und beschreibt die API-Endpunkte, Anfrageparameter und Antwortstrukturen.
Installieren des OpenAPI Generators: Falls noch nicht geschehen, installieren Sie das OpenAPI Generator CLI-Tool. Installationsanweisungen finden Sie in der OpenAPI Generator-Dokumentation.
Den Client generieren: Verwenden Sie die OpenAPI Generator CLI, um den Client-Code zu generieren. Der Befehl sieht in der Regel wie folgt aus:

openapi-generator-cli generate -i path/to/openapi.yaml -g <language> -o path/to/output/directory

Ersetzen Sie <language> durch die gewünschte Programmiersprache (z. B. python, java, javascript usw.) und geben Sie den Pfad zur OpenAPI-Spezifikationsdatei und das Ausgabeverzeichnis an, in dem der generierte Client-Code gespeichert werden soll.

Push-Benachrichtigungen

Thu, 05 Jan 2017 00:00:00 +0000

Um noch schneller benachrichtigt zu werden, bieten wir eine Push-API für neue Alerts an. Sobald ein Datenleck-Vorfall gefunden wird, veröffentlichen wir die Warnmeldung in Ihrem System. Dies geschieht über einen HTTP-Aufruf. Die Zustellung wird auf unserer Seite als abgeschlossen markiert, sobald Ihre API einen 2xx-HTTP-Statuscode zurückgibt.

Um diese Funktion nutzen zu können, müssen Sie sich mit uns in Verbindung setzen, damit wir die Funktion für Ihren Tenant aktivieren können.

Der Payload sieht wie folgt aus:

Verschlüsselung im Client

Thu, 05 Jan 2017 00:00:00 +0000

Neben der Möglichkeit, die zu überwachenden Daten im Klartext an omniac Business zu senden, bieten wir auch an, die Daten bereits normalisiert, verschlüsselt und gehasht zu empfangen. Letzteres ist auch der von uns empfohlene Weg, da so die persönlichen Attribute Ihrer Nutzer nie im Klartext Ihren Firmenkontext verlassen. Die Verarbeitungsschritte, die dafür notwendig sind, müssen identisch mit denen sein, die wir durchführen, bevor wir die Daten zum Durchsuchen unserer Datenleck-Datenbank verwenden. Im Folgenden wird dieses Vorgehen kurz erläutert.