For Vendors & Partners

Integration Guide

Everything you need to integrate your systems with Argus Command Center. Whether you're a data provider, system integrator, or technology partner, this guide covers all integration points, data formats, and best practices.

Integration Overview

Argus Command Center provides a comprehensive, multi-layered integration architecture designed for enterprise-grade law enforcement and intelligence operations. Our platform supports both inbound data ingestion and outbound data sharing through multiple protocols and formats.

200+
API Endpoints
Full
GraphQL Support
WebSocket
Real-time Streaming

Integration Architecture

Our integration architecture supports bidirectional data flow, allowing vendors to push data into Argus and receive real-time updates from the platform. All integrations are secured with enterprise-grade authentication and comply with CJIS, FedRAMP, BSI C5, ISO 27001, and international security standards.

Inbound Integrations

Push data into Argus from your systems. Ideal for data providers, OSINT sources, and enterprise systems.

  • Real-time data ingestion via API
  • Batch file imports (CSV, XML, JSON)
  • Automated data enrichment pipelines
  • Deduplication and entity resolution

Outbound Integrations

Receive data and alerts from Argus. Perfect for downstream systems, dashboards, and notification services.

  • Webhook notifications for events
  • GraphQL subscriptions for real-time data
  • Scheduled data exports
  • Custom report generation

Authentication & Authorization

All API access requires authentication. We support multiple authentication methods to accommodate different integration scenarios and security requirements.

API Key Authentication

Simple bearer token authentication for server-to-server integrations. API keys are scoped to specific permissions and can be rotated regularly.

Authorization: Bearer <api_key>

OAuth 2.0 / OpenID Connect

Full OAuth 2.0 support for user-delegated access. Ideal for applications that act on behalf of users with their consent.

OAuth 2.0 / OpenID Connect

JWT Token Authentication

Short-lived JWT tokens for stateless authentication. Tokens include user claims and permissions for fine-grained access control.

argus_auth_token (JWT)

Authentication Example

Token Authentication Flowbash
# Obtain an access token
curl -X POST https://auth.knogin.com/v1/login \
  -H "Content-Type: application/x-www-form-urlencoded" \
  -d "email=your-email@example.com" \
  -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>"

Integration Methods

Choose the integration method that best fits your use case. We support REST, GraphQL, WebSocket, and file-based integrations.

GraphQL API

Our primary API interface. GraphQL allows you to request exactly the data you need in a single request, reducing bandwidth and improving performance.

  • Query exactly the fields you need
  • Real-time subscriptions for live updates
  • Strongly typed schema with introspection
Explore GraphQL Schema

REST API

Traditional RESTful endpoints for simple CRUD operations and compatibility with existing tooling.

  • Standard HTTP methods (GET, POST, PUT, DELETE)
  • JSON request and response bodies
  • OpenAPI 3.0 specification available
View REST Endpoints

WebSocket / Real-time

Persistent connections for real-time data streaming. Receive instant notifications when data changes.

  • Low-latency push notifications
  • Alert streaming and event subscriptions
  • Automatic reconnection handling
WebSocket Documentation

File Import / Export

Bulk data operations through file uploads and scheduled exports. Supports multiple formats including CSV, Excel, and XML.

  • CSV, XLSX, XML, JSON formats
  • STIX 2.1 threat intelligence format
  • Automated scheduled imports

Data Formats & Taxonomy

Understanding our data model is essential for successful integration. Argus uses a standardized taxonomy for entities, relationships, and events.

Core Entity Types

Argus supports a comprehensive set of entity types for law enforcement and intelligence operations. Each entity type has specific attributes, identifiers, and relationship capabilities.

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

Supported Data Formats

API Formats

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

Import Formats

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

File Attachments

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

Entity Schema Example

Person Entity (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": "john.doe@example.com" },
    { "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"
  }
}

Pre-Built Connectors

Argus includes pre-built connectors for common law enforcement systems, intelligence providers, and enterprise platforms. Custom connectors can be developed for additional systems.

Law Enforcement Systems

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

Intelligence & OSINT Providers

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

Enterprise Systems

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

Need a custom connector? Our integration team can build custom connectors for your proprietary systems. Contact us to discuss your requirements.

SDKs & Client Libraries

Official SDKs simplify integration with type-safe interfaces, automatic retry logic, and built-in authentication handling.

JavaScript / TypeScript

Full-featured SDK for Node.js and browser environments with TypeScript support.

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

Python

Pythonic SDK with async support for data science and automation workflows.

  • Python 3.10+
  • Async support
  • Type hints

Java / Kotlin

Enterprise-grade SDK for Java and Kotlin applications with Android support.

  • Java 17+
  • Kotlin coroutines
  • Android compatible

C# / .NET

Modern .NET SDK with async/await patterns for Windows and cross-platform apps.

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

Go

Lightweight Go client with context support for high-performance services.

  • Go 1.21+
  • Context support
  • Zero dependencies

REST / cURL

Direct REST API access with OpenAPI spec, Postman collection, and interactive documentation.

  • OpenAPI 3.0 spec
  • Postman collection
  • Interactive docs
SDK Usage Example (TypeScript)typescript
import { ArgusClient } from '@argus/sdk';

// Initialize the client
const argus = new ArgusClient({
  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 & Event Notifications

Webhooks allow Argus to push real-time notifications to your systems when events occur. Configure webhook endpoints to receive alerts, status changes, and data updates.

Available Events

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

  • HMAC-SHA256 signature verification for payload authenticity
  • Automatic retry with exponential backoff for failed deliveries
  • IP allowlisting for webhook endpoints available
  • Idempotency keys to prevent duplicate processing
Webhook Payload & Verificationtypescript
// 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));
}

Security Requirements

All integrations must meet our security requirements to protect sensitive law enforcement data. We enforce strict standards for authentication, encryption, and access control.

Technical Requirements

  • TLS 1.2 or higher required for all connections
  • Authentication required for all API requests
  • AES-256 encryption for data at rest
  • Complete audit logging of all API access
  • Role-based access control (RBAC) enforcement

Compliance Certifications

  • CJIS Security Policy compliant
  • FedRAMP Moderate authorized
  • SOC 2 Type II certified
  • ISO 27001 certified
  • GDPR compliant for EU data

Testing & Sandbox Environment

Test your integration in our sandbox environment before going live. The sandbox provides realistic test data and full API functionality without affecting production systems.

Sandbox Environment

Full-featured sandbox environment with realistic test data. Test all API operations without affecting production data.

Test Data Sets

Pre-populated test datasets including sample entities, relationships, and alerts for comprehensive testing.

Integration Certification

Complete our certification process to become an official Argus integration partner with marketplace listing.

Integration Testing Process

  1. Request sandbox access through the partner portal
  2. Develop and test your integration against the sandbox API
  3. Submit your integration for review by our team
  4. Complete security assessment and penetration testing
  5. Receive certification and deploy to production

Become an Integration Partner

Interested in integrating with Argus Command Center? Fill out the form below and our partnerships team will reach out to discuss next steps.

Vendor Integration Request

Tell us about your integration needs and we'll get back to you within 2-3 business days.

Your information will be handled according to our privacy policy. We'll never share your details with third parties.

Ready to Integrate?

Contact our integration team to discuss your requirements and get access to our sandbox environment.