Microsoft Graph Mail Delegated

Microsoft Graph Mail   |  Microsoft Graph Mail Delegated

In diesem Dokument wird beschrieben, wie Sie Microsoft Graph Mail Delegated in Google Security Operations (Google SecOps) einbinden.

Hinweis

Bevor Sie die Integration von Microsoft Graph Mail Delegated konfigurieren, müssen Sie Folgendes tun:

1. Microsoft Entra-Anwendung erstellen

2. Konfigurieren Sie die API-Berechtigungen für Ihre Anwendung.

3. Clientschlüssel erstellen

4. Aktualisierungstoken generieren

Microsoft Entra-Anwendung erstellen

So erstellen Sie die Microsoft Entra-Anwendung:

1. Melden Sie sich im Azure-Portal als Nutzeradministrator oder Passwortadministrator an.

2. Wählen Sie Microsoft Entra ID aus.

3. Rufen Sie App-Registrierungen > Neue Registrierung auf.

4. Geben Sie den Namen der Anwendung ein.

5. Wählen Sie geeignete unterstützte Kontotypen aus.

6. Konfigurieren Sie die Redirect URI mit den folgenden Werten:

   1. Gleis: Web

   2. Weiterleitungs-URL: http://localhost

7. Klicken Sie auf Registrieren.

   In diesem Dokument wird ein Beispiel mit einer Einrichtung für einen einzelnen Mandanten verwendet. Da bei dieser Integration der OAuth 2.0-Autorisierungscode-Vorgang verwendet wird, erfolgt eine interaktive Nutzeranmeldung. Daher ist während der Einrichtung ein Redirect URI erforderlich.

8. Speichern Sie die Werte für die Anwendungs-ID (Client) und die Verzeichnis-ID (Mandant), um die Integrationsparameter zu konfigurieren.

API-Berechtigungen konfigurieren

So konfigurieren Sie die API-Berechtigungen für die Integration:

1. Rufen Sie im Azure-Portal API-Berechtigungen > Berechtigung hinzufügen auf.

2. Wählen Sie Microsoft Graph > Delegierte Berechtigungen aus.

3. Wählen Sie im Abschnitt Berechtigungen auswählen die folgenden erforderlichen Berechtigungen aus:

   • Mail.Read
   • Mail.ReadWrite
   • Mail.Send
   • User.Read
   • Directory.Read.All
   Hinweis: Damit Sie mit einem freigegebenen Postfach interagieren können, muss das authentifizierende Nutzerkonto expliziten delegierten Zugriff auf das freigegebene Zielpostfach haben. Weisen Sie die entsprechenden delegierten Berechtigungen (z. B. Mail.Read.Shared oder Mail.Send.Shared) in Ihrer Microsoft Entra-Anwendungskonfiguration zu.

4. Klicken Sie auf Berechtigungen hinzufügen.

5. Klicken Sie auf Einwilligung des Administrators für ORGANIZATION_NAME erteilen.

   Klicken Sie im Dialogfeld Bestätigung der Administratoreinwilligung erteilen auf Ja.

Clientschlüssel erstellen

So erstellen Sie einen Clientschlüssel:

1. Rufen Sie Zertifikate und Secrets > Neuer Clientschlüssel auf.

2. Geben Sie eine Beschreibung für einen Clientschlüssel an und legen Sie dessen Ablaufdatum fest.

3. Klicken Sie auf Hinzufügen.

4. Speichern Sie den Wert des Clientschlüssels (nicht die Secret-ID), um ihn als Parameterwert für Clientschlüsselwert zu verwenden, wenn Sie die Integration konfigurieren. Der Wert des Clientschlüssels wird nur einmal angezeigt.

Aktualisierungstoken generieren

So generieren Sie ein Aktualisierungstoken:

1. Konfigurieren Sie die Integrationsparameter (außer dem Parameter Refresh Token) und speichern Sie sie.

2. Optional: Fall in Google SecOps simulieren

3. Führen Sie die Aktion Get Authorization aus.

4. Führen Sie die Aktion Token generieren aus.

5. Konfigurieren Sie den Parameter Refresh Token.

Optional: Fall simulieren

Wenn Sie ein Aktualisierungstoken generieren möchten, führen Sie manuelle Aktionen für einen beliebigen Fall aus. Wenn Ihre Google SecOps-Instanz neu ist und keine vorhandenen Fälle enthält, simulieren Sie einen Fall.

So simulieren Sie einen Fall in Google SecOps:

1. Wählen Sie im linken Navigationsbereich Anfragen aus.

2. Klicken Sie auf der Seite Fälle auf add Fall hinzufügen > Fälle simulieren.

3. Wählen Sie einen der Standardfälle aus und klicken Sie auf Erstellen. Es spielt keine Rolle, welchen Fall Sie simulieren möchten.

4. Klicken Sie auf Simulieren.

   Wenn Sie eine andere Umgebung als die Standardumgebung haben und diese verwenden möchten, wählen Sie die richtige Umgebung aus und klicken Sie auf Simulieren.

5. Klicken Sie auf dem Tab Fälle auf Aktualisieren. Der simulierte Fall wird in der Fallliste angezeigt.

Aktion „Autorisierung abrufen“ ausführen

So führen Sie die Aktion Autorisierung abrufen manuell aus:

1. Wählen Sie auf dem Tab Fälle einen Fall aus oder verwenden Sie den simulierten Fall, um eine Fallansicht zu öffnen.

2. Klicken Sie in der Fallansicht auf Manuelle Aktion.

3. Geben Sie im Feld Suchen für die manuelle Maßnahme Microsoft Graph Mail Delegated ein.

4. Wählen Sie in den Ergebnissen unter der Integration „Microsoft Graph Mail Delegated“ die Option Autorisierung abrufen aus. Diese Aktion gibt einen Autorisierungslink zurück, mit dem Sie sich interaktiv in der Microsoft Entra-Anwendung anmelden können.

5. Klicken Sie auf Ausführen.

6. Rufen Sie nach der Ausführung der Aktion das Fall-Repository des Falls auf. Klicken Sie im Aktionsdatensatz Microsoft Graph Mail Delegated_Get Authorization auf Mehr anzeigen. Kopieren Sie den Autorisierungslink.

7. Öffnen Sie ein neues Browserfenster im Inkognitomodus und fügen Sie die generierte Autorisierungs-URL ein. Die Azure-Anmeldeseite wird geöffnet.

8. Melden Sie sich mit den Nutzeranmeldedaten an, die Sie für die Integration verwendet haben. Nach der Anmeldung werden Sie in Ihrem Browser zu einer Adresse mit einem Code in der Adressleiste weitergeleitet.

   Der Browser sollte einen Fehler anzeigen, da die Anwendung Sie zu http://localhost weiterleitet.

9. Kopieren Sie die gesamte URL mit dem Zugriffscode aus der Adressleiste.

Aktion „Token generieren“ ausführen

So führen Sie die Aktion Token generieren manuell aus:

1. Wählen Sie auf dem Tab Fälle einen Fall aus oder verwenden Sie den simulierten Fall, um eine Fallansicht zu öffnen.

2. Klicken Sie auf dem Tab Fallansicht auf Manuelle Aktion.

3. Geben Sie im Feld Suchen für die manuelle Maßnahme Microsoft Graph Mail Delegated ein.

4. Wählen Sie in den Ergebnissen unter der Integration „Microsoft Graph Mail Delegated“ die Option Token generieren aus.

5. Fügen Sie im Feld Authorization URL die gesamte URL mit dem Zugriffscode ein, die Sie nach dem Ausführen der Aktion Authentifizierung abrufen kopiert haben.

6. Klicken Sie auf Ausführen.

7. Nachdem die Aktion ausgeführt wurde, rufen Sie das Fall-Repository des Falls auf. Klicken Sie im Aktionsdatensatz Microsoft Graph Mail Delegated_Generate Token auf Mehr anzeigen.

8. Kopieren Sie den gesamten Wert des generierten Aktualisierungstokens.

Parameter „Aktualisierungstoken“ konfigurieren

1. Rufen Sie das Konfigurationsdialogfeld für die delegierte Integration von Microsoft Graph Mail auf.

2. Geben Sie den Wert des Aktualisierungstokens, den Sie in der Aktion Token generieren erhalten haben, in das Feld Aktualisierungstoken ein.

3. Klicken Sie auf Speichern.

4. Klicken Sie auf Testen, um zu prüfen, ob die Konfiguration korrekt ist und die Integration wie erwartet funktioniert.

Wichtig: Wenn Sie die delegierten Berechtigungen von Microsoft Graph nach der Konfiguration dieser Integration ändern, müssen Sie die von der Integration verwendeten Anmeldedaten neu generieren. Dazu gehört das Aktualisieren des Clientschlüssels (falls neu generiert) und das Generieren eines neuen Aktualisierungstokens, damit die aktualisierten Berechtigungen in den von Google SecOps verwendeten Tokens berücksichtigt werden.

Integrationsparameter

Für die Integration von Microsoft Graph Mail Delegated sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Microsoft Entra ID Endpoint	Pflichtangabe. Der Microsoft Entra ID-Endpunkt, der in der Integration verwendet werden soll. Der Wert kann für verschiedene Mandantentypen unterschiedlich sein. Der Standardwert ist https://login.microsoftonline.com.
Microsoft Graph Endpoint	Pflichtangabe. Der Microsoft Graph-Endpunkt, der in der Integration verwendet werden soll. Der Wert kann für verschiedene Mandantentypen unterschiedlich sein. Der Standardwert ist https://graph.microsoft.com.
Client ID	Pflichtangabe. Die Client-ID (Anwendungs-ID) der Microsoft Entra-Anwendung, die in der Integration verwendet werden soll.
Client Secret Value	Pflichtangabe. Der Clientschlüsselwert der Microsoft Entra-Anwendung, die in der Integration verwendet werden soll.
Microsoft Entra ID Directory ID	Pflichtangabe. Der Microsoft Entra ID-Wert (Mandanten-ID).
User Mailbox	Pflichtangabe. Das Postfach, das in der Integration verwendet werden soll.
Refresh Token	Pflichtangabe. Das Aktualisierungstoken, das für die Authentifizierung verwendet wird.
Redirect URL	Pflichtangabe. Die Weiterleitungs-URL, die Sie beim Erstellen Ihrer Microsoft Entra ID-Anwendung konfiguriert haben. Der Standardwert ist http://localhost.
Mail Field Source	Pflichtangabe. Wenn diese Option ausgewählt ist, ruft die Integration die Postfachadresse aus dem Nutzerdetailattribut mail ab. Wenn diese Option nicht ausgewählt ist, ruft die Integration die Postfachadresse aus dem Feld userPrincipalName ab. Standardmäßig aktiviert.
Verify SSL	Pflichtangabe. Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zum Microsoft Graph-Server hergestellt wird. Standardmäßig aktiviert.
Base64 Encoded Private Key	Optional. Der Base64-codierte private Schlüssel, der zum Entschlüsseln von S/MIME-verschlüsselten E‑Mails verwendet wird. Wenn ein Wert angegeben wird, müssen Sie auch den Base64 Encoded Certificate angeben.
Base64 Encoded Certificate	Optional. Das Base64-codierte Zertifikat, das zum Entschlüsseln von S/MIME-verschlüsselten E‑Mails verwendet wird. Wenn ein Wert angegeben wird, müssen Sie auch den Base64 Encoded Private Key angeben.
Base64 Encoded CA certificate	Optional. Das Base64-codierte vertrauenswürdige CA-Zertifikat für die Signaturprüfung. Wenn kein Wert angegeben ist, schlägt die Signaturprüfung für eingehende signierte E‑Mails fehl, es sei denn, Bypass S/MIME Signature Verification ist aktiviert.

Eine Anleitung zum Konfigurieren einer Integration in Google SecOps finden Sie unter Integrationen konfigurieren.

Sie können später bei Bedarf Änderungen vornehmen. Nachdem Sie eine Integrationsinstanz konfiguriert haben, können Sie sie in Playbooks verwenden. Weitere Informationen zum Konfigurieren und Unterstützen mehrerer Instanzen finden Sie unter Mehrere Instanzen unterstützen.

Aktionen

Weitere Informationen zu Aktionen finden Sie unter Auf ausstehende Aktionen im Workdesk reagieren und Manuelle Aktion in einem Fall ausführen.

Domain blockieren

Mit der Aktion Domain blockieren können Sie bestimmte E‑Mail-Domains blockieren, indem Sie sie einer Nachrichtenregel im Zielpostfach hinzufügen. Wenn die Regel nicht vorhanden ist, wird sie erstellt.

Diese Aktion ist asynchron. Passen Sie das Aktionszeitlimit in der integrierten Entwicklungsumgebung (IDE) von Google SecOps nach Bedarf an.

Aktionseingaben

Für die Aktion Domain blockieren sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Domains	Optional. Durch Kommas getrennte Liste der Absenderdomains, die blockiert werden sollen (z. B. example.com). Domains, die manuell in dieses Feld eingegeben werden, und Domains, die dynamisch aus Entitäten extrahiert werden, werden zusammen verwendet und beide den Regelbedingungen hinzugefügt.
Mailboxes	Pflichtangabe. Standardwert ist Default Mailbox. Zielpostfach, dem die Nachrichtenregel hinzugefügt wird. Hinweis: Nachrichtenregeln können nur für das Postfach des authentifizierten Nutzers erstellt werden. Wenn Sie Regeln für andere Postfächer verwalten möchten, verwenden Sie die Microsoft Graph Mail-Integration.
Rule Name	Pflichtangabe. Standardwert ist Google SecOps - Blocked Domains. Name der Nachrichtenregel, der diese Domains hinzugefügt werden sollen. Wenn die Regel bereits vorhanden ist, wird sie aktualisiert.
Action	Pflichtangabe. Standardwert ist Select One. Aktion, die für diese Domains ausgeführt werden soll. Mögliche Werte: Select One, moveToJunk, delete. Move To Junk verschiebt sie in den Ordner „Junk-E‑Mail“ und Delete leitet sie an „Gelöschte Elemente“ weiter. Mit Select One wird die vorhandene Aktion beibehalten, wenn die Regel vorhanden ist.
How many mailboxes to process in a single batch	Optional. Standardwert ist 1. Geben Sie an, wie viele Postfächer die Aktion in einem einzelnen Batch verarbeiten soll.

Aktionsausgaben

Die Aktion Domain blockieren liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die Sie erhalten, wenn Sie die Aktion Domain blockieren verwenden:

{
    "status": "Success",
    "mailbox": "[e-mail]",
    "blocked_domain": "malicious-domain.com"
}

Ausgabenachrichten

Die Aktion Domain blockieren liefert die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Successfully blocked domain DOMAIN for mailbox MAILBOX.	Aktion erfolgreich.
Failed to block domain DOMAIN for mailbox MAILBOX. Reason: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Skriptausgabe beschrieben, wenn die Aktion Domain blockieren verwendet wird:

Name des Skriptergebnisses	Wert
is_success	True oder False

Absender blockieren

Mit der Aktion Absender blockieren können Sie bestimmte E‑Mail-Absender blockieren, indem Sie sie einer Nachrichtenregel im Zielpostfach hinzufügen. Wenn die Regel nicht vorhanden ist, wird sie erstellt.

Diese Aktion ist asynchron. Passen Sie das Aktionszeitlimit in der integrierten Entwicklungsumgebung (IDE) von Google SecOps nach Bedarf an.

Aktionseingaben

Für die Aktion Absender blockieren sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Senders	Optional. Durch Kommas getrennte Liste der zu blockierenden Absender-E‑Mail-Adressen. Absender, die manuell in dieses Feld eingegeben werden, und Absender, die dynamisch aus Entitäten extrahiert werden, werden zusammengefasst und den Regelbedingungen hinzugefügt.
Mailboxes	Pflichtangabe. Standardwert ist Default Mailbox. Zielpostfach, dem die Nachrichtenregel hinzugefügt wird. Hinweis: Nachrichtenregeln können nur für das Postfach des authentifizierten Nutzers erstellt werden. Wenn Sie Regeln für andere Postfächer verwalten möchten, verwenden Sie die Microsoft Graph Mail-Integration.
Rule Name	Pflichtangabe. Standardwert ist Google SecOps - Blocked Senders. Name der Nachrichtenregel, der diese Absender hinzugefügt werden sollen. Wenn die Regel bereits vorhanden ist, wird sie aktualisiert.
Action	Pflichtangabe. Standardwert ist Select One. Aktion, die für diese Absender ausgeführt werden soll. Mögliche Werte: Select One, Move To Junk, Delete. Move To Junk verschiebt sie in den Ordner „Junk-E‑Mail“ und Delete leitet sie an „Gelöschte Elemente“ weiter. Mit Select One wird die vorhandene Aktion beibehalten, wenn die Regel vorhanden ist.
How many mailboxes to process in a single batch	Optional. Standardwert ist 1. Geben Sie an, wie viele Postfächer die Aktion in einem einzelnen Batch verarbeiten soll.

Aktionsausgaben

Die Aktion Absender blockieren liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

JSON-Ergebnis

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die Sie erhalten, wenn Sie die Aktion Absender blockieren verwenden:

[
  {
    "Entity": "[e-mail]",
    "EntityResult": {
      "successful_mailboxes": [
        "[e-mail]"
      ],
      "failed_mailboxes": []
    }
  }
]

Ausgabenachrichten

Die Aktion Absender blockieren liefert die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Successfully blocked sender SENDER for mailbox MAILBOX.	Aktion erfolgreich.
Failed to block sender SENDER for mailbox MAILBOX. Reason: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses beschrieben, wenn die Aktion Absender blockieren verwendet wird:

Name des Skriptergebnisses	Wert
is_success	True oder False

E-Mails löschen

Mit der Aktion E‑Mail löschen können Sie eine oder mehrere E‑Mails aus einem Postfach löschen. Dadurch werden E‑Mails anhand Ihrer Suchkriterien gelöscht. Mit den entsprechenden Berechtigungen können Sie mit der Aktion E‑Mail löschen E‑Mails in andere Postfächer verschieben.

Diese Aktion ist asynchron. Passen Sie das Aktionszeitlimit in der integrierten Entwicklungsumgebung (IDE) von Google SecOps nach Bedarf an.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion E-Mail löschen sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Delete In Mailbox	Pflichtangabe. Das Standardpostfach, in dem der Löschvorgang ausgeführt werden soll. Wenn die Berechtigungen es zulassen, kann die Aktion auch in anderen Postfächern suchen. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String.
Folder Name	Pflichtangabe. Ein Postfachordner, in dem nach E‑Mails gesucht werden soll. Wenn Sie einen Unterordner angeben möchten, verwenden Sie den Schrägstrich /, z. B. Inbox/Subfolder.
Mail IDs	Optional Eine Filterbedingung, um nach E‑Mails mit bestimmten E‑Mail-IDs zu suchen. Dieser Parameter akzeptiert eine durch Kommas getrennte Liste von E‑Mail-IDs, nach denen gesucht werden soll. Wenn dieser Parameter angegeben wird, werden die Parameter Subject Filter und Sender Filter bei der Suche ignoriert.
Subject Filter	Optional Eine Filterbedingung, die den zu suchenden E‑Mail-Betreff angibt.
Sender Filter	Optional Eine Filterbedingung, die den Absender der angeforderten E‑Mails angibt.
Timeframe (Minutes)	Optional Eine Filterbedingung, die den Zeitraum in Minuten angibt, in dem nach E‑Mails gesucht werden soll.
Only Unread	Optional Wenn diese Option ausgewählt ist, wird nur nach ungelesenen E‑Mails gesucht. Standardmäßig nicht ausgewählt.
How many mailboxes to process in a single batch	Optional Die Anzahl der Postfächer, die in einem einzelnen Batch (einzelne Verbindung zum Mailserver) verarbeitet werden sollen. Der Standardwert ist 25.

Aktionsausgaben

In der folgenden Tabelle werden die Ausgabetypen beschrieben, die mit der Aktion E-Mail löschen verknüpft sind:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Nicht verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

Ausgabenachrichten

Die Aktion E‑Mail löschen liefert die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Successfully deleted emails in the following mailboxes: MAILBOX_NAME: DELETED_EMAILS_NUMBER Mailbox MAILBOX was not found.	Aktion erfolgreich.
Action was not able to find any emails based on the specified search criteria. Action failed to delete any emails because the provided mailbox folder name was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER Failed to find any of the provided mailboxes: MAILBOX_LIST Failed to execute action, the error is: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses beschrieben, wenn Sie die Aktion E-Mail löschen verwenden:

Name des Skriptergebnisses	Wert
is_success	True oder False

Posteingangsregeln löschen

Mit der Aktion Posteingangsregeln löschen können Sie eine bestimmte Posteingangsregel für die angegebenen Postfächer löschen. Diese Aktion ist asynchron. Passen Sie das Aktionszeitlimit in der integrierten Entwicklungsumgebung (IDE) von Google SecOps nach Bedarf an.

Aktionseingaben

Für die Aktion Posteingangsregeln löschen sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Mailboxes	Pflichtangabe. Standardwert ist Default Mailbox. Zielpostfach, aus dem die Nachrichtenregel gelöscht wird. Hinweis: Nachrichtenregeln können nur aus dem Postfach des authentifizierten Nutzers gelöscht werden. Wenn Sie Regeln für andere Postfächer verwalten möchten, verwenden Sie die Microsoft Graph Mail-Integration.
Rule Name	Pflichtangabe. Der genaue Name der zu löschenden Regel für Posteingangsnachrichten.
How many mailboxes to process in a single batch	Optional. Standardwert ist 1. Geben Sie an, wie viele Postfächer die Aktion in einem einzelnen Batch verarbeiten soll. Der Standardwert ist 1, da Vorgänge auf das Postfach des authentifizierten Nutzers beschränkt sind.

Aktionsausgaben

Die Aktion Posteingangsregeln löschen liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

JSON-Ergebnis

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die Sie erhalten, wenn Sie die Aktion Posteingangsregeln löschen verwenden:

{
    "deleted_rule": [
        "New test cases"
    ],
    "successful_mailboxes": [
        "[e-mail]"
    ],
    "failed_mailboxes": [
        "[e-mail]",
        "[e-mail]"
    ]
}

Ausgabenachrichten

Die Aktion Posteingangsregeln löschen liefert die folgenden Ausgabemeldungen:

Ausgabemeldung	Beschreibung der Nachricht
Successfully deleted inbox rule RULE_NAME from mailbox MAILBOX.	Aktion erfolgreich.
Failed to delete inbox rule RULE_NAME from mailbox MAILBOX. Reason: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Posteingangsregeln löschen beschrieben:

Name des Skriptergebnisses	Wert
is_success	True oder False

Anhänge aus E‑Mails herunterladen

Verwenden Sie die Aktion Anhänge aus E‑Mail herunterladen, um Anhänge aus E‑Mails anhand der angegebenen Kriterien herunterzuladen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Diese Aktion ist asynchron. Passen Sie bei Bedarf den Zeitüberschreitungswert für das Skript in der Google SecOps-IDE an.

Die Aktion ersetzt den Unterstrich \` forward slash or/backslash characters in the names of the downloaded attachments with the_`.

Aktionseingaben

Für die Aktion Anhänge aus E-Mail herunterladen sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Search In Mailbox	Pflichtangabe. Das Standardpostfach, in dem der Suchvorgang ausgeführt wird. Wenn die Berechtigungen es zulassen, kann die Aktion auch in anderen Postfächern suchen. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String.
Folder Name	Pflichtangabe. Ein Postfachordner, in dem die Suche ausgeführt werden soll. Wenn Sie einen Unterordner angeben möchten, verwenden Sie den Schrägstrich /, z. B. Inbox/Subfolder.
Download Destination	Pflichtangabe. Ein Speichertyp zum Speichern der heruntergeladenen Anhänge. Standardmäßig wird versucht, den Anhang im Cloud Storage-Bucket zu speichern. Das Speichern eines Anhangs im lokalen Dateisystem ist eine Fallback-Option. Die möglichen Werte sind GCP Bucket und Local File System. Der Standardwert ist GCP Bucket.
Download Path	Pflichtangabe. Ein Pfad zum Herunterladen von Anhängen. Wenn Sie Anhänge im Cloud Storage-Bucket oder in einem lokalen Dateisystem speichern, müssen Sie den Downloadpfad im Unix-ähnlichen Format angeben, z. B. /tmp/test.
Mail IDs	Optional Eine Filterbedingung, um nach E‑Mails mit bestimmten E‑Mail-IDs zu suchen. Dieser Parameter akzeptiert eine durch Kommas getrennte Liste von E‑Mail-IDs, nach denen gesucht werden soll. Wenn dieser Parameter angegeben wird, werden die Parameter Subject Filter und Sender Filter bei der Suche ignoriert.
Subject Filter	Optional Eine Filterbedingung, die den Betreff der E‑Mail angibt, nach der gesucht werden soll. Dieser Filter verwendet die contains-Logik.
Sender Filter	Optional Eine Filterbedingung, die den Absender der angeforderten E‑Mails angibt. Dieser Filter verwendet die equals-Logik.
Download Attachments From EML	Optional Wenn diese Option ausgewählt ist, werden Anhänge aus EML-Dateien heruntergeladen. Standardmäßig nicht ausgewählt.
Download attachments to unique path?	Optional Wenn diese Option ausgewählt ist, werden Anhänge über die Aktion in den eindeutigen Pfad heruntergeladen, der im Parameterfeld Download Path angegeben ist. So wird verhindert, dass zuvor heruntergeladene Anhänge überschrieben werden. Standardmäßig nicht ausgewählt.
How many mailboxes to process in a single batch	Optional Die Anzahl der Postfächer, die in einem einzelnen Batch (einzelne Verbindung zum Mailserver) verarbeitet werden sollen. Der Standardwert ist 25.

Aktionsausgaben

Die Aktion Anhänge aus E‑Mail herunterladen liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

JSON-Ergebnis

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die Sie erhalten, wenn Sie die Aktion Anhänge aus E‑Mail herunterladen verwenden:

[
    {
        "attachment_name": "name1.png",
        "downloaded_path": "file_path/name1.png"
    },
    {
        "attachment_name": "name2.png",
        "downloaded_path": "file_path/name2.png"
    }
]

Ausgabenachrichten

Die Aktion Anhänge aus E-Mail herunterladen liefert die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Downloaded NUMBER_OF_ATTACHMENTS attachments. Files: PATHS. Failed to find emails in MAILBOX with the following mail ids: EMAIL_IDS. In the mailboxes listed below, emails were found, but there were no attachments to download. Affected mailboxes: MAILBOXES. Mail IDs without attachments to download: LIST_OF_EMAIL_IDS attachments.	Aktion erfolgreich.
Failed to find any emails using the provided criteria! Failed to find any of the provided mailboxes: MAILBOXES Action failed to run because the provided mailbox folder name FOLDER_NAME was not found in the mailbox MAILBOX. Error executing action. Reason: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Skriptergebnisausgabe beschrieben, wenn die Aktion Anhänge aus E-Mail herunterladen verwendet wird:

Name des Skriptergebnisses	Wert
is_success	True oder False

Daten aus angehängter EML-Datei extrahieren

Verwenden Sie die Aktion Daten aus angehängter EML extrahieren, um Daten aus den EML-Anhängen der E-Mail abzurufen und in den Aktionsergebnissen zurückzugeben. Diese Aktion unterstützt die Dateiformate .eml, .msg und .ics.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Daten aus angehängter EML-Datei extrahieren sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Search In Mailbox	Pflichtangabe. Das Standardpostfach, in dem der Suchvorgang ausgeführt wird. Wenn die Berechtigungen es zulassen, kann die Aktion auch in anderen Postfächern suchen. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String.
Folder Name	Optional Ein Postfachordner, in dem die Suche ausgeführt werden soll. Wenn Sie einen Unterordner angeben möchten, verwenden Sie den Schrägstrich /, z. B. Inbox/Subfolder.
Mail IDs	Pflichtangabe. Eine Filterbedingung, um nach E‑Mails mit bestimmten E‑Mail-IDs zu suchen. Dieser Parameter akzeptiert eine durch Kommas getrennte Liste von E‑Mail-IDs, nach denen gesucht werden soll.
Regex Map JSON	Optional Eine JSON-Definition, die reguläre Ausdrücke enthält, die auf die angehängte E-Mail-Datei angewendet werden sollen, um zusätzliche Schlüsselwerte im JSON-Ergebnis der Aktion zu generieren. Beispiel für diesen Parameterwert: {ips: \\b\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\\\.\\\\d{1,3}\\b}

Aktionsausgaben

Die Aktion Daten aus angehängter EML-Datei extrahieren liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

JSON-Ergebnis

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die Sie erhalten, wenn Sie die Aktion Daten aus angehängter EML-Datei extrahieren verwenden:

[
    {
        "type": "EML",
        "subject": "examplesubject",
        "from": "[e-mail]",
        "to": "[e-mail],[e-mail]",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>example-html</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.eml"
    },
    {
        "type": "MSG",
        "subject": "examplesubject",
        "from": "[e-mail]",
        "to": "[e-mail],[e-mail]",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>examplehtml</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.msg"
    },
    {
        "type": "ICS",
        "subject": "examplesubject",
        "from": "[e-mail]",
        "to": "[e-mail],[e-mail]",
        "date": "Thu,4Jul202412:11:29+0530",
        "text": "text",
        "html": "<p>example-html</p>",
        "regex": {},
        "regex_from_text_part": {},
        "id": "ID",
        "name": "example.ics"
    }
]

Ausgabenachrichten

Die Aktion Daten aus angehängter EML-Datei extrahieren liefert die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Extracted data from ATTACHMENT_NAMES attached email files. Files: PATHS Failed to find emails in MAILBOX with the following mail ids: MAIL_ID_LIST	Aktion erfolgreich.
Failed to find any emails using the provided criteria! Failed to find any of the provided mailboxes: MAILBOX_LIST Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX Failed to execute action, the error is: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses beschrieben, wenn die Aktion Daten aus angehängter EML-Datei extrahieren verwendet wird:

Name des Skriptergebnisses	Wert
is_success	True oder False

E‑Mail weiterleiten

Mit der Aktion E-Mail weiterleiten können Sie E-Mails weiterleiten, die vorherige Threads enthalten. Mit den entsprechenden Berechtigungen können über diese Aktion E-Mails von einem anderen Postfach als dem in der Integrationskonfiguration angegebenen gesendet werden.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion E-Mail weiterleiten sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Send From	Pflichtangabe. Eine optionale E-Mail-Adresse, von der eine E-Mail gesendet werden soll, sofern die Berechtigungen dies zulassen. Standardmäßig wird die E-Mail vom Standardpostfach gesendet, das in der Integrationskonfiguration angegeben ist.
Folder Name	Optional Ein Postfachordner, in dem nach E‑Mails gesucht werden soll. Wenn Sie einen Unterordner angeben möchten, verwenden Sie den Schrägstrich /, z. B. Inbox/Subfolder.
Mail ID	Pflichtangabe. Die ID der weiterzuleitenden E‑Mail.
Subject	Pflichtangabe. Der Betreff der E‑Mail.
Send to	Pflichtangabe. Eine durch Kommas getrennte Liste von E‑Mail-Adressen für die E‑Mail-Empfänger, z. B. [e-mail], [e-mail].
CC	Optional Eine durch Kommas getrennte Liste von E‑Mail-Adressen für das CC-Feld der E‑Mail. Das Format ist mit dem des Parameters Send to identisch.
BCC	Optional Eine durch Kommas getrennte Liste von E‑Mail-Adressen für das Feld „Bcc“ der E‑Mail. Das Format ist dasselbe wie für den Parameter Send to.
Attachments Paths	Optional Eine durch Kommas getrennte Liste von Pfaden für Dateianhänge, die auf dem Server gespeichert sind, z. B. /FILE_DIRECTORY/file.pdf, /FILE_DIRECTORY/image.jpg.
Mail content	Pflichtangabe. Der E‑Mail-Text.

Aktionsausgaben

In der folgenden Tabelle werden die Ausgabetypen beschrieben, die mit der Aktion E-Mail weiterleiten verknüpft sind:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Nicht verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

Ausgabenachrichten

Die Aktion E-Mail weiterleiten liefert die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Email with message ID MAIL_ID was forwarded successfully.	Aktion erfolgreich.
Error executing action "Forward Email" because the provided mail id EMAIL_ID was not found. Action failed to delete any emails because the provided mailbox folder name was not found in the mailbox(es): MAILBOX: MAILBOX_FOLDER Action failed to run because specified attachments were not found: ATTACHMENTS_LIST Failed to execute action, the error is: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses beschrieben, wenn Sie die Aktion E-Mail weiterleiten verwenden:

Name des Skriptergebnisses	Wert
is_success	True oder False

Token generieren

Verwenden Sie die Aktion Token generieren, um ein Aktualisierungstoken für die Integrationskonfiguration mit delegierter Authentifizierung abzurufen. Verwenden Sie die Autorisierungs-URL, die Sie in der Aktion Autorisierung abrufen erhalten haben.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Nachdem Sie das Aktualisierungstoken zum ersten Mal generiert haben, sollten Sie den Job zur Erneuerung des Aktualisierungstokens konfigurieren und aktivieren, damit das Aktualisierungstoken automatisch erneuert wird und gültig bleibt.

Aktionseingaben

Für die Aktion Token generieren sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Authorization URL	Pflichtangabe. Eine Autorisierungs-URL, die Sie in der Aktion Autorisierung abrufen erhalten haben. Die URL ist erforderlich, um ein Aktualisierungstoken anzufordern.

Aktionsausgaben

Die Aktion Token generieren liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Nicht verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

Ausgabenachrichten

Die Aktion Token generieren kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung	Beschreibung der Nachricht
Successfully fetched the refresh token: TOKEN_VALUE. Enter this token in the integration configuration to authenticate with delegated permissions on behalf of the user that performed the configuration steps. We recommend you to configure a Refresh Token Renewal Job after you generate the initial refresh token so the job automatically renews and keeps the token valid.	Die Aktion war erfolgreich.
Failed to generate a token because the authorization URL that you provided is incorrect. The "code" parameter is missing. Make sure to copy the whole URL properly. Failed to get the refresh token! Error is ERROR_REASON Failed to connect to the Microsoft Graph Mail service! Error is ERROR_REASON	Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Token generieren verwendet wird:

Name des Skriptergebnisses	Wert
is_success	True oder False

Autorisierung abrufen

Verwenden Sie die Aktion Autorisierung abrufen, um einen Link mit dem Zugriffscode für die delegierte Authentifizierung zu erhalten. Kopieren Sie den gesamten Link und verwenden Sie ihn in der Aktion Token generieren, um das Aktualisierungstoken abzurufen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Keine.

Aktionsausgaben

Die Aktion Autorisierung abrufen liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Nicht verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

Ausgabenachrichten

Die Aktion Autorisierung abrufen kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung	Beschreibung der Nachricht
Authorization URL generated successfully. To obtain a URL with access code, go to the link below as the user that you configured for the integration. Provide the URL with the access code in the Generate Token action.	Die Aktion war erfolgreich.
Failed to generate the authorization URL! Error is ERROR_REASON Failed to connect to the Microsoft Graph Mail service! Error is ERROR_REASON	Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle sind die Werte für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Autorisierung abrufen aufgeführt:

Name des Skriptergebnisses	Wert
is_success	True oder False

Postfacheinstellungen für die Einrichtung abrufen

Verwenden Sie die Aktion Get Mailbox Account Out Of Facility Settings, um die Abwesenheitseinstellungen für das Postfachkonto für die angegebene Google SecOps-User-Entität abzurufen.

Für die Aktion Get Mailbox Account Out Of Facility Settings wird die Betaversion der Microsoft Graph API verwendet.

Diese Aktion wird für die Google SecOps-Entität User ausgeführt.

Aktionseingaben

Keine.

Aktionsausgaben

Die Aktion Postfachkonto aus den Einrichtungseinstellungen abrufen liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die Sie erhalten, wenn Sie die Aktion Get Mailbox Account Out Of Facility Settings verwenden:

{
   "@odata.context": "https://graph.microsoft.com/beta/$metadata#communications/presences/$entity",
   "id": "ID",
   "availability": "Offline",
   "activity": "Offline",
   "statusMessage": null,
   "outOfOfficeSettings": {
       "message": "\n\nOut Of Facility111\n",
       "isOutOfOffice": true
   }
}

Ausgabenachrichten

Die Aktion Postfachkonto aus den Einrichtungseinstellungen abrufen kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung	Beschreibung der Nachricht
Successfully returned OOF settings for ENTITY_ID. Failed to find the following usernames in Office 365 service: USERNAME_LIST.	Die Aktion war erfolgreich.
Error executing action "Add Identity Protection Detection Comment". Reason: ERROR_REASON Action wasn't able to find OOF settings for ENTITY_ID.	Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn Sie die Aktion Get Mailbox Account Out Of Facility Settings verwenden:

Name des Skriptergebnisses	Wert
is_success	True oder False

Listenregeln

Verwenden Sie die Aktion Regeln auflisten, um alle Nachrichtenregeln für ein bestimmtes Postfach mithilfe der Microsoft Graph API aufzulisten.

Aktionseingaben

Für die Aktion Regeln auflisten sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Mailboxes	Pflichtangabe. Standardwert ist Default Mailbox. Zielpostfach, in dem die Nachrichtenregeln aufgeführt werden. Hinweis: Nachrichtenregeln können nur für das Postfach des authentifizierten Nutzers aufgelistet werden. Wenn Sie Regeln für andere Postfächer verwalten möchten, verwenden Sie die Microsoft Graph Mail-Integration.
Rule Name	Optional. Nach dem Anzeigenamen der Regel filtern.
Limit	Optional. Standardwert ist 20. Beschränken Sie die Anzahl der Regeln, die pro Postfach zurückgegeben werden sollen.

Aktionsausgaben

Die Aktion Regeln auflisten liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

Tabelle mit Fall-Repository

Die Aktion Regeln auflisten liefert Ausführungsdetails in der Tabelle „Fallpinnwand“.

JSON-Ergebnis

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die Sie erhalten, wenn Sie die Aktion Regeln auflisten verwenden:

[
  {
    "mailbox": "[e-mail]",
    "rules": [
      {
        "id": "AAMkAD...",
        "displayName": "Google SecOps - Blocked Senders",
        "sequence": 1,
        "isEnabled": true
      }
    ]
  }
]

Ausgabenachrichten

Die Aktion Regeln auflisten liefert die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Successfully fetched NUMBER_OF_RULES rules for mailbox MAILBOX.	Aktion erfolgreich.
Failed to fetch rules for mailbox MAILBOX. Reason: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses beschrieben, wenn die Aktion Regeln auflisten verwendet wird:

Name des Skriptergebnisses	Wert
is_success	True oder False

E‑Mail als Junk-E‑Mail markieren

Mit der Aktion E-Mail als Spam markieren können Sie E-Mails in einem bestimmten Postfach als Spam markieren. Dadurch wird der Absender der E‑Mail der Liste der blockierten Absender hinzugefügt und die Nachricht in den Ordner Junk-E‑Mail verschoben.

Für die Aktion E‑Mail als Spam markieren wird die Betaversion der Microsoft Graph API verwendet.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion E‑Mail als Spam markieren sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Search In Mailbox	Pflichtangabe. Ein Postfach, in dem nach E‑Mails gesucht werden soll. Standardmäßig wird versucht, die E‑Mail im Standardpostfach zu suchen, das Sie in der Integrationskonfiguration angegeben haben. Wenn Sie eine Suche in anderen Postfächern ausführen möchten, konfigurieren Sie die entsprechenden Berechtigungen für die Aktion. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String.
Folder Name	Pflichtangabe. Ein Postfachordner, in dem nach E‑Mails gesucht werden soll. Wenn Sie einen Unterordner angeben möchten, verwenden Sie den Schrägstrich /, z. B. Inbox/Subfolder. Der Standardwert ist Inbox.
Mail IDs	Pflichtangabe. Die IDs oder internetMessageId-Werte der E‑Mails, die als Spam markiert werden sollen. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String.

Aktionsausgaben

Die Aktion E‑Mail als Spam markieren liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Nicht verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

Ausgabenachrichten

Die Aktion E‑Mail als Spam markieren kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung	Beschreibung der Nachricht
Successfully marked the email as junk. Failed to find email with ID ID in MAILBOX. Mailbox MAILBOX was not found.	Die Aktion war erfolgreich.
Error executing action "Mark Email as Junk". Reason: ERROR_REASON Failed to find any emails based on provided parameters! Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX.	Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn Sie die Aktion E‑Mail als Spam markieren verwenden:

Name des Skriptergebnisses	Wert
is_success	True oder False

E‑Mail als „Kein Junk“ markieren

Mit der Aktion E‑Mail als „Kein Spam“ markieren können Sie E‑Mails in einem bestimmten Postfach als „Kein Spam“ markieren. Dadurch wird der Absender aus der Liste der blockierten Absender entfernt und die Nachricht in den Ordner Posteingang verschoben.

Für die Aktion E-Mail als „Kein Spam“ markieren wird die Betaversion der Microsoft Graph API verwendet.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion E‑Mail als „Kein Spam“ markieren sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Search In Mailbox	Pflichtangabe. Ein Postfach, in dem nach einer E‑Mail gesucht werden soll. Standardmäßig wird versucht, die E‑Mail im Standardpostfach zu suchen, das Sie in der Integrationskonfiguration angegeben haben. Wenn Sie eine Suche in anderen Postfächern ausführen möchten, konfigurieren Sie die entsprechenden Berechtigungen für die Aktion. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String.
Folder Name	Pflichtangabe. Ein Postfachordner, in dem nach E‑Mails gesucht werden soll. Wenn Sie einen Unterordner angeben möchten, verwenden Sie den Schrägstrich /, z. B. Inbox/Subfolder.
Mail IDs	Pflichtangabe. Die IDs oder internetMessageId-Werte der E‑Mails, die als Spam markiert werden sollen. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String.

Aktionsausgaben

Die Aktion E‑Mail als „Kein Spam“ markieren liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Nicht verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

Ausgabenachrichten

Die Aktion E‑Mail als „Kein Spam“ markieren kann die folgenden Ausgabemeldungen zurückgeben:

Ausgabemeldung	Beschreibung der Nachricht
Successfully marked the email as not junk. Failed to find email with ID ID in MAILBOX. Mailbox MAILBOX was not found.	Die Aktion war erfolgreich.
Error executing action "Mark Email as Not Junk". Reason: ERROR_REASON Failed to find any emails based on provided parameters! Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX.	Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn Sie die Aktion E‑Mail als „Kein Spam“ markieren verwenden:

Name des Skriptergebnisses	Wert
is_success	True oder False

E‑Mail in Ordner verschieben

Verwenden Sie die Aktion E-Mail in Ordner verschieben, um eine oder mehrere E-Mails aus dem Quell-E-Mail-Ordner in den anderen Ordner im Postfach zu verschieben. Mit den entsprechenden Berechtigungen können Sie mit dieser Aktion E-Mails in andere Postfächer verschieben, die sich von dem in der Integrationskonfiguration angegebenen Postfach unterscheiden.

Diese Aktion ist asynchron. Passen Sie das Aktionszeitlimit in der integrierten Entwicklungsumgebung (IDE) von Google SecOps nach Bedarf an.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Verwenden Sie die folgenden Parameter, um die Aktion E-Mail in Ordner verschieben zu konfigurieren:

Parameter	Beschreibung
Move In Mailbox	Pflichtangabe. Das Standardpostfach, in dem der Verschiebevorgang ausgeführt wird. Wenn die Berechtigungen es zulassen, kann die Aktion auch in anderen Postfächern suchen. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String.
Source Folder Name	Pflichtangabe. Ein Quellordner, aus dem die E‑Mail verschoben werden soll. Wenn Sie einen Unterordner angeben möchten, verwenden Sie den Schrägstrich /, z. B. Inbox/Subfolder.
Destination Folder Name	Pflichtangabe. Ein Zielordner, in den die E‑Mail verschoben werden soll. Geben Sie den Parameterwert im folgenden Format an: Inbox/folder_name/subfolder_name. Bei diesem Parameter wird nicht zwischen Groß- und Kleinschreibung unterschieden.
Mail IDs	Optional Eine Filterbedingung, um nach E‑Mails mit bestimmten E‑Mail-IDs zu suchen. Dieser Parameter akzeptiert eine durch Kommas getrennte Liste von E‑Mail-IDs, nach denen gesucht werden soll. Wenn dieser Parameter angegeben wird, werden die Parameter Subject Filter und Sender Filter bei der Suche ignoriert.
Subject Filter	Optional Eine Filterbedingung, die den Betreff der E‑Mail angibt, nach der gesucht werden soll. Dieser Filter verwendet die contains-Logik.
Sender Filter	Optional Eine Filterbedingung, die den Absender der angeforderten E‑Mails angibt. Dieser Filter verwendet die equals-Logik.
Timeframe (Minutes)	Optional Eine Filterbedingung, die den Zeitraum in Minuten angibt, in dem nach E‑Mails gesucht werden soll.
Only Unread	Optional Wenn diese Option ausgewählt ist, wird nur nach ungelesenen E‑Mails gesucht. Standardmäßig nicht ausgewählt.
How many mailboxes to process in a single batch	Optional Die Anzahl der Postfächer, die in einem einzelnen Batch (einzelne Verbindung zum Mailserver) verarbeitet werden sollen. Der Standardwert ist 25.

Aktionsausgaben

In der folgenden Tabelle werden die Ausgabetypen beschrieben, die mit der Aktion E‑Mail in Ordner verschieben verknüpft sind:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Nicht verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

Ausgabenachrichten

Die Aktion E-Mail in Ordner verschieben liefert die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Successfully moved emails in the following mailboxes: MAILBOX: MOVED_EMAILS_NUMBER Mailbox MAILBOX was not found.	Aktion erfolgreich.
Action was not able to find any emails based on the specified search criteria. Action failed to move any emails because the provided source folder was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER Action failed to move any emails because the provided destination folder was not found in the mailbox(es): MAILBOX_NAME, MAILBOX_FOLDER Failed to find any of the provided mailboxes: MAILBOX_LIST Failed to execute action, the error is: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses beschrieben, wenn Sie die Aktion E-Mail in Ordner verschieben verwenden:

Name des Skriptergebnisses	Wert
is_success	True oder False

Ping

Verwenden Sie die Aktion Ping, um die Verbindung zum Microsoft Graph-E-Mail-Dienst zu testen.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Keine.

Aktionsausgaben

In der folgenden Tabelle werden die Ausgabetypen beschrieben, die mit der Aktion Ping verknüpft sind:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Nicht verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

Ausgabenachrichten

Die Aktion Ping liefert die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Successfully connected to the Microsoft Graph mail service with the provided connection parameters!	Aktion erfolgreich.
Failed to connect to the Microsoft Graph mail service! Error is ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses beschrieben, wenn Sie die Aktion Ping verwenden:

Name des Skriptergebnisses	Wert
is_success	True oder False

Microsoft-Suchanfrage ausführen

Verwenden Sie die Aktion Microsoft-Suchanfrage ausführen, um eine Suche mit der Microsoft-Suchmaschine durchzuführen. Für die Suche wird die von Ihnen angegebene einfache oder erweiterte Abfrage verwendet. Weitere Informationen zu Microsoft Search finden Sie unter Übersicht über die Microsoft Search API in Microsoft Graph.

Je nach Entitätsbereich müssen Sie für die Aktion Microsoft-Suchanfrage ausführen möglicherweise zusätzliche Berechtigungen konfigurieren. Weitere Informationen zu den Berechtigungen, die für bestimmte Entitätstypen erforderlich sind, finden Sie unter Microsoft Search API zum Abfragen von Daten verwenden. Weitere Informationen zum Konfigurieren von Berechtigungen für die Integration finden Sie unter API-Berechtigungen konfigurieren.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Microsoft-Suchanfrage ausführen sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Entity Types To Search	Optional Eine durch Kommas getrennte Liste der erwarteten Ressourcentypen für die Suchantwort. Folgende Werte sind möglich: acronym bookmark chatMessage drive driveItem event externalItem list listItem message person site
Fields To Return	Optional Die Felder, die in der Suchantwort zurückgegeben werden sollen. Wenn Sie diesen Parameter nicht konfigurieren, gibt die Aktion alle verfügbaren Felder zurück.
Search Query	Optional Die Abfrage zum Ausführen der Suche. Weitere Informationen zu den Beispielen für Suchanfragen finden Sie unter Microsoft Search API zum Suchen von Outlook-Nachrichten verwenden.
Max Rows To Return	Optional Die maximale Anzahl von Zeilen, die die Aktion zurückgeben soll. Wenn Sie diesen Parameter nicht konfigurieren, wird der Standardwert verwendet. Der Standardwert ist 25.
Advanced Query	Optional Die vollständige Suchnutzlast, die verwendet werden soll, anstatt die Suchanfrage mit anderen Aktionsparametern zu erstellen. Formatieren Sie die Suchnutzlast als JSON-String. Wenn Sie diesen Parameter konfigurieren, werden alle anderen Parameter ignoriert.

Aktionsausgaben

Die Aktion Microsoft-Suchanfrage ausführen liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Nicht verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

Ausgabenachrichten

Die Aktion Microsoft-Suchanfrage ausführen kann die folgenden Ausgabenachrichten zurückgeben:

Ausgabemeldung	Beschreibung der Nachricht
Successfully retrieved results for the provided search query. No results found for the provided query.	Die Aktion war erfolgreich.
Failed to construct a search query based on the provided parameters. Please check, if you specified all parameters properly. Failed to run the search because the API doesn't support the provided combination of entities. See Microsoft documentation for supported entity combinations - URL. The error is ERROR_REASON Failed to run the search as the provided advanced search query is invalid! Error is ERROR_REASON Failed to connect to the Microsoft Graph Mail service! Error is ERROR_REASON	Die Aktion ist fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Microsoft-Suchanfrage ausführen verwendet wird:

Name des Skriptergebnisses	Wert
is_success	True oder False

Domain aus Sperrliste entfernen

Mit der Aktion Blockierte Domain entfernen können Sie bestimmte E‑Mail-Domains aus einer Nachrichtenregel im Zielpostfach entfernen. Wenn die Regel leer ist, wird sie gelöscht.

Diese Aktion ist asynchron. Passen Sie das Aktionszeitlimit in der integrierten Entwicklungsumgebung (IDE) von Google SecOps nach Bedarf an.

Aktionseingaben

Für die Aktion Remove Block Domain sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Domains	Optional. Durch Kommas getrennte Liste der zu entfernenden Absenderdomains (z. B. example.com). Domains, die manuell in dieses Feld eingegeben werden, und Domains, die dynamisch aus Entitäten extrahiert werden, werden beide aus den Regelbedingungen entfernt.
Mailboxes	Pflichtangabe. Standardwert ist Default Mailbox. Zielpostfach, in dem die Nachrichtenregel vorhanden ist. Hinweis: Nachrichtenregeln können nur für das Postfach des authentifizierten Nutzers aktualisiert werden. Wenn Sie Regeln für andere Postfächer verwalten möchten, verwenden Sie die Microsoft Graph Mail-Integration.
Rule Name	Pflichtangabe. Standardwert ist Google SecOps - Blocked Domains. Name der Nachrichtenregel, aus der diese Domains entfernt werden sollen.
How many mailboxes to process in a single batch	Optional. Standardwert ist 1. Geben Sie an, wie viele Postfächer die Aktion in einem einzelnen Batch verarbeiten soll.

Aktionsausgaben

Die Aktion Remove Block Domain liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

JSON-Ergebnis

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die Sie erhalten, wenn Sie die Aktion Remove Block Domain verwenden:

[
  {
    "Entity": "example.com",
    "EntityResult": {
      "successful_mailboxes": [
        "[e-mail]"
      ],
      "failed_mailboxes": []
    }
  }
]

Ausgabenachrichten

Die Aktion Remove Block Domain (Blockierte Domain entfernen) liefert die folgenden Ausgabemeldungen:

Ausgabemeldung	Beschreibung der Nachricht
Successfully removed domain DOMAIN from the blocked senders list for mailbox MAILBOX.	Aktion erfolgreich.
Failed to remove domain DOMAIN from the blocked senders list for mailbox MAILBOX. Reason: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses bei Verwendung der Aktion Blockierte Domain entfernen beschrieben:

Name des Skriptergebnisses	Wert
is_success	True oder False

Absender nicht mehr blockieren

Mit der Aktion Absenderblockierung entfernen können Sie bestimmte E-Mail-Absender aus einer Nachrichtenregel im Zielpostfach entfernen. Wenn die Regel leer ist, wird sie gelöscht.

Diese Aktion ist asynchron. Passen Sie das Aktionszeitlimit in der integrierten Entwicklungsumgebung (IDE) von Google SecOps nach Bedarf an.

Aktionseingaben

Für die Aktion Remove Block Sender sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Senders	Optional. Durch Kommas getrennte Liste der zu entfernenden Absender-E‑Mail-Adressen. Absender, die manuell in dieses Feld eingegeben wurden, und Absender, die dynamisch aus Entitäten extrahiert wurden, werden beide aus den Regelbedingungen entfernt.
Mailboxes	Pflichtangabe. Standardwert ist Default Mailbox. Zielpostfach, in dem die Nachrichtenregel vorhanden ist. Hinweis: Nachrichtenregeln können nur für das Postfach des authentifizierten Nutzers aktualisiert werden. Wenn Sie Regeln für andere Postfächer verwalten möchten, verwenden Sie die Microsoft Graph Mail-Integration.
Rule Name	Pflichtangabe. Standardwert ist Google SecOps - Blocked Senders. Name der Nachrichtenregel, aus der diese Absender entfernt werden sollen.
How many mailboxes to process in a single batch	Optional. Standardwert ist 1. Geben Sie an, wie viele Postfächer die Aktion in einem einzelnen Batch verarbeiten soll.

Aktionsausgaben

Die Aktion Absenderblockierung entfernen liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

JSON-Ergebnis

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die Sie erhalten, wenn Sie die Aktion Remove Block Sender verwenden:

[
  {
    "Entity": "[e-mail]",
    "EntityResult": {
      "successful_mailboxes": [
        "[e-mail]"
      ],
      "failed_mailboxes": []
    }
  }
]

Ausgabenachrichten

Die Aktion Remove Block Sender (Absenderblockierung entfernen) liefert die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Successfully removed sender SENDER from the blocked senders list for mailbox MAILBOX.	Aktion erfolgreich.
Failed to remove sender SENDER from the blocked senders list for mailbox MAILBOX. Reason: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses beschrieben, wenn die Aktion Absender blockieren entfernen verwendet wird:

Name des Skriptergebnisses	Wert
is_success	True oder False

E‑Mail im Fall speichern

Verwenden Sie die Aktion E‑Mail im Fall speichern, um E‑Mails oder E‑Mail-Anhänge in der Google SecOps-Fallpinnwand zu speichern. Mit den entsprechenden Berechtigungen können mit dieser Aktion E‑Mails aus anderen Postfächern als dem in der Integrationskonfiguration angegebenen gespeichert werden.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Save Email To The Case sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Search In Mailbox	Pflichtangabe. Das Standardpostfach, in dem der Suchvorgang ausgeführt wird. Wenn die Berechtigungen es zulassen, kann die Aktion auch in anderen Postfächern suchen.
Folder Name	Optional Ein Postfachordner, in dem nach E‑Mails gesucht werden soll. Wenn Sie einen Unterordner angeben möchten, verwenden Sie den Schrägstrich /, z. B. Inbox/Subfolder.
Mail ID	Pflichtangabe. Eine durch Kommas getrennte Liste von E‑Mail-IDs, nach denen gesucht werden soll. Wenn Sie die Aktion E-Mail senden verwendet haben, um E-Mails zu senden, legen Sie den Parameterwert entweder auf den Platzhalter {SendEmail.JSONResult|id} oder {SendEmail.JSONResult|internetMessageId} fest.
Save Only Email Attachments	Optional Wenn diese Option ausgewählt ist, werden nur Anhänge aus der angegebenen E‑Mail gespeichert. Standardmäßig nicht ausgewählt.
Attachment To Save	Optional Wenn der Parameter Save Only Email Attachments ausgewählt ist, werden mit der Aktion nur die durch diesen Parameter angegebenen Anhänge gespeichert. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String.
Base64 Encode	Optional Wenn diese Option ausgewählt ist, wird die E‑Mail-Datei durch die Aktion in das Base64-Format codiert. Standardmäßig nicht ausgewählt.

Aktionsausgaben

In der folgenden Tabelle werden die Ausgabetypen beschrieben, die mit der Aktion E‑Mail im Fall speichern verknüpft sind:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

Anhang im Fall-Repository

Die folgenden Anhänge sind mit der Aktion E-Mail im Fall speichern verknüpft:

• EMAIL_SUBJECT.eml, wenn die Aktion die E‑Mail speichert.

• Wenn die Aktion den Anhang speichert, enthält der Name des Anhangs eine Dateiendung, falls vorhanden.

JSON-Ergebnis

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die Sie erhalten, wenn Sie die Aktion Save Email To The Case verwenden:

{
    "id": "ID",
    "createdDateTime": "2024-02-16T14:10:34Z",
    "eml_info": "example_info",
    "lastModifiedDateTime": "2024-02-16T14:10:41Z",
    "changeKey": "cxsdjjh",
    "categories": [],
    "receivedDateTime": "2024-02-16T14:10:35Z",
    "sentDateTime": "2024-02-16T14:09:36Z",
    "hasAttachments": true,
    "internetMessageId": "INTERNET_MESSAGE_ID",
    "subject": "all attachments",
    "bodyPreview": "all the attachments",
    "importance": "normal",
    "parentFolderId": "PARENT_FOLDER_ID",
    "conversationId": "CONVERSATION_ID",
    "conversationIndex": "example-index",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://example.com/",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "<html><head>example-html</head></html>"
    },
    "sender": {
        "emailAddress": {
            "name": "NAME",
            "address": "[e-mail]"
        }
    },
    "from": {
        "emailAddress": {
            "name": "NAME",
            "address": "[e-mail]"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "NAME",
                "address": "[e-mail]"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "flag": {
        "flagStatus": "notFlagged"
    }
}

Ausgabenachrichten

In einem Fall-Repository liefert die Aktion E‑Mail im Fall speichern die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Email successfully saved! Successfully saved the following attachments: ATTACHMENTS_LIST The following attachments were not found in email with mail id: EMAIL_ID: ATTACHMENTS_LIST	Aktion erfolgreich.
Mailbox MAILBOX_NAME was not found. Action failed to run because the provided mailbox folder name MAILBOX_FOLDER was not found in the mailbox MAILBOX_NAME Failed to execute action, the error is: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Skriptausgabe beschrieben, wenn Sie die Aktion Save Email To The Case verwenden:

Name des Skriptergebnisses	Wert
is_success	True oder False

E‑Mails suchen

Verwenden Sie die Aktion E‑Mails suchen, um eine E‑Mail-Suche im Standardpostfach basierend auf den angegebenen Suchkriterien auszuführen. Mit den entsprechenden Berechtigungen kann diese Aktion eine Suche in anderen Postfächern ausführen.

Diese Aktion ist asynchron. Passen Sie das Aktionszeitlimit in der Google SecOps-IDE nach Bedarf an.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion E-Mails suchen sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Search In Mailbox	Obligatorisch Das Standardpostfach, in dem der Suchvorgang ausgeführt wird. Wenn die Berechtigungen es zulassen, kann die Aktion auch in anderen Postfächern suchen. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String. Verwenden Sie für komplexe Suchvorgänge in einer großen Anzahl von Postfächern die Integration des Exchange Extension Pack.
Folder Name	Optional Ein Postfachordner, in dem nach E‑Mails gesucht werden soll. Wenn Sie einen Unterordner angeben möchten, verwenden Sie den Schrägstrich / (z. B. Inbox/Subfolder). Standardwert ist Inbox.
Subject Filter	Optional Eine Filterbedingung, die den Betreff der E‑Mail angibt, nach der gesucht werden soll. Dieser Filter verwendet die contains-Logik.
Sender Filter	Optional Eine Filterbedingung, die den Absender der angeforderten E‑Mails angibt. Dieser Filter verwendet die equals-Logik.
Recipient Filter	Optional Eine Filterbedingung, die den Empfänger der angeforderten E-Mails angibt.
Timeframe (minutes)	Optional Eine Filterbedingung, die den Zeitraum in Minuten angibt, in dem nach E‑Mails gesucht werden soll.
Start Time	Optional Geben Sie die Startzeit für die E‑Mail-Suche im ISO 8601-Format an. Dieser Parameter hat Vorrang vor Timeframe (minutes).
End Time	Optional Geben Sie die Endzeit für die E‑Mail-Suche im ISO 8601-Format an. Wenn nichts angegeben ist und Start Time gültig ist, wird für diesen Parameter die aktuelle Zeit verwendet.
Body Regex Filter	Optional Geben Sie ein Muster eines regulären Ausdrucks an, nach dem im Text der E-Mail gesucht werden soll.
Message IDs	Optional Eine durch Kommas getrennte Liste von Nachrichten-IDs, nach denen gesucht werden soll. Hinweis: Dieser Filter hat Vorrang vor anderen Filtern.
Max Emails To Return	Optional Die Anzahl der E-Mails, die für die Aktion zurückgegeben werden sollen. Wenn Sie keinen Wert festlegen, wird der API-Standardwert verwendet. Standardwert ist 10.
Only Unread	Optional Wenn diese Option ausgewählt ist, wird nur nach ungelesenen E‑Mails gesucht. Standardmäßig nicht ausgewählt.
Select All Fields For Return	Optional Wenn diese Option ausgewählt ist, gibt die Aktion alle verfügbaren Felder für die abgerufene E‑Mail zurück. Standardmäßig nicht ausgewählt.
How many mailboxes to process in a single batch	Optional Die Anzahl der Postfächer, die in einem einzelnen Batch (einzelne Verbindung zum Mailserver) verarbeitet werden sollen. Standardwert ist 25.
Limit the Amount of Information Returned in the JSON Result	Optional Wenn diese Option ausgewählt ist, wird die Menge der von der Aktion zurückgegebenen Informationen auf die wichtigsten E‑Mail-Felder beschränkt. Standardmäßig nicht ausgewählt.
Disable the Action JSON Result	Optional Wenn diese Option ausgewählt ist, gibt die Aktion kein JSON-Ergebnis zurück. Standardmäßig nicht ausgewählt.

Aktionsausgaben

Die Aktion E‑Mails suchen liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Scriptergebnis	Verfügbar

Tabelle mit Fall-Repository

Mit der Aktion E-Mails suchen kann die folgende Tabelle generiert werden:

Tabellentitel: Übereinstimmende E-Mails

Spalten:

• Mail-ID
• Subject
• Sender
• Empfänger
• Eingangsdatum

Scriptergebnis

In der folgenden Tabelle sind die Werte für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion E‑Mails suchen verwendet wird:

Name des Skriptergebnisses	Wert
is_success	true oder false

Aktionsausgabenachrichten

Die Aktion E-Mails suchen liefert die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Successfully found emails in the following mailboxes: MAILBOX: FOUND_EMAILS_NUMBER Mailbox MAILBOX was not found. Action was not able to find any emails based on the specified search criteria.	Aktion erfolgreich.
Failed to find any of the provided mailboxes: MAILBOX_LIST Failed to execute action, the error is: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

E-Mail senden

Mit der Aktion E-Mail senden können Sie E-Mails von einem bestimmten Postfach an eine beliebige Liste von Empfängern senden.

Mit dieser Aktion können entweder Nur-Text- oder HTML-formatierte E‑Mails gesendet werden. Mit den entsprechenden Berechtigungen kann die Aktion E-Mails von einem anderen Postfach als dem in der Integrationskonfiguration angegebenen senden.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Kurzübersicht zur S/MIME-Konfiguration

Anhand der folgenden Referenz können Sie bestimmen, welche S/MIME-Parameter basierend auf dem Sicherheitsniveau der ausgehenden E‑Mail konfiguriert werden müssen:

Gewünschter E‑Mail-Typ	Base64 Encoded Certificate	Base64 Encoded Private Key	Base64 Encoded Recipient Certificate
Standard-E‑Mail (kein S/MIME)	Leer lassen	Leer lassen	Leer lassen
Digital signiert	Erforderlich	Erforderlich	Leer lassen
Verschlüsselt	Leer lassen	Leer lassen	Erforderlich
Signiert und verschlüsselt	Erforderlich	Erforderlich	Erforderlich

Zertifikatsdateien in Base64 konvertieren

Führen Sie die folgenden Befehle aus, um Ihre Zertifikats- und privaten Schlüsseldateien in einzeilige Base64-Strings für die Aktionsparameter zu codieren:

Linux und macOS:

base64 -w 0 sender_cert.crt
base64 -w 0 sender_key.key

Windows PowerShell:

[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\path\to\certificate.crt"))
[Convert]::ToBase64String([IO.File]::ReadAllBytes("C:\path\to\private_key.key"))

Aktionseingaben

Für die Aktion E-Mail senden sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Send From	Pflichtangabe. Eine optionale E-Mail-Adresse, von der E-Mails gesendet werden sollen, sofern die Berechtigungen dies zulassen. Standardmäßig werden E-Mails über das Standardpostfach gesendet, das in der Integrationskonfiguration angegeben ist.
Subject	Pflichtangabe. Der Betreff der E‑Mail.
Send to	Pflichtangabe. Eine durch Kommas getrennte Liste von E‑Mail-Adressen für die E‑Mail-Empfänger, z. B. [e-mail], [e-mail].
CC	Optional Eine durch Kommas getrennte Liste von E‑Mail-Adressen für das CC-Feld der E‑Mail. Das Format ist mit dem des Parameters Send to identisch.
BCC	Optional Eine durch Kommas getrennte Liste von E‑Mail-Adressen für das Feld „Bcc“ der E‑Mail. Das Format ist dasselbe wie für den Parameter Send to.
Attachments Paths	Optional Eine durch Kommas getrennte Liste von Pfaden für Dateianhänge, die auf dem Server gespeichert sind, z. B. /FILE_DIRECTORY/file.pdf, /FILE_DIRECTORY/image.jpg.
Attachments Location	Pflichtangabe. Ein Speicherort für die Anhänge. Standardmäßig versucht die Aktion, Anhänge aus dem Cloud Storage-Bucket hochzuladen. Die möglichen Werte sind GCP Bucket oder Local File System. Der Standardwert ist GCP Bucket.
Mail Content Type	Optional Der Typ des E-Mail-Inhalts. Folgende Werte sind möglich: Text HTML Der Standardwert ist Text.
Mail Content	Pflichtangabe. Der E‑Mail-Text.
Reply-To Recipients	Optional Eine durch Kommas getrennte Liste von Empfängern, die im Header Reply-To verwendet werden sollen. Verwenden Sie den Header Reply-To, um Antwort-E-Mails an die angegebene E-Mail-Adresse statt an die Adresse des Absenders im Feld From weiterzuleiten.
Base64 Encoded Certificate	Optional Das Base64-codierte öffentliche X.509-Zertifikat (.cer, .crt, .pem) des Absenders (einzeiliges Format). Wird für die digitale S/MIME-Signatur verwendet. Wenn angegeben, müssen Sie auch Base64 Encoded Private Key angeben.
Base64 Encoded Private Key	Optional Der Base64-codierte private Schlüssel (.key, .pem) des Absenders (einzeiliges Format). Wird für die digitale S/MIME-Signatur verwendet. Erforderlich, wenn Base64 Encoded Certificate angegeben ist.
Base64 Encoded Recipient Certificate	Optional Das Base64-codierte öffentliche Zertifikat (.cer, .crt, .pem) des Empfängers (einzeiliges Format). Wird für die E‑Mail-Verschlüsselung verwendet.

Aktionsausgaben

In der folgenden Tabelle werden die Ausgabetypen beschrieben, die mit der Aktion E-Mail senden verknüpft sind:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Nicht verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

Ausgabenachrichten

Die Aktion E-Mail senden liefert die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Email was sent successfully.	Aktion erfolgreich.
Action failed to run because specified attachments were not found: ATTACHMENTS_LIST Failed to execute action, the error is: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses beschrieben, wenn Sie die Aktion E-Mail senden verwenden:

Name des Skriptergebnisses	Wert
is_success	True oder False

E‑Mail-HTML senden

Mit der Aktion Send Email HTML können Sie E-Mails, die Sie mit der Google SecOps-HTML-Vorlage erstellt haben, von einem bestimmten Postfach an eine beliebige Liste von Empfängern senden. Mit den entsprechenden Berechtigungen kann die Aktion E-Mails von einem anderen Postfach als dem Standardpostfach senden.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion E-Mail-HTML senden sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Send From	Pflichtangabe. Eine optionale E-Mail-Adresse, von der E-Mails gesendet werden sollen, sofern die Berechtigungen dies zulassen. Standardmäßig werden E-Mails über das Standardpostfach gesendet, das in der Integrationskonfiguration angegeben ist.
Subject	Pflichtangabe. Der Betreff der E‑Mail.
Send to	Pflichtangabe. Eine durch Kommas getrennte Liste von E‑Mail-Adressen für die E‑Mail-Empfänger, z. B. [e-mail], [e-mail].
CC	Optional Eine durch Kommas getrennte Liste von E‑Mail-Adressen für das CC-Feld der E‑Mail. Das Format ist mit dem des Parameters Send to identisch.
BCC	Optional Eine durch Kommas getrennte Liste von E‑Mail-Adressen für das Feld „Bcc“ der E‑Mail. Das Format ist dasselbe wie für den Parameter Send to.
Attachments Paths	Optional Ein vollständiger Pfad für den bereitzustellenden Anhang, z. B. /FILE_DIRECTORY/file.pdf, /FILE_DIRECTORY/image.jpg. Sie können mehrere Werte in einem kommagetrennten String angeben.
Email HTML Template	Pflichtangabe. Der Typ der zu verwendenden HTML-Vorlage. Die möglichen Werte sind Email HTML Template und Dynamically generated list of available templates. Der Standardwert ist Email HTML Template.
Mail Content	Pflichtangabe. Der E‑Mail-Text.
Reply-To Recipients	Optional Eine durch Kommas getrennte Liste von Empfängern, die im Header Reply-To verwendet werden sollen. Verwenden Sie den Header Reply-To, um Antwort-E-Mails an die angegebene E-Mail-Adresse statt an die im Feld From angegebene Absenderadresse weiterzuleiten.
Attachment Location	Pflichtangabe. Ein Speicherort für die Anhänge. Standardmäßig versucht die Aktion, Anhänge aus dem Cloud Storage-Bucket hochzuladen. Die möglichen Werte sind GCP Bucket oder Local File System. Der Standardwert ist GCP Bucket.

Aktionsausgaben

Die Aktion Send Email HTML liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

JSON-Ergebnis

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die Sie erhalten, wenn Sie die Aktion E-Mail-HTML senden verwenden:

{
    "createdDateTime": "2024-01-30T16:50:27Z",
    "lastModifiedDateTime": "2024-01-30T16:50:27Z",
    "changeKey": "example-key",
    "categories": [],
    "receivedDateTime": "2024-01-30T16:50:27Z",
    "sentDateTime": "2024-01-30T16:50:27Z",
    "hasAttachments": false,
    "internetMessageId": "outlook.com",
    "subject": "Testing",
    "bodyPreview": "example",
    "importance": "normal",
    "parentFolderId": "ID",
    "conversationId": "ID",
    "conversationIndex": "INDEX",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://example.com",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "content"
    },
    "sender": {
        "emailAddress": {
            "name": "NAME",
            "address": "[e-mail]"
        }
    },
    "from": {
        "emailAddress": {
            "name": "NAME",
            "address": "[e-mail]"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "NAME",
                "address": "[e-mail]"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "uniqueBody": {
        "contentType": "html",
        "content": "content"
    },
    "flag": {
        "flagStatus": "notFlagged"
    },
    "id": "ID"
}

Ausgabenachrichten

Auf einer Case Wall liefert die Aktion Send Email HTML die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Email was sent successfully.	Aktion erfolgreich.
Action failed to run because the HTML template was not specified. Action failed to run because the following specified attachments were not found: ATTACHMENT_LIST Failed to execute action, the error is: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses beschrieben, wenn Sie die Aktion E-Mail-HTML senden verwenden:

Name des Skriptergebnisses	Wert
is_success	True oder False

Antwort im Thread senden

Verwenden Sie die Aktion Thread-Antwort senden, um eine Nachricht als Antwort auf den E-Mail-Thread zu senden. Mit den entsprechenden Berechtigungen kann die Aktion E-Mails von einem anderen Postfach als dem in der Integrationskonfiguration angegebenen senden.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Send Thread Reply sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Send From	Pflichtangabe. Eine optionale E-Mail-Adresse, von der E-Mails gesendet werden sollen, sofern die Berechtigungen dies zulassen. Standardmäßig werden E-Mails über das Standardpostfach gesendet, das in der Integrationskonfiguration angegeben ist.
Mail ID	Pflichtangabe. Die E‑Mail-ID, nach der gesucht werden soll.
Folder Name	Optional Ein Postfachordner, in dem nach E‑Mails gesucht werden soll. Wenn Sie einen Unterordner angeben möchten, verwenden Sie den Schrägstrich /, z. B. Inbox/Subfolder. Der Standardwert ist Inbox.
Attachments Paths	Optional Eine durch Kommas getrennte Liste von Pfaden für Dateianhänge, die auf dem Server gespeichert sind, z. B. /FILE_DIRECTORY/file.pdf, /FILE_DIRECTORY/image.jpg.
Mail Content	Pflichtangabe. Der E‑Mail-Text.
Reply All	Optional Wenn diese Option ausgewählt ist, wird eine Antwort an alle Empfänger der ursprünglichen E‑Mail gesendet. Standardmäßig nicht ausgewählt. Dieser Parameter hat Vorrang vor dem Parameter Reply To.
Reply To	Optional Eine durch Kommas getrennte Liste von E-Mail-Adressen, an die die Antwort gesendet werden soll. Wenn Sie keinen Wert angeben und das Kästchen Reply All nicht aktiviert ist, wird die Antwort nur an den ursprünglichen Absender der E‑Mail gesendet. Wenn das Kästchen Reply All angeklickt ist, wird dieser Parameter von der Aktion ignoriert.
Attachments Location	Pflichtangabe. Ein Speicherort für die Anhänge. Standardmäßig versucht die Aktion, Anhänge aus dem Cloud Storage-Bucket hochzuladen. Die möglichen Werte sind GCP Bucket oder Local File System. Der Standardwert ist GCP Bucket.
Message Timezone	Optional. Die Zeitzone, die für das ursprüngliche Sendedatum der E-Mail im Antwortheader verwendet wird (z. B. UTC, America/New_York oder Europe/London). Wenn der angegebene Wert nicht gültig ist, wird der Standardwert verwendet. Der Standardwert ist UTC.

Aktionsausgaben

In der folgenden Tabelle werden die Ausgabetypen beschrieben, die mit der Aktion Thread-Antwort senden verknüpft sind:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

JSON-Ergebnis

Das folgende Beispiel zeigt die JSON-Ergebnisausgabe, die bei Verwendung der Aktion Send Thread Reply empfangen wird:

  {
    "id": "yyyy",
    "createdDateTime": "2024-02-02T10:57:18Z",
    "lastModifiedDateTime": "2024-02-02T10:57:23Z",
    "changeKey": "dsf+oAAQLaPjk",
    "categories": [],
    "receivedDateTime": "2024-02-02T10:57:20Z",
    "sentDateTime": "2024-02-02T10:57:19Z",
    "hasAttachments": true,
    "internetMessageId": "sdfhsjdfhjsdjfd",
    "subject": "RE: reply checking",
    "bodyPreview": "Reply check kr",
    "importance": "normal",
    "parentFolderId": "id",
    "conversationId": "id",
    "conversationIndex": "sdghfjfke",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://www.example.com/about",
    "inferenceClassification": "focused",
    "body": {
      "contentType": "text",
      "content": "Reply check kr"
    },
    "sender": {
      "emailAddress": {
        "name": "aff",
        "address": "[e-mail]"
      }
    },
    "from": {
      "emailAddress": {
        "name": "fasf",
        "address": "[e-mail]"
      }
    },
    "toRecipients": [
      {
        "emailAddress": {
          "name": "wf",
          "address": "[e-mail]"
        }
      }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "uniqueBody": {
      "contentType": "html",
      "content": "Reply check"
    },
    "flag": {
      "flagStatus": "notFlagged"
    }
  }

Ausgabenachrichten

Die Aktion Thread-Antwort senden liefert die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Successfully sent reply to the mail with ID: EMAIL_ID	Aktion erfolgreich.
Error executing action "Send Thread Reply". Reason: if you want to send a reply only to your own email address, you need to work with "Reply To" parameter.	Aktion fehlgeschlagen. Prüfen Sie den Wert des Parameters Reply To.
Error executing action "Send Thread Reply" because the provided mail id EMAIL_ID was not found. Action failed to run because specified attachments were not found: ATTACHMENTS_LIST Failed to execute action, the error is: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses beschrieben, wenn Sie die Aktion Send Thread Reply verwenden:

Name des Skriptergebnisses	Wert
is_success	True oder False

E‑Mail zur Abstimmung senden

Verwenden Sie die Aktion Abstimmungs-E-Mail senden, um E-Mails mit den vordefinierten Antwortoptionen zu senden. Bei dieser Aktion werden Google SecOps-HTML-Vorlagen verwendet, um die E‑Mail zu formatieren. Mit den entsprechenden Berechtigungen können Sie mit der Aktion Abstimmungs-E-Mail senden E-Mails von einem anderen Postfach als dem Standardpostfach senden.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion E-Mail zur Abstimmung senden sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Send From	Pflichtangabe. Eine optionale E-Mail-Adresse, von der E-Mails gesendet werden sollen, sofern die Berechtigungen dies zulassen. Standardmäßig werden E-Mails über das Standardpostfach gesendet, das in der Integrationskonfiguration angegeben ist.
Subject	Pflichtangabe. Der Betreff der E‑Mail.
Send to	Pflichtangabe. Eine durch Kommas getrennte Liste von E‑Mail-Adressen für die E‑Mail-Empfänger, z. B. [e-mail], [e-mail].
CC	Optional Eine durch Kommas getrennte Liste von E‑Mail-Adressen für das CC-Feld der E‑Mail. Das Format ist mit dem des Parameters Send to identisch.
BCC	Optional Eine durch Kommas getrennte Liste von E‑Mail-Adressen für das Feld „Bcc“ der E‑Mail. Das Format ist dasselbe wie für den Parameter Send to.
Attachments Paths	Optional Ein vollständiger Pfad für den bereitzustellenden Anhang, z. B. /FILE_DIRECTORY/file.pdf, /FILE_DIRECTORY/image.jpg. Sie können mehrere Werte in einem kommagetrennten String angeben.
Email HTML Template	Pflichtangabe. Der Typ der zu verwendenden HTML-Vorlage. Die möglichen Werte sind Email HTML Template und Dynamically generated list of available templates. Der Standardwert ist Email HTML Template.
Reply-To Recipients	Optional Eine durch Kommas getrennte Liste von Empfängern, die im Header Reply-To verwendet werden sollen. Verwenden Sie den Header Reply-To, um Antwort-E-Mails an die angegebene E-Mail-Adresse statt an die im Feld From angegebene Absenderadresse weiterzuleiten.
Structure of voting options	Pflichtangabe. Die Struktur der Abstimmung, die an die Empfänger gesendet werden soll. Die möglichen Werte sind Yes/No oder Approve/Reject. Der Standardwert ist Yes/No.
Attachment Location	Pflichtangabe. Ein Speicherort für die Anhänge. Standardmäßig versucht die Aktion, den Anhang aus dem Cloud Storage-Bucket hochzuladen. Die möglichen Werte sind GCP Bucket oder Local File System. Der Standardwert ist GCP Bucket.

Aktionsausgaben

Die Aktion E-Mail zur Abstimmung senden liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Nicht verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Nicht verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

JSON-Ergebnis

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die Sie erhalten, wenn Sie die Aktion E-Mail zur Abstimmung senden verwenden:

{
    "createdDateTime": "2024-01-30T16:50:27Z",
    "lastModifiedDateTime": "2024-01-30T16:50:27Z",
    "changeKey": "KEY",
    "categories": [],
    "receivedDateTime": "2024-01-30T16:50:27Z",
    "sentDateTime": "2024-01-30T16:50:27Z",
    "hasAttachments": false,
    "internetMessageId": "<example-message-ID>",
    "subject": "Testing",
    "bodyPreview": "example",
    "importance": "normal",
    "parentFolderId": "FOLDER_ID",
    "conversationId": "CONVERSATION_ID",
    "conversationIndex": "CONVERSATION_INDEX",
    "isDeliveryReceiptRequested": false,
    "isReadReceiptRequested": false,
    "isRead": true,
    "isDraft": false,
    "webLink": "https://www.example.com/about",
    "inferenceClassification": "focused",
    "body": {
        "contentType": "html",
        "content": "content"
    },
    "sender": {
        "emailAddress": {
            "name": "NAME",
            "address": "[e-mail]"
        }
    },
    "from": {
        "emailAddress": {
            "name": "NAME",
            "address": "[e-mail]"
        }
    },
    "toRecipients": [
        {
            "emailAddress": {
                "name": "NAME",
                "address": "[e-mail]"
            }
        }
    ],
    "ccRecipients": [],
    "bccRecipients": [],
    "replyTo": [],
    "uniqueBody": {
        "contentType": "html",
        "content": "content"
    },
    "flag": {
        "flagStatus": "notFlagged"
    },
    "id": "ID"
}

Ausgabenachrichten

In einem Fall-Repository werden für die Aktion E‑Mail zur Abstimmung senden die folgenden Ausgabenachrichten angezeigt:

Ausgabemeldung	Beschreibung der Nachricht
Email was sent successfully.	Aktion erfolgreich.
Action failed to run because the HTML template was not specified. Action failed to run because the following specified attachments were not found: ATTACHMENT_LIST Failed to execute action, the error is: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Skriptausgabe beschrieben, wenn Sie die Aktion Abstimmungs-E-Mail senden verwenden:

Name des Skriptergebnisses	Wert
is_success	True oder False

Auf E‑Mail von Nutzer warten

Mit der Aktion Auf E‑Mail von Nutzer warten können Sie auf die Antwort des Nutzers auf eine E‑Mail warten, die mit der Aktion E‑Mail senden gesendet wurde.

Diese Aktion ist asynchron. Passen Sie das Aktionszeitlimit in der Google SecOps-IDE nach Bedarf an. Wenn Sie das Zeitlimit auf 0 setzen oder leer lassen, wird das in den Umgebungseinstellungen konfigurierte Standardzeitlimit verwendet.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Auf E-Mail von Nutzer warten sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Mail ID	Obligatorisch Die ID oder internetMessageId der E-Mail, auf die die Aktion wartet. Wenn Sie die Aktion E-Mail senden verwendet haben, um E-Mails zu senden, legen Sie den Parameterwert entweder auf den Platzhalter {SendEmail.JSONResult|id} oder {SendEmail.JSONResult|internetMessageId} fest.
Mail Date	Optional Zeitstempel der E-Mail, auf die die Aktion wartet. Wenn die Nachricht mit der Aktion E‑Mail senden gesendet wurde, wählen Sie das Feld {SendEmail.JSONResult|sentDateTime} oder {SendEmail.JSONResult|createdDateTime} als Platzhalter aus.
Mail Recipients	Optional Durch Kommas getrennte Liste der E‑Mail-Adressen von Empfängern, auf deren Antwort die Aktion wartet. Wenn die Nachricht mit der Aktion E-Mail senden gesendet wurde, wählen Sie das Feld {SendEmail.JSONResult|toRecipients} als Platzhalter aus.
How long to wait for recipient reply (minutes)	Optional Wie viele Minuten auf die Antwort des Nutzers gewartet werden soll, bevor die Anfrage als abgelaufen markiert wird. Standardwert ist 10080.
Wait for All Recipients to Reply?	Optional Wenn diese Option ausgewählt ist, wartet die Aktion auf Antworten von allen Empfängern, bis das Zeitlimit erreicht ist oder die erste Antwort eingeht. Standardmäßig nicht ausgewählt.
Wait Stage Exclude pattern	Optional Ein regulärer Ausdruck, um bestimmte Antworten von der Wartephase auszuschließen. Dieser Parameter funktioniert sowohl mit dem Betreff als auch mit dem Text der E-Mail. Wenn Sie beispielsweise den regulären Ausdruck Out of Office.* konfigurieren, werden automatische Abwesenheitsnachrichten nicht als Antworten von Empfängern betrachtet und es wird auf eine tatsächliche Antwort des Nutzers gewartet.
Folder to Check for Reply	Optional Ein E‑Mail-Ordner im Postfach, in dem nach eingehenden Antworten von Empfängern gesucht werden soll. Die Suche wird in dem Postfach ausgeführt, von dem die E-Mail mit einer Frage gesendet wurde. Unterstützt verschachtelte Unterordner mit dem Schrägstrich / (z. B. Inbox/Subfolder). Bei diesem Parameter wird zwischen Groß- und Kleinschreibung unterschieden. Der Standardwert ist Inbox.
Fetch Response Attachments	Optional Wenn diese Option ausgewählt ist und die Antwort des Empfängers Anhänge enthält, ruft die Aktion die Antwort ab und fügt sie als Anhang zum Aktionsergebnis hinzu. Standardmäßig nicht ausgewählt.
Limit the Amount of Information Returned in the JSON Result	Optional Wenn diese Option ausgewählt ist, wird die Menge der von der Aktion zurückgegebenen Informationen auf die wichtigsten E‑Mail-Felder beschränkt. Standardmäßig ausgewählt.
Disable the Action JSON Result	Optional Wenn diese Option ausgewählt ist, gibt die Aktion kein JSON-Ergebnis zurück. Standardmäßig nicht ausgewählt.

Aktionsausgaben

Die Aktion Auf E-Mail von Nutzer warten liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Scriptergebnis	Verfügbar

Anhang im Fall-Repository

Der folgende Case Wall-Anhang ist mit der Aktion Wait For Email From User verknüpft:

Typ: Entität

Anhangsinhalt: Titel, Dateiname (ggf. einschließlich Erweiterungen), fileContent.

• Titel: RECIPIENT_EMAIL Antwortanhang.
• Dateiname: ATTACHMENT_FILENAME + FILE_EXTENSION
• fileContent: CONTENT_OF_THE_ATTACHED_FILE

Tabelle mit Fall-Repository

Mit der Aktion Wait For Email From User kann die folgende Tabelle generiert werden:

Tabellentitel: Übereinstimmende E-Mails

Spalten:

• Mail-ID
• Eingangsdatum
• Sender
• Empfänger
• Subject

Scriptergebnis

In der folgenden Tabelle ist der Wert für die Ausgabe des Skriptergebnisses aufgeführt, wenn die Aktion Auf E-Mail von Nutzer warten verwendet wird:

Name des Skriptergebnisses	Wert
is_success	true oder false

Aktionsausgabenachrichten

Die Aktion Auf E‑Mail von Nutzer warten liefert die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Found the user EMAIL_RECIPIENT reply: USER_REPLY Timeout getting reply from user: EMAIL_RECIPIENT.	Aktion erfolgreich.
Action failed to receive any replies until timeout. Failed to execute action, the error is: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Auf E-Mail-Ergebnisse warten

Verwenden Sie die Aktion Auf Abstimmungs-E-Mail-Ergebnisse warten, um auf die Nutzerantwort zu warten, die auf der Abstimmungs-E-Mail basiert, die mit der Aktion Abstimmungs-E-Mail senden gesendet wurde.

Diese Aktion ist asynchron. Passen Sie das Aktionszeitlimit in der Google SecOps-IDE nach Bedarf an.

Diese Aktion wird nicht für Google SecOps-Entitäten ausgeführt.

Aktionseingaben

Für die Aktion Wait For Vote Email Results sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Vote Mail Sent From	Pflichtangabe. Das Postfach, von dem aus die Aktion E‑Mail zur Abstimmung senden eine E‑Mail gesendet hat. Der Standardwert ist das Postfach, das Sie in der Integrationskonfiguration angegeben haben. Optional können Sie einen anderen Wert für diesen Parameter festlegen, wenn die Abstimmungs-E-Mail von einem anderen Postfach gesendet wird.
Mail ID	Pflichtangabe. Die ID der E‑Mail. Wenn die E-Mail mit der Aktion Send Vote Email gesendet wird, legen Sie den Parameterwert entweder auf den Platzhalter SendVoteEmail.JSONResult|id oder SendEmail.JSONResult|internetMessageId fest. Wenn Sie E‑Mail-IDs zurückgeben möchten, können Sie die Aktion E‑Mails suchen verwenden.
Wait for All Recipients To Reply?	Optional Wenn diese Option ausgewählt ist, wartet die Aktion auf Antworten von allen Empfängern, bis das Zeitlimit erreicht ist oder die erste Antwort eingeht. Standardmäßig aktiviert.
Wait Stage Exclude Pattern	Optional Ein regulärer Ausdruck, um bestimmte Antworten von der Wartephase auszuschließen. Dieser Parameter funktioniert mit dem E‑Mail-Text. Beispiel: Die Aktion betrachtet automatische Abwesenheitsnachrichten nicht als Antworten des Empfängers, sondern wartet auf eine tatsächliche Antwort des Nutzers.
Folder To Check For Reply	Optional Einen E‑Mail-Ordner im Postfach, in dem nach der Antwort des Nutzers gesucht werden soll. Die Suche wird in dem Postfach ausgeführt, von dem die E-Mail mit einer Frage gesendet wurde. Dieser Parameter akzeptiert eine durch Kommas getrennte Liste von Ordnern, um die Nutzerantwort in mehreren Ordnern zu prüfen. Bei diesem Parameter wird zwischen Groß- und Kleinschreibung unterschieden. Der Standardwert ist Inbox.
Folder To Check For Sent Mail	Optional Ein Postfachordner, in dem nach der gesendeten E‑Mail gesucht werden soll. Es ist ein Postfach, von dem aus Sie die E-Mail mit einer Frage gesendet haben. Dieser Parameter akzeptiert eine durch Kommas getrennte Liste von Ordnern, um die Nutzerantwort in mehreren Ordnern zu prüfen. Bei diesem Parameter wird zwischen Groß- und Kleinschreibung unterschieden. Wenn Sie einen Unterordner angeben möchten, verwenden Sie den Schrägstrich /, z. B. Inbox/Subfolder. Der Standardwert ist Sent Items.
Fetch Response Attachments	Optional Wenn diese Option ausgewählt ist und die Antwort des Empfängers Anhänge enthält, ruft die Aktion die Antwort ab und fügt sie als Anhang zur Case Wall hinzu. Standardmäßig nicht ausgewählt.

Aktionsausgaben

Die Aktion Wait For Vote Email Results liefert die folgenden Ausgaben:

Aktionsausgabetyp	Verfügbarkeit
Anhang im Fall-Repository	Verfügbar
Link zum Fall-Repository	Nicht verfügbar
Tabelle mit Fall-Repository	Verfügbar
Anreicherungstabelle	Nicht verfügbar
JSON-Ergebnis	Verfügbar
Ausgabenachrichten	Verfügbar
Scriptergebnis	Verfügbar

Anhang im Fall-Repository

Der folgende Anhang im Fall-Repository ist mit der Aktion Wait For Vote Email Results verknüpft:

Typ: Entität

Anhangsinhalt: Titel, Dateiname (ggf. einschließlich Erweiterungen), fileContent.

• Titel: RECIPIENT_EMAIL Antwortanhang.
• Dateiname: ATTACHMENT_FILENAME  + FILE_EXTENSION
• fileContent: CONTENT_OF_THE_ATTACHED_FILE

Tabelle mit Fall-Repository

In einem Fall-Repository generiert die Aktion Auf E-Mail-Ergebnisse warten die folgende Tabelle:

Tabellentitel: Übereinstimmende E-Mails

Spalten:

• Mail-ID
• Eingangsdatum
• Sender
• Empfänger
• Subject

JSON-Ergebnis

Im folgenden Beispiel wird die JSON-Ergebnisausgabe beschrieben, die Sie erhalten, wenn Sie die Aktion Wait For Vote Email Results verwenden:

{
    "Responses": [
        {
            "recipient": "[e-mail]",
            "vote": "Approve"
        }
    ]
}

Ausgabenachrichten

Die Aktion Auf Ergebnisse der Abstimmungs-E-Mail warten liefert die folgenden Ausgabenachrichten:

Ausgabemeldung	Beschreibung der Nachricht
Found the user EMAIL_RECIPIENT reply: USER_REPLY. Exceeded timeout to get a reply from user: EMAIL_RECIPIENT.	Aktion erfolgreich.
Action failed to receive any replies until timeout. Failed to execute action, the error is: ERROR_REASON	Aktion fehlgeschlagen. Prüfen Sie die Verbindung zum Server, die Eingabeparameter oder die Anmeldedaten.

Scriptergebnis

In der folgenden Tabelle werden die Werte für die Ausgabe des Skriptergebnisses beschrieben, wenn Sie die Aktion Wait For Vote Email Results verwenden:

Name des Skriptergebnisses	Wert
is_success	True oder False

Connectors

Weitere Informationen zum Konfigurieren von Connectors in Google SecOps finden Sie unter Daten aufnehmen (Connectors).

Hinweis: Um Datenverlust zu vermeiden, verwenden Connectors Ereignis-Flattening. Wenn eine Rohbenachrichtigung eine Liste von Entitäten enthält (z. B. mehrere E-Mail-Adressen, Hostnamen oder IP-Adressen), werden diese von Connectors automatisch in separate, eindeutige Ereignisse aufgeteilt.

Beispiel: Eine einzelne Rohbenachrichtigung mit drei verschiedenen E-Mail-Adressen wird als drei separate Ereignisse aufgenommen, die jeweils eine eindeutige E-Mail-Adresse enthalten.

So wird sichergestellt, dass jede Entität korrekt als eindeutiges Asset indexiert wird, sodass sie in Playbooks vollständig durchsuchbar und nutzbar ist.

Microsoft Graph Mail Delegated Connector

Verwenden Sie den Microsoft Graph Mail Delegated Connector, um E‑Mails vom Microsoft Graph-E‑Mail-Dienst abzurufen.

Der Microsoft Graph Mail Delegated Connector verwendet die delegierte Authentifizierung in Microsoft 365 und erfordert die interaktive Anmeldung des Nutzers, um eine Verbindung zu Microsoft 365 herzustellen.

Verwenden Sie die dynamische Liste, um die angegebenen Werte mithilfe von regulären Ausdrücken aus dem E‑Mail-Text und dem Betreff zu filtern. Standardmäßig verwendet der Connector einen regulären Ausdruck, um die URLs aus der E‑Mail herauszufiltern.

Voraussetzungen für Connectors

Für den Microsoft Graph Mail Delegated Connector müssen Sie die Integrationsparameter konfigurieren und ein Aktualisierungstoken generieren.

Connector-Eingaben

Für den Microsoft Graph Mail Delegated Connector sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Product Field Name	Pflichtangabe. Der Name des Felds, in dem der Produktname gespeichert ist. Der Standardwert ist device_product. Der Produktname wirkt sich hauptsächlich auf die Zuordnung aus. Um den Zuordnungsprozess für den Connector zu optimieren und zu verbessern, wird der Standardwert device_product in einen Fallback-Wert aufgelöst, auf den im Code verwiesen wird. Eine ungültige Eingabe für diesen Parameter wird standardmäßig in einen Fallback-Wert aufgelöst.
Event Field Name	Pflichtangabe. Der Feldname, der zur Bestimmung des Ereignisnamens (Untertyp) verwendet wird. Der Standardwert ist event_name.
Environment Field Name	Optional Der Name des Felds, in dem der Umgebungsname gespeichert ist. Wenn das Feld „environment“ nicht gefunden wird, wird die Umgebung auf "" gesetzt.
Environment Regex Pattern	Optional Ein reguläres Ausdrucksmuster, das für den im Feld Environment Field Name gefundenen Wert ausgeführt werden soll. Mit diesem Parameter können Sie das Umgebungsfeld mithilfe der Logik regulärer Ausdrücke bearbeiten. Verwenden Sie den Standardwert .*, um den erforderlichen Rohwert Environment Field Name abzurufen. Wenn das Muster des regulären Ausdrucks null oder leer ist oder der Umgebungswert null ist, ist das endgültige Umgebungsergebnis "".
Email Exclude Pattern	Optional Ein regulärer Ausdruck, um bestimmte E‑Mails von der Aufnahme auszuschließen, z. B. Spam oder Nachrichten. Dieser Parameter funktioniert sowohl mit dem Betreff als auch mit dem Text der E‑Mail.
Script Timeout (Seconds)	Pflichtangabe. Das Zeitlimit in Sekunden für den Python-Prozess, der das aktuelle Script ausführt. Der Standardwert ist 300.
Microsoft Entra ID Endpoint	Pflichtangabe. Der Microsoft Entra-Endpunkt, der in der Integration verwendet werden soll. Der Standardwert ist https://login.microsoftonline.com.
Microsoft Graph Endpoint	Pflichtangabe. Der Microsoft Graph-Endpunkt, der in der Integration verwendet werden soll. Der Standardwert ist https://graph.microsoft.com.
Mail Address	Pflichtangabe. Eine E-Mail-Adresse, die der Connector verwenden soll.
Refresh Token	Pflichtangabe. Das Aktualisierungstoken, das für die Authentifizierung verwendet wird.
Client ID	Pflichtangabe. Eine Anwendungs-ID (Client-ID) der Microsoft Entra-Anwendung.
Client Secret Value	Pflichtangabe. Der Clientschlüsselwert der Microsoft Entra-Anwendung.
Microsoft Entra ID Directory ID	Pflichtangabe. Der Microsoft Entra ID-Wert (Mandanten-ID).
Folder to check for emails	Pflichtangabe. E‑Mail-Ordner, in dem nach den E‑Mails gesucht werden soll. Dieser Parameter akzeptiert eine durch Kommas getrennte Liste von Ordnern, um die Nutzerantwort in mehreren Ordnern zu suchen. Wenn Sie einen Unterordner angeben möchten, verwenden Sie den Schrägstrich /, z. B. Inbox/Subfolder. Bei diesem Parameter wird zwischen Groß- und Kleinschreibung unterschieden. Der Standardwert ist Inbox.
Offset Time In Hours	Pflichtangabe. Die Anzahl der Stunden vor der ersten Connector-Iteration zum Abrufen von E‑Mails. Dieser Parameter gilt für die erste Connector-Iteration, nachdem Sie den Connector zum ersten Mal aktiviert haben. Der Connector kann diesen Parameter als Fallback-Wert verwenden, wenn der Zeitstempel der letzten Connector-Iteration abläuft. Der Standardwert ist 24.
Max Emails Per Cycle	Pflichtangabe. Die Anzahl der E‑Mails, die bei jeder Connector-Iteration abgerufen werden sollen. Der Standardwert ist 10.
Unread Emails Only	Optional Wenn diese Option ausgewählt ist, erstellt der Connector nur Fälle aus ungelesenen E‑Mails. Standardmäßig nicht ausgewählt.
Mark Emails as Read	Optional Wenn diese Option ausgewählt ist, werden E‑Mails nach der Aufnahme als gelesen markiert. Standardmäßig nicht ausgewählt.
Disable Overflow	Optional Wenn diese Option ausgewählt ist, ignoriert der Connector den Überlaufmechanismus von Google SecOps. Standardmäßig nicht ausgewählt.
Verify SSL	Pflichtangabe. Wenn diese Option ausgewählt ist, validiert die Integration das SSL-Zertifikat, wenn eine Verbindung zu Microsoft Graph hergestellt wird. Standardmäßig aktiviert.
Original Received Mail Prefix	Optional Ein Präfix, das den extrahierten Ereignisschlüsseln (z. B. to, from oder subject) aus der ursprünglichen E-Mail hinzugefügt wird, die im überwachten Postfach empfangen wurde. Der Standardwert ist orig.
Attached Mail File Prefix	Optional Ein Präfix, das den extrahierten Ereignisschlüsseln (z. B. to, from oder subject) aus der angehängten E‑Mail-Datei hinzugefügt wird, die im überwachten Postfach empfangen wurde. Der Standardwert ist attach.
Create a Separate Google Secops Alert per Attached Mail File	Optional Wenn diese Option ausgewählt ist, erstellt der Connector mehrere Benachrichtigungen, und zwar eine für jede angehängte E‑Mail-Datei. Dieses Verhalten ist nützlich, wenn Sie E‑Mails mit mehreren angehängten E‑Mail-Dateien verarbeiten und die Google SecOps-Ereigniszuordnung so festlegen, dass Entitäten aus angehängten E‑Mail-Dateien erstellt werden. Standardmäßig nicht ausgewählt.
Attach Original EML	Optional Wenn diese Option ausgewählt ist, hängt der Connector die ursprüngliche E-Mail als EML-Datei an die Fallinformationen an. Standardmäßig nicht ausgewählt.
Headers to add to events	Optional Ein kommagetrennter String mit E‑Mail-Headern, die Google SecOps-Ereignissen hinzugefügt werden sollen, z. B. DKIM-Siganture, Received oder From. Sie können eine genaue Übereinstimmung für Header konfigurieren oder diesen Parameterwert als regulären Ausdruck festlegen. Der Connector filtert die konfigurierten Werte aus der Liste internetMessageHeaders und fügt sie dem Google SecOps-Ereignis hinzu. Wenn Sie verhindern möchten, dass der Connector dem Ereignis Header hinzufügt, legen Sie den Parameterwert so fest: None. Standardmäßig fügt der Connector alle verfügbaren Header hinzu.
Case Name Template	Optional Ein benutzerdefinierter Fallname. Wenn Sie diesen Parameter konfigurieren, fügt der Connector dem Google SecOps SOAR-Ereignis einen neuen Schlüssel namens custom_case_name hinzu. Sie können Platzhalter im folgenden Format angeben: [name of the field]. Beispiel: Phishing - [event_mailbox]. Für Platzhalter verwendet der Connector das erste Google SecOps SOAR-Ereignis. Der Connector verarbeitet nur Schlüssel, die den Stringwert enthalten.
Alert Name Template	Optional Ein benutzerdefinierter Name für die Benachrichtigung. Sie können Platzhalter im folgenden Format angeben: [name of the field]. Beispiel: Phishing - [event_mailbox]. Für Platzhalter verwendet der Connector das erste Google SecOps SOAR-Ereignis. Der Connector verarbeitet nur Schlüssel, die den Stringwert enthalten. Wenn Sie keinen Wert oder eine ungültige Vorlage angeben, verwendet der Connector den Standardnamen für Benachrichtigungen.
Proxy Server Address	Optional Die Adresse des zu verwendenden Proxyservers.
Proxy Username	Optional Der Proxy-Nutzername für die Authentifizierung.
Proxy Password	Optional Das Proxy-Passwort für die Authentifizierung.
Mail Field Source	Optional Wenn diese Option ausgewählt ist, ruft die Integration die Postfachadresse aus dem Nutzerdetailattribut mail ab. Wenn diese Option nicht ausgewählt ist, ruft die Integration die Postfachadresse aus dem Feld userPrincipalName ab. Standardmäßig aktiviert.
Extract URLs from HTML Email Part	Optional Wenn diese Option ausgewählt ist, extrahiert der Connector URLs aus dem HTML-Text der E‑Mail. So kann der Connector komplexe URLs extrahieren, aber keine URLs aus dem Nur-Text-Teil der E-Mail. Extrahierte URLs sind im Ereignisfeld urls_from_html_part verfügbar. Standardmäßig aktiviert.
Event Fields to Exclude	Optional Eine durch Kommas getrennte Liste von Ereignisfeldern, die von der Ereigniserstellung ausgeschlossen werden sollen (z. B. field1, field2).
Exclude Attachments	Optional Wenn diese Option ausgewählt ist, werden E-Mail-Anhänge vom Connector nicht aufgenommen oder zu Rechtsangelegenheiten hinzugefügt.
Bypass S/MIME Signature Verification	Optional Wenn diese Option ausgewählt ist, werden S/MIME-signierte E-Mails vom Connector aufgenommen, ohne dass ein Base64-codiertes CA-Zertifikat für die Signaturprüfung erforderlich ist. Der Inhalt der Nachricht, die Header und die Anhänge werden direkt extrahiert.
Base64 Encoded Private Key	Optional Der Base64-codierte private Schlüssel, der zum Entschlüsseln eingehender S/MIME-verschlüsselter E‑Mails verwendet wird. Wenn angegeben, müssen Sie auch Base64 Encoded Certificate angeben.
Base64 Encoded Certificate	Optional Das Base64-codierte Zertifikat, das zum Entschlüsseln eingehender S/MIME-verschlüsselter E‑Mails verwendet wird. Wenn angegeben, müssen Sie auch Base64 Encoded Private Key angeben.
Base64 Encoded CA certificate	Optional Das Base64-codierte vertrauenswürdige CA-Zertifikat zur Überprüfung der digitalen Signaturen eingehender S/MIME-E-Mails. Wenn kein CA-Zertifikat angegeben ist, schlägt die Signaturprüfung für eingehende signierte E‑Mails fehl, es sei denn, Bypass S/MIME Signature Verification ist aktiviert.

Connector-Regeln

Der Connector unterstützt Proxys.

Jobs

So konfigurieren Sie Jobs in Google SecOps:

1. Wählen Sie im linken Navigationsbereich Antwort > Jobplaner aus.
2. Klicken Sie auf dem Tab Jobs auf add Neuen Job erstellen.
3. Wählen Sie den gewünschten Job aus der Liste aus und klicken Sie auf Speichern.
4. Fahren Sie mit der Jobkonfiguration fort.

Job zur Erneuerung des Aktualisierungstokens

Verwenden Sie den Aktualisierungsjob für Aktualisierungstokens, um das Aktualisierungstoken für die Integration regelmäßig zu aktualisieren.

Standardmäßig läuft das Aktualisierungstoken alle 90 Tage ab. Wir empfehlen, diesen Job so zu konfigurieren, dass er alle 7 oder 14 Tage automatisch ausgeführt wird, damit das Aktualisierungstoken auf dem neuesten Stand bleibt.

Job-Eingaben

Für den Job zur Erneuerung des Aktualisierungstokens sind die folgenden Parameter erforderlich:

Parameter	Beschreibung
Integration Environments	Optional Die Integrationsumgebungen, für die Aktualisierungstokens aktualisiert werden sollen. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String. Setzen Sie zum Konfigurieren dieses Parameters jeden Umgebungsnamen in doppelte Anführungszeichen (""), z. B. "Default environment", "Environment 1" oder "Environment 5".
Connector Names	Optional Die Connector-Namen, für die Aktualisierungstokens aktualisiert werden sollen. Dieser Parameter akzeptiert mehrere Werte als kommagetrennten String. Wenn Sie diesen Parameter konfigurieren möchten, setzen Sie jeden Connector-Namen in doppelte Anführungszeichen (""), z. B. "Microsoft Graph Mail Delegated Connector", "Connector 2" oder "Connector 5".

Benötigen Sie weitere Hilfe? Antworten von Community-Mitgliedern und Google SecOps-Experten erhalten