Overview
Cork is a security and compliance platform that helps MSPs monitor their clients’ security posture. By integrating Cork with MSPortal.ai, you can:- View compliance events, vulnerabilities, and endpoints in a centralized dashboard
- Track security metrics across all your managed clients
- Add security findings to the Planner for remediation tracking
- Include security data in client reports
Prerequisites
- Active Cork account with API access
- MSPortal.ai account with integration management permissions
- Cork API key with read access
Part 1: Generate Cork API Key
Before connecting to MSPortal.ai, you need to create an API key in Cork.Log into Cork
Navigate to API Settings
Create API Key
Copy API Key
Part 2: Connect Cork in MSPortal
The Cork connection page lists its tasks in the Setup guide: Connect, Import or match companies, Import devices and Review. See Connect and manage integrations for the tasks every connection shares.Connect
Open the connection page
Enter API Key
Test the connection
- Verify you copied the full API key without extra spaces
- Ensure the API key has not been revoked or expired
- Check that your Cork account has API access enabled
Save and continue
Import or match companies
This task opens Import or match Cork clients. Map Cork clients (organizations) to your MSPortal companies. This determines which data syncs to which company. Only data from matched clients syncs to MSPortal.Load clients
Review suggestions
Match the rest
Import missing companies
Import devices
Cork sends endpoint data that adds security information to your devices, so there are no staged devices to import. This task shows what has synced:Review and finish setup
Open Review and select Finish setup once the required tasks are complete. Each match saves independently; finishing does not apply pending company links or wait for security imports.What Gets Synced
Cork integration syncs the following data types to MSPortal:Compliance Events
Security compliance findings from Cork, including:- Event type and description
- Affected entity (device, inbox, or domain)
- At-risk status
- Resolution status
- Creation date
Endpoints
Device and endpoint information:- Device name and hostname
- Operating system type and version
- IP addresses
- Last seen timestamp
Inboxes
Email inbox data:- Inbox identifier
- Associated user
- Domain information
Vulnerabilities
Software vulnerability data:- CVE identifier
- Affected software product and version
- Vendor information
- CVSS score (severity rating 0.0-10.0)
- EPSS score (exploitation probability)
- Cork priority (Critical, Accelerated, Routine)
- Known exploited status
Synchronization Schedule
After initial setup, data syncs automatically:Managing Your Integration
Open the Cork connection from Settings > Integrations to manage it:Checking or Replacing Your API Key
Open Connect to test the saved key or enter a replacement. Leave the masked value unchanged to keep the stored key. After testing a replacement, click Save changes and check the result. A test alone does not save a replacement. Verify the saved connection before you revoke the old key in Cork.Troubleshooting
Frequently asked questions
Does Test connection create the Cork connection?
Does Test connection create the Cork connection?
When do Cork company matches save?
When do Cork company matches save?
Do suggestions guarantee the correct company?
Do suggestions guarantee the correct company?
Does Run sync refresh the page only?
Does Run sync refresh the page only?
Does Finish setup mean all security data finished syncing?
Does Finish setup mean all security data finished syncing?
Can I rotate the Cork key by retesting a replacement?
Can I rotate the Cork key by retesting a replacement?
Do zero Cork findings prove a company is secure?
Do zero Cork findings prove a company is secure?
Security & Privacy
- API Key Storage: Your Cork API key is encrypted using Supabase Vault and never exposed in logs or responses
- Data Isolation: All synced data is tenant-isolated and only visible to your organization
- Read-Only Access: MSPortal only requires read access to Cork data; it never modifies your Cork configuration