Hauptmenü öffnen

IRIS Ersteinrichtung

Version vom 9. Februar 2023, 17:34 Uhr von Sbaumbach (Diskussion | Beiträge) (Die Seite wurde neu angelegt: „KoBei der Ersteinrichtung von IRIS legen Sie die Basis-URL fest und konfigurieren einen SMTP-Account. == Konfigurator öffnen == === Docker === Unter Docker…“)
(Unterschied) ← Nächstältere Version | Aktuelle Version (Unterschied) | Nächstjüngere Version → (Unterschied)

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.