Für Anbieter & Partner

Integrationsleitfaden

Alles, was Sie zur Integration Ihrer Systeme mit Public Safety Command Center benötigen. Ob Sie Datenanbieter, Systemintegrator oder Technologiepartner sind – dieser Leitfaden behandelt alle Integrationspunkte, Datenformate und Best Practices.

Integrationsübersicht

Public Safety Command Center bietet eine umfassende, mehrschichtige Integrationsarchitektur, die für Strafverfolgung und nachrichtendienstliche Operationen auf Unternehmensniveau konzipiert ist. Unsere Plattform unterstützt sowohl eingehende Datenerfassung als auch ausgehende Datenfreigabe über mehrere Protokolle und Formate.

200+
API-Endpunkte
Vollständig
GraphQL-Unterstützung
WebSocket
Echtzeit-Streaming

Integrationsarchitektur

Unsere Integrationsarchitektur unterstützt bidirektionalen Datenfluss und ermöglicht es Anbietern, Daten in Public Safety zu übertragen und Echtzeit-Updates von der Plattform zu empfangen. Alle Integrationen sind mit Authentifizierung auf Unternehmensniveau gesichert und entsprechen den Standards BSI C5, ISO 27001 sowie internationalen Sicherheitsstandards.

Eingehende Integrationen

Übertragen Sie Daten aus Ihren Systemen in Public Safety. Ideal für Datenanbieter, OSINT-Quellen und Unternehmenssysteme.

  • Echtzeit-Datenerfassung über API
  • Batch-Dateiimporte (CSV, XML, JSON)
  • Automatisierte Datenanreicherungspipelines
  • Deduplizierung und Entitätsauflösung

Ausgehende Integrationen

Empfangen Sie Daten und Warnmeldungen von Public Safety. Perfekt für nachgelagerte Systeme, Dashboards und Benachrichtigungsdienste.

  • Webhook-Benachrichtigungen für Ereignisse
  • GraphQL-Subscriptions für Echtzeitdaten
  • Geplante Datenexporte
  • Benutzerdefinierte Berichtserstellung

Authentifizierung & Autorisierung

Sämtlicher API-Zugriff erfordert Authentifizierung. Wir unterstützen mehrere Authentifizierungsmethoden, um verschiedene Integrationsszenarien und Sicherheitsanforderungen zu berücksichtigen.

API-Key-Authentifizierung

Einfache Bearer-Token-Authentifizierung für Server-zu-Server-Integrationen. API-Keys sind auf spezifische Berechtigungen beschränkt und können regelmäßig rotiert werden.

Authorization: Bearer <api_key>

OAuth 2.0 / OpenID Connect

Vollständige OAuth 2.0-Unterstützung für benutzerdelegierten Zugriff. Ideal für Anwendungen, die im Auftrag von Benutzern mit deren Zustimmung handeln.

OAuth 2.0 / OpenID Connect

JWT-Token-Authentifizierung

Kurzlebige JWT-Tokens für zustandslose Authentifizierung. Tokens enthalten Benutzeransprüche und Berechtigungen für feinabgestimmte Zugriffskontrolle.

argus_auth_token (JWT)

Authentifizierungsbeispiel

Token-Authentifizierungsablaufbash
# Obtain an access token
curl -X POST https://auth.knogin.com/v1/login \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "[email protected]" \
  -d "password=your-password" \
  -d "platform=argus"

# Response contains:
# - argus_auth_token (JWT access token)
# - knogin_refresh_token (for token refresh)

# Use the token in subsequent requests
curl -X GET https://api.knogin.com/v1/health \
  -H "Authorization: Bearer <argus_auth_token>"

Integrationsmethoden

Wählen Sie die Integrationsmethode, die am besten zu Ihrem Anwendungsfall passt. Wir unterstützen REST, GraphQL, WebSocket und dateibasierte Integrationen.

GraphQL-API

Unsere primäre API-Schnittstelle. GraphQL ermöglicht es Ihnen, exakt die benötigten Daten in einer einzigen Anfrage anzufordern, wodurch Bandbreite reduziert und die Leistung verbessert wird.

  • Fragen Sie exakt die Felder ab, die Sie benötigen
  • Echtzeit-Subscriptions für Live-Updates
  • Stark typisiertes Schema mit Introspection
GraphQL-Schema erkunden

REST-API

Traditionelle RESTful-Endpunkte für einfache CRUD-Operationen und Kompatibilität mit vorhandenen Tools.

  • Standard-HTTP-Methoden (GET, POST, PUT, DELETE)
  • JSON-Anfrage- und Antwort-Bodies
  • OpenAPI 3.0-Spezifikation verfügbar
REST-Endpunkte anzeigen

WebSocket / Echtzeit

Persistente Verbindungen für Echtzeit-Datenstreaming. Empfangen Sie sofortige Benachrichtigungen bei Datenänderungen.

  • Push-Benachrichtigungen mit geringer Latenz
  • Alarmstreaming und Ereignisabonnements
  • Automatische Wiederverbindungsbehandlung
WebSocket-Dokumentation

Dateiimport / -export

Massendatenoperationen durch Datei-Uploads und geplante Exporte. Unterstützt mehrere Formate einschließlich CSV, Excel und XML.

  • CSV-, XLSX-, XML-, JSON-Formate
  • STIX 2.1 Bedrohungsintelligenz-Format
  • Automatisierte geplante Importe

Datenformate & Taxonomie

Das Verständnis unseres Datenmodells ist entscheidend für eine erfolgreiche Integration. Public Safety verwendet eine standardisierte Taxonomie für Entitäten, Beziehungen und Ereignisse.

Kern-Entitätstypen

Public Safety unterstützt einen umfassenden Satz von Entitätstypen für Strafverfolgungs- und nachrichtendienstliche Operationen. Jeder Entitätstyp verfügt über spezifische Attribute, Identifikatoren und Beziehungsfähigkeiten.

Person
Organization
Vehicle
Location
Document
Phone
Email
Social Account
IP Address
Cryptocurrency
Domain
Event

Unterstützte Datenformate

API-Formate

  • JSON (application/json)
  • GraphQL
  • Multipart form-data

Importformate

  • CSV / TSV
  • Excel (XLSX)
  • XML / NIEM
  • STIX 2.1

Dateianhänge

  • PDF, DOCX, TXT
  • JPEG, PNG, GIF, WebP
  • MP3, WAV, OGG
  • MP4, MOV, AVI

Entitäts-Schema-Beispiel

Personen-Entität (JSON)json
{
  "id": "profile-uuid-123",
  "type": "PERSON",
  "attributes": {
    "firstName": "John",
    "lastName": "Doe",
    "dateOfBirth": "1985-03-15",
    "nationality": "US"
  },
  "identifiers": [
    { "type": "SSN", "value": "***-**-1234", "verified": true },
    { "type": "PASSPORT", "value": "AB123456", "country": "US" }
  ],
  "contacts": [
    { "type": "EMAIL", "value": "[email protected]" },
    { "type": "PHONE", "value": "+1-555-123-4567" }
  ],
  "addresses": [
    {
      "type": "HOME",
      "street": "123 Main St",
      "city": "Los Angeles",
      "state": "CA",
      "postalCode": "90001",
      "country": "US",
      "coordinates": { "lat": 34.0522, "lng": -118.2437 }
    }
  ],
  "metadata": {
    "source": "vendor-system",
    "sourceId": "ext-12345",
    "createdAt": "2024-01-15T10:30:00Z",
    "updatedAt": "2024-06-20T14:45:00Z"
  }
}

Vorgefertigte Konnektoren

Public Safety umfasst vorgefertigte Konnektoren für gängige Strafverfolgungssysteme, OSINT-Anbieter und Unternehmensplattformen. Benutzerdefinierte Konnektoren können für zusätzliche Systeme entwickelt werden.

Strafverfolgungssysteme

CAD Systems
Verfügbar
RMS Platforms
Verfügbar
Evidence.com
Verfügbar
NCIC/NLETS
Verfügbar
CJIS
Verfügbar
NIBRS
Verfügbar
PropertyRoom
Verfügbar
Body Camera Systems
Verfügbar
License Plate Readers
Verfügbar

Nachrichtendienst- & OSINT-Anbieter

TLOxp
Partner
LexisNexis
Partner
Babel Street
Partner
Pipl
Verfügbar
Spokeo
Verfügbar
Chainalysis
Partner
Recorded Future
Partner
VirusTotal
Verfügbar
Shodan
Verfügbar

Unternehmenssysteme

Microsoft 365 / Entra ID
Verfügbar
Google Workspace
Verfügbar
Salesforce
Verfügbar
ServiceNow
Verfügbar
Slack
Verfügbar
MS Teams
Verfügbar
Jira
Verfügbar
AWS S3
Verfügbar
Azure Blob Storage
Verfügbar

Benötigen Sie einen benutzerdefinierten Konnektor? Unser Integrationsteam kann benutzerdefinierte Konnektoren für Ihre proprietären Systeme entwickeln. Kontaktieren Sie uns, um Ihre Anforderungen zu besprechen.

SDKs & Client-Bibliotheken

Offizielle SDKs vereinfachen die Integration mit typsicheren Schnittstellen, automatischer Wiederholungslogik und integrierter Authentifizierungsbehandlung.

JavaScript / TypeScript

Vollumfängliches SDK für Node.js- und Browser-Umgebungen mit TypeScript-Unterstützung.

  • Node.js 18+
  • Browser ESM
  • TypeScript types

Python

Pythonisches SDK mit Async-Unterstützung für Data Science- und Automatisierungs-Workflows.

  • Python 3.10+
  • Async support
  • Type hints

Java / Kotlin

Unternehmens-SDK für Java- und Kotlin-Anwendungen mit Android-Unterstützung.

  • Java 17+
  • Kotlin coroutines
  • Android compatible

C# / .NET

Modernes .NET-SDK mit Async/Await-Mustern für Windows und plattformübergreifende Apps.

  • .NET 6+
  • Async/await
  • NuGet package

Go

Leichtgewichtiger Go-Client mit Context-Unterstützung für Hochleistungsdienste.

  • Go 1.21+
  • Context support
  • Zero dependencies

REST / cURL

Direkter REST-API-Zugriff mit OpenAPI-Spezifikation, Postman-Collection und interaktiver Dokumentation.

  • OpenAPI 3.0 spec
  • Postman collection
  • Interactive docs
SDK-Verwendungsbeispiel (TypeScript)typescript
import { Public SafetyClient } from '@argus/sdk';

// Initialize the client
const argus = new Public SafetyClient({
  apiKey: process.env.ARGUS_API_KEY,
  organizationId: 'your-org-id',
  environment: 'production', // or 'sandbox'
});

// Create a new investigation
const investigation = await argus.investigations.create({
  title: 'Financial Fraud Case #2024-001',
  priority: 'HIGH',
  assignees: ['agent-123', 'agent-456'],
});

// Upload evidence
const evidence = await argus.evidence.upload({
  investigationId: investigation.id,
  file: documentBuffer,
  metadata: {
    type: 'document',
    source: 'bank-records',
    chainOfCustody: true,
  },
});

// Run AI analysis
const analysis = await argus.ai.analyze({
  evidenceIds: [evidence.id],
  models: ['entity-extraction', 'relationship-mapping'],
});

// Subscribe to real-time alerts
argus.alerts.subscribe({
  investigationId: investigation.id,
  onAlert: (alert) => {
    console.log('New alert:', alert);
  },
});

Webhooks & Ereignisbenachrichtigungen

Webhooks ermöglichen es Public Safety, Echtzeit-Benachrichtigungen an Ihre Systeme zu senden, wenn Ereignisse auftreten. Konfigurieren Sie Webhook-Endpunkte, um Warnmeldungen, Statusänderungen und Daten-Updates zu empfangen.

Verfügbare Ereignisse

  • alert.created
  • alert.updated
  • alert.resolved
  • investigation.created
  • investigation.updated
  • case.created
  • case.status_changed
  • profile.created
  • profile.enriched
  • evidence.uploaded
  • evidence.processed
  • report.generated
  • workflow.completed

Webhook-Sicherheit

  • HMAC-SHA256-Signaturverifizierung für Payload-Authentizität
  • Automatische Wiederholung mit exponentiellem Backoff bei fehlgeschlagenen Zustellungen
  • IP-Zulassungsliste für Webhook-Endpunkte verfügbar
  • Idempotenz-Schlüssel zur Vermeidung doppelter Verarbeitung
Webhook-Payload & Verifizierungtypescript
// Webhook payload example
{
  "id": "evt_abc123",
  "type": "alert.created",
  "timestamp": "2024-06-20T14:30:00Z",
  "data": {
    "alertId": "alert-xyz789",
    "severity": "HIGH",
    "title": "Suspicious activity detected",
    "investigationId": "inv-123",
    "entityIds": ["profile-456", "profile-789"],
    "metadata": {
      "triggerRule": "financial-threshold",
      "matchScore": 0.95
    }
  },
  "signature": "sha256=a1b2c3d4..."
}

// Verify webhook signature
import crypto from 'crypto';

function verifyWebhook(payload: string, signature: string, secret: string): boolean {
  const expected = 'sha256=' + crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected));
}

Sicherheitsanforderungen

Alle Integrationen müssen unsere Sicherheitsanforderungen erfüllen, um sensible Strafverfolgungsdaten zu schützen. Wir setzen strenge Standards für Authentifizierung, Verschlüsselung und Zugriffskontrolle durch.

Technische Anforderungen

  • TLS 1.2 oder höher erforderlich für alle Verbindungen
  • Authentifizierung erforderlich für alle API-Anfragen
  • AES-256-Verschlüsselung für ruhende Daten
  • Vollständige Audit-Protokollierung aller API-Zugriffe
  • Rollenbasierte Zugriffskontrolle (RBAC) Durchsetzung

Compliance-Zertifizierungen

  • CJIS Security Policy konform
  • FedRAMP Moderate autorisiert
  • SOC 2 Typ II zertifiziert
  • ISO 27001 zertifiziert
  • DSGVO-konform für EU-Daten

Testen & Sandbox-Umgebung

Testen Sie Ihre Integration in unserer Sandbox-Umgebung, bevor Sie live gehen. Die Sandbox bietet realistische Testdaten und volle API-Funktionalität ohne Auswirkungen auf Produktionssysteme.

Sandbox-Umgebung

Vollwertige Sandbox-Umgebung mit realistischen Testdaten. Testen Sie alle API-Operationen ohne Auswirkungen auf Produktionsdaten.

Testdatensätze

Vorbefüllte Testdatensätze einschließlich Beispielentitäten, Beziehungen und Warnmeldungen für umfassende Tests.

Integrationszertifizierung

Schließen Sie unseren Zertifizierungsprozess ab, um ein offizieller Public Safety-Integrationspartner mit Marktplatz-Eintrag zu werden.

Integrationstestprozess

  1. Sandbox-Zugriff über das Partnerportal anfordern
  2. Ihre Integration gegen die Sandbox-API entwickeln und testen
  3. Ihre Integration zur Überprüfung durch unser Team einreichen
  4. Sicherheitsbewertung und Penetrationstests abschließen
  5. Zertifizierung erhalten und in Produktion bereitstellen

Integrationspartner werden

Interessiert an einer Integration mit Public Safety Command Center? Füllen Sie das untenstehende Formular aus und unser Partnerschaftsteam wird sich mit Ihnen in Verbindung setzen, um die nächsten Schritte zu besprechen.

Anfrage zur Anbieterintegration

Teilen Sie uns Ihre Integrationsbedürfnisse mit und wir werden uns innerhalb von 2-3 Werktagen bei Ihnen melden.

Ihre Informationen werden gemäß unserer Datenschutzrichtlinie behandelt. Wir werden Ihre Daten niemals an Dritte weitergeben.

Bereit zur Integration?

Kontaktieren Sie unser Integrationsteam, um Ihre Anforderungen zu besprechen und Zugang zu unserer Sandbox-Umgebung zu erhalten.