Integrations & API

StacksAtlas is designed to be a collaborative citizen of your IT ecosystem. While it functions as a standalone appliance, it provides several extensible touchpoints for automation and external monitoring.

SMTP (Email Alerts)

The core notification engine can be configured to send instant alerts for critical network events (e.g., Device Offline, IP Drift).

• Custom SMTP Support: Connect to any internal or cloud-based mail server (Office 365, Gmail, Mandrill).
• Threshold Management: Configure global or per-device frequency limits to prevent "alert fatigue."

Scalar REST API (Live)

The StacksAtlas background service exposes a local REST API that powers the dashboard. This API is now fully documented via Scalar and accessible directly on your appliance.

• Endpoint Access: Explore the interactive documentation at https://localhost:5001/api-docs.
• Authentication: Secured via Opaque Hashed API Keys (PBKDF2). Generate an individually revocable sa_ token from the StacksAtlas UI and pass it as a Bearer Token in the Authorization header.
• Security Audit: A dedicated /api/security/audit endpoint provides a lightweight, aggregate posture of your environment (Red/Yellow/Green counts), ideal for low-bandwidth status dashboards.
• Use Case: Export device lists to external Asset Management systems (CMDB) or trigger custom diagnostic sweeps programmatically.

OpenAVC Official Integration (v1.2.3)

StacksAtlas is now an official integration partner for the OpenAVC room control platform. The native StacksAtlas plugin allows our intelligence to function as a rich ecosystem bridge, bringing native network health into the OpenAVC command center.

• Real-Time Status Cards: High-level "Network Pulse" cards showing online device counts and critical security risks directly on your control surface.
• Vendor Composition: Automatically aggregates your network's hardware distribution (e.g., Cisco, Shure, Q-SYS) to provide at-a-glance inventory visibility.
• Security Risk Summaries: Beyond simple counts, the plugin now lists the specific names of devices with "Red" security grades, enabling instant identification of network threats.
• Zero-Config Setup: Uses the native StacksAtlas API Key system for instant, secure authentication between the NUC and the appliance.

Quick Start: Setting up the Integration

1. Generate API Key: In your StacksAtlas appliance, go to Settings > API Keys and generate a new key for OpenAVC. Copy the sa_ token.
2. Install Plugin: In the OpenAVC Programmer IDE, open the Plugins view, click the Browse tab, and install the StacksAtlas plugin.
3. Configure: Go to the Installed tab, enable the plugin, and enter your StacksAtlas URL (e.g., https://192.168.1.50:5001) and the API Key you generated.
4. Activate Pulse: Once the plugin status turns Green, navigate to the OpenAVC Dashboard. The "Network Pulse" card will automatically appear, streaming live data from your appliance.

System Logging (Syslog / SIEM) (v1.3.0)

StacksAtlas now supports native Syslog export (RFC5424) to allow real-time event streaming to enterprise SIEM platforms like Splunk, LogRhythm, or Elastic.

• Real-Time Auditing: Every discovery event, security risk detection, and system health change is streamed instantly over UDP.
• Centralized Correlation: Enterprise security teams can now correlate StacksAtlas device discovery events with global network logs.
• Protocol Standard: Uses the modern RFC5424 standard with support for custom Application Names (TAGs) for easy filtering in your SIEM.

Configuration

To enable SIEM export, navigate to Settings > Appliance Infrastructure. Enable the Syslog & SIEM Export toggle, provide the target Host and Port (Default 514), and click Restart & Apply.

Outbound Webhooks (v1.2.7)

StacksAtlas now features a resilient, multi-provider Outbound Webhook subsystem designed for instant notification without the overhead of SMTP. This allows the appliance to push real-time alerts directly into your team's existing communication channels.

Supported Providers

• Slack: Native integration with formatted blocks and color-coded status indicators.
• Microsoft Teams: Adaptive Card support for rich, actionable notifications within Teams channels.
• Discord: Webhook integration with embedded rich-text alerts.
• Generic HTTP: Custom JSON payloads for integration with Zapier, Make.com, or internal automation endpoints.

Reliability Features

• Circuit Breaker Protection: To prevent "alert storms" and protect both your appliance and the destination service, StacksAtlas automatically trips a circuit breaker if a webhook fails 5 consecutive times. This prevents dead endpoints from consuming system resources.
• Pre-flight Testing: Use the "Test Webhook" button in the UI to fire a dummy payload (e.g., "Device 'Test-Node' joined the network") to verify connectivity and formatting before going live.
• Encrypted Secrets: All webhook URLs and signing secrets are encrypted at rest using AES-GCM, ensuring that sensitive integration tokens remain private.

Configuration

1. Navigate to Settings > Notifications.
2. Select Add Webhook and choose your provider.
3. Provide a descriptive Name and the target URL (Webhook URI).
4. Select the Trigger Events you wish to subscribe to (e.g., "Device Down", "Critical Security Risk").
5. Click Create & Verify. We recommend running a Test Payload immediately to ensure the destination channel is receiving data.