How to Configure Connectors/Integrations
Prerequisites
Admin access or Integration Manage permission
API credentials for the tool you want to connect
Network access from Zeron to the external tool's API
Connecting an Integration
Navigation: Sidebar → Integrations
Step 1: Browse Available Integrations
Click Integrations in the sidebar.
Browse the list of available connectors organized by category:
| Category | Example Tools |
|---|
| Endpoint Security | Microsoft Defender, CrowdStrike, SentinelOne |
| Vulnerability Management | Tenable, Qualys, Rapid7 |
| Cloud Providers | AWS, Azure, GCP |
| Identity & Access | Azure AD, Okta, ZITADEL |
| Ticketing | Jira, ServiceNow |
| SIEM | Splunk, Microsoft Sentinel |
Step 2: Select and Configure
Click on the integration you want to connect.
A configuration form appears with required fields specific to that tool.
Common fields include:
| Field | Description |
|---|
| API Key / Token | Authentication credential for the external tool |
| API Endpoint / URL | The base URL of the tool's API |
| Tenant ID | For multi-tenant tools (e.g., Azure, Microsoft 365) |
| Client ID & Secret | For OAuth-based authentication |
| Sync Interval | How frequently to pull data |
Fill in all required fields.
Click Test Connection (if available) to verify the configuration.
Click Save to activate the integration.
> Warning: Store API keys securely. Never share API credentials via email or chat. Use the platform's secure credential storage.
Step 3: Verify the Connection
After saving, the integration status should show as Connected or Active.
Wait for the initial data sync to complete (may take 5-30 minutes depending on data volume).
Verify data is appearing in the Asset Inventory and Dashboard.
> Tip: Check the Dashboard's Integration Health section to confirm all connections are syncing successfully.
Managing Integrations
Viewing Integration Status
Each integration shows its current status: Active, Error, or Disconnected
Last sync time indicates when data was last pulled
Error messages help diagnose connection issues
Editing an Integration
Click on an active integration.
Update credentials or configuration as needed.
Click Save to apply changes.
Disabling/Removing an Integration
Click on the integration you want to disable.
Toggle off or click Remove to disconnect.
Historical data from the integration will be retained but no new data will sync.
Troubleshooting
| Issue | Solution |
|---|
| Connection test fails | Verify API credentials are correct and not expired. Check that the API endpoint URL is reachable. |
| Integration shows "Error" status | Check the error message for details. Common causes: expired tokens, permission changes, API rate limits. |
| No data appearing after connection | Wait for the initial sync cycle (up to 30 minutes). Verify the tool has data accessible via API. |
| Rate limiting errors | Reduce the sync frequency or contact support to adjust polling intervals. |
Related Articles
Getting Started with Interno
Prerequisites Before you begin, ensure you have: An active Zeron account with Interno access Admin or Security Analyst role assigned to your profile At least one security tool/integration ready to connect (e.g., Microsoft Defender, CrowdStrike, AWS) ...
How to Generate Reports
Prerequisites At least one integration connected and syncing Access to the Reports section Generating a Report Navigation: Sidebar → Reports Step 1: Open Reports Click Reports in the sidebar. The Reports page loads with available report types and ...
How to Set Up Alerts and Evidence Queries
Prerequisites Access to the Query Library section At least one integration connected and syncing For Evidence Queries: knowledge of your compliance framework's control identifiers Evidence Queries Navigation: Sidebar > Query Library > Evidences Tab ...
How to View and Manage Asset Inventory
Prerequisites At least one integration connected and syncing under Integrations Access to the Asset Inventory section Accessing Asset Inventory Navigation: Sidebar → Asset Inventory Click Asset Inventory in the sidebar. The page opens with two tabs: ...
How to View Proactive Risk Insights
Prerequisites At least one integration connected and syncing data Access to the Dashboard and ZIN Copilot How Proactive Insights Work ZIN continuously analyzes: Data Source What ZIN Looks For Integrations New vulnerabilities, configuration changes, ...