Block Telegram’s widget engine on macOS with Santa
The native Telegram for macOS 13.2.0 (ru.keepcoder.Telegram) runs bot-widget JavaScript in a separate XPC helper. A Santa signing-ID rule can prevent that helper from launching while allowing Telegram itself to run. This guide applies to that Mac client. Recheck the helper and the effective decision after Telegram updates. Telegram’s helper setup
-
Quit Telegram with ⌘Q so any running helper exits. If Santa is new to this Mac, install the official package and approve its extension under System Settings → General → Login Items & Extensions → Endpoint Security Extensions. Under Privacy & Security → Full Disk Access, turn on Santa Endpoint Security Extension. Run
santactl statusto confirm the daemon responds. The default Monitor mode enforces the rule. Santa installation · macOS approvals -
Locally managed Macs can run the command below to block the helper silently. It also updates an existing alerting rule for the same ID in place. On a centrally managed fleet, deploy the identifier with rule type
SIGNINGIDand policySILENT_BLOCKLIST. Santa still logs denials and suppresses its GUI and terminal notifications. To show alerts, use--blocklocally orBLOCKLISTin fleet policy. Santa rule referencesudo santactl rule --silent-block --signingid \ --identifier '6N38VWS5BX:ru.keepcoder.Telegram.WidgetEngine' -
Check the installed helper before reopening Telegram. With the silent rule, look for the signing ID above,
Rule: Blocked (SigningID, Silent), andExpected Decision: Denied by rule. If the helper is missing or the decision differs, recheck the client version and Santa policy.helper='/Applications/Telegram.app/Contents/XPCServices/WidgetEngineService.xpc/Contents/MacOS/WidgetEngineService' santactl fileinfo --key 'Signing ID' --key Rule --key 'Expected Decision' "$helper"
End-to-end result on Telegram for macOS 13.2.0 with Santa 2026.9. With the silent rule, opening a fresh private bot widget produced a Widget stopped placeholder, no new Santa alert, and a signing-ID denial in Santa’s log. Telegram kept the same process ID. In a separate test with the alerting rule, the original caption stayed visible and the chat responded normally after dismissing the Telegram Widgets alert.
To undo the local rule, run
sudo santactl rule --remove --signingid \
--identifier '6N38VWS5BX:ru.keepcoder.Telegram.WidgetEngine'
For a managed fleet, remove the rule from the same policy that deployed it and sync the clients.