IRIS Initial setup: Unterschied zwischen den Versionen
Ddang (Diskussion | Beiträge) |
Ddang (Diskussion | Beiträge) |
||
Zeile 60: | Zeile 60: | ||
==== SMTP authentication type ==== | ==== SMTP authentication type ==== | ||
− | IRIS supports the login via | + | IRIS supports the login via Password or OAuth2 as well. |
− | The | + | The Password authentication is easier to setup, but you have to make sure that the password does not expire. |
− | Choose between | + | Choose between Password and OAuth2. |
The OAuth2 authentication is explained further down. | The OAuth2 authentication is explained further down. | ||
==== SMTP password ==== | ==== SMTP password ==== | ||
− | (Only for | + | (Only for Password authentication) |
− | The | + | The Password which IRIS should use to login to the SMTP server. |
==== Test E-Mail ==== | ==== Test E-Mail ==== | ||
Zeile 82: | Zeile 82: | ||
− | === SMTP | + | === SMTP with OAuth2 === |
− | + | If you have chosen the Password as the SMTP authentication, you can skip this chapter. | |
− | + | To use OAuth2 as the SMTP authentication, choose OAuth2 as the SMTP authentication type. | |
− | + | Please enter the remaining settings under System configuration except for the token and save these settings. | |
− | + | After that, go to the menu option "OAuth2 Clients" in IRIS. | |
==== OAuth2 clients ==== | ==== OAuth2 clients ==== | ||
− | + | By default, there are no OAuth2 Clients setup yet. | |
− | + | 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). | |
− | + | Click on the button "New app" to create a new OAuth2 client. | |
==== Name ==== | ==== Name ==== | ||
− | + | The name you enter here only serves as a reference for you. | |
==== Client ID ==== | ==== Client ID ==== | ||
− | + | You receive the Client ID after the registration of the OAuth2 client at your email provider. | |
==== Client Secret ==== | ==== Client Secret ==== |
Version vom 10. Mai 2023, 14:06 Uhr
At the initial setup for IRIS, you determine the base url and configure a SMTP-Account.
This configuration is necessary for further functionality of IRIS.
Open Web-Interface
The configuration can be accessed over the Web-Interface after the first launch of IRIS.
For that, you need to log in to IRIS with an admin-account.
On the left, you will find a menu option called "System Settings".
Note for the admin-account:
At the first launch, a user "root@localhost" will automatically be generated for you.
You can find the password in the log, which looks like following:
2023-02-08 17:22:38.926 -08 WARN [main] (init.ServiceInitializer:166) - A new user has been created.: Username: root@localhost Password: P6oV-GK3GYsdnn_5usDg1tBmn00 Please login with this user and change your password immediately!
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".
A password must contain at least 12 characters and fulfill at least 3 of the following conditions:
- contains uppercase letters A-Z
- contains lowercase letters a-z
- contains numbers 0-9
- contains special characters !%$§~ä#...
Konfiguration
General Settings
Base URL
The URL that leads to IRIS. It is equivalent to the (Sub-)Domain without path specification and without trailing slash, e.g. https://iris.firmenname.de
SMTP Settings
SMTP host
The server name of your SMTP server, e.g. smtp.office356.com for Microsoft 356
SMTP port
The port uesd by your SMTP server, e.g. 587 for Microsoft 356
TLS
Place the checkmark only if the connection with the SMTP server should be encoded via TLS.
SMTP sender e-mail address
The sender e-mail address which IRIS should use for sending mails.
SMTP username
The username used to login to the SMTP server. Sometimes identical with the sender e-mail.
SMTP authentication type
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.
Choose between Password and OAuth2.
The OAuth2 authentication is explained further down.
SMTP password
(Only for Password authentication)
The Password which IRIS should use to login to the SMTP server.
Test E-Mail
If you have set up all settings, you can send a test e-mail with this button.
Please keep in mind that, at that time, no settings were saved.
The tests are running with the current listed (and unsaved) settings in the browser.
SMTP with OAuth2
If you have chosen the Password as the SMTP authentication, you can skip this chapter.
To use OAuth2 as the SMTP authentication, choose OAuth2 as the SMTP authentication type.
Please enter the remaining settings under System configuration except for the token and save these settings.
After that, go to the menu option "OAuth2 Clients" in IRIS.
OAuth2 clients
By default, there are no OAuth2 Clients setup yet.
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).
Click on the button "New app" to create a new OAuth2 client.
Name
The name you enter here only serves as a reference for you.
Client ID
You receive the Client ID after the registration of the OAuth2 client at your email 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
Sobald Sie den Client erstellt haben, klicken Sie bitte in dem neu erstellten Client auf den Button "Authorize".
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.
Achtung: Bitte seien Sie sich bewusst, unter welchem Account Sie die Freigabe auf der Seite des E-Mail Betreibers durchführen.
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.