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 bash
um 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 account
Konfigurator ausführen:
java -jar account.jar CONFIGURE_ALL
Windows
Ö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_ALL
Konfiguration
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.
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.