Skip to content

Users/v dhbedu/checkpoint email security - #14972

Open
v-dhbedu_microsoft (dhanunjaya1054) wants to merge 5 commits into
Azure:masterfrom
dhanunjaya1054:users/v-dhbedu/CheckpointEmailSecurity
Open

Users/v dhbedu/checkpoint email security#14972
v-dhbedu_microsoft (dhanunjaya1054) wants to merge 5 commits into
Azure:masterfrom
dhanunjaya1054:users/v-dhbedu/CheckpointEmailSecurity

Conversation

@dhanunjaya1054

Copy link
Copy Markdown
Contributor

Required items, please complete

Change(s):

  • See guidance below

Reason for Change(s):

  • See guidance below

Version Updated:

  • Required only for Detections/Analytic Rule templates
  • See guidance below

Testing Completed:

  • Yes

v-dhbedu and others added 3 commits August 11, 2026 00:45
…nector

The RestApiPoller for CheckPointEmailSecurityEvents was configured with
pagingInfoPlacement=QueryString for a POST endpoint. The Check Point
event/query API expects the scrollId pagination token in the POST request
body under requestData, not in the URL query string. This caused the
connector to re-fetch page 1 on every paginated call, producing thousands
of duplicate records per event (reported as 8,000+ duplicates for a single
event).

Fix:
- Changed pagingInfoPlacement from QueryString to Body
- Changed NextPageParaName from scrollId to requestData.scrollId so the
  token is correctly nested inside the requestData object in the POST body

Bumped solution version to 3.0.2.
- Increase queryWindowInMin from 5 to 1440 (1 day) for AntiPhishing and
  Spam exception poller endpoints to reduce duplicate re-ingestion
  volume, since Check Point's exceptions API returns a full snapshot
  with no delta/time filter.
- Add deduplicated Parser functions (CheckPointEmailSecAntiPhishingExceptions,
  CheckPointEmailSecuritySpamExceptions) that dedupe by EntityId via
  arg_max(TimeGenerated, *).
- Update connector UI (graphQueries, sampleQueries, dataTypes) to
  reference the new parser aliases instead of raw _CL tables, so the
  connector blade displays deduplicated data.
- Bump solution version to 3.1.0 and update ReleaseNotes.md.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
v-dhbedu and others added 2 commits August 24, 2026 23:29
Investigated whether pagingType: PersistentToken could genuinely fix
the exception-endpoint duplicate issue (as opposed to just reducing
poll frequency). Confirmed via Check Point's official API docs
(managing-exceptions.html) that GET /exceptions/{excType} only accepts
'excType' as a request parameter - there is no documented way to send
scrollId back in on a request, and the sample response even shows an
empty scrollId value. This confirms scrollId is purely an intra-request
depth-pagination cursor for one full snapshot listing, not a cross-poll
incremental/delta checkpoint like AirlockDigital, Atlassian, or Cyren
use PersistentToken for. PersistentToken would not have reduced
duplicates for this vendor endpoint and could risk sending an
unrecognized/stale scrollId on the next poll.

Reverted pagingType back to the original NextPageToken for both
AntiPhishing and Spam exception endpoints. The real duplicate fix
remains the deduplicated Parser functions + 1-day queryWindowInMin
already in place.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Per request, collapsed the incremental 3.0.3/3.0.4/3.0.5/3.1.0/3.1.1
package history back into a single v3.0.2 release containing all
accumulated changes:
- Events pagination fix (scrollId in request body, not query string)
- Exception endpoint duplicate mitigation (queryWindowInMin: 1440)
- Deduplicated Parser functions for AntiPhishing/Spam exceptions
- Connector UI (sampleQueries/dataTypes/graphQueries) updated to use
  parser aliases instead of raw duplicate-laden tables
- Reverted exception endpoint pagingType to NextPageToken (verified
  against Check Point's API docs that PersistentToken has no
  cross-poll delta capability for this endpoint)

Removed package zips 3.0.3.zip through 3.1.1.zip. Consolidated
ReleaseNotes.md into a single 3.0.2 entry describing all changes.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@v-atulyadav v-atulyadav self-assigned this Aug 25, 2026
@v-atulyadav
v-atulyadav requested a lite review from Copilot August 25, 2026 07:33
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants