Pour Fournisseurs et Partenaires

Guide d'Intégration

Tout ce dont vous avez besoin pour intégrer vos systèmes à Public Safety Command Center. Que vous soyez fournisseur de données, intégrateur de systèmes ou partenaire technologique, ce guide couvre tous les points d'intégration, formats de données et meilleures pratiques.

Aperçu de l'Intégration

Public Safety Command Center fournit une architecture d'intégration complète et multicouche conçue pour les opérations de renseignement et d'application de la loi de niveau entreprise. Notre plateforme prend en charge l'ingestion de données entrantes et le partage de données sortantes via plusieurs protocoles et formats.

200+
Points d'API
Complet
Support GraphQL
WebSocket
Streaming Temps Réel

Architecture d'Intégration

Notre architecture d'intégration prend en charge le flux de données bidirectionnel, permettant aux fournisseurs d'envoyer des données vers Public Safety et de recevoir des mises à jour en temps réel de la plateforme. Toutes les intégrations sont sécurisées avec une authentification de niveau entreprise et conformes aux normes SecNumCloud, ANSSI et internationales.

Intégrations Entrantes

Envoyez des données vers Public Safety depuis vos systèmes. Idéal pour les fournisseurs de données, sources OSINT et systèmes d'entreprise.

  • Ingestion de données en temps réel via API
  • Importations de fichiers par lots (CSV, XML, JSON)
  • Pipelines d'enrichissement de données automatisés
  • Déduplication et résolution d'entités

Intégrations Sortantes

Recevez des données et alertes d'Public Safety. Parfait pour les systèmes en aval, tableaux de bord et services de notification.

  • Notifications webhook pour les événements
  • Abonnements GraphQL pour données en temps réel
  • Exportations de données programmées
  • Génération de rapports personnalisés

Authentification et Autorisation

Tout accès à l'API nécessite une authentification. Nous prenons en charge plusieurs méthodes d'authentification pour accommoder différents scénarios d'intégration et exigences de sécurité.

Authentification par Clé API

Authentification simple par token bearer pour les intégrations serveur à serveur. Les clés API ont des permissions spécifiques et peuvent être renouvelées régulièrement.

Authorization: Bearer <api_key>

OAuth 2.0 / OpenID Connect

Support complet OAuth 2.0 pour l'accès délégué par utilisateur. Idéal pour les applications agissant au nom des utilisateurs avec leur consentement.

OAuth 2.0 / OpenID Connect

Authentification par Token JWT

Tokens JWT de courte durée pour l'authentification sans état. Les tokens incluent les claims utilisateur et permissions pour un contrôle d'accès granulaire.

argus_auth_token (JWT)

Exemple d'Authentification

Flux d'Authentification par Tokenbash
# 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>"

Méthodes d'Intégration

Choisissez la méthode d'intégration qui correspond le mieux à votre cas d'utilisation. Nous prenons en charge les intégrations REST, GraphQL, WebSocket et basées sur fichiers.

API GraphQL

Notre interface API principale. GraphQL vous permet de demander exactement les données dont vous avez besoin en une seule requête, réduisant la bande passante et améliorant les performances.

  • Interrogez exactement les champs dont vous avez besoin
  • Abonnements en temps réel pour mises à jour en direct
  • Schéma fortement typé avec introspection
Explorer le Schéma GraphQL

API REST

Points de terminaison RESTful traditionnels pour les opérations CRUD simples et la compatibilité avec les outils existants.

  • Méthodes HTTP standard (GET, POST, PUT, DELETE)
  • Corps de requête et réponse en JSON
  • Spécification OpenAPI 3.0 disponible
Voir les Points REST

WebSocket / Temps Réel

Connexions persistantes pour le streaming de données en temps réel. Recevez des notifications instantanées lorsque les données changent.

  • Notifications push à faible latence
  • Streaming d'alertes et abonnements aux événements
  • Gestion automatique de la reconnexion
Documentation WebSocket

Import / Export de Fichiers

Opérations de données en masse via téléchargements de fichiers et exportations programmées. Prend en charge plusieurs formats dont CSV, Excel et XML.

  • Formats CSV, XLSX, XML, JSON
  • Format STIX 2.1 pour renseignement sur les menaces
  • Importations programmées automatisées

Formats de Données et Taxonomie

Comprendre notre modèle de données est essentiel pour une intégration réussie. Public Safety utilise une taxonomie standardisée pour les entités, relations et événements.

Types d'Entités Principaux

Public Safety prend en charge un ensemble complet de types d'entités pour les opérations d'application de la loi et de renseignement. Chaque type d'entité a des attributs spécifiques, identifiants et capacités de relation.

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

Formats de Données Supportés

Formats API

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

Formats d'Import

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

Pièces Jointes

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

Exemple de Schéma d'Entité

Entité Personne (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"
  }
}

Connecteurs Préconstruits

Public Safety inclut des connecteurs préconstruits pour les systèmes courants d'application de la loi, fournisseurs OSINT et plateformes d'entreprise. Des connecteurs personnalisés peuvent être développés pour des systèmes supplémentaires.

Systèmes d'Application de la Loi

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

Fournisseurs de Renseignement et OSINT

TLOxp
Partenaire
LexisNexis
Partenaire
Babel Street
Partenaire
Pipl
Disponible
Spokeo
Disponible
Chainalysis
Partenaire
Recorded Future
Partenaire
VirusTotal
Disponible
Shodan
Disponible

Systèmes d'Entreprise

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

Besoin d'un connecteur personnalisé ? Notre équipe d'intégration peut construire des connecteurs personnalisés pour vos systèmes propriétaires. Contactez-nous pour discuter de vos besoins.

SDKs et Bibliothèques Client

Les SDKs officiels simplifient l'intégration avec des interfaces typées, une logique de nouvelle tentative automatique et une gestion de l'authentification intégrée.

JavaScript / TypeScript

SDK complet pour les environnements Node.js et navigateur avec support TypeScript.

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

Python

SDK Pythonique avec support async pour les workflows de science des données et d'automatisation.

  • Python 3.10+
  • Async support
  • Type hints

Java / Kotlin

SDK de niveau entreprise pour les applications Java et Kotlin avec support Android.

  • Java 17+
  • Kotlin coroutines
  • Android compatible

C# / .NET

SDK .NET moderne avec patterns async/await pour les applications Windows et multiplateformes.

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

Go

Client Go léger avec support de contexte pour les services haute performance.

  • Go 1.21+
  • Context support
  • Zero dependencies

REST / cURL

Accès direct à l'API REST avec spec OpenAPI, collection Postman et documentation interactive.

  • OpenAPI 3.0 spec
  • Postman collection
  • Interactive docs
Exemple d'Utilisation du SDK (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 et Notifications d'Événements

Les webhooks permettent à Public Safety d'envoyer des notifications en temps réel à vos systèmes lorsque des événements se produisent. Configurez des points de terminaison webhook pour recevoir des alertes, changements d'état et mises à jour de données.

Événements Disponibles

  • 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

Sécurité des Webhooks

  • Vérification de signature HMAC-SHA256 pour l'authenticité du payload
  • Nouvelle tentative automatique avec backoff exponentiel pour les livraisons échouées
  • Liste blanche d'IP disponible pour les points de terminaison webhook
  • Clés d'idempotence pour éviter le traitement en double
Payload de Webhook et Vérificationtypescript
// 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));
}

Exigences de Sécurité

Toutes les intégrations doivent répondre à nos exigences de sécurité pour protéger les données sensibles d'application de la loi. Nous appliquons des normes strictes pour l'authentification, le chiffrement et le contrôle d'accès.

Exigences Techniques

  • TLS 1.2 ou supérieur requis pour toutes les connexions
  • Authentification requise pour toutes les requêtes API
  • Chiffrement AES-256 pour les données au repos
  • Journal d'audit complet de tous les accès API
  • Application du contrôle d'accès basé sur les rôles (RBAC)

Certifications de Conformité

  • CJIS Security Policy compliant
  • FedRAMP Moderate authorized
  • Certifié SOC 2 Type II
  • Certifié ISO 27001
  • Conforme RGPD pour les données UE

Tests et Environnement Sandbox

Testez votre intégration dans notre environnement sandbox avant de passer en production. Le sandbox fournit des données de test réalistes et une fonctionnalité API complète sans affecter les systèmes de production.

Environnement Sandbox

Environnement sandbox complet avec des données de test réalistes. Testez toutes les opérations API sans affecter les données de production.

Jeux de Données de Test

Jeux de données de test préremplis incluant des entités, relations et alertes d'exemple pour des tests complets.

Certification d'Intégration

Complétez notre processus de certification pour devenir un partenaire d'intégration officiel Public Safety avec listing marketplace.

Processus de Test d'Intégration

  1. Demandez l'accès au sandbox via le portail partenaires
  2. Développez et testez votre intégration contre l'API sandbox
  3. Soumettez votre intégration pour révision par notre équipe
  4. Complétez l'évaluation de sécurité et les tests de pénétration
  5. Recevez la certification et déployez en production

Devenir Partenaire d'Intégration

Intéressé par l'intégration avec Public Safety Command Center ? Remplissez le formulaire ci-dessous et notre équipe de partenariats vous contactera pour discuter des prochaines étapes.

Demande d'Intégration Fournisseur

Parlez-nous de vos besoins d'intégration et nous vous répondrons sous 2-3 jours ouvrables.

Vos informations seront traitées conformément à notre politique de confidentialité. Nous ne partagerons jamais vos données avec des tiers.

Prêt à Intégrer ?

Contactez notre équipe d'intégration pour discuter de vos besoins et obtenir l'accès à notre environnement sandbox.