ArcFlowMailApp - Versionsgeschichte

Jens: Stand 4.1.09 Authentifizierung über OAuth2 ergänzt

2024-09-06T08:02:06Z

Stand 4.1.09 Authentifizierung über OAuth2 ergänzt

← Nächstältere Version		Version vom 6. September 2024, 08:02 Uhr
Zeile 91:		Zeile 91:
	</li>		</li>
	</ul>		</ul>

			Ist der Mail-Server nicht im gleichen Netzwerk installiert (zum Beispiel bei Microsoft Office365), ist eine Authentifizierung über OAuth2 erforderlich. Innerhalb der ArcFlowMailApp werden die "Application (client) ID" und die "Directory (tenant) ID" benötigt. Um diese zu ermitteln sind umfangreiche Einstellungen bei Office 365 erforderlich. Wir stellen dazu eine [https://arcflow.net/sites/default/kcfinder/files/downloads/arcflow/OAuth_mit_POP3%20_f%C3%BCr_Office_365.pdf Beschreibung] zur Verfügung. Die Informationen für die Anmeldung mit OAuth2 werden in dem Unterverzeichnis "M365_TokenCache" gespeichert.

	<p>Bestehende Konten können mit der Schaltfläche [[file:DE_BtnAccountDelete.gif]] wieder entfernt werden.</p></p>		<p>Bestehende Konten können mit der Schaltfläche [[file:DE_BtnAccountDelete.gif]] wieder entfernt werden.</p></p>

Jens: Stand 4.1.08 Screenshots aktualisiert

2024-04-02T13:24:00Z

Stand 4.1.08 Screenshots aktualisiert

← Nächstältere Version		Version vom 2. April 2024, 13:24 Uhr
Zeile 1:		Zeile 1:
	~~{{Outdated}}~~
	<languages />		<languages />
	<translate>		<translate>

Jens: Stand 4.1.08 Änderungen an den "Account data"

2024-04-02T07:41:36Z

Stand 4.1.08 Änderungen an den "Account data"

← Nächstältere Version		Version vom 2. April 2024, 07:41 Uhr
Zeile 21:		Zeile 21:
	</p><p>		</p><p>

	<p>Zur Installation der ArcFlowMailApp wird eine separaten ~~Installtionsroutine~~ benötigt. Diese befindet sich im Verzeichnis "Client\App\Install\ArcFlowMailApp". Nach dem Starten von "Setup_ArcFlowMailApp.exe" wird das Installationsverzeichnis und ob eine Verknüpfung auf dem Desktop angelegt werden soll abgefragt. Anschließend erfolgt die Installation. Das Einrichten und Starten des Dienstes erfolgt über die ~~installieten~~ Dateien.</p>		<p>Zur Installation der ArcFlowMailApp wird eine separaten Installationsroutine benötigt. Diese befindet sich im Verzeichnis "Client\App\Install\ArcFlowMailApp". Nach dem Starten von "Setup_ArcFlowMailApp.exe" wird das Installationsverzeichnis und ob eine Verknüpfung auf dem Desktop angelegt werden soll abgefragt. Anschließend erfolgt die Installation. Das Einrichten und Starten des Dienstes erfolgt über die installierten Dateien.</p>

	<b>Konfiguration</b>{{Marker}}		<b>Konfiguration</b>{{Marker}}
Zeile 47:		Zeile 47:
	<p>[[file:DE_ArcFlowMailAppSettings.jpg]]</p>		<p>[[file:DE_ArcFlowMailAppSettings.jpg]]</p>

	<p>Im Bereich "Common" wird das externe Verzeichnis eingetragen, in dem die E-Mails gespeichert werden sollen. Innerhalb des Verzeichnisses wird für jedes abgefragte Mail-Konto ein weiteres Unterverzeichnis angelegt. Der Name des ~~Vezeichnisses~~ setzt sich aus dem Namen des Mail-Servers und dem abgefragten Konto zusammen. Bei den hier gezeigten Einstellungen wird das Verzeichnis "127.0.0.1~archiv@~~local~~.~~lan~~" angelegt.~~</p>~~		<p>Im Bereich "Common" wird das externe Verzeichnis eingetragen, in dem die E-Mails gespeichert werden sollen. Innerhalb des Verzeichnisses wird für jedes abgefragte Mail-Konto ein weiteres Unterverzeichnis angelegt. Der Name des Verzeichnisses setzt sich aus dem Namen des Mail-Servers und dem abgefragten Konto zusammen. Bei den hier gezeigten Einstellungen wird das Verzeichnis "127.0.0.1~archiv@arcflow.net" angelegt. Die E-Mails werden im Format EML gespeichert.</p>

	~~<p>~~Die E-Mails ~~können~~ im Format EML ~~und/oder als XML-Dateien~~ gespeichert ~~werden. Die Einstellung des Datei-Types erfolgt in "Storage mode"~~.</p>

	<p>{{Info\|Damit die E-Mail in ArcFlow archiviert werden, muss ein entsprechendes Transferverzeichnis eingerichtet werden (siehe [[Importfunktionen - Transferverzeichnisse#\|Importfunktionen / Transferverzeichnisse]]).}}</p>		<p>{{Info\|Damit die E-Mail in ArcFlow archiviert werden, muss ein entsprechendes Transferverzeichnis eingerichtet werden (siehe [[Importfunktionen - Transferverzeichnisse#\|Importfunktionen / Transferverzeichnisse]]).}}</p>
Zeile 63:		Zeile 61:

	<li><b>Type</b>		<li><b>Type</b>
	<p>Zur Zeit werden ~~zwei~~ Methoden zur Abfrage der E-Mails unterstützt: POP3 ~~oder~~ POP3 über SSL. Der Typ der Abfrage wird hier ausgewählt. Nach der Auswahl wird der entsprechende Standard-Port eingetragen. Wird vom E-Mail-Server ein abweichender Port verwendet, muss dieser in das Feld "Port" eingetragen werden.</p>		<p>Zur Zeit werden drei Methoden zur Abfrage der E-Mails unterstützt: "POP3", "POP3 über SSL" oder "POP3 OAuth2". Der Typ der Abfrage wird hier ausgewählt. Nach der Auswahl wird der entsprechende Standard-Port eingetragen. Wird vom E-Mail-Server ein abweichender Port verwendet, muss dieser in das Feld "Port" eingetragen werden. Bei der Methode "POP3 OAuth2" müssen weitere Informationen auf der Seite "OAuth2" angegeben werden.</p>
	</li></p>		</li></p>

			<li><b>TLS12 erzwingen</b>
			<p>Mit dieser Einstellung kann eine mit TLS 1.2 gesicherte Verbindung zum E-Mail-Server erzwungen werden. Stellt der E-Mail-Server keine solche Verbindung bereit, können keine E-Mails abgerufen werden.</p>
			</li>

			<li><b>Connect-Timeout</b>
			<p>Die ArcFlowMailApp kommuniziert mit dem E-Mail-Server. In diesem Feld wird der Timeout für diese Kommunikation angegeben. Antwortet der E-Mail-Server nicht innerhalb der hier angegebenen Millisekunden, wird die Kommunikation abgebrochen. Standardmäßig wird 30 Sekunden auf eine Antwort gewartet, ist das System stark ausgelastet, kann dieses Timeout entsprechend erhöht werden.</p>
			</li>

			<li><b>Read-Timeout</b>
			<p>Wurde eine Verbindung mit dem E-Mail-Server aufgenommen, werden bis zu 50 Mails vom Server abgeholt. Kommt es dabei zu einer Verzögerung von mehr als den hier angegebenen Millisekunden, wird die Verbindung abgebrochen.</p>
			</li>

	<p><li><b>User / Password</b>		<p><li><b>User / Password</b>
Zeile 70:		Zeile 80:
	</li>		</li>

	<li><b>~~Verify~~</b>		<li><b>Pop3 Session delay</b>
	<p>~~Die Einstellungen können über~~ die ~~Schaltfläche [Verify]~~ überprüft ~~werden~~. ~~Die ArcFlowMailApp führt eine Anmeldung mit den angegebenen Daten durch und gibt das Ergebnis zurück. Es~~ werden ~~dabei eine~~ E-Mails abgeholt~~, sondern nur die Anmeldung überprüft~~.</p>		<p>In diesem Feld wird das Intervall eingetragen, in dem die MailApp überprüft, ob neue E-Mails eingegangen sind. Sind E-Mails vorhanden, werden diese in Paketen zu maximal 50 E-Mails abgeholt. Es kann ein Intervall von 0 bis 60000 ms angegeben werden.</p>
	</li>		</li>

	<li><b>~~Delay~~</b>		<li><b>Error delay</b>
	<p>~~Die ArcFlowMailApp kommuniziert mit dem~~ E-Mail-Server~~. In dem Feld "Delay"~~ wird ~~der Timeout für diese Kommunikation angegeben. Antwortet der E-Mail-Server nicht innerhalb der~~ hier ~~angegebenen Millisekunden, wird die Kommunikation abgebrochen. Standardmäßig wird 1 Sekunde auf~~ eine ~~Antwort gewartet, ist das System stark ausgelastet, kann dieses Timeout entsprechend erhöht werden~~.</p>		<p>Kommt es beim Herstellen einer Verbindung zum E-Mail-Server zu einem Fehler, wird nach den hier eingetragenen Minuten eine erneute Verbindung versucht.</p>
	</li>		</li>

	<li><b>~~Receive-Interval~~</b>		<li><b>Verify</b>
	<p>~~In diesem Feld wird das Intervall eingetragen, in dem~~ die ~~MailApp~~ überprüft~~, ob neue E-Mails eingegangen sind~~. ~~Sind E-Mails vorhanden,~~ werden ~~diese in Paketen zu maximal 50~~ E-Mails abgeholt.</p>		<p>Die Einstellungen können über die Schaltfläche [Verify] überprüft werden. Die ArcFlowMailApp führt eine Anmeldung mit den angegebenen Daten durch und gibt das Ergebnis zurück. Es werden dabei keine E-Mails abgeholt, sondern nur die Anmeldung überprüft.</p>
	</li>		</li>
	</ul>		</ul>

Robin1 am 23. November 2023 um 09:58 Uhr

2023-11-23T09:58:18Z

← Nächstältere Version		Version vom 23. November 2023, 09:58 Uhr
Zeile 1:		Zeile 1:
			{{Outdated}}
	<languages />		<languages />
	<translate>		<translate>

AfWikiBot: Die Seite wurde neu angelegt: „

2020-08-19T14:47:00Z

Die Seite wurde neu angelegt: „<languages /> <translate>  <table class=BigTable bgcolor="#242A34"> <tr> <td class="BigTitle" colspan="2" align…“

Neue Seite
<languages />
<translate>

<table class=BigTable bgcolor="#242A34">
<tr>
<td class="BigTitle" colspan="2" align="center">[[file:DE_Schriftzug.gif]]</td>
</tr>
<tr>
<td class="BigTitle"> ArcFlowMailApp</td>
<td class="BigTitle" align=right>[[file:DE_Admin.gif|alt=Nur für Administratoren]]</td>
</tr>
<tr>
<td class="BigKurz" colspan="2">Dienst zur Überwachung von Postfächern</td>
</tr>
</table>
<div class="BigLang">
Mit diesem Dienst können Postfächer eines Mail-Servers überwacht und eingehende E-Mails in einem externen Verzeichnis gespeichert werden. Mails, die erfolgreich abgeholt wurden, werden aus dem Konto gelöscht. Das Verzeichnis kann vom ArcFlow-Jobserver überwacht werden, der alle dort abgelegten Dateien (E-Mails) nach ArcFlow importiert.

Installation{{Marker}}


Zur Installation der ArcFlowMailApp wird eine separaten Installtionsroutine benötigt. Diese befindet sich im Verzeichnis "Client\App\Install\ArcFlowMailApp". Nach dem Starten von "Setup_ArcFlowMailApp.exe" wird das Installationsverzeichnis und ob eine Verknüpfung auf dem Desktop angelegt werden soll abgefragt. Anschließend erfolgt die Installation. Das Einrichten und Starten des Dienstes erfolgt über die installieten Dateien.

Konfiguration{{Marker}}


Nach der Installation von ArcFlow befinden sich alle notwendigen Dateien in dem Installationsverzeichnis. Es wird nur die Datei "ArcFlowMailApp.exe" benötigt. Alle Einstellungen werden in der Datei "ArcFlowMailApp.config.xml" gespeichert. Nach dem Start des Dienstes wird eine Protokolldatei "ArcFlowMailApp.log" angelegt.

Zur Konfiguration und Einrichtung des Dienstes muss das Programm gestartet werden.

[[file:DE_ArcFlowMailApp.jpg]]

<ul>
<li>[[#Settings|Settings]]</li>
<li>[[#ManageService|Manage Service]]</li>
<li>[[#LiveLogging|Live Logging]]</li>
</ul>

Das Programm kann durch Drücken der Schaltfläche [Close] beendet werden.

Settings{{Marker}}


Durch Drücken der Schaltfläche [Settings] werden die Einstellungen der MailApp aufgerufen.

[[file:DE_ArcFlowMailAppSettings.jpg]]

Im Bereich "Common" wird das externe Verzeichnis eingetragen, in dem die E-Mails gespeichert werden sollen. Innerhalb des Verzeichnisses wird für jedes abgefragte Mail-Konto ein weiteres Unterverzeichnis angelegt. Der Name des Vezeichnisses setzt sich aus dem Namen des Mail-Servers und dem abgefragten Konto zusammen. Bei den hier gezeigten Einstellungen wird das Verzeichnis "127.0.0.1~archiv@local.lan" angelegt.

Die E-Mails können im Format EML und/oder als XML-Dateien gespeichert werden. Die Einstellung des Datei-Types erfolgt in "Storage mode".

{{Info|Damit die E-Mail in ArcFlow archiviert werden, muss ein entsprechendes Transferverzeichnis eingerichtet werden (siehe [[Importfunktionen - Transferverzeichnisse#|Importfunktionen / Transferverzeichnisse]]).}}

Die Konten, die abgefragt werden sollen, werden im Bereich "Accounts" angegeben. In einer Liste werden alle bereits eingetragenen Konten mit dem Mail-Server uns der E-Mail-Adresse angezeigt. Über die Schaltflächen [[file:DE_BtnAccountAdd.gif]] und [[file:DE_BtnAccountEdit.gif]] können neue Konten eingetragen bzw. vorhandene Konten geändert werden. Dazu wird folgender Dialog aufgerufen:

[[file:DE_ArcFlowMailAppSettingsAccountData.jpg]]

<ul>
<li>Server
In diesem Eingabefeld wird der E-Mail-Server eingetragen. Es kann entweder der Name oder die IP-Adresse des Servers eingetragen werden.
</li>

<li>Type
Zur Zeit werden zwei Methoden zur Abfrage der E-Mails unterstützt: POP3 oder POP3 über SSL. Der Typ der Abfrage wird hier ausgewählt. Nach der Auswahl wird der entsprechende Standard-Port eingetragen. Wird vom E-Mail-Server ein abweichender Port verwendet, muss dieser in das Feld "Port" eingetragen werden.
</li>

<li>User / Password
In diesen Feldern werden die Anmelde-Daten für den E-Mail-Server eingetragen. Ist eine Authentifizierung beim Server erforderlich, muss ein Kennwort angegeben werden. Abhängig vom E-Mail-Server wird als Benutzer der Kontoname oder die komplette E-Mail-Adresse angegeben.
</li>

<li>Verify
Die Einstellungen können über die Schaltfläche [Verify] überprüft werden. Die ArcFlowMailApp führt eine Anmeldung mit den angegebenen Daten durch und gibt das Ergebnis zurück. Es werden dabei eine E-Mails abgeholt, sondern nur die Anmeldung überprüft.
</li>

<li>Delay
Die ArcFlowMailApp kommuniziert mit dem E-Mail-Server. In dem Feld "Delay" wird der Timeout für diese Kommunikation angegeben. Antwortet der E-Mail-Server nicht innerhalb der hier angegebenen Millisekunden, wird die Kommunikation abgebrochen. Standardmäßig wird 1 Sekunde auf eine Antwort gewartet, ist das System stark ausgelastet, kann dieses Timeout entsprechend erhöht werden.
</li>

<li>Receive-Interval
In diesem Feld wird das Intervall eingetragen, in dem die MailApp überprüft, ob neue E-Mails eingegangen sind. Sind E-Mails vorhanden, werden diese in Paketen zu maximal 50 E-Mails abgeholt.
</li>
</ul>

Bestehende Konten können mit der Schaltfläche [[file:DE_BtnAccountDelete.gif]] wieder entfernt werden.

Manage Service{{Marker}}


Über die Schaltfläche [Manage Service] wird die MailApp als Windows-Dienst eingerichtet, gestartet und angehalten.

{{Info|Für das Einrichten des Dienstes müssen Informationen in die Registrierungsdatenbank von Windows geschrieben werden. Dazu werden Administrationsrechte auf dem System benötigt.}}

[[file:DE_ArcFlowMailAppManageService.jpg]]

Änderungen an den Installationsparametern können nur erfolgen, wenn der Dienst nicht installiert ist. Sollen zu einem späteren Zeitpunkt Änderungen vorgenommen werden, muss der Dienst zunächst gestoppt und entfernt werden.

<ul>
<li>Starttype
Hier wird die Startart des Dienstes angegeben. Es kann zwischen folgenden Einstellungen gewählt werden:
<table class=lang>
<tr>
<td valign=top>Automatisch</td>
<td valign=top>Der Dienst wird beim Starten des Systems mit gestartet.</td>
</tr>
<tr>
<td valign=top>Manuell</td>
<td valign=top>Der Dienst muss über die Dienste-Verwaltung des Systems oder über diese Applikation von einem Benutzer gestartet werden.</td>
</tr>
<tr>
<td valign=top>Deaktiviert</td>
<td valign=top>Der Dienst kann nicht gestartet werden.</td>
</tr>
</table>
</li>

<li>Logon as
Der Dienst wird in einem Benutzerkontext ausgeführt. In dieser Einstellung wird der Benutzerkontext gewählt. Es können die vordefinierten Systemkonten oder ein Benutzerkonto verwendet werden. Bei der Verwendung eines Benutzerkontos muss der Benutzer und das Kennwort in "Account" und "Password" angegeben werden.
</li>

<li>Allow interaction with Desktop
Ist diese Einstellung aktiviert, kann der Dienst mit einem Benutzer interagieren, vorausgesetzt, ein Benutzer ist auf dem System angemeldet. Der Dienst ist zur Zeit nicht darauf ausgelegt, mit einem Benutzer zu interagieren.
</li>
</ul>

Nach dem ersten Starten der Applikation ist der Dienst noch nicht installiert. Die Installation erfolgt durch das Drücken der Schaltfläche [Install]. Damit wird der Dienst auch gleich gestartet. Im laufenden Betrieb kann der Dienst über die Schaltfläche [Stop] angehalten und über [Start] wieder gestartet werden. Mit der Schaltfläche [Remove] kann der Dienst wieder entfernt werden.

Die Schaltfläche [Remove] löscht keine Dateien, es wird lediglich der Dienst aus der Registrierungsdatenbank von Windows entfernt.

Live Logging{{Marker}}


Mit dieser Schaltfläche wird das Programm beendet und alle neuen Protokolleinträge angezeigt. Das Programm kann erneut gestartet werden.

[[file:DE_ArcFlowMailAppLiveLogging.jpg]]

Alle Meldungen des Dienstes können in der Protokolldatei "ArcFlowMailApp.log" eingesehen werden. Mit dem "Live Logging" kann im laufenden Betrieb die Funktion des Dienstes überwacht werden, ohne wiederholt die Protokolldatei öffnen zu müssen.

</div>
</translate>