E-Mail an KanBo senden – Installation (On-Premise)

Inhaltsverzeichnis

This post is also available in: English

Mit der Funktion „E-Mails an KanBo senden“ können Sie E-Mails direkt an ein KanBo Board senden und aus der E-Mail eine neue Karte erstellen.
Es ermöglicht Ihnen auch, E-Mails und deren Anhänge zu einer vorhandenen KanBo hinzuzufügen.

Voraussetzungen

  • Für die Funktionalität ist es erforderlich, dass auf Ihrer Exchange ein Dienstkonto vorhanden ist, das als Catch-All-Konto dienen kann.
    Dieser Benutzer
    muss über eine Exchange-Lizenz verfügen.
  • Sie müssen ein E-Mail-Konto für eingehende E-Mails mit einer benutzerdefinierten Domain einrichten.
    Erstellen eines Kontos mit dieser Domain
    in seiner E-Mail-Adresse (Beispiel: mails@yourdomain.com).
    Sie können eine Subdomain oder eine vollqualifizierte Domain verwenden.


1. Erstellen einer Catch-All-E-Mail-Adresse.

Sie müssen ein Catch-All-E-Mail-Konto auf dem Exchange-Server erstellen.

  • Lesen Sie hier, wie Sie eine Catch-All-E-Mail-Adresse erstellen.
  • Lesen Sie hier mehr über Catch-All-Adressen und wie Sie sie in Exchange erstellen.
  • Erstellen Sie ein neues Konto für den Catch-All-Zweck. Stellen Sie sicher, dass dieses Konto über die Exchange-Lizenz und das Postfach verfügt.
  • Fügen Sie die benutzerdefinierte Domäne zu akzeptierten Domänen hinzu.

2. Erstellen eines SSL-Zertifikats.

Dies ist eine empfohlene Methode für das IIS-Szenario. Führen Sie diese Schritte auf Ihrer virtuellen Maschine aus.

  1. Gehen Sie zum IIS und doppelklicken Sie auf Serverzertifikate.

  1. Klicken Sie nun auf Selbstsigniertes Zertifikat erstellen.

  1. Geben Sie einen Anzeigenamen für ein Zertifikat an, und wählen Sie Persönlich aus. Klicken Sie auf OK.

  1. Wählen Sie das Zertifikat aus, und wählen Sie Exportieren aus.

  1. Wählen Sie den Pfad und den Namen für das Zertifikat aus, und fügen Sie ein neues Kennwort hinzu.


3. Ändern der KanBo

  1. Wechseln Sie zu dem SpeicherortKanBo, an dem Ihr KanBo-Back-End gehostet wird (das KanBo). Öffnen Sie die appsettings.json in einem beliebigen Texteditor.

  1. Fügen Sie dem Abschnitt "plugins" den folgenden Code hinzu, und ändern Sie den Pfad zum Zertifikat.
{
    "type": "auth.app",
    "issuer": "incoming-mails",
    "children": [
     {
      "type": "signature",
      "algo": "rs256",
      "children": [
       [
        "cert",
        {
         "type": "x509-file",
         "file": "C:\\Certs\\mails\\somecert.cer"
        }
       ]
      ]
     },
     [
      "mapper",
      {
       "type": "service",
       "name": "incoming emails",
       "roles": "service"
      }
     ],
     [
      "mapper",
      {
       "type": "user"
      }
     ],
     [
      "mapper",
      {
       "type": "email",
       "roles": "service"
      }
     ],
     [
      "mapper",
      {
       "type": "login"
      }
     ]
    ]
   },
  1. Legen Sie den KanBoIncomingMail-Wert auf true fest.
  2. "IncomingMail": true,
    

  3. Legen Sie KanBoIncomingMailDomain auf den Namen Ihrer sendenden Domäne fest, d. h. auf den Namen, für den Sie das Catch-All-Postfach haben.
  4. "IncomingMailDomain": "YourDomain",
    

  5. Speichern Sie die appsettings.json

Wenn Sie beabsichtigen, E-Mails an Ihre Catch-All-Adresse und einige andere E-Mail-Adressen (mehrere gleichzeitig) zu senden, fügen Sie diesen Eintrag hinzu und passen Sie die Anzahl daran an, dass sie der maximalen Anzahl von Empfängern entspricht.

<add key="kanbo.max-receivers" value="1" />


4. Konfigurieren Sie das E-Mail-Tool

  1. Kontaktieren Sie uns unter support@kanboapp.com, um ein KanBo zu erhalten. JobHost.zip Paket, wenn Sie es nicht haben.
  2. Nachdem Sie das Paket heruntergeladen haben, entpacken Sie es und verschieben Sie es an einen ausgewählten Speicherort. In unserem Fall wäre es: C:\Email Tool\EmailToKanBo\EmailToKanBo.
  3. Öffnen Sie Ihr Verzeichnis und beginnen Sie mit der Bearbeitung appsettings.json

  1. Im folgenden Abschnitt ändern Sie bitte die folgenden Werte:
    • YourCatchAllEmail@domain.com - fügen Sie hier Ihre Catch-All-E-Mail hinzu
    • Passwort - fügen Sie hier die E-Mail-Adresse des Catch-All-Kontos hinzu
    • mail.url - Serveradresse Ihrer Exchange-Instanz
<add key="mail.type" value="ews-unread" />
<add key="mail.receiver-email" value="YourCatchAllEmail@domain.com"/>
<add key="mail.receiver-password" value="Password"/>
<!-- will autodiscover if empty -->
<add key="mail.url" value="https://some-host-address"/>


  1. Passen Sie im nächsten Abschnitt die folgenden Werte an:
  • CertPath - lokaler Pfad zu Ihrem Zertifikat,
  • Passwort - Ihr Zertifikatspasswort,
  • https://YourKanboAddress - fügen Sie hier Ihre KanBo hinzu
  • YourDomain - fügen Sie hier Ihre E-Mail-Domain ein, mit der die Catch-All-Adresse verbunden ist

<add key="kanbo.api.cert.file" value="CerthPath\CertName.pfx"/>
<add key="kanbo.api.cert.pass" value="Password"/>
<add key="kanbo.api.url" value="https://YourKanBoAddress"/>
<add key="kanbo.incoming-mail-domain" value="YourDomain"/>
  1. Speichern Sie die Änderungen.



5. Fügen Sie dem Taskplaner eine Aufgabe hinzu.

Hier ist ein einfaches Beispiel, wie Sie E-Mail zu KanBo Task zum Windows Task Scheduler hinzufügen.

Das vollständige Handbuch für geplante Windows finden Sie auf der Microsoft-Website: Link

  1. Führen Sie den Taskplaner aus. Fügen Sie Daten in den folgenden Werten ein:
  • Name
  • Wählen Sie den Benutzer mit den entsprechenden Berechtigungen zum Ausführen der Aufgabe aus.
  • Wählen Sie Ausführen aus, unabhängig davon, ob der Benutzer angemeldet ist oder nicht
  • Es wird auch empfohlen, Mit höchsten Rechten ausführen auszuwählen.

  1. Wählen Sie die Registerkarte Auslöser aus, und erstellen Sie einen neuen Auslöser. Führen Sie die folgenden Schritte aus:
  • Beginnen Sie die Aufgabe - nach einem Zeitplan
  • Einstellungen: Täglich
  • Erweiterte Einstellungen: Wiederholen Sie die Aufgabe alle 5 Minuten für eine Dauer von unbegrenzt (Sie können natürlich einen anderen Zeitraum wählen, der Ihren Bedürfnissen entspricht)
  • Wählen Sie Aktiviert aus

  1. Wählen Sie die Registerkarte "Aktionen" aus und fügen Sie eine neue Aktion hinzu, die auf die EmailToKanBo.Webjob.exe Datei in dem Ordner verweist, in dem Sie das Tool "E-Mail an KanBo " entpackt haben.
    • Aktion: Starten Sie ein Programm,
    • Programm/Skript - lokaler Pfad zu EmailToKanBo.Webjob.exe Datei (Beispiel:  C:\Email Tool\EmailToKanBo\EmailToKanBo\EmailToKanBo.Webjob.exe)
    • Starten in (optional) - fügen Sie einen lokalen Pfad zu dem Ordner hinzu, in dem  sich EmailToKanBo.Webjob.exe befindet (Beispiel:  C:\Email Tool\EmailToKanBo\EmailToKanBo\)

  2. Nachdem diese Aktion abgeschlossen ist, wählen Sie OK aus, und bestätigen Sie Ihre Administratoranmeldeinformationen.



6. Verwenden Sie es

Sie haben die Konfiguration und Installation der Funktion "Eingehende E-Mails" abgeschlossen. Lesen Sie nun, wie Sie diese Funktion nutzen können, indem Sie einen Artikel hier lesen: Eingehende E-Mails.

Empfehlung: Legen Sie eine Outlook-Aufbewahrungsrichtlinie fest, um alte Nachrichten zu entfernen.

War dieser Beitrag hilfreich?

Bitte kontaktieren Sie uns, wenn Sie weitere Fragen haben.