Voor Leveranciers & Partners

Integratiegids

Alles wat u nodig heeft om uw systemen te integreren met Public Safety Command Center. Of u nu een dataleverancier, systeemintegrator of technologiepartner bent, deze gids behandelt alle integratiepunten, dataformaten en best practices.

Integratieoverzicht

Public Safety Command Center biedt een uitgebreide, meerlaagse integratiearchitectuur ontworpen voor wetshandhavings- en inlichtingenoperaties op ondernemingsniveau. Ons platform ondersteunt zowel inkomende data-opname als uitgaande gegevensdeling via meerdere protocollen en formaten.

200+
API-eindpunten
Volledig
GraphQL-ondersteuning
WebSocket
Real-time Streaming

Integratiearchitectuur

Onze integratiearchitectuur ondersteunt bidirectionele gegevensstroom, waardoor leveranciers gegevens naar Public Safety kunnen pushen en real-time updates van het platform kunnen ontvangen. Alle integraties zijn beveiligd met authenticatie van ondernemingsniveau en voldoen aan BIO, BSI C5, ISO 27001 en internationale beveiligingsnormen.

Inkomende Integraties

Push data naar Public Safety vanuit uw systemen. Ideaal voor dataleveranciers, OSINT-bronnen en bedrijfssystemen.

  • Real-time data-opname via API
  • Batch-bestandsimport (CSV, XML, JSON)
  • Geautomatiseerde dataverrijkingspijplijnen
  • Ontdubbeling en entiteitsresolutie

Uitgaande Integraties

Ontvang data en waarschuwingen van Public Safety. Perfect voor downstream-systemen, dashboards en notificatiediensten.

  • Webhook-notificaties voor gebeurtenissen
  • GraphQL-abonnementen voor real-time data
  • Geplande data-exports
  • Aangepaste rapportgeneratie

Authenticatie & Autorisatie

Alle API-toegang vereist authenticatie. We ondersteunen meerdere authenticatiemethoden om tegemoet te komen aan verschillende integratiescenario's en beveiligingseisen.

API-sleutel Authenticatie

Eenvoudige bearer-token authenticatie voor server-naar-server integraties. API-sleutels zijn beperkt tot specifieke machtigingen en kunnen regelmatig worden geroteerd.

Authorization: Bearer <api_key>

OAuth 2.0 / OpenID Connect

Volledige OAuth 2.0-ondersteuning voor door gebruikers gedelegeerde toegang. Ideaal voor applicaties die namens gebruikers handelen met hun toestemming.

OAuth 2.0 / OpenID Connect

JWT-token Authenticatie

Kortlevende JWT-tokens voor staatloze authenticatie. Tokens bevatten gebruikersclaims en machtigingen voor fijnmazige toegangscontrole.

argus_auth_token (JWT)

Authenticatievoorbeeld

Token Authenticatiestroombash
# 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>"

Integratiemethoden

Kies de integratiemethode die het beste bij uw use case past. We ondersteunen REST, GraphQL, WebSocket en bestandsgebaseerde integraties.

GraphQL API

Onze primaire API-interface. GraphQL stelt u in staat om precies de gegevens op te vragen die u nodig heeft in één verzoek, wat bandbreedte vermindert en prestaties verbetert.

  • Vraag precies de velden op die u nodig heeft
  • Real-time abonnementen voor live updates
  • Sterk getypeerd schema met introspectie
Verken GraphQL-schema

REST API

Traditionele RESTful-eindpunten voor eenvoudige CRUD-operaties en compatibiliteit met bestaande tooling.

  • Standaard HTTP-methoden (GET, POST, PUT, DELETE)
  • JSON verzoek- en antwoordlichamen
  • OpenAPI 3.0 specificatie beschikbaar
Bekijk REST-eindpunten

WebSocket / Real-time

Persistente verbindingen voor real-time datastreaming. Ontvang directe notificaties wanneer gegevens veranderen.

  • Lage-latentie push-notificaties
  • Alarmstreaming en gebeurtenisabonnementen
  • Automatische herverbindingsafhandeling
WebSocket-documentatie

Bestandsimport / -export

Bulk data-operaties via bestandsuploads en geplande exports. Ondersteunt meerdere formaten waaronder CSV, Excel en XML.

  • CSV, XLSX, XML, JSON formaten
  • STIX 2.1 dreigingsinformatieformaat
  • Geautomatiseerde geplande imports

Dataformaten & Taxonomie

Het begrijpen van ons datamodel is essentieel voor succesvolle integratie. Public Safety gebruikt een gestandaardiseerde taxonomie voor entiteiten, relaties en gebeurtenissen.

Kern-entiteittypes

Public Safety ondersteunt een uitgebreide set entiteittypes voor wetshandhavings- en inlichtingenoperaties. Elk entiteittype heeft specifieke attributen, identificatoren en relatiemogelijkheden.

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

Ondersteunde Dataformaten

API-formaten

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

Importformaten

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

Bestandsbijlagen

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

Voorbeeld Entiteitsschema

Persoon Entiteit (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"
  }
}

Kant-en-klare Connectoren

Public Safety bevat kant-en-klare connectoren voor veelvoorkomende wetshandhavingssystemen, OSINT-providers en systeemplatforms. Aangepaste connectoren kunnen worden ontwikkeld voor extra systemen.

Wetshandhavingssystemen

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

Inlichtingen- & OSINT-providers

TLOxp
Partner
LexisNexis
Partner
Babel Street
Partner
Pipl
Beschikbaar
Spokeo
Beschikbaar
Chainalysis
Partner
Recorded Future
Partner
VirusTotal
Beschikbaar
Shodan
Beschikbaar

Bedrijfssystemen

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

Aangepaste connector nodig? Ons integratieteam kan aangepaste connectoren bouwen voor uw eigen systemen. Neem contact met ons op om uw vereisten te bespreken.

SDK's & Clientbibliotheken

Officiële SDK's vereenvoudigen integratie met type-safe interfaces, automatische herhalingslogica en ingebouwde authenticatie-afhandeling.

JavaScript / TypeScript

Volledige SDK voor Node.js en browseromgevingen met TypeScript-ondersteuning.

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

Python

Pythonic SDK met async-ondersteuning voor data science en automatiseringsworkflows.

  • Python 3.10+
  • Async support
  • Type hints

Java / Kotlin

Enterprise-grade SDK voor Java- en Kotlin-applicaties met Android-ondersteuning.

  • Java 17+
  • Kotlin coroutines
  • Android compatible

C# / .NET

Moderne .NET SDK met async/await-patronen voor Windows en cross-platform apps.

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

Go

Lichtgewicht Go-client met contextondersteuning voor high-performance services.

  • Go 1.21+
  • Context support
  • Zero dependencies

REST / cURL

Directe REST API-toegang met OpenAPI-spec, Postman-collectie en interactieve documentatie.

  • OpenAPI 3.0 spec
  • Postman collection
  • Interactive docs
SDK Gebruiksvoorbeeld (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 & Gebeurtenismeldingen

Webhooks stellen Public Safety in staat om real-time meldingen naar uw systemen te pushen wanneer gebeurtenissen plaatsvinden. Configureer webhook-eindpunten om waarschuwingen, statuswijzigingen en data-updates te ontvangen.

Beschikbare Gebeurtenissen

  • 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-beveiliging

  • HMAC-SHA256 handtekeningverificatie voor payload-authenticiteit
  • Automatische herhaling met exponentiële back-off voor mislukte leveringen
  • IP-allowlisting voor webhook-eindpunten beschikbaar
  • Idempotentiesleutels om dubbele verwerking te voorkomen
Webhook Payload & Verificatietypescript
// 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));
}

Beveiligingsvereisten

Alle integraties moeten voldoen aan onze beveiligingsvereisten om gevoelige wetshandhavingsgegevens te beschermen. We handhaven strikte normen voor authenticatie, encryptie en toegangscontrole.

Technische Vereisten

  • TLS 1.2 of hoger vereist voor alle verbindingen
  • Authenticatie vereist voor alle API-verzoeken
  • AES-256 encryptie voor data in rust
  • Volledige audit-logging van alle API-toegang
  • Handhaving van op rollen gebaseerde toegangscontrole (RBAC)

Nalevingscertificeringen

  • BIO-conform (Baseline Informatiebeveiliging Overheid)
  • BSI C5 geautoriseerd
  • SOC 2 Type II gecertificeerd
  • ISO 27001 gecertificeerd
  • AVG-conform voor EU-data

Testen & Sandbox-omgeving

Test uw integratie in onze sandbox-omgeving voordat u live gaat. De sandbox biedt realistische testdata en volledige API-functionaliteit zonder productiesystemen te beïnvloeden.

Sandbox-omgeving

Volledige sandbox-omgeving met realistische testdata. Test alle API-operaties zonder productiedata te beïnvloeden.

Testdatasets

Vooraf ingevulde testdatasets inclusief voorbeeldentiteiten, relaties en waarschuwingen voor uitgebreid testen.

Integratiecertificering

Voltooi ons certificeringsproces om een officiële Public Safety-integratiepartner te worden met vermelding op de marktplaats.

Integratietestproces

  1. Vraag sandbox-toegang aan via het partnerportaal
  2. Ontwikkel en test uw integratie tegen de sandbox-API
  3. Dien uw integratie in voor beoordeling door ons team
  4. Voltooi beveiligingsbeoordeling en penetratietesten
  5. Ontvang certificering en implementeer naar productie

Word een Integratiepartner

Geïnteresseerd in integratie met Public Safety Command Center? Vul het onderstaande formulier in en ons partnerschapsteam neemt contact op om de vervolgstappen te bespreken.

Verzoek tot Leveranciersintegratie

Vertel ons over uw integratiebehoeften en we nemen binnen 2-3 werkdagen contact met u op.

Uw informatie wordt behandeld volgens ons privacybeleid. We zullen uw gegevens nooit delen met derden.

Klaar om te Integreren?

Neem contact op met ons integratieteam om uw vereisten te bespreken en toegang te krijgen tot onze sandbox-omgeving.