IRIS Ersteinrichtung
KoBei der Ersteinrichtung von IRIS legen Sie die Basis-URL fest und konfigurieren einen SMTP-Account.
Konfigurator öffnen
Docker
Unter Docker verwenden Sie den Befehl:
docker exec -i -t iris bashum auf dem Docker-Container direkt zu arbeiten.
Alle Einstellungen bleiben fest bestehen, sind also nur für die Ersteinrichtung notwendig.
Wechseln in das Verzeichnis account:
cd accountKonfigurator ausführen:
java -jar account.jar CONFIGURE_ALLWindows
Öffnen Sie eine CMD oder PowerShell und wechseln in das Verzeichnis [iris]\account
dann führen Sie folgenden Befehl aus:
.\jre\bin\java.exe -jar account.jar CONFIGURE_ALLKonfiguration
Base Settings
Base URL
Die URL, von dem IRIS erreichbar sein wird. Entspricht der (Sub-)Domain ohne Pfadangabe und ohne abschließendem Slash, z.B. https://iris.firmenname.de
SMTP Settings
SMTP host
Der Servername von Ihrem SMTP Server, bei Microsoft 365 ist das z.B. smtp.office365.com
SMTP port
Der Port, auf dem Ihr SMTP Server hört, bei Microsoft 356 ist das z.B. 587
TLS
Geben Sie true ein, wenn die Verbindung mit dem SMTP Server verschlüsselt werden soll, andernfalls false
SMTP sender email
Die Absender E-Mail Adresse von dem IRIS aus Mails verschicken soll.
SMTP username
Der Benutzername, mit dem man sich beim SMTP Server anmeldet. Manchmal identisch mit der Absender E-Mail.
SMTP authentication type
IRIS unterstützt die Anmeldung per Password oder auch OAuth2.
Die Password-Authentifizierung ist einfacher einzurichten, Sie müssen allerdings auch sicherstellen, dass das Passwort nicht abläuft.
Geben Sie password oder oauth2 je nach Wahl ein.
Die OAuth2-Authentifizierung wird weiter unten beschrieben.
SMTP password
(Nur bei Authentifizierungs-Typ password)
Das Password, mit dem sich IRIS beim SMTP Server anmelden soll.
Hinweis: Bei der Passwort-Eingabe wird das Passwort nicht angezeigt, auch keine **** als Ersatz.
Send test email
Geben Sie y ein, um eine Test-Email zu versenden (empfohlen)
Receiver
Geben Sie die E-Mail Adresse vom Empfänger der Test-Email ein
SMTP mit OAuth2
Wählen Sie beim SMTP authentication type oauth2 aus.
Tipp: Sie können die reine Konfiguration von OAuth2 Clients auch über die Startoption OAUTH2 statt CONFIGURE_ALL ausführen.
Somit müssen Sie nicht jedes mal die grundsätzlichen SMTP Parameter eingeben, sollte die Konfiguration nicht klappen.
Configured OAuth2 clients
Im Standard gibt es noch keine angelegten OAuth2 Clients.
Wählen Sie c um einen neuen Client zu erstellen.
Sie erhalten sofort eine Redirect URI, die Sie bei der Registrierung des OAuth2 Clients bei Ihrem E-Mail Provider verwenden können (bei Microsoft 365 müssen Sie unter portal.azure.com eine neue App-Registrierung vornehmen, wo Sie diese Redirect URI eintragen müssen).
Name
Den Namen, den Sie hier eingeben, dient nur als Referenz für Sie.
Client ID
Die Client ID erhalten Sie nach der Registrierung des OAuth2 Clients bei Ihrem E-Mail Provider.
Client Secret
Das Client Secret erhalten Sie nach der Registrierung des OAuth2 Clients bei Ihrem E-Mail Provider.
Authorization URL
Das ist die URL, die IRIS bei der ersten Autorisierung per Browser öffnen soll.
Bei einer unter Azure angelegten App, die nur von Ihrer Organisation verwendbar ist, verwenden Sie diese URL:
https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize
Token URL
Das ist die URL, die IRIS zum Anfordern eines Tokens aufrufen soll.
Bei einer unter Azure angelegten App, die nur von Ihrer Organisation verwendbar ist, verwenden Sie diese URL:
https://login.microsoftonline.com/organizations/oauth2/v2.0/token
Refresh Token URL
Das ist die URL, die IRIS zum Anfordern eines Refresh-Tokens aufrufen soll.
Bei einer unter Azure angelegten App, die nur von Ihrer Organisation verwendbar ist, verwenden Sie diese URL:
https://login.microsoftonline.com/organizations/oauth2/v2.0/token
Scope
Den Scope, den IRIS bei einer Token-Anfrage anfordern soll.
Bei einer unter Azure angelegten App verwenden Sie diesen Scope:
offline_access https://outlook.office.com/SMTP.Send
Erstellte Anwendung autorisieren
Wählen Sie die neu erstellte Anwendung über die Zahleneingabe aus und sagen Sie bei "Run initial authorization" y.
Es wird ein Link erstellt, den Sie im Browser aufrufen müssen.
Nach Bestätigung der Autorisierungsanfrage sollte ein Token an IRIS gesendet worden sein.
Sie werden hierbei im Log eine Meldung sehen mit "Valid token received".
Danach können Sie genauso wie bei der Passwort-Authentifizierung eine Test-E-Mail verschicken.