Anpassen von Repositorybereitstellungen

Es gibt zwei primäre Möglichkeiten, die Bereitstellung Ihrer Repositoryinhalte für Microsoft Sentinel Arbeitsbereiche anzupassen. Jede Methode verwendet unterschiedliche Dateien und Syntax. Betrachten Sie daher diese Beispiele, um Ihnen den Einstieg zu erleichtern. Bevor Sie beginnen, stellen Sie sicher, dass die erforderlichen Repositoryverbindungs- und Bereitstellungsvoraussetzungen vorhanden sind.

Voraussetzungen

Zum Anpassen einer Repositorybereitstellung benötigen Sie eine vorhandene Repositoryverbindung. Informationen zum Erstellen eines Inhalts finden Sie unter Bereitstellen von benutzerdefinierten Inhalten aus Ihrem Repository. Stellen Sie nach dem Erstellen der Verbindung sicher, dass Sie diese Anforderungen erfüllen:

• Zugriff des Projektmitarbeiters auf Ihr GitHub-Repository oder Den Zugriff des Projektadministrators auf Ihr Azure DevOps-Repository
• Für GitHub aktivierte Aktionen und für Azure DevOps aktivierte Pipelines
• Stellen Sie sicher, dass benutzerdefinierte Inhaltsdateien, die Sie in Ihren Arbeitsbereichen bereitstellen möchten, in einem unterstützten Format vorliegen. Informationen zu unterstützten Formaten finden Sie unter Planen Ihres Repositoryinhalts.

Weitere Informationen zu bereitstellbaren Inhaltstypen finden Sie unter Planen Ihres Repositoryinhalts.

Anpassen des Workflows oder der Pipeline

Der Standardworkflow stellt nur Inhalte bereit, die seit der letzten Bereitstellung geändert wurden, basierend auf Commits im Repository. Passe den Workflow oder die Pipeline an, um verschiedene Deployment-Trigger zu konfigurieren oder Inhalte ausschließlich aus einem bestimmten Root-Ordner zu deployen.

Wählen Sie je nach Verbindungstyp eine der folgenden Registerkarten aus:

Skalieren Ihrer Bereitstellungen mit Parameterdateien

Anstatt Parameter als Inlinewerte in Ihren Inhaltsdateien zu übergeben, sollten Sie eine Bicep-Parameterdatei oder eine JSON-Datei verwenden, die die Parameterwerte enthält. Ordnen Sie diese Parameterdateien dann den zugeordneten Microsoft Sentinel Inhaltsdateien zu, um Ihre Bereitstellungen in verschiedenen Arbeitsbereichen besser zu skalieren.

Es gibt mehrere Möglichkeiten, den Inhaltsdateien Parameterdateien zuzuordnen. Beachten Sie, dass Bicep-Parameterdateien nur Bicep-Dateivorlagen unterstützen, JSON-Parameterdateien jedoch beides. Die Repositorybereitstellungspipeline berücksichtigt Parameterdateien in der folgenden Reihenfolge:

1. Gibt es eine Zuordnung im sentinel-deployment.config?
   Weitere Informationen finden Sie unter Anpassen der Verbindungskonfiguration.

2. Gibt es eine einem Arbeitsbereich zugeordnete Parameterdatei? Ja, die Inhaltsdateien befinden sich im selben Verzeichnis zusammen mit einer einem Arbeitsbereich zugeordneten Parameterdatei, die einem der folgenden Muster entspricht:
   .<WorkspaceID>.bicepparam
   .parameters-<WorkspaceID>.json

3. Gibt es eine Standardparameterdatei? Ja, die Inhaltsdateien befinden sich im selben Verzeichnis mit einer Parameterdatei, die einem der folgenden Muster entspricht:
   .bicepparam
   .parameters.json

Vermeiden Sie Konflikte mit mehreren Arbeitsbereichsbereitstellungen, indem Sie Ihre Parameterdateien über die Konfigurationsdatei zuordnen oder die Arbeitsbereichs-ID im Dateinamen angeben.

Wenn Sie die im sentinel-deployment.config aufgelistete zugeordnete Parameterdatei ändern, wird die Bereitstellung der gekoppelten Inhaltsdatei ausgelöst. Das Hinzufügen oder Ändern einer im Arbeitsbereich zugeordneten Parameterdatei oder einer Standardparameterdatei löst auch eine Bereitstellung der gekoppelten Inhaltsdateien zusammen mit den neu geänderten Parametern aus, es sei denn, eine Parameterzuordnung mit höherer Rangfolge ist vorhanden. Andere Inhaltsdateien werden nicht bereitgestellt, solange das Feature für intelligente Bereitstellungen in der Workflow-/Pipelinedefinitionsdatei weiterhin aktiviert ist.

Anpassen der Verbindungskonfiguration

Das Bereitstellungsskript für Repositorys unterstützt die Verwendung einer Bereitstellungskonfigurationsdatei für jeden Repositorybranch ab Juli 2022. Mit der JSON-Konfigurationsdatei können Sie Parameterdateien relevanten Inhaltsdateien zuordnen, bestimmte Inhalte in Bereitstellungen priorisieren und bestimmte Inhalte aus Bereitstellungen ausschließen.

1. Erstellen Sie die Datei sentinel-deployment.config im Stammverzeichnis Ihres Repositorys.

   

2. Fügen Sie Ihre strukturierten Inhalte in drei optionalen Abschnitten ein: "prioritizedcontentfiles":, "excludecontentfiles":und "parameterfilemappings":. Wenn keine Abschnitte enthalten sind oder die .config-Datei ausgelassen wird, wird der Bereitstellungsprozess weiterhin ausgeführt. Ungültige oder nicht erkannte Abschnitte werden ignoriert.

Hier sehen Sie ein Beispiel für den gesamten Inhalt einer gültigen sentinel-deployment.config-Datei . Dieses Beispiel finden Sie auch unter Microsoft Sentinel CICD repositories sample.

{
  "prioritizedcontentfiles": [
    "parsers/Sample/ASimAuthenticationAWSCloudTrail.json",
    "workbooks/sample/TrendMicroDeepSecurityAttackActivity_ARM.json",
    "Playbooks/PaloAlto-PAN-OS/PaloAltoCustomConnector/azuredeploy.bicep"
  ], 
  "excludecontentfiles": [
     "Detections/Sample/PaloAlto-PortScanning.json",
     "parameters"
  ],
  "parameterfilemappings": {
    "879001c8-2181-4374-be7d-72e5dc69bd2b": {
      "Playbooks/PaloAlto-PAN-OS/Playbooks/PaloAlto-PAN-OS-BlockIP/azuredeploy.bicep": "parameters/samples/auzredeploy.bicepparam"
    },
    "9af71571-7181-4cef-992e-ef3f61506b4e": {
      "Playbooks/Enrich-SentinelIncident-GreyNoiseCommunity-IP/azuredeploy.json": "path/to/any-parameter-file.json"
    }
  },
  "DummySection": "This shouldn't impact deployment"
}

• Um Inhaltsdateien zu priorisieren:

  Wenn die Menge an Inhalten in Ihrem Repository zunimmt, kann sich die Bereitstellungszeit erhöhen. Fügen Sie diesem Abschnitt zeitkritische Inhalte hinzu, um die Bereitstellung zu priorisieren, wenn ein Trigger auftritt.

  Fügen Sie dem "prioritizedcontentfiles": Abschnitt vollständige Pfadnamen hinzu. Der Abgleich von Wildcards wird derzeit nicht unterstützt.

• Um Inhaltsdateien auszuschließen, ändern Sie den "excludecontentfiles": Abschnitt mit vollständigen Pfadnamen einzelner .json Inhaltsdateien.

• Um Parameter abzubilden:

  Das Bereitstellungsskript akzeptiert drei Methoden der Zuordnungsparameter (Konfigurationsdateizuordnungen, dateien mit Arbeitsbereich zugeordneten Parametern und Standardparameterdateien), wie in der Skalierung Ihrer Bereitstellungen mit Parameterdateien beschrieben. Das Zuordnen von Parametern über die sentinel-deployment.config hat die höchste Priorität und garantiert, dass eine bestimmte Parameterdatei den zugeordneten Inhaltsdateien zugeordnet wird. Ändern Sie den Abschnitt mit der "parameterfilemappings": Arbeitsbereichs-ID Ihrer Zielverbindung und den vollständigen Pfadnamen einzelner .json Dateien.

Verwandte Inhalte

• Beispiel für Microsoft Sentinel CICD-Repositories.
• Grundlegendes zur Struktur und Syntax von Bicep-Dateien
• Parameter in Bicep
• Erstellen Resource Manager Parameterdatei
• Parameter in ARM-Vorlagen