Para Proveedores y Socios

Guía de Integración

Todo lo que necesita para integrar sus sistemas con Public Safety Command Center. Ya sea proveedor de datos, integrador de sistemas o socio tecnológico, esta guía cubre todos los puntos de integración, formatos de datos y mejores prácticas.

Resumen de Integración

Public Safety Command Center proporciona una arquitectura de integración completa y multicapa diseñada para operaciones de inteligencia y aplicación de la ley de nivel empresarial. Nuestra plataforma soporta tanto la ingesta de datos entrantes como el intercambio de datos salientes a través de múltiples protocolos y formatos.

200+
Endpoints de API
Completo
Soporte GraphQL
WebSocket
Streaming en Tiempo Real

Arquitectura de Integración

Nuestra arquitectura de integración soporta flujo de datos bidireccional, permitiendo a los proveedores enviar datos a Public Safety y recibir actualizaciones en tiempo real de la plataforma. Todas las integraciones están aseguradas con autenticación de nivel empresarial y cumplen con los estándares ENS, CCN e internacionales.

Integraciones Entrantes

Envíe datos a Public Safety desde sus sistemas. Ideal para proveedores de datos, fuentes OSINT y sistemas empresariales.

  • Ingesta de datos en tiempo real vía API
  • Importaciones de archivos por lotes (CSV, XML, JSON)
  • Pipelines automatizados de enriquecimiento de datos
  • Deduplicación y resolución de entidades

Integraciones Salientes

Reciba datos y alertas de Public Safety. Perfecto para sistemas downstream, dashboards y servicios de notificación.

  • Notificaciones webhook para eventos
  • Suscripciones GraphQL para datos en tiempo real
  • Exportaciones de datos programadas
  • Generación de informes personalizados

Autenticación y Autorización

Todo acceso a la API requiere autenticación. Soportamos múltiples métodos de autenticación para acomodar diferentes escenarios de integración y requisitos de seguridad.

Autenticación con API Key

Autenticación simple con token bearer para integraciones servidor a servidor. Las claves API tienen permisos específicos y pueden rotarse regularmente.

Authorization: Bearer <api_key>

OAuth 2.0 / OpenID Connect

Soporte completo de OAuth 2.0 para acceso delegado por usuario. Ideal para aplicaciones que actúan en nombre de usuarios con su consentimiento.

OAuth 2.0 / OpenID Connect

Autenticación con Token JWT

Tokens JWT de corta duración para autenticación sin estado. Los tokens incluyen claims de usuario y permisos para control de acceso granular.

argus_auth_token (JWT)

Ejemplo de Autenticación

Flujo de Autenticación con 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étodos de Integración

Elija el método de integración que mejor se adapte a su caso de uso. Soportamos integraciones REST, GraphQL, WebSocket y basadas en archivos.

API GraphQL

Nuestra interfaz API principal. GraphQL le permite solicitar exactamente los datos que necesita en una sola petición, reduciendo ancho de banda y mejorando el rendimiento.

  • Consulte exactamente los campos que necesita
  • Suscripciones en tiempo real para actualizaciones en vivo
  • Esquema fuertemente tipado con introspección
Explorar Esquema GraphQL

API REST

Endpoints RESTful tradicionales para operaciones CRUD simples y compatibilidad con herramientas existentes.

  • Métodos HTTP estándar (GET, POST, PUT, DELETE)
  • Cuerpos de solicitud y respuesta en JSON
  • Especificación OpenAPI 3.0 disponible
Ver Endpoints REST

WebSocket / Tiempo Real

Conexiones persistentes para streaming de datos en tiempo real. Reciba notificaciones instantáneas cuando los datos cambien.

  • Notificaciones push de baja latencia
  • Streaming de alertas y suscripciones de eventos
  • Manejo automático de reconexión
Documentación WebSocket

Importación / Exportación de Archivos

Operaciones de datos en masa a través de cargas de archivos y exportaciones programadas. Soporta múltiples formatos incluyendo CSV, Excel y XML.

  • Formatos CSV, XLSX, XML, JSON
  • Formato STIX 2.1 para inteligencia de amenazas
  • Importaciones programadas automatizadas

Formatos de Datos y Taxonomía

Entender nuestro modelo de datos es esencial para una integración exitosa. Public Safety utiliza una taxonomía estandarizada para entidades, relaciones y eventos.

Tipos de Entidad Principales

Public Safety soporta un conjunto completo de tipos de entidad para operaciones de aplicación de la ley e inteligencia. Cada tipo de entidad tiene atributos específicos, identificadores y capacidades de relación.

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

Formatos de Datos Soportados

Formatos de API

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

Formatos de Importación

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

Archivos Adjuntos

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

Ejemplo de Esquema de Entidad

Entidad Persona (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"
  }
}

Conectores Preconstruidos

Public Safety incluye conectores preconstruidos para sistemas comunes de aplicación de la ley, proveedores OSINT y plataformas empresariales. Se pueden desarrollar conectores personalizados para sistemas adicionales.

Sistemas de Aplicación de la Ley

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

Proveedores de Inteligencia y OSINT

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

Sistemas Empresariales

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

¿Necesita un conector personalizado? Nuestro equipo de integración puede construir conectores personalizados para sus sistemas propietarios. Contáctenos para discutir sus requisitos.

SDKs y Bibliotecas Cliente

Los SDKs oficiales simplifican la integración con interfaces de tipo seguro, lógica de reintento automático y manejo de autenticación incorporado.

JavaScript / TypeScript

SDK completo para entornos Node.js y navegador con soporte TypeScript.

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

Python

SDK Pythonico con soporte async para flujos de trabajo de ciencia de datos y automatización.

  • Python 3.10+
  • Async support
  • Type hints

Java / Kotlin

SDK de nivel empresarial para aplicaciones Java y Kotlin con soporte Android.

  • Java 17+
  • Kotlin coroutines
  • Android compatible

C# / .NET

SDK .NET moderno con patrones async/await para apps Windows y multiplataforma.

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

Go

Cliente Go ligero con soporte de contexto para servicios de alto rendimiento.

  • Go 1.21+
  • Context support
  • Zero dependencies

REST / cURL

Acceso directo a API REST con spec OpenAPI, colección Postman y documentación interactiva.

  • OpenAPI 3.0 spec
  • Postman collection
  • Interactive docs
Ejemplo de Uso de 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 y Notificaciones de Eventos

Los webhooks permiten a Public Safety enviar notificaciones en tiempo real a sus sistemas cuando ocurren eventos. Configure endpoints de webhook para recibir alertas, cambios de estado y actualizaciones de datos.

Eventos 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

Seguridad de Webhooks

  • Verificación de firma HMAC-SHA256 para autenticidad del payload
  • Reintento automático con backoff exponencial para entregas fallidas
  • Lista de IPs permitidas disponible para endpoints webhook
  • Claves de idempotencia para prevenir procesamiento duplicado
Payload de Webhook y Verificacióntypescript
// 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));
}

Requisitos de Seguridad

Todas las integraciones deben cumplir nuestros requisitos de seguridad para proteger datos sensibles de aplicación de la ley. Aplicamos estándares estrictos para autenticación, cifrado y control de acceso.

Requisitos Técnicos

  • TLS 1.2 o superior requerido para todas las conexiones
  • Autenticación requerida para todas las solicitudes API
  • Cifrado AES-256 para datos en reposo
  • Registro de auditoría completo de todo acceso API
  • Aplicación de control de acceso basado en roles (RBAC)

Certificaciones de Cumplimiento

  • CJIS Security Policy compliant
  • FedRAMP Moderate authorized
  • Certificado SOC 2 Tipo II
  • Certificado ISO 27001
  • Cumple RGPD para datos de la UE

Pruebas y Entorno Sandbox

Pruebe su integración en nuestro entorno sandbox antes de pasar a producción. El sandbox proporciona datos de prueba realistas y funcionalidad completa de API sin afectar sistemas de producción.

Entorno Sandbox

Entorno sandbox completo con datos de prueba realistas. Pruebe todas las operaciones API sin afectar datos de producción.

Conjuntos de Datos de Prueba

Datasets de prueba prepoblados incluyendo entidades de muestra, relaciones y alertas para pruebas completas.

Certificación de Integración

Complete nuestro proceso de certificación para convertirse en socio de integración oficial de Public Safety con listado en marketplace.

Proceso de Pruebas de Integración

  1. Solicite acceso al sandbox a través del portal de socios
  2. Desarrolle y pruebe su integración contra la API sandbox
  3. Envíe su integración para revisión por nuestro equipo
  4. Complete la evaluación de seguridad y pruebas de penetración
  5. Reciba certificación y despliegue a producción

Conviértase en Socio de Integración

¿Interesado en integrarse con Public Safety Command Center? Complete el formulario a continuación y nuestro equipo de partnerships se comunicará para discutir los próximos pasos.

Solicitud de Integración de Proveedor

Cuéntenos sobre sus necesidades de integración y le responderemos en 2-3 días hábiles.

Su información será manejada de acuerdo con nuestra política de privacidad. Nunca compartiremos sus datos con terceros.

¿Listo para Integrar?

Contacte a nuestro equipo de integración para discutir sus requisitos y obtener acceso a nuestro entorno sandbox.