IRIS Initial setup - Versionsgeschichte

Ddang am 10. Mai 2023 um 13:03 Uhr

2023-05-10T13:03:20Z

Ddang am 10. Mai 2023 um 12:12 Uhr

2023-05-10T12:12:57Z

Ddang am 10. Mai 2023 um 12:06 Uhr

2023-05-10T12:06:14Z

Ddang am 3. Mai 2023 um 13:08 Uhr

2023-05-03T13:08:26Z

Ddang am 3. Mai 2023 um 13:07 Uhr

2023-05-03T13:07:32Z

Ddang am 3. Mai 2023 um 13:07 Uhr

2023-05-03T13:07:05Z

Ddang am 3. Mai 2023 um 12:58 Uhr

2023-05-03T12:58:58Z

Ddang am 3. Mai 2023 um 12:18 Uhr

2023-05-03T12:18:49Z

Ddang am 3. Mai 2023 um 12:03 Uhr

2023-05-03T12:03:49Z

Ddang am 26. April 2023 um 13:30 Uhr

2023-04-26T13:30:40Z

@@ Zeile 108: / Zeile 108: @@
 ==== Authorization URL ====
-This is the URL that IRIS should open at the first authorization via browser.
+This is the URL which IRIS should open at the first authorization via browser.
-Bei einer unter Azure angelegten App, die nur von Ihrer Organisation verwendbar ist, verwenden Sie diese URL:
+For an app applied under Azure which is only accessible from your organization, use this URL:
 <nowiki>https://login.microsoftonline.com/organizations/oauth2/v2.0/authorize</nowiki>
 ==== Token URL ====
-Das ist die URL, die IRIS zum Anfordern eines Tokens aufrufen soll.
+This is the URL which IRIS should call to request a token.
-Bei einer unter Azure angelegten App, die nur von Ihrer Organisation verwendbar ist, verwenden Sie diese URL:
+For an app applied under Azure which is only accessible from your organization, use this URL:
 <nowiki>https://login.microsoftonline.com/organizations/oauth2/v2.0/token</nowiki>
 ==== Refresh Token URL ====
-Das ist die URL, die IRIS zum Anfordern eines Refresh-Tokens aufrufen soll.
+This is the URL which IRIS should call to request a refresh token.
-Bei einer unter Azure angelegten App, die nur von Ihrer Organisation verwendbar ist, verwenden Sie diese URL:
+For an app applied under Azure which is only accessible from your organization, use this URL:
 <nowiki>https://login.microsoftonline.com/organizations/oauth2/v2.0/token</nowiki>
 ==== Scope ====
-Den Scope, den IRIS bei einer Token-Anfrage anfordern soll.
+The scope which IRIS should request for a token request.
-Bei einer unter Azure angelegten App verwenden Sie diesen Scope:
+For an app applied under Azure, use this scope
 offline_access <nowiki>https://outlook.office.com/SMTP.Send</nowiki>
-==== Erstellte Anwendung autorisieren ====
+==== Authorize created application ====
-Sobald Sie den Client erstellt haben, klicken Sie bitte in dem neu erstellten Client auf den Button "Authorize".
+As soon as you created the client, please click the button "Authorize" in the newly created client.
-Danach öffnet sich ein Browser-Fenster, wo Sie sich auf der Seite des E-Mail Betreibers (z.B. Microsoft) einloggen können und den Zugriff Ihrer Anwendung bestätigen können.
+A browser window opens afterwards, where you can login to the site of the email provider (e.g. Microsoft) and confirm the access of your application.
-Achtung: Bitte seien Sie sich bewusst, unter welchem Account Sie die Freigabe auf der Seite des E-Mail Betreibers durchführen.
+Note: Please be aware on which account you perform the authorization on the site of the email provider.
-Sollten Sie für E-Mails einen anderen als Ihrem eigenen Account (auf Seite des E-Mail Betreibers) verwenden möchten, müssen Sie sich zuerst auf der Seite des Betreibers ausloggen oder ggf. die Authorisierung über ein privates Browser-Fenster öffnen.
+If you want to use another account for emails rather than your own (on the site of the email provider), you have to log off the site of the provider first or open the authorization with a private browser window.

@@ Zeile 105: / Zeile 105: @@
 ==== Client Secret ====
-Das Client Secret erhalten Sie nach der Registrierung des OAuth2 Clients bei Ihrem E-Mail Provider.
+You receive the Client Secret after the registration of the OAuth2 client at your email provider.
 ==== Authorization URL ====
-Das ist die URL, die IRIS bei der ersten Autorisierung per Browser öffnen soll.
+This is the URL that IRIS should open at the first authorization via browser.
 Bei einer unter Azure angelegten App, die nur von Ihrer Organisation verwendbar ist, verwenden Sie diese URL:

@@ Zeile 60: / Zeile 60: @@
 ==== SMTP authentication type ====
-IRIS supports the login via password or OAuth2 as well.
+IRIS supports the login via Password or OAuth2 as well.
-The password authentication is easier to setup, but you have to make sure that the password does not expire.
+The Password authentication is easier to setup, but you have to make sure that the password does not expire.
-Choose between password and OAuth2.
+Choose between Password and OAuth2.
 The OAuth2 authentication is explained further down.
 ==== SMTP password ====
-(Only for password authentication)
+(Only for Password authentication)
-The password which IRIS should use to login to the SMTP server.
+The Password which IRIS should use to login to the SMTP server.
 ==== Test E-Mail ====
@@ Zeile 82: / Zeile 82: @@
-=== SMTP mit OAuth2 ===
+=== SMTP with OAuth2 ===
-Falls Sie als SMTP-Authentifizierung Password gewählt haben, können Sie dieses Kapitel überspringen.
+If you have chosen the Password as the SMTP authentication, you can skip this chapter.
-Um OAuth2 als SMTP-Authentifizierung zu nutzen, wählen Sie bei SMTP authentication type OAuth2 aus.
+To use OAuth2 as the SMTP authentication, choose OAuth2 as the SMTP authentication type.
-Bitte tragen Sie die restlichen Einstellungen unter System configuration bis auf das Token ein und speichern diese Einstellungen.
+Please enter the remaining settings under System configuration except for the token and save these settings.
-Danach gehen Sie in IRIS bitte in den Menüpunkt "OAuth2 Clients".
+After that, go to the menu option "OAuth2 Clients" in IRIS.
 ==== OAuth2 clients ====
-Im Standard gibt es noch keine angelegten OAuth2 Clients.
+By default, there are no OAuth2 Clients setup yet.
-Nachdem Sie in der Systemkonfiguration eine Base URL gespeichert haben, erhalten Sie in diesem Menü 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).
+After you have saved a base URL in the system configuration, you will receive a Redirect URI in this menu, which you can use for the registration of the OAuth2 client at your email provider (at Microsoft 365 you have to make an app-registration under portal.azure.com, where you have to enter this Redirect URI).
-Klicken Sie auf den Button "New app", um einen neuen OAuth2 client zu erstellen.
+Click on the button "New app" to create a new OAuth2 client.
 ==== Name ====
-Den Namen, den Sie hier eingeben, dient nur als Referenz für Sie.
+The name you enter here only serves as a reference for you.
 ==== Client ID ====
-Die Client ID erhalten Sie nach der Registrierung des OAuth2 Clients bei Ihrem E-Mail Provider.
+You receive the Client ID after the registration of the OAuth2 client at your email provider.
 ==== Client Secret ====

← Nächstältere Version		Version vom 3. Mai 2023, 13:08 Uhr
Zeile 79:		Zeile 79:

	The tests are running with the current listed (and unsaved) settings in the browser.		The tests are running with the current listed (and unsaved) settings in the browser.
		+
		+

	=== SMTP mit OAuth2 ===		=== SMTP mit OAuth2 ===

← Nächstältere Version		Version vom 3. Mai 2023, 13:07 Uhr
Zeile 79:		Zeile 79:

	The tests are running with the current listed (and unsaved) settings in the browser.		The tests are running with the current listed (and unsaved) settings in the browser.
−
−
−

	=== SMTP mit OAuth2 ===		=== SMTP mit OAuth2 ===

@@ Zeile 40: / Zeile 40: @@
 ==== Base URL ====
-URL that leads to IRIS. It is equivalent to the (Sub-)Domain without path specification and without trailing slash, e.g. <nowiki>https://iris.firmenname.de</nowiki>
+The URL that leads to IRIS. It is equivalent to the (Sub-)Domain without path specification and without trailing slash, e.g. <nowiki>https://iris.firmenname.de</nowiki>
 === SMTP Settings ===
 ==== SMTP host ====
-Der Servername von Ihrem SMTP Server, bei Microsoft 365 ist das z.B. smtp.office365.com
+The server name of your SMTP server, e.g. smtp.office356.com for Microsoft 356
 ==== SMTP port ====
-Der Port, auf dem Ihr SMTP Server hört, bei Microsoft 356 ist das z.B. 587
+The port uesd by your SMTP server, e.g. 587 for Microsoft 356
 ==== TLS ====
-Aktivieren Sie das Häkchen, wenn die Verbindung mit dem SMTP Server per TLS verschlüsselt werden soll, andernfalls nicht
+Place the checkmark only if the connection with the SMTP server should be encoded via TLS.
 ==== SMTP sender e-mail address ====
-Die Absender E-Mail Adresse von dem IRIS aus Mails verschicken soll.
+The sender e-mail address which IRIS should use for sending mails.
 ==== SMTP username ====
-Der Benutzername, mit dem man sich beim SMTP Server anmeldet. Manchmal identisch mit der Absender E-Mail.
+The username used to login to the SMTP server. Sometimes identical with the sender e-mail.
 ==== SMTP authentication type ====
-IRIS unterstützt die Anmeldung per Password oder auch OAuth2.
+IRIS supports the login via password or OAuth2 as well.
-Die Password-Authentifizierung ist einfacher einzurichten, Sie müssen allerdings auch sicherstellen, dass das Passwort nicht abläuft.
+The password authentification is easier to setup, but you have to make sure that the password does not expire.
-Wählen Sie Password oder OAuth2 aus.
+Choose between password and OAuth2.
-Die OAuth2-Authentifizierung wird weiter unten beschrieben.
+The OAuth2 authentification is explained further down.
 ==== SMTP password ====
-(Nur bei Authentifizierungs-Typ Password)
+(Only for password authentification)
-Das Password, mit dem sich IRIS beim SMTP Server anmelden soll.
+The password which IRIS should use to login to the SMTP server.
 ==== Test E-Mail ====

@@ Zeile 5: / Zeile 5: @@
 This configuration is necessary for further functionality of IRIS.
-== Web-Interface öffnen ==
+== Open Web-Interface ==
-Die Konfiguration kann nach dem ersten Start von IRIS über das Web-Interface erreicht werden.
+The configuration can be accessed over the Web-Interface after the first launch of IRIS.
-Loggen Sie sich hierzu über einen Admin-Account in IRIRS ein.
+For that, you need to log in to IRIS with an admin-account.
-Sie finden dann links einen Menüpunkt namens "System settings".
+On the left, you will find a menu option called "System Settings".
-Beim ersten Start wird Ihnen ein Benutzer "root@localhost" automatisch erstellt.
+Note for the admin-account:
-Das Passwort finden Sie im Log und sieht ungefähr so aus:
+At the first launch, a user "root@localhost" will automatically be generated for you.
 -02-08 17:22:38.926 -08 WARN  [main] (init.ServiceInitializer:166) - A new user has been created.:
   Username: root@localhost
@@ Zeile 24: / Zeile 25: @@
-Ein Passwort muss mindestens 12 Zeichen lang sein und mindestens 3 der folgenden Kriterien entsprechen:
+We strongly recommend to change the password immediately, here you can go to user on the top right after the login, and then click "Change Password".
-* Enthält Großbuchstaben A-Z
+* contains uppercase letters A-Z
-* Enthält Kleinbuchstaben a-z
+* contains lowercase letters a-z
-* Enthält Nummern 0-9
+* contains numbers 0-9
-* Enthält Sonderzeichen !%$§~ä#...
+* contains special characters !%$§~ä#...
 == Konfiguration ==