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)

We are currently researching native Syslog sink support for v1.1.0 to allow StacksAtlas events to be ingested by standard SIEM (Security Information and Event Management) platforms like Splunk or Elastic.

Webhooks

Future updates will include outbound Webhook support, allowing StacksAtlas to push alerts directly to platforms like Slack, Microsoft Teams, or PagerDuty without requiring intermediate email servers.