Skip to main content

Integrations Overview

Containment.AI integrates with your existing security infrastructure to provide comprehensive AI governance. This guide covers available integrations and how they work.

Available Integrations​

Core Integrations​

IntegrationPurposePlans
Chrome ExtensionBrowser-level policy enforcementAll
SIEMSecurity event forwardingPro, Enterprise
MDMDevice management deploymentPro, Enterprise
Site ControlsPer-site policy overridesPro, Enterprise

Identity Providers​

IntegrationPurposePlans
SSOSingle sign-on authenticationEnterprise
SCIMUser provisioning/deprovisioningEnterprise

Integration Status​

Check integration health at Integrations:

StatusIndicatorMeaning
Connected🟢 GreenWorking normally
Degraded🟡 YellowPartial issues
Disconnected🔴 RedNot working
Not Configured⚪ GraySetup needed

Setting Up Integrations​

General Process​

  1. Navigate to Integrations
  2. Find the integration you want
  3. Click Configure or Connect
  4. Follow the setup wizard
  5. Test the connection
  6. Enable in production

Requirements​

Most integrations require:

  • Admin access to both systems
  • API keys or OAuth credentials
  • Network connectivity
  • Appropriate permissions

Data Flow​

Outbound Data​

What Containment.AI sends to integrations:

  • Alert notifications
  • Audit events
  • Usage metrics
  • Health status

Inbound Data​

What integrations send to Containment.AI:

  • User directory (SCIM)
  • Authentication (SSO)
  • Device status (MDM)

Privacy​

Integration data handling:

  • Content is never shared
  • Metadata only where needed
  • Compliant with privacy requirements

Authentication​

API Keys​

Some integrations use API keys:

  • Generate in integration settings
  • Rotate regularly
  • Store securely

OAuth​

Others use OAuth flow:

  • Authorize in the connected system
  • Tokens managed automatically
  • Re-authorize if expired

SAML/OIDC​

Identity integrations use:

  • SAML 2.0 for SSO
  • OIDC for modern auth
  • Standard protocols

Webhooks​

Receiving Webhooks​

Configure external systems to send data:

  1. Get your webhook URL from integration settings
  2. Configure the external system
  3. Test with sample data

Sending Webhooks​

Configure Containment.AI to send events:

  1. Click Add Webhook
  2. Enter destination URL
  3. Select events to send
  4. Add authentication headers
  5. Test and save

Testing Integrations​

Connection Test​

Verify basic connectivity:

  1. Click Test Connection
  2. View test results
  3. Troubleshoot if needed

Data Test​

Send test data:

  1. Click Send Test Event
  2. Check the receiving system
  3. Verify data format

End-to-End Test​

Full workflow testing:

  1. Trigger a policy
  2. Watch the alert flow
  3. Verify in connected systems

Troubleshooting​

Common Issues​

Connection Refused

  • Check firewall rules
  • Verify URL is correct
  • Confirm network access

Authentication Failed

  • Rotate API keys
  • Re-authorize OAuth
  • Check credentials

Data Not Appearing

  • Verify event selection
  • Check data format
  • Review logs

Logs​

View integration logs:

  1. Open integration settings
  2. Click Logs tab
  3. Filter by status/date
  4. Review error details

Best Practices​

Security​

  • Use least privilege
  • Rotate credentials regularly
  • Monitor integration health

Reliability​

  • Set up alerts for failures
  • Have fallback plans
  • Test periodically

Documentation​

  • Document all integrations
  • Note credentials location
  • Track changes

Next Steps​