跳转到内容
本站为社区维护的非官方中文翻译,与 Cloudflare, Inc. 无关联。本站不提供账户登录,请勿在任何非官方站点输入您的 Cloudflare 账户信息。官方文档:developers.cloudflare.com

Sentinel

最后更新 查看 MarkdownAgent 设置

Cloudflare 与 Microsoft Sentinel 集成,使你能在集中的空间中更轻松地分析 Cloudflare 数据。Cloudflare 提供两个版本的此连接器。我们建议使用最新的 Codeless Connector 集成,因为它提供更简单的设置、成本管理,并与 Sentinel Data Lake ↗ 集成。

Sentinel CCF Solution ↗(推荐):Codeless Connector Framework (CCF) 使合作伙伴、高级用户和开发人员能够创建自定义连接器,将数据摄取到 Microsoft Sentinel。

Sentinel Function Based Connector ↗:Microsoft Sentinel 的 Cloudflare 连接器使用 Azure Functions ↗ 处理来自 Cloudflare Logpush 服务的安全日志,并将其直接摄取到 SIEM 平台。

本指南提供清晰的分步说明,介绍如何使用 Azure Blob Storage 将 Cloudflare 日志与 Microsoft Sentinel 的 CCF 连接器集成。按照这些步骤操作,你将能够在 Microsoft Sentinel 中安全地收集、存储和分析 Cloudflare 日志,从而增强组织的安全监控和事件响应能力。

步骤 1:先决条件

开始之前,请确保满足以下先决条件。

Azure 资源

  • 具有创建和管理资源权限的 Azure subscription(建议 Contributor 或 Owner 角色)。
  • 已启用 Azure Data Lake Storage Gen2 ↗(分层命名空间开启)的 Azure Storage account。通用 Logpush Azure 目标支持标准 Blob Storage,但 CCF 连接器需要分层命名空间。Logpush 会将 Cloudflare 日志文件写入此账户。
  • 存储账户内专用于接收 Cloudflare Logpush 文件的 Azure Blob container。CCF 连接器通过 Event Grid 监视此容器中的新文件。
  • 已部署在 Log Analytics workspace 之上的 Microsoft Sentinel workspace。连接器的 Data Collection Rule (DCR) 和 Data Collection Endpoint (DCE) 绑定到此 Log Analytics workspace,所有摄取的 Cloudflare 日志记录都会落入其中的表。
  • 具有要导出日志的域名或账户访问权限,以及配置 Logpush 作业权限的 Cloudflare 账户。

RBAC 角色

CCF 连接器使用属于 Cloudflare CCF 连接器应用程序的服务主体向 Azure 进行身份验证,该应用程序注册为多租户 Microsoft Entra 应用程序。部署连接器的 ARM 模板会自动为该服务主体分配所需角色。

部署用户必须在 Microsoft Sentinel workspace 上具有 Microsoft Sentinel Contributor、Contributor 或 Owner 权限,才能部署连接器资源。因为 ARM 模板会为服务主体创建角色分配,用户还必须在存储账户范围内具有 Owner 或 User Access Administrator。仅有 Contributor 和 Microsoft Sentinel Contributor 无法创建角色分配。

部署时,Cloudflare CCF 连接器服务主体会获得存储账户上的 Storage Blob Data Reader(从 Blob 容器读取日志文件)以及 Storage Queue Data Contributor(从 Storage Queue 读取并删除指针消息)。

详情请参阅 Microsoft 文档中的 Microsoft Sentinel 的 Azure 角色 ↗ 和 存储的 Azure 角色 ↗。

Event Grid 资源提供程序

托管存储账户的订阅中必须已注册 Microsoft.EventGrid 资源提供程序。在 Azure 门户的 Subscriptions(订阅) > 选择订阅 > Settings(设置) > Resource providers(资源提供程序) > 搜索 Microsoft.EventGrid 中验证注册状态。

也可以运行以下 Azure CLI 命令:

az provider register --namespace Microsoft.EventGrid --subscription <subscription-id>
az provider show --namespace Microsoft.EventGrid --subscription <subscription-id> --query "registrationState"

继续操作前,注册状态应报告为 Registered。

网络访问配置

默认情况下,存储账户必须允许公共网络访问,以便连接器的托管资源能够访问 Blob 容器端点和 Storage Queue 端点。

  • 如果未使用 Network Security Perimeter (NSP) 限制访问,请打开存储账户的 Networking(网络) 刀片,并将 Public network access(公共网络访问) 设置为 Enabled from all networks(从所有网络启用)。
  • 不支持使用选定的虚拟网络或 IPv4 CIDR 范围限制访问,因为 Azure Storage 防火墙在 IP 范围和调用方区域亲和性方面存在限制。
  • 如果合规性要求网络限制,请改用 Azure Network Security Perimeter (NSP) ↗。在 NSP 规则中包含 Sentinel 服务标记入站范围,并将 Event Grid 系统主题订阅配置为使用系统分配的托管标识投递。

完整选项请参阅 Microsoft 的 为 Sentinel 启用存储网络安全 ↗ 指南。

存储账户与 Sentinel 共置

Azure Blob Storage 账户和 Microsoft Sentinel workspace 必须位于同一 Azure 订阅和同一资源组 中。将这些资源拆分到不同订阅或资源组的部署会在 ARM 模板验证期间失败。详情请参阅故障排除。

步骤 2:设置 Logpush 作业

  1. 登录 Cloudflare 仪表板 ↗,并选择你的账户和域名。

  2. 前往 Analytics(分析) > Logs(日志) 并选择 Logpush。

  3. 选择 Create Logpush Job(创建 Logpush 作业)。选择要导出的日志类型(例如 HTTP requests(HTTP 请求))。

  4. 对于目标,选择 Azure Blob Storage(Azure Blob 存储)。

  5. 输入你的 Azure Blob Storage 详细信息:

    • SAS Token(Shared Access Signature)

    要从 Azure 门户生成 SAS 令牌,首先导航到你的存储账户。在 Data Storage(数据存储) 部分下,选择 Containers(容器) 并选择相关容器。在设置中,找到并选择 Shared access signature(共享访问签名)。配置所需权限,例如 write 和 create,并指定令牌的开始和过期日期。配置完成后,相应地生成 SAS 令牌。

  6. 保存并激活 Logpush 作业。

完整详情请参阅 Cloudflare Logpush to Azure 文档。

步骤 3:安装 Cloudflare CCF 解决方案

  1. 登录 Azure 门户并打开你的 Microsoft Sentinel workspace。如果还没有,请按照 Microsoft 的入门指南 ↗创建 Log Analytics workspace 并在其上启用 Microsoft Sentinel。
  2. 在左侧导航窗格的 Content management(内容管理) 下,选择 Content hub(内容中心)。如果页面显示为空,请刷新并等待内容列表加载。
  3. 在搜索栏中输入 Cloudflare 并按 Enter。
  4. 选择 Cloudflare CCF 解决方案并选择 Install(安装)。
  5. 安装解决方案后,选择 Manage(管理)。
  6. 选择 Cloudflare (Using Blob Container) (via Codeless Connector Framework) 并选择 Open connector page(打开连接器页面)。
Azure 门户

步骤 4:配置 CCF 连接器

在连接器页面上填写以下字段:

  • Service Principal ID(服务主体 ID):此字段会预填充租户中 Cloudflare CCF 连接器服务主体的对象 ID。如果为空,请确保已在 Microsoft Entra 租户中为 Cloudflare CCF 连接器应用程序授予管理员同意,然后重新加载页面。详情请参阅 Microsoft 的管理员同意工作流 ↗。
  • Blob Container URL(Blob 容器 URL):在 Azure 门户中打开接收 Cloudflare 日志的存储账户。在 Data storage(数据存储) > Containers(容器) 下打开目标容器,前往 Properties(属性) 并复制 URL。
  • Storage Account Resource Group Name(存储账户资源组名称)、Storage Account Location(存储账户位置) 和 Storage Account Subscription ID(存储账户订阅 ID):可在存储账户的 Overview(概览) 页面获取。
  • Event Grid System Topic Name(Event Grid 系统主题名称):首次部署时将此字段留空。ARM 模板会自动创建该主题。如果要重新配置现有部署,请在 Azure 门户中打开 Event Grid > System topics(系统主题),按位置筛选,并复制 Source(源) 与存储账户匹配的主题名称。

选择 Connect(连接) 以开始部署。部署完成后,Azure 门户会显示 Deployment succeeded 通知,按钮会变为 Disconnect(断开连接)。

配置字段

步骤 5:验证日志摄取

  1. 在 Azure 门户中打开为 Sentinel 实例提供支持的 Log Analytics workspace。

  2. 在左侧导航窗格中选择 Logs(日志)。

  3. 在编辑器中输入以下查询并选择 Run(运行):

    CloudflareV2_CL
    | take 10
  4. 确认已返回 Cloudflare 日志记录。

数据连接器Cloudflare 流量概览

故障排除

CreateDataFlowResources 部署错误

ARM 模板部署失败,错误类似:

InvalidTemplate: Deployment template validation failed:
'The resource 'Microsoft.Resources/deployments/CreateDataFlowResources' is not defined in the template.'

CCF 连接器的 ARM 模板在单个资源组范围内运行,并将存储账户、Blob 容器、Event Grid 系统主题、Storage Queue、Data Collection Rule (DCR)、Data Collection Endpoint (DCE) 和 Microsoft Sentinel workspace 作为共置资源交叉引用。如果其中任何资源位于部署范围之外,模板将无法解析引用,并在创建任何内容之前验证失败。

要解决该错误:

  1. 验证共置:在 Azure 门户中打开存储账户和 Microsoft Sentinel workspace(或其底层 Log Analytics workspace),并在 Overview(概览) 刀片上确认 Resource group(资源组) 和 Subscription(订阅) 匹配。如果不匹配,请将存储账户移动到托管 Sentinel 的资源组,或在该资源组中创建新的存储账户。
  2. 验证网络访问:确认存储账户已启用公共网络访问,或已按先决条件所述配置 Network Security Perimeter。不支持使用 IPv4 CIDR 地址的选定网络限制。
  3. 重试部署:对齐资源后,重新运行 ARM 模板部署。CreateDataFlowResources 错误不应再出现。

存储相关失败模式和缓解措施的完整列表,请参阅 Microsoft 的 Azure Storage Blob 连接器故障排除指南 ↗。

支持的日志

我们支持在 Sentinel Connectors(CCF 和基于 Function 的)中使用以下字段。你可以按照 Enable Microsoft Azure 文档中所述,使用我们的 logpush 功能将所有日志字段推送到 Azure。

CCF 连接器会在存在规范等价项时,将 Cloudflare 日志字段规范化为 Microsoft Sentinel ASIM schema ↗(例如 ClientIP 变为 SrcIpAddr,EdgeResponseStatus 变为 HttpStatusCode),并保留没有 schema 等价项的 Cloudflare 原生名称。在针对连接器输出表的 KQL 查询中,请使用下列表中的字段名称。

Parser fields

Application
BotScore
BotScoreSrc
CacheCacheStatus
CacheResponseBytes
CacheResponseStatus
CacheTieredFill
ClientASN
ClientASNDescription
ClientDeviceType
ClientIPClass
ClientMatchedIpFirewall
ClientRefererHost
ClientRefererPath
ClientRefererQuery
ClientRefererScheme
ClientRequestPath
ClientRequestProtocol
ClientRequestQuery
ClientRequestScheme
ClientRequestURI
ClientTcpRtt
ClientTlsClientHelloServerName
ClientTlsStatus
ClientXRequestedWith
ColoCode
ConnectTimestamp
Datetime
DisconnectTimestamp
DstBytes
DstIpAddr
DstPortNumber
DvcAction
EdgeColoCode
EdgeColoID
EdgeEndTimestamp
EdgePathingOp
EdgePathingSrc
EdgePathingStatus
EdgeRateLimitAction
EdgeRateLimitID
EdgeRequestHost
EdgeResponseCompressionRatio
EdgeResponseStatus
EdgeServerIP
EdgeStartTimestamp
EventResult
EventSubType
FirewallMatchesSources
HttpContentType
HttpReferrerOriginal
HttpRequestHeaderHost
HttpRequestMethod
HttpStatusCode
HttpUserAgentOriginal
IpFirewall
MatchIndex
NetworkProtocol
NetworkRuleName
OriginProto
OriginResponseBytes
OriginResponseHTTPExpires
OriginResponseHTTPLastModified
OriginResponseTime
OriginSSLProtocol
OriginTcpRtt
OriginTlsCipher
OriginTlsFingerprint
OriginTlsMode
OriginTlsProtocol
OriginTlsStatus
OriginatorRayID
ParentRayID
ProxyProtocol
RayID
SecurityLevel
SrcBytes
SrcGeoCountry
SrcIpAddr
SrcPortNumber
TimeGenerated
Timestamp
TlsCipher
TlsVersion
WAFAction
WAFFlags
WAFMatchedVar
WAFProfile
WAFRuleID
WAFRuleMessage
WorkerCPUTime
WorkerStatus
WorkerSubrequest
WorkerSubrequestCount
ZoneID

Workbook fields

ClientDeviceType
SrcIpAddr
ClientIPClass
ClientRequestProtocol
ClientRequestReferer
ClientRequestURI
ClientRequestUserAgent
EdgePathingOp
EdgePathingSrc
EdgePathingStatus
EdgeResponseContentType
HttpRequestMethod
HttpStatusCode
TimeGenerated
threat

Analytic rules

ClientIPClass
ClientRequestURI
DstBytes
HttpRequestMethod
HttpStatusCode
HttpUserAgentOriginal
SrcBytes
SrcGeoCountry
SrcIpAddr
TimeGenerated
WAFAction
WAFRuleID
WAFRuleMessage

Hunting queries

ClientRequestURI
ClientTlsStatus
EdgeRequestHost
EdgeResponseStatus
HttpStatusCode
HttpUserAgentOriginal
NetworkRuleName
OriginTlsStatus
SrcGeoCountry
SrcIpAddr
TimeGenerated

资源

Download Cloudflare's CCF Sentinel Solution ↗
Microsoft Data Lake Overview ↗
About the CCF Platform ↗

这篇文档对您有帮助吗?