Verbessern des Bedrohungsschutzes durch Integrieren von Sicherheitsvorgängen mit der Sicherheits-API von Microsoft Graph und Azure Logic Apps
Gilt für: Azure Logic Apps (Verbrauch)
Mit Azure Logic Apps und dem Sicherheits-API-Connector von Microsoft Graph können Sie die Art und Weise verbessern, in der Ihre App Bedrohungen erkennt, sich schützt und reagiert, indem Sie automatisierte Workflows für die Integration von Microsoft-Sicherheitsprodukten, Diensten und Partnern erstellen. Sie können z.B. Playbooks in Microsoft Defender für Cloud erstellen, die Entitäten der Sicherheits-API von Microsoft Graph, wie z.B. Warnungen, überwachen und verwalten. Unter anderem werden folgende Szenarien vom Sicherheits-API-Connector von Microsoft Graph unterstützt:
Abrufen von Warnungen basierend auf Abfragen oder nach Warnungs-ID. Sie können z.B. eine Liste abrufen, die Warnungen mit hohem Schweregrad enthält.
Aktualisieren von Warnungen. Beispielsweise können Sie Warnungszuweisungen aktualisieren, Kommentare zu Warnungen hinzufügen oder Warnungen markieren.
Überwachen, wenn Warnungen erstellt oder geändert werden, durch Erstellen von Warnungsabonnements (Webhooks).
Verwalten Ihrer Warnungsabonnements. Sie können z.B. aktive Abonnements abrufen, die Ablaufzeit für ein Abonnement erweitern oder Abonnements löschen.
Der Workflow Ihrer Logik-App kann Aktionen verwenden, die Antworten vom Sicherheits-API-Connector von Microsoft Graph erhalten, und diese Ausgabe weiteren Aktionen in Ihrem Workflow zur Verfügung stellen. Sie können die Ausgabe der Aktionen des Sicherheits-API-Connectors von Microsoft Graph auch von anderen Aktionen in Ihrem Workflow verwenden lassen. Wenn Sie z.B. Warnungen mit hohem Schweregrad über den Sicherheits-API-Connector von Microsoft Graph erhalten haben, können Sie diese Warnungen in einer E-Mail-Nachricht mithilfe des Outlook-Connectors senden.
Weitere Informationen zu Microsoft Graph-Sicherheit finden Sie in der Übersicht über die Sicherheits-API von Microsoft Graph. Falls Sie noch nicht mit Logik-Apps vertraut sind, finden Sie weitere Informationen unter Was ist Azure Logic Apps?. Informationen zu Power Automate oder Power Apps finden Sie in der Übersicht über Power Automate bzw. in der Übersicht über Power Apps.
Voraussetzungen
Ein Azure-Konto und ein Azure-Abonnement. Wenn Sie nicht über ein Azure-Abonnement verfügen, können Sie sich für ein kostenloses Azure-Konto registrieren.
Um den Sicherheits-API-Connector von Microsoft Graph verwenden zu können, benötigen Sie die explizit gegebene Zustimmung des Mandantenadministrators für Microsoft Entra, die Teil der Authentifizierungsanforderungen der Sicherheits-API in Microsoft Graph ist. Diese Zustimmung erfordert die Anwendungs-ID des Sicherheits-API-Connectors von Microsoft Graph und den Namen, die Sie auch im Azure-Portal finden:
Eigenschaft Wert Anwendungsname MicrosoftGraphSecurityConnectorAnwendungs-ID c4829704-0edc-4c3d-a347-7c4a67586f3cUm die Zustimmung für den Connector zu gewähren, kann Ihr Mandantenadministrator für Microsoft Entra einen dieser Schritte ausführen:
Erteilen der Zustimmung des Mandantenadministrators für Microsoft Entra-Anwendungen.
Während der ersten Ausführung Ihrer Logik-App kann Ihre App die Zustimmung von Ihrem Microsoft Entra-Mandantenadministrator über die Einwilligungserfahrung für Anwendungen anfordern.
Grundlegende Kenntnisse über die Erstellung von Logik-Apps
Die Logik-App, mit der Sie auf die Entitäten Ihrer Sicherheits-API von Microsoft Graph wie z.B. Warnungen zugreifen möchten. Um einen Microsoft Graph-Sicherheitstrigger zu verwenden, benötigen Sie eine leere Logik-App. Um eine Microsoft Graph-Sicherheitsaktion zu verwenden, benötigen Sie eine Logik-App, die mit dem entsprechenden Trigger für Ihr Szenario beginnt.
Herstellen einer Verbindung mit der Sicherheits-API von Microsoft Graph
Wenn Sie einen Trigger oder eine Aktion hinzufügen, der/die eine Verbindung mit einem Dienst oder System herstellt, und Sie keine bestehende oder aktive Verbindung haben, werden Sie von Azure Logic Apps aufgefordert, die Verbindungsinformationen anzugeben, die je nach Verbindungstyp variieren, z. B.:
- Ihre Kontoanmeldeinformationen.
- Ein für die Verbindung zu verwendender Name.
- Der Name des Servers oder des Systems
- Der zu verwendende Authentifizierungstyp
- Eine Verbindungszeichenfolge.
Melden Sie sich beim Azure-Portal an, und öffnen Sie Ihre Logik-App im Logik-App-Designer, sofern sie nicht bereits geöffnet ist.
Fügen Sie für leere Logik-Apps die Trigger und alle weiteren gewünschten Aktionen hinzu, bevor Sie eine Aktion der Sicherheits-API von Microsoft Graph hinzufügen.
Oder
Wählen Sie für vorhandene Logik-Apps im letzten Schritt zum Hinzufügen einer Aktion der Sicherheits-API von Microsoft Graph die Option Neuer Schritt aus.
Oder
Wenn Sie zwischen Schritten eine Aktion einfügen möchten, bewegen Sie den Mauszeiger über den Pfeil zwischen den Schritten. Wählen Sie das daraufhin angezeigte Pluszeichen (+) und dann Aktion hinzufügen aus.
Geben Sie in das Suchfeld „microsoft graph security“ als Filter ein. Wählen Sie in der Liste mit den Aktionen die gewünschte Aktion aus.
Melden Sie sich mit Ihren Anmeldeinformationen für die Sicherheits-API von Microsoft Graph.
Geben Sie die erforderlichen Informationen für die ausgewählte Aktion ein, und fahren Sie mit dem Erstellen Ihres Logik-App-Workflows fort.
Trigger hinzufügen
In Azure Logic Apps muss jede Logik-App mit einem Trigger beginnen, der ausgelöst wird, wenn ein bestimmtes Ereignis eintritt oder eine bestimmte Bedingung erfüllt wird. Bei jeder Auslösung des Triggers erstellt das Logic Apps-Modul eine Logik-App-Instanz und startet die Ausführung des Workflows Ihrer App.
Hinweis
Beim Auslösen eines Triggers verarbeitet der Trigger alle neuen Warnungen. Werden keine Warnungen empfangen, wird die Triggerausführung übersprungen. Der nächste Triggerabruf erfolgt basierend auf dem in den Triggereigenschaften angegebenen Wiederholungsintervall.
Dieses Beispiel zeigt, wie Sie einen Logik-App-Workflow starten können, wenn neue Warnungen an Ihre App gesendet werden.
Erstellen Sie im Azure-Portal eine leere Logik-App, die den Logik-App-Designer öffnet. In diesem Beispiel wird das Azure-Portal verwendet.
Geben Sie im Designer in das Suchfeld „microsoft graph security“ als Filter ein. Wählen Sie in der Auslöserliste den folgenden Auslöser aus: Bei allen neuen Benachrichtigungen
Stellen Sie im Trigger Informationen zu den Warnungen bereit, die Sie überwachen möchten. Weitere Eigenschaften stehen zur Verfügung, wenn Sie die Liste Neuen Parameter hinzufügen öffnen und einen Parameter auswählen, um diese Eigenschaft dem Trigger hinzuzufügen.
| Eigenschaft | Eigenschaft (JSON) | Erforderlich | Type | BESCHREIBUNG |
|---|---|---|---|---|
| Intervall | interval |
Ja | Ganzzahl | Eine positive ganze Zahl, die beschreibt, wie oft der Workflow basierend auf der Häufigkeit ausgeführt wird. Zulässige Mindest- und Maximalintervalle: - Month: 1 - 16 Monate Wenn das Intervall also beispielsweise auf „6“ und die Häufigkeit auf „Month“ festgelegt ist, erfolgt die Wiederholung alle sechs Monate. |
| Frequency | frequency |
Ja | String | Die Zeiteinheit für die Wiederholung: Second (Sekunde), Minute (Minute), Hour (Stunde), Day (Tag), Week (Woche) oder Month (Monat) |
| Zeitzone | timeZone |
No | String | Nur relevant, wenn Sie eine Startzeit angeben, da dieser Trigger keine UTC-Abweichung akzeptiert. Wählen Sie die anzuwendende Zeitzone aus. |
| Startzeit | startTime |
No | String | Geben Sie Startdatum und -uhrzeit im folgenden Format an: JJJJ-MM-TTThh:mm:ss (bei Auswahl einer Zeitzone) Oder JJJJ-MM-TTThh:mm:ssZ (wenn keine Zeitzone ausgewählt wird) Für den 18. September 2017 um 14:00 Uhr würden Sie also „2017-09-18T14:00:00“ angeben und eine Zeitzone (z. B. „Pacific Standard Time“) auswählen. Alternativ können Sie „2017-09-18T14:00:00Z“ ohne Zeitzone angeben. Hinweis: Diese Startzeit kann maximal 49 Jahre in der Zukunft liegen und muss dem ISO 8601-Format für Datums-/Uhrzeitangaben entsprechen und im UTC-Datums-/Zeitformat angegeben werden, jedoch ohne UTC-Abweichung. Wenn Sie keine Zeitzone auswählen, müssen Sie den Buchstaben „Z“ ohne Leerzeichen anhängen. „Z“ bezieht sich auf die entsprechende nautische Zeit. Bei einfachen Zeitpläne ist die Startzeit das erste Vorkommen. Bei komplexeren Zeitplänen wird der Trigger nicht vor der Startzeit ausgelöst. Wie kann ich Startdatum und -uhrzeit verwenden? |
Wenn Sie fertig sind, wählen Sie auf der Symbolleiste des Designers die Option Speichern aus.
Fahren Sie nun damit fort, der Logik-App weitere Aktionen für die Aufgaben hinzuzufügen, die anhand der Triggerergebnisse durchgeführt werden sollen.
Hinzufügen von Aktionen
Hier finden Sie ausführlichere Informationen zur Verwendung der verschiedenen verfügbaren Aktionen mit dem Sicherheits-API-Connector von Microsoft Graph.
Verwalten von Warnungen
Um zu filtern, sortieren, oder die neuesten Ergebnisse zu erhalten, geben Sie nur die von Microsoft Graph unterstützten ODATA-Abfrageparameter ein. Geben Sie nicht die vollständige Basis-URL oder die HTTP-Aktion an, z.B. den https://graph.microsoft.com/v1.0/security/alerts-, GET- oder PATCH-Vorgang. Dieses spezifische Beispiel zeigt die Parameter für eine Warnungen abrufen-Aktion, wenn Sie eine Liste mit Warnungen mit hohem Schweregrad wünschen:
Filter alerts value as Severity eq 'high'
Weitere Informationen zu den Abfragen, die Sie mit diesem Connector verwenden können, finden Sie unter Auflisten von Warnungen. Um erweiterte Funktionen mit diesem Connector zu erstellen, informieren Sie sich über die Schemaeigenschaftenwarnungen, die der Connector unterstützt.
| Aktion | BESCHREIBUNG |
|---|---|
| Warnungen abrufen | Rufen Sie auf Basis von Warnungseigenschaften gefilterte Warnungen ab, z. B. Provider eq 'Azure Security Center' or 'Palo Alto Networks'. |
| Warnung nach ID abrufen | Rufen Sie eine bestimmte Warnung basierend auf der Warnungs-ID ab. |
| Benachrichtigung aktualisieren | Aktualisieren Sie eine bestimmte Warnung basierend auf der Warnungs-ID. Um sicherzustellen, dass Sie die erforderlichen und bearbeitbaren Eigenschaften in der Anforderung übergeben, informieren Sie sich über die bearbeitbaren Eigenschaften für Warnungen. Um z.B. eine Warnung Sicherheitsanalysten zur Untersuchung zuzuweisen, können Sie die Eigenschaft Zugewiesen an der Warnung aktualisieren. |
Verwalten von Warnungsabonnements
Microsoft Graph unterstützt Abonnements oder Webhooks. Stellen Sie zum Abrufen, Aktualisieren oder Löschen von Abonnements die von Microsoft Graph unterstützten ODATA-Abfrageparameter für das Microsoft Graph-Entitätskonstrukt bereit, und beziehen Sie security/alerts gefolgt von der ODATA-Abfrage mit ein. Beziehen Sie nicht die Basis-URL mit ein, z.B. https://graph.microsoft.com/v1.0. Verwenden Sie stattdessen das Format in diesem Beispiel:
security/alerts?$filter=status eq 'NewAlert'
| Aktion | BESCHREIBUNG |
|---|---|
| Abonnements erstellen | Erstellen Sie ein Abonnement, das Sie über Änderungen informiert. Sie können dieses Abonnement nach den bestimmten Warnungstypen filtern, die Sie wünschen. Beispielsweise können Sie ein Abonnement erstellen, das Sie bei Warnungen mit hohem Schweregrad benachrichtigt. |
| Aktive Abonnements abrufen | Rufen Sie nicht abgelaufene Abonnements ab. |
| Abonnement aktualisieren | Aktualisieren Sie ein Abonnement durch die Bereitstellung der Abonnement-ID. Um z.B. Ihr Abonnement zu erweitern, können Sie die expirationDateTime-Eigenschaft des Abonnements aktualisieren. |
| Abonnement löschen | Löschen Sie ein Abonnement durch die Bereitstellung der Abonnement-ID. |
Verwalten von Threat Intelligence-Indikatoren
Um zu filtern, sortieren, oder die neuesten Ergebnisse zu erhalten, geben Sie nur die von Microsoft Graph unterstützten ODATA-Abfrageparameter ein. Geben Sie nicht die vollständige Basis-URL oder die HTTP-Aktion an, z.B. den https://graph.microsoft.com/beta/security/tiIndicators-, GET- oder PATCH-Vorgang. Dieses spezifische Beispiel zeigt die Parameter für eine Get tiIndicators-Aktion, wenn Sie eine Liste mit dem Bedrohungstyp DDoS benötigen:
Filter threat intelligence indicator value as threatType eq 'DDoS'
Weitere Informationen zu den Abfragen, die Sie mit diesem Connector verwenden können, finden Sie unter „Optionale Abfrageparameter“ in der Referenzdokumentation zu Microsoft Graph Security-Threat Intelligence-Indikatoren. Um erweiterte Funktionen mit diesem Connector zu erstellen, informieren Sie sich über die Threat Intelligence-Indikatoren für Schemaeigenschaften, die der Connector unterstützt.
| Aktion | BESCHREIBUNG |
|---|---|
| Abrufen von Threat Intelligence-Indikatoren | Rufen Sie auf Basis von tiIndicators-Eigenschaften gefilterte Threat Intelligence-Indikatoren ab, z. B. threatType eq 'MaliciousUrl' or 'DDoS' |
| Abrufen von Threat Intelligence-Indikatoren nach ID | Rufen Sie einen bestimmten Threat Intelligence-Indikator basierend auf der tiIndicator-ID ab. |
| Erstellen von Threat Intelligence-Indikatoren | Erstellen Sie einen neuen Threat Intelligence-Indikator, indem Sie Daten an die tiIndicator-Sammlung übermitteln. Um sicherzustellen, dass Sie die erforderlichen Eigenschaften in der Anforderung übergeben, informieren Sie sich über die erforderlichen Eigenschaften zum Erstellen von Threat Intelligence-Indikatoren. |
| Übermitteln mehrerer Threat Intelligence-Indikatoren | Erstellen Sie mehrere neue Threat Intelligence-Indikatoren, indem Sie eine tiIndicator-Sammlung veröffentlichen. Um sicherzustellen, dass Sie in der Anforderung die erforderlichen Eigenschaften übergeben, informieren Sie sich über die erforderlichen Eigenschaften zum Übermitteln mehrerer Threat Intelligence-Indikatoren. |
| Aktualisieren von Threat Intelligence-Indikatoren | Aktualisieren Sie einen bestimmten Threat Intelligence-Indikator basierend auf der tiIndicator-ID. Um sicherzustellen, dass Sie in der Anforderung die erforderlichen und bearbeitbaren Eigenschaften übergeben, informieren Sie sich über die bearbeitbaren Eigenschaften für Threat Intelligence-Indikatoren. Um z. B. die anzuwendende Aktion, wenn der Indikator innerhalb des Sicherheitstools targetProduct abgeglichen wird, zu aktualisieren, können Sie die Eigenschaft Aktion des Threat Intelligence-Indikators aktualisieren. |
| Aktualisieren mehrerer Threat Intelligence-Indikatoren | Aktualisieren Sie mehrere Threat Intelligence-Indikatoren. Um sicherzustellen, dass Sie in der Anforderung die erforderlichen Eigenschaften übergeben, informieren Sie sich über die erforderlichen Eigenschaften zum Aktualisieren mehrerer Threat Intelligence-Indikatoren. |
| Löschen von Threat Intelligence-Indikatoren nach ID | Löschen Sie einen bestimmten Threat Intelligence-Indikator basierend auf der tiIndicator-ID. |
| Löschen mehrerer Threat Intelligence-Indikatoren nach ID | Löschen Sie mehrere Threat Intelligence-Indikatoren anhand ihrer IDs. Um sicherzustellen, dass Sie in der Anforderung die erforderlichen Eigenschaften übergeben, informieren Sie sich über die erforderlichen Eigenschaften zum Löschen mehrerer Threat Intelligence-Indikatoren nach ID. |
| Löschen mehrerer Threat Intelligence-Indikatoren nach externer ID | Löschen Sie mehrere Threat Intelligence-Indikatoren anhand der externen IDs. Um sicherzustellen, dass Sie in der Anforderung die erforderlichen Eigenschaften übergeben, informieren Sie sich über die erforderlichen Eigenschaften zum Löschen mehrerer Threat Intelligence-Indikatoren nach externer ID. |
Referenz zu Konnektoren
Technische Details zu Triggern, Aktionen und Beschränkungen aus der OpenAPI-Beschreibung (ehemals Swagger) des Connectors finden Sie auf der Referenzseite des Connectors.