.pkg。这是个人用户(或评估者)手动完成一次的体验。
整个设置过程为一次安装加两次授权:先批准系统扩展,再授予 Full Disk Access。无需 Terminal,无需 csrutil,无需开发者模式。若需要可同时省去这两次授权的零点击主机群路径,请参阅通过 MDM 部署。
在整个流程中,System Integrity Protection (SIP) 始终保持启用。该采集器是一个经过公证、以 Developer ID 签名的应用,其 Endpoint Security 扩展携带一份 Apple 颁发的预置描述文件,授权
com.apple.developer.endpoint-security.client entitlement。由于该 entitlement 是以合法方式授权的,你永远无需运行 csrutil disable,也无需启用开发者模式。目标 Mac 始终保持完全加固状态。What gets installed
采集器以单个组件形式交付:Hilt EDR(EDRApp.app,由团队 Cybe Corporation 签名,Team ID MVMB6LCP2A)。该应用内嵌两个 Apple 系统扩展——不含内核扩展 (kext)。
运行
.pkg 后:
.pkg 本身已公证,并以 Developer ID Installer 证书签名,因此 Gatekeeper 会在无任何警告的情况下接受它。
Install procedure
1
Run the notarized .pkg
双击
.pkg,并在提示时以管理员密码进行身份验证。安装程序会将 EDRApp.app 放入 /Applications,并注册 forwarder LaunchDaemon。由于软件包已公证并已装订(stapled),Gatekeeper 不会弹出任何“无法验证开发者”或恶意软件警告。安装无需重启。2
Launch the app — it requests the system extension
从
/Applications 中打开一次 Hilt EDR。首次启动时,应用会提交一个 OSSystemExtensionRequest 以激活 ESensor Endpoint Security 扩展,macOS 随即弹出系统提示,告知该扩展已被阻止并需要批准。在该提示上点击 Open System Settings(或 Allow)。应用会保持激活请求处于待定状态,直到你完成下一步。3
Approve the Endpoint Security extension
前往 System Settings → General → Login Items & Extensions → Endpoint Security Extensions,启用 ESensor,并进行身份验证。这是一道适用于每一款第三方 Endpoint Security 产品的 Apple 安全关卡——在没有 MDM 的情况下无法通过点击省去。一旦批准,该扩展即被允许加载。
4
Grant Full Disk Access to ESensor
前往 System Settings → Privacy & Security → Full Disk Access,为 ESensor 条目启用开关(显示为 ESensor / “Hilt EDR Sensor”)。完成上一步后,它会自动出现在此列表中。
Full Disk Access 条目名为 ESensor / “Hilt EDR Sensor”,而非 “EDRApp”——请为该条目开启开关。Full Disk Access 是任何 Endpoint Security 客户端的硬性要求(参见下文的 Full Disk Access)。
Why Full Disk Access is required
Endpoint Security 客户端在订阅事件之前,必须通过两道相互独立的运行时关卡。它们很容易混淆,因此请务必区分清楚:
经过公证并正确签名的采集器始终能通过第一道关卡。第二道关卡是 Full Disk Access,在独立流程中需由你(用户)完成。在 ESensor 获得 Full Disk Access 之前,
es_new_client() 会以 ES_NEW_CLIENT_RESULT_ERR_NOT_PERMITTED 失败。
ESensor 的设计能够自动从此情形中恢复。当它遇到 ERR_NOT_PERMITTED 时会退出,launchd 会在数秒后将其重新启动。因此,如果你在授予 Full Disk Access 之前启动应用,该扩展只会循环重启,直到你打开开关——此时下一次重启便会成功,事件随即开始流动。在授予 Full Disk Access 之后,你无需重启应用或 Mac。
这正是安装步骤以 Full Disk Access 结尾的原因。顺序很宽容——放在最后授予也没问题——但在该开关打开之前,传感器不会发送任何遥测。
SIP, notarization, and the sandbox
该构建的三项特性使其能够在一台正常、加固的 Mac 上运行:- SIP 保持启用。 ES 扩展位于一个已签名的 bundle 中,该 bundle 携带 Apple 颁发的预置描述文件,将 Endpoint Security entitlement 列入允许列表,因此在 SIP 开启的情况下,内核的可信执行层 (AMFI) 依然承认该 entitlement。无需
csrutil disable,无需systemextensionsctl developer on。 - 已公证并已装订。 应用、其扩展以及
.pkg均以 Developer ID 证书签名,使用 Hardened Runtime,并经 Apple 公证 + 装订。公证满足 Gatekeeper 的恶意软件/签名检查——它并非激活扩展的环节。扩展仍需被批准(步骤 3)或由 MDM 预先批准。 - ES 扩展不使用 App Sandbox。 Endpoint Security 扩展绝不能使用 App Sandbox;无论 Full Disk Access 状态如何,被沙盒化的宿主进程都会导致
es_new_client()以ERR_NOT_PERMITTED失败。
Verification — what you see once it is running
当扩展获得批准且 Full Disk Access 被授予后,ESensor 会连接其 Endpoint Security 客户端,forwarder 随即开始发送事件。你可以在主机上和仪表盘中确认安装情况: 在 Mac 上:- System Settings → General → Login Items & Extensions → Endpoint Security Extensions 显示 ESensor 已启用。
- System Settings → Privacy & Security → Full Disk Access 显示 ESensor / “Hilt EDR Sensor” 开关已打开。
- ESensor 扩展稳定运行(无重启循环),表示
es_new_client()已成功——既无ERR_NOT_ENTITLED也无ERR_NOT_PERMITTED。
platform / developer_id / adhoc / unsigned_or_invalid)、signing_id、team_id 和 cdhash,以及应用归因(application_id、application_display_name、responsible_pid、session_id、device_name)。完整 schema 请参阅事件数据模型。
在仪表盘背后,路径为:
What this install does NOT do
- 不会禁用 System Integrity Protection。 全程无
csrutil disable,无 Recovery 启动,无开发者模式。 - 不会安装内核扩展。 该采集器是完全运行于用户空间、基于 Apple 现代框架的系统扩展。
- 不会打开任何入站套接字,也不会“phone home”。 forwarder 仅向配置的接入端点发起出站 HTTPS。不存在任何入站监听器。
- 不会读取文件内容。 ESensor 采集事件元数据(路径、操作、签名身份、归因)——而非所涉文件的字节内容。
- 不会自动更新。 在早期访问期间,升级通过重新运行已公证的
.pkg完成;macOS 上尚不提供设备端自动更新。
Requirements
Hilt macOS 采集器处于早期访问阶段。此处描述的、SIP 保持开启的已公证
.pkg 安装方式即为正式交付模型。macOS 上尚不提供自动更新与设备端隔离响应。