Aktion „Verbinden“ im E-Mail-Paket

Verwenden Sie die Verbinden-Aktion, um eine Verbindung mit einem E-Mail-Server herzustellen. Dies ist die erste Aktion, die Sie zum Automatisieren einer E‑Mail-bezogenen Aufgabe verwenden müssen.

Vorbereitungen

Sie können OAuth 2.0 verwenden, um sich beim E-Mail-Server für die E-Mail-Automatisierung zu authentifizieren. Führen Sie je nach E-Mail-Dienstanbieter die entsprechenden Schritte aus:
  • Outlook/Office 365
    • Wenn Sie den Authentifizierungsmodus Client-Anmeldedatenablauf verwenden, führen Sie die folgenden Schritte aus:
      1. Melden Sie sich beim Microsoft Azure portal an.
      2. Registrieren Sie eine Anwendung bei der Microsoft Identity-Plattform, um die Client-ID und Mandanten-ID zu erhalten. Einzelheiten finden Sie unter Register an application.
      3. Fügen Sie einen geheimen Clientschlüssel hinzu.

        Einzelheiten finden Sie unter Add a client secret.

      4. Je nachdem, mit welchem Mailserver Sie sich verbinden, führen Sie die entsprechenden Schritte aus:
    • Wenn Sie den Authentifizierungsmodus Autorisierungscode mit PKCE verwenden, führen Sie die folgenden Schritte aus:
      1. Melden Sie sich beim Microsoft Azure portal an.
      2. Registrieren Sie eine Anwendung bei der Microsoft Identity-Plattform, um die Client-ID und Mandanten-ID zu erhalten. Einzelheiten finden Sie unter Register an application.
      3. Legen Sie bei der Registrierung der Anwendung das Attribut „URI umleiten“ auf http://localhost:9999/callback fest.
      4. Fügen Sie Berechtigungen mit dem für IMAP, POP3 und SMTP delegierten Typ hinzu und erteilen Sie der Anwendung die erforderliche Berechtigung für Microsoft Graph.
    • Wenn Sie den Authentifizierungsmodus Control Room-verwaltet verwenden, siehe Configure Control Room managed OAuth for Outlook/Office365 (A-people login required).

    Die Videos in der folgenden Wiedergabeliste bieten Informationen zur Konfiguration und Verwendung der OAuth2.0-Authentifizierung in der E-Mail „Verbinden“- Aktion:

    Anmerkung: Wenn die Mailbox innerhalb einer Schleife Aktionverwendet wird, müssen Sie den Nutzer registrieren, der die Automatisierung durchführen soll. Weitere Informationen finden Sie unter Manage users and groups assignment to an application.
  • Gmail
    • Wenn Sie den Authentifizierungsmodus Autorisierungscode mit PKCE verwenden, führen Sie die folgenden Schritte aus:
      1. Konfigurieren Sie die OAuth2.0-Einstellungen in der Google Cloud-Plattform (GCP) und rufen Sie die erforderlichen Anmeldedaten ab, um Automation 360 mit Ihren Google Workspace-Anwendungen zu verbinden.
      2. Denken Sie daran, ein Projekt zu erstellen.

        Siehe Projekt erstellen.

      3. Generieren Sie die Client-ID und den geheimen Clientschlüssel.
        Siehe OAuth 2.0 einrichten.
        Anmerkung:
        • Wählen Sie die Option Webanwendung .
        • Fügen Sie diese autorisierte Umleitungs-URI hinzu: http://localhost:8888/Callback.
      4. Führen Sie die folgenden Schritte aus, um die Nutzereinwilligung für den Nutzernamen einzurichten, den Sie für die Verbindung mit Automation 360 verwenden werden.
    • Wenn Sie den Authentifizierungsmodus Control Room-verwaltet verwenden, führen Sie die folgenden Schritte aus:
      Wichtig: Das E-Mail Paket- unterstützt derzeit nur die Control Room-verwaltete OAuth-Option für die OAuth-Verbindungen auf der Grundlage des Autorisierungscode-Ablaufs.
      1. Konfigurieren Sie die OAuth2.0-Einstellungen in der Google Cloud-Plattform (GCP) und rufen Sie die erforderlichen Anmeldedaten ab, um Automation 360 mit Ihren Google Workspace-Anwendungen zu verbinden.
      2. Denken Sie daran, ein Projekt zu erstellen.

        Siehe Projekt erstellen.

      3. Generieren Sie die Client-ID und den geheimen Clientschlüssel.
        Siehe OAuth 2.0 einrichten.
        Anmerkung:
        • Wählen Sie die Option Webanwendung .
        • Führen Sie die folgenden Schritte aus, um den autorisierten Umleitungs-URI hinzuzufügen:
          1. Melden Sie sich im Control Room als Administrator oder als Nutzer mit den Berechtigungen „Verbindungen verwalten“ und „Verbindungen anzeigen“ an und navigieren Sie zu Managen > OAuth-Verbindungen.
          2. Klicken Sie auf die Registerkarte Verbindung erstellen und wählen Sie im Feld Providertyp die Option Benutzerdefiniert aus.
          3. Kopieren Sie die Callback-URL und navigieren Sie zurück zu der Seite „Client-Anwendung“ in der Google Cloud-Konsole.
          4. Klicken Sie unter Autorisierte Umleitungs-URIs auf die Schaltfläche + URI HINZUFÜGEN und fügen Sie den URI in das Feld URIs ein.
          5. Klicken Sie auf Erstellen.

          Wie Sie eine OAuth-Verbindung im Control Room erstellen, erfahren Sie unter Herstellung der OAuth-Verbindung.

      4. Führen Sie die folgenden Schritte aus, um die Nutzereinwilligung für den Nutzernamen einzurichten, den Sie für die Verbindung mit Automation 360 verwenden werden.
Anmerkung:
  • Der Client-Anmeldedatenablauf unterstützt Gmail nicht.
  • Die Authentifizierungsmodi „Client-Anmeldedaten“ und „Autorisierungscode mit PKCE“ unterstützen die Mailserver von Yahoo und MSN nicht.
Empfohlen: Wenn Sie beide Authentifizierungsmodi (Client-Anmeldedaten und Autorisierungscode mit PKCE) verwenden möchten, müssen Sie sich in zwei separaten Anwendungen registrieren.
Anmerkung: Wenn Sie eine Verbindung zu einem Exchange Web Services-Server herstellen, muss die Multi-Faktor-Authentifizierung (MFA) deaktiviert werden, auch in allen Sicherheitsrichtlinien auf Unternehmensebene, in denen die MFA aktiviert sein könnte. Wenn MFA nicht vollständig deaktiviert ist, kann es zu Verbindungs- oder Autorisierungsfehlern kommen. Wenn Sie dennoch die MFA verwenden möchten, lesen Sie die Informationen in diesem Artikel (beachten Sie, dass eine erfolgreiche Verbindung nicht garantiert werden kann):

Multi-factor authentication for Azure EWS (A-people login required)

Mit dieser Aktion können Sie die Anmeldedaten und Details des E-Mail-Servers angeben und diese Daten mit einem Sitzungsnamen verknüpfen. Verwenden Sie denselben Sitzungsnamen auch für die anderen E-Mail Aktionen-, sodass Sie die Serverinformationen nur einmal angeben müssen.

Prozedur

Führen Sie die folgenden Schritte aus, um eine Verbindung mit einem E-Mail-Server herzustellen:

Anmerkung: Wenn Sie eine Automatisierung auf der macOS-Plattform erstellen und eine Verbindung mit einem E-Mail-Server herstellen, wird Outlook auf macOS nicht unterstützt. Sie können das Microsoft Outlook (macOS)-Paket verwenden, um E-Mail-bezogene Aufgaben in der Microsoft Outlook-Clientanwendung zu automatisieren.

Microsoft Outlook (macOS) Paket

  1. Doppelklicken Sie in der Palette Aktionen auf die Verbinden-Aktion oder ziehen Sie sie aus dem E-Mail -Paket.
  2. Geben Sie einen Sitzungsnamen ein.
    Dieser Sitzungsname dient als eindeutiger Bezeichner für diese spezielle E-Mail-Verbindung.
  3. Verwenden Sie das Feld Verbinden mit, um einen der folgenden Tabs auszuwählen und eine Verbindung mit Microsoft Outlook oder einem Mailserver herzustellen.
    • Outlook

      Sie müssen keine weiteren Details angeben. Sie können die Option Variable verwenden, um die E-Mail-Adresse anzugeben, mit der Sie sich verbinden möchten.

      Anmerkung: Sie können keine Verbindung zum neuen Outlook-Client herstellen. Sie können jedoch zum klassischen Outlook-Client wechseln, um eine E-Mail-bezogene Aufgabe zu automatisieren.
    • E-Mail-Server
      Anmerkung: Informationen zu Host und Port für die verschiedenen Mailserver finden Sie unter E-Mail-Servereinstellungen.
      Aktualisieren Sie die folgenden Felder:
      • Sichere Verbindung (SSL/TLS) verwenden: Wählen Sie diese Option aus, wenn Sie eine sichere Verbindung mit dem Mailserver herstellen möchten.
      • Host: Geben Sie den Namen des Mailservers ein.
        Anmerkung: Bei diesem Feld wird nicht zwischen Groß- und Kleinschreibung unterschieden.
      • Port: Geben Sie die Portnummer für den Server an.
      • Protokoll: Wählen Sie entweder das IMAP- oder das POP3-Protokoll.
        Anmerkung: Regex wird für das IMAP-Protokoll unterstützt und liest E-Mails aus allen Unterordnern im Posteingang.
      • Authentifizierungsmodus: Wählen Sie aus den folgenden Authentifizierungsmodi:
        • Basic: Verwendet Nutzername und Passwort.
        • Oauth2 – Autorisierungscode mit PKCE: Einzelheiten finden Sie unter Microsoft identity platform and OAuth 2.0 authorization code flow.

          Weitere Informationen zum Einrichten einer Anwendung in Azure zur Verwendung von OAuth Authorization Code mit PKCE-Ablauf für Mailserver finden Sie unter How to setup App in Azure and Exchange Online to use OAuth 2.0 Client Credentials Flow for IMAP/POP3 Mail Server (A-People login required).

        • OAuth2 – Client-Anmeldedaten: Einzelheiten finden Sie unter Microsoft identity platform and the OAuth 2.0 client credentials flow.

          Weitere Informationen zum Einrichten einer Anwendung in Azure zur Verwendung des OAuth2.0-Client-Anmeldedatenablaufs für IMAP/POP3-Mailserver finden Sie unter How to setup App in Azure and Exchange Online to use OAuth 2.0 Client Credentials Flow for IMAP/POP3 Mail Server (A-People login required).

        • Control Room verwaltet:
          Um den vom Control Room verwalteten OAuth2-Authentifizierungsmodus zur Automatisierung von Gmail zu verwenden, müssen Sie die OAuth-Verbindung im Control Room konfigurieren. Einzelheiten finden Sie unter Herstellung der OAuth-Verbindung.
          Anmerkung: Control Room OAuth Managed unterstützt nur Gmail und nicht den Outlook-Client.

          Aktualisieren Sie die Informationen in den folgenden Feldern:

          • Verbindung: Klicken Sie auf die Schaltfläche Wählen..., um einen Verbindungstyp auszuwählen.
          • Wählen Sie im Feld Anbieter-Typ die Option Benutzerdefiniert.

          • Wählen Sie den Verbindungsnamen, den Sie im Control Room für Google Workspace-Apps eingerichtet haben.

          • Wählen Sie im Feld Tokentyp eine der folgenden Optionen aus:

            Informationen zu den Zugriffs- und Aktualisierungstokens der Google Workspace-Anwendung finden Sie unter Konfiguration von Unternehmensanwendungen.

            • Freigegeben: Wählen Sie diese Option, wenn das OAuth2-Zugangstoken von allen Nutzern, die die Automatisierung ausführen, gemeinsam genutzt wird.
              Anmerkung: Diese Option erfordert, dass der Control Room-Administrator oder ein beliebiger Nutzer (mit aktivierten Optionen „Verbindungen verwalten“ und „Verbindungen anzeigen“ für die OAUTH-VERBINDUNGEN) eine OAuth-Verbindung im Control Room einrichtet. Speichern Sie die Anmeldedaten einmalig, um ein gemeinsames Zugriffstoken zu generieren, das von allen Nutzern, die die Automatisierung ausführen, verwendet werden kann.
            • Benutzerspezifisch: Wählen Sie diese Option, wenn das OAuth2-Zugriffstoken für jeden Nutzer, der die Automatisierung ausführt, spezifisch ist.
              Anmerkung: Diese Option erfordert, dass der Control Room-Administrator oder ein beliebiger Nutzer (mit aktivierten Optionen „Verbindungen verwalten“ und „Verbindungen anzeigen“ für die OAUTH-VERBINDUNGEN) eine OAuth-Verbindung im Control Room einrichtet. Achten Sie darauf, die Anmeldedaten nicht zu speichern, damit jeder Nutzer, der die Automatisierung ausführt, seine Anmeldedaten angeben und ein Zugriffstoken generieren kann, das nur von diesem einen Nutzer verwendet werden kann.
            • Klicken Sie auf Bestätigen.
          Anmerkung: Wenn Sie die Option Benutzerspezifisch verwenden, müssen Sie sich bei Ihrem Google-Konto anmelden, um sich zu authentifizieren und ein benutzerspezifisches Token zu generieren. Führen Sie die folgenden Schritte aus, um diese Option zu nutzen:
          1. Navigieren Sie im Control Room zu Ihrem Profil Meine Einstellungen > OAuth-Verbindungen.
          2. Klicken Sie auf Anmelden, um sich zu authentifizieren.
          3. Melden Sie sich bei Ihrem Google-Konto an und wählen Sie Weiter.
          4. Überprüfen Sie die Dienste, auf die Sie Zugriff haben, und klicken Sie auf Weiter.

            Wenn die Verbindung erfolgreich ist, wird der Status Aktiv angezeigt.

        Je nach dem von Ihnen gewählten Authentifizierungsmodus müssen Sie die Details in den folgenden Feldern angeben, sofern zutreffend.
        • Nutzername: Geben Sie den Nutzernamen ein, den Sie für den Zugriff auf den Mailserver verwenden möchten.

          Beispiel: john.smith@myCompanyName.com

        • Passwort: Geben Sie das Passwort für den angegebenen Nutzernamen ein.
        • Geben Sie in die Felder Client-ID, Mandanten-ID, URI umleiten und Geheimer Clientschlüssel die Informationen ein, die in Ihrem Azure portal für Ihr Konto bereitgestellt wurden.
        • E-Mail-Anbieter: Wählen Sie in der Dropdown-Liste Ihren E-Mail-Dienstanbieter aus.
          • Outlook/Office365

            Wenn Sie diese Option wählen, geben Sie die Mandanten-ID an.

          • Gmail
        Für die Felder Nutzername, Passwort, Mandanten-ID, Client-ID und Geheimer Clientschlüssel wählen Sie auf der Registerkarte Anmeldedaten, Variable oder Unsichere Zeichenfolge Folgendes aus:
        • Anmeldedaten: Verwenden Sie einen im Credential Vault verfügbaren Wert.
        • Variable: Verwenden Sie eine benutzerdefinierte Variable, die die Werte speichert.
        • Unsichere Zeichenfolge: Geben Sie manuell einen Wert ein.
    • EWS-Server
      Aktualisieren Sie die folgenden Felder:
      • Exchange-Version: Wählen Sie die Version, die Ihr Unternehmen verwendet:
        • Exchange Server 2013
        • Exchange2010_SP2
        • Exchange2010_SP1
        • Exchange2010
        • Exchange2007_SP1
      • Azure Cloud: Wählen Sie das Produkt, das Ihr Unternehmen verwendet:
        • Azure Global: Für Anwender der kommerziellen Version von Microsoft 365 (login.microsoftonline.com)
        • Azure US GCC High: Für Anwender der Microsoft 365 Government Version (login.microsoftonline.us)
      • Optional: Domänenname:
        • Wenn Sie Microsoft 365-Kunde sind und dieses Feld leer lassen, verwendet Automation Workspace die Adresse smtp.office365.com für die Verbindung zum Server.
        • Wenn Sie Microsoft 365-Kunde sind und einen Domänennamen in das Feld Nutzername eingegeben haben, müssen Sie smtp.office365.com in dieses Feld eingeben.
        • Wenn Sie kein Microsoft 365-Kunde sind, geben Sie den Domänennamen Ihres Unternehmens ein. Andernfalls verwendet Automation Workspace den Domänennamen, den Sie im Feld Nutzername angegeben haben.
      • Authentifizierungsmodus: Wählen Sie aus den folgenden Authentifizierungsmodi:
        Anmerkung: Ab Automation 360v.27 wird der Authentifizierungstyp Authentifizierungsmodus OAuth2-Silent in OAuth2-ROPC und der Authentifizierungsmodus OAuth2-Interactive in OAuth2-Implicit umbenannt.

        Wenn Sie Probleme mit der Verbindung zu einem freigegebenen Postfach über EWS haben, lesen Sie bitte Unable to connect to shared mailbox using EWS error (A-People login required).

        Je nach dem von Ihnen gewählten Authentifizierungsmodus müssen Sie die Details in den folgenden Feldern angeben, sofern zutreffend.
        • Nutzername: Geben Sie den Nutzernamen ein, den Sie für den Zugriff auf den Mailserver verwenden möchten.

          Beispiel: john.smith@myCompanyName.com

        • Passwort: Geben Sie das Passwort für den angegebenen Nutzernamen ein.
        • Geben Sie in die Felder Client-ID, Mandanten-ID, URI umleiten und Geheimer Clientschlüssel die Informationen ein, die in Ihrem Azure portal für Ihr Konto bereitgestellt wurden.
        • Verbindung testen: Klicken auf Verbindung testen, um sich bei Ihrem Konto anzumelden, die zur Authentifizierung angeforderten Berechtigungen zu akzeptieren und eine Verbindung mit dem Server herzustellen.
          Anmerkung:
          • Wenn Sie einen Desktop-Vorgang durchführen und auf Verbindung testen klicken, werden Variablen wie Anmeldedaten, Anmeldedatenvariable oder Zeichenfolgenvariablen derzeit nicht unterstützt.
          • Wenn Sie eine Desktop-Operation durchführen und auf Verbindung testen klicken, um sich bei Ihrem Konto anzumelden, fügen Sie diese Umleitungs-URI hinzu: https://outlook.office365.com
        Für die Felder Nutzername, Passwort, Mandanten-ID, Client-ID und Geheimer Clientschlüssel wählen Sie auf der Registerkarte Anmeldedaten, Variable oder Unsichere Zeichenfolge Folgendes aus:
        • Anmeldedaten: Verwenden Sie einen im Credential Vault verfügbaren Wert.
        • Variable: Verwenden Sie eine benutzerdefinierte Variable, die die Werte speichert.
        • Unsichere Zeichenfolge: Geben Sie manuell einen Wert ein.
      • Timeout-Dauer der Verbindung (Sekunden) (Optional): Geben Sie in diesem Feld die Zeit an, die zum Herstellen einer Verbindung zum EWS-Server benötigt wird. Sie können den Timeout-Wert zwischen 10 Sekunden und 60 Sekunden einstellen. Standardmäßig ist das Feld Verbindungs-Timeout-Dauer (Sekunden) (Optional) auf 10 Sekunden eingestellt.
    Anmerkung:
    • Wenn Sie eine Verbindung mit dem EWS-Server herstellen und die Schleife-Aktion verwenden, um alle E-Mails vom E-Mail-Server abzurufen, und wenn der E-Mail-Betreff die folgenden Zeichen enthält, kann der Bot nicht ausgeführt werden und eine Fehlermeldung wird angezeigt.
      • Steuerungszeichen
        • Bereich: 0x00 - 0x08 (except 0x09 - Horizontal Tab) and 0x0B - 0x0C (except 0x0A - Line Feed and 0x0D - Carriage Return)
        • Hexadezimalwerte: 0x00-0x08, 0x0B-0x0C, 0x0E-0x1F
      • Paare mit hohem Surrogatwert und Paare mit niedrigem Surrogatwert
        • Bereich: 0xD800 - 0xDFFF
        • Hexadezimalwerte: 0xD800 - 0xDFFF
      • Nicht-Zeichen-Codepunkte
        • Bereich: 0xFDD0 - 0xFDEF, 0xFFFE - 0xFFFF
        • Hexadezimalwerte: 0xFDD0 - 0xFDEF, 0xFFFE - 0xFFFF
      • Eingeschränkte Bereiche
        • Bereich: 0x1FFFE - 0x1FFFF, 0x2FFFE - 0x2FFFF, 0x3FFFE - 0x3FFFF, 0x4FFFE - 0x4FFFF, 0x5FFFE - 0x5FFFF, 0x6FFFE - 0x6FFFF, 0x7FFFE - 0x7FFFF, 0x8FFFE - 0x8FFFF, 0x9FFFE - 0x9FFFF, 0xAFFFE - 0xAFFFF, 0xBFFFE - 0xBFFFF, 0xCFFFE - 0xCFFFF, 0xDFFFE - 0xDFFFF, 0xEFFFE - 0xEFFFF, 0xFFFFE - 0xFFFFF, 0x10FFFE - 0x10FFFF
        • Hexadezimalwerte: 0x1FFFE - 0x1FFFF, 0x2FFFE - 0x2FFFF, 0x3FFFE - 0x3FFFF, 0x4FFFE - 0x4FFFF, 0x5FFFE - 0x5FFFF, 0x6FFFE - 0x6FFFF, 0x7FFFE - 0x7FFFF, 0x8FFFE - 0x8FFFF, 0x9FFFE - 0x9FFFF, 0xAFFFE - 0xAFFFF, 0xBFFFE - 0xBFFFF, 0xCFFFE - 0xCFFFF, 0xDFFFE - 0xDFFFF, 0xEFFFE - 0xEFFFF, 0xFFFFE - 0xFFFFF, 0x10FFFE - 0x10FFFF

          Problemumgehung: Sie können Microsoft Outlook oder einen E-Mail-Server verwenden, um diesen Vorgang durchzuführen. Wir empfehlen jedoch, dass Sie das Microsoft 365 Outlook Paket- verwenden, da Microsoft die Einstellung von EWS-APIs angekündigt hat, mit deren Hilfe die Verbindung mit Exchange Online hergestellt wird. Einzelheiten finden Sie unter Einstellung der EWS-APIs in Exchange Online.

    • Wenn Sie eine Verbindung mit Microsoft Outlook herstellen, werden E-Mail-Nachrichten aus dem freigegebenen Postfach verarbeitet. Vergewissern Sie sich, dass Sie das freigegebene Postfach in Ihrer Outlook-Anwendung eingerichtet haben.
      • Diese Funktion wird nur für Outlook unterstützt.
      • Sie können nur ein Postfach aus der Liste der Postfächer in dem freigegebenen Postfach auswählen.
      • Die Besprechungseinladung wird in Outlook nicht gelesen, da der Bot keine Kalendereinladungen als E-Mail-Objekte auswählt. Diese Funktion wird derzeit nicht unterstützt.
  4. Klicken Sie auf Speichern.