|
| 1 | +# Check Point Email Security Solution for Microsoft Sentinel |
| 2 | + |
| 3 | +## Overview |
| 4 | + |
| 5 | +The Check Point Email Security (Harmony Email & Collaboration) solution for Microsoft Sentinel enables you to ingest security events and audit logs from Check Point's Email Security platform using the Codeless Connector Framework (CCF). This connector provides visibility into advanced email threats including: |
| 6 | + |
| 7 | +## Data Collected |
| 8 | + |
| 9 | +The connector ingests data into four custom tables in your Log Analytics workspace: |
| 10 | + |
| 11 | +- Security events including phishing, malware, DLP, and other threat detections with severity levels, confidence indicators, and remediation actions |
| 12 | +- Anti-phishing whitelist and exception rules configured in your tenant |
| 13 | +- Spam whitelist and exception rules configured in your tenant |
| 14 | +- Administrative actions and system events including login/logout, configuration changes, and other audit trail data |
| 15 | + |
| 16 | +### Key Fields in Security Events |
| 17 | + |
| 18 | +- **EventType** - Type of security event (dlp, phishing, malware, etc.) |
| 19 | +- **Severity** - Severity level (Low, Medium, High, Highest) |
| 20 | +- **ConfidenceIndicator** - Detection confidence (malicious, suspicious) |
| 21 | +- **SenderAddress** - Email sender associated with the event |
| 22 | +- **State** - Current event state (active, dismissed) |
| 23 | +- **Saas** - Source platform (office365_emails, gmail) |
| 24 | + |
| 25 | +## Prerequisites |
| 26 | + |
| 27 | +Before configuring the connector, you need: |
| 28 | + |
| 29 | +1. **Microsoft Sentinel workspace** with read and write permissions |
| 30 | +2. **Check Point Infinity Portal account** with access to: |
| 31 | + - Harmony Email & Collaboration service |
| 32 | + - Logs as a Service capability |
| 33 | + |
| 34 | +### API Credentials Required |
| 35 | + |
| 36 | +You need **two separate API keys** from the Check Point Infinity Portal: |
| 37 | + |
| 38 | +| Credential | Service | Purpose | |
| 39 | +|------------|---------|---------| |
| 40 | +| Client ID + Client Secret | Harmony Email & Collaboration | Security events and exceptions | |
| 41 | +| Audit Client ID + Audit Client Secret | Logs as a Service | Audit logs | |
| 42 | + |
| 43 | +## How to Connect |
| 44 | + |
| 45 | +### Step 1: Generate API Keys in Check Point Infinity Portal |
| 46 | + |
| 47 | +1. Log in to your [Check Point Infinity Portal](https://portal.checkpoint.com) |
| 48 | +2. Navigate to **Global Settings** > **API Keys** |
| 49 | +3. Create the first API key: |
| 50 | + - Select service: **Harmony Email & Collaboration** |
| 51 | + - Save the **Client ID** and **Client Secret** |
| 52 | +4. Create the second API key: |
| 53 | + - Select service: **Logs as a Service** |
| 54 | + - Save the **Audit Client ID** and **Audit Client Secret** |
| 55 | + |
| 56 | +### Step 2: Identify Your API Base URL |
| 57 | + |
| 58 | +The API Base URL is region-specific. Use the appropriate URL for your tenant: |
| 59 | + |
| 60 | +| Region | API Base URL | |
| 61 | +|--------|--------------| |
| 62 | +| US | `https://cloudinfra-gw.portal.checkpoint.com` | |
| 63 | +| EU | `https://cloudinfra-gw-eu.portal.checkpoint.com` | |
| 64 | +| AP | `https://cloudinfra-gw-ap.portal.checkpoint.com` | |
| 65 | + |
| 66 | +### Step 3: Configure the Connector in Microsoft Sentinel |
| 67 | + |
| 68 | +1. In Microsoft Sentinel, navigate to **Data connectors** |
| 69 | +2. Search for **Check Point Email Security (via Codeless Connector Framework)** |
| 70 | +3. Click **Open connector page** |
| 71 | +4. Click **Add Connection** |
| 72 | +5. Enter the following: |
| 73 | + - **API Base URL** - Your region-specific base URL |
| 74 | + - **Client ID** - From Harmony Email & Collaboration API key |
| 75 | + - **Client Secret** - From Harmony Email & Collaboration API key |
| 76 | + - **Audit Client ID** - From Logs as a Service API key |
| 77 | + - **Audit Client Secret** - From Logs as a Service API key |
| 78 | +6. Click **Connect** |
| 79 | + |
| 80 | +### Multi-Tenant Support |
| 81 | + |
| 82 | +This connector supports ingesting data from multiple Check Point Email Security tenants. To add additional tenants, click **Add Connection** and provide the credentials for each tenant separately. |
| 83 | + |
| 84 | + |
| 85 | +## Resources |
| 86 | + |
| 87 | +- [Check Point Harmony Email & Collaboration Documentation](https://www.checkpoint.com/harmony/email-security/) |
0 commit comments