你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。

GitHub 高级安全功能与微软云端防御集成 - 沙盒项目

本指南提供了沙盒项目的设置步骤,帮助您端到端地评估GitHub高级安全性(GHAS)与Microsoft Defender for Cloud的集成,使用简单的用例。

GHAS与Defender for Cloud的集成通过将运行时风险和上下文与原始代码关联,最大化Microsoft的云原生应用安全,从而实现更快的AI修复。

遵循本指南,您可以:

  • 为 Defender for Cloud 覆盖范围设置 GitHub 存储库。
  • 创建运行时风险因素。
  • 将代码链接到运行时资源。
  • 在 Defender for Cloud 中测试实际用例。

先决条件

Aspect 详细信息
环境要求 - 在 Defender for Cloud 中创建有连接器的 GitHub 帐户
- GHAS 许可证
- 在订阅上启用 Defender 云安全状况管理 (DCSPM)
- 智能 Microsoft Security Copilot 副驾驶®(可选,用于自动修正)
角色和权限 - 安全管理员权限
- Azure 订阅的安全管理员(查看 Defender for Cloud 中的安全检查结果)
- GitHub组织所有者
云环境 仅在商业云中可用(不在 Azure 政府、世纪互联运营的Azure或其他主权云中)。

准备好你的环境

步骤 1:设置GitHub存储库并运行工作流

若要测试集成,请使用沙盒示例GitHub已包含所有内容的存储库来生成易受攻击的容器映像。

在你建立仓库之前:

  1. 将以下存储库克隆到GitHub组织:

    该仓库启用了 GHAS,并已接入启用 Defender 云安全态势管理的 Azure 租户。

  2. 在存储库中,执行以下步骤:

    1. 转到设置。
    2. 在左窗格中,选择“机密和变量>操作”。 然后选择 “新建存储库机密”。
    3. 在存储库或组织级别添加以下机密:
    变量 Description
    ACR_ENDPOINT 容器注册表的身份验证服务器。
    ACR_USERNAME 容器注册表的用户名。
    ACR_PASSWORD (ACR密码) 容器注册表的密码。

    注释

    可以为这些变量选择任何名称。 它们不需要遵循特定模式。

您可以通过以下步骤在Azure门户中找到容器注册表认证服务器、用户名和密码:

  1. 选择要部署到的容器注册表。
  2. 在 “设置”下,选择 “访问密钥”。
  3. “访问密钥”窗格显示身份验证服务器、用户名和密码的密钥。

在存储库中,选择操作,选择生成和推送到 ACR工作流,然后选择运行工作流。

检查镜像是否已部署到您的容器注册表。 对于示例存储库,镜像应位于名为mdc-mock-0001的注册表中,并使用标签mdc-ghas-integration。

将 mdc-mock-0001:mdc-ghas-integration 镜像作为正在运行的容器部署到集群上。 将容器镜像部署到集群的一种方法是连接集群并使用命令 kubectl run 。 下面是 Azure Kubernetes 服务(AKS)的示例:

  1. 设置群集订阅:

    az account set --subscription $subscriptionID
    
  2. 设置群集的凭据:

    az aks get-credentials --resource-group $resourceGroupName --name $kubernetesClusterName --overwrite-existing
    
  3. 部署镜像:

    kubectl run $containerName --image=$registryName.azurecr.io/mdc-mock-0001:mdc-ghas-integration
    

步骤 2:创建示例风险因素(业务关键规则)

Defender for Cloud 检测到此集成的一个风险因素是业务关键性。 组织可以创建规则,将资源标记为业务关键。

  1. 在 Defender for Cloud 门户中,转到 “环境设置>资源关键性”。
  2. 在右窗格中,选择要打开Microsoft Defender 的链接。
  3. 选择“ 创建新分类”。
  4. 输入名称和说明。
  5. 在查询生成器中,选择 “云资源”。 编写查询以将 资源名称 设置为等于部署到群集的容器的名称进行验证。 然后选择“下一步”。
  6. 在 “预览资产 ”页上,如果Microsoft Defender 检测到资源,则容器的名称将显示为 K8s-container 或 K8s-pod 的资产类型。 即使名称尚不可见,请继续执行下一步。
  7. 选择关键级别,然后查看并提交分类规则。

注释

Defender在检测到容器后,会对该容器施加关键性标签。 此过程最多可能需要 24 小时。

步骤 3:验证环境是否已准备就绪

验证确认您的环境已正确配置,能够呈现代码到运行时的推荐并生成可操作的结果。

在验证过程中,Defender 验证代码到运行时的完整可见性。

  • Defender for Cloud 持续监控源代码仓库的安全漏洞。
  • 在部署之前,对构建工件(如容器映像)在容器注册表中进行扫描。
  • 将监视部署到 Kubernetes 群集的运行时工作负荷,以防范安全风险。
  • Defender for Cloud 关联并跟踪从代码到生成和部署再到运行时的每个工件。

注释

应用上述步骤后,最长可能需要 24 小时才能查看以下结果。

测试 GitHub 无代理扫描功能是否检测到存储库。

进入云安全资源管理器,运行以下列表中描述的验证查询。 这些验证查询测试 Defender for Cloud 是否能识别由您的流水线和工作负载产生的工件。 如果查询返回结果,则表示扫描和相关性按预期工作。

注释

如果未返回任何结果,则可能表示尚未生成项目、未配置扫描或缺少权限。

  • 验证 Azure 容器注册表 中的 Defender for Cloud 是否扫描了容器映像并用它创建容器。
  • 在查询中,添加适合特定部署的条件。
  • 验证容器是否正在运行,并且 Defender for Cloud 扫描了 AKS 群集。
  • 验证是否在 Defender for Cloud 端正确配置了风险因素。 在 Defender for Cloud 清单页上搜索容器名称,应会看到它标记为关键。

注释

只有在风险因素尚未在你的环境中配置时,才需要验证风险因素配置。

成功的验证可确保后续步骤(如建议、市场活动以及GitHub问题生成)产生有意义的结果。