Repository navigation
Administration Configuration
Die Konfigurationseinstellungen werden in einer Datei usermanager.config gespeichert. Diese muss im config-Verzeichnis ihrer Payara-Domain liegen (z.B. /opt/payara5/glassfish/domains/domain1/config).
Beispiel einer Konfigurationsdatei:
serviceorder=LDAP,Local copyusertolocal=true passwordsalt=SomeSalt authtokensalt=SomeSalt debugmode=true ldap_host= ldap_port= ldap_adminUID= ldap_password= ldap_method=plain ldap_activedirectory= ldap_bind_dn= ldap_allow_username_or_email_login=false ldap_base= ldap_user_filter=(&(objectClass=user)(CN=$u))
Die Service-Einstellungen legen das Verhalten des Usermanagers fest.
| Name | Beschreibung | optional |
|---|---|---|
| serviceorder | Gibt die Abzufragenden Services und deren Reihenfolge an. Network,Local,LDAP oder eine Kombination davon (ohne Leerzeichen) | nein |
| copyusertolocal | Legt fest, ob per LDAP oder Netzwerk identifizierte Benutzer als Kopie in der lokalen Datenbank angelegt werden sollen | ja (standard=false) |
Die Reihenfolge der Angabe legt die Priorität des Anmeldeverfahrens fest. So bedeutet z.B. LDAP,Local, dass zunächst eine Identifizierung über LDAP versucht wird, danach eine gegen die lokale Datenbank.
Die Sicherheitseinstellungen erhöhen die Sicherheit bei der Anmeldung, wenn mehrere Clients genutzt werden.
| Name | Beschreibung | optional |
|---|---|---|
| passwordsalt | String mit dem das Benutzerpasswort verschlüsselt wird. Muss identisch mit dem Salt auf dem Server sein. | nein |
| authtokensalt | String, mit dem das Authtoken verschlüsselt wird. Muss identisch mit dem Salt auf dem Server sein. | nein |
Die angegebenen Salts müssen von allen Client-Anwendungen, welche den Usermanger-Server verwenden wollen, gekannt werden. Nur wenn der Client die übertragenen Passwörter mit dem korrekten Salt-Verschlüsselt, ist eine Identifizierung der Benutzer möglich.
HINWEIS: Die Verwendung von LDAP zum Login ist ab Java17 nicht mehr möglich!
Damit das LDAP-Anmeldeverfahren genutzt werden kann, müssen ein paar zusätzliche Einstellungen in die Konfigurationsdatei aufgenommen werden.
| Name | Beschreibung | optional |
|---|---|---|
| ldap_host | Host-Adresse des LDAP Service | nein |
| ldap_port | Port unter welchem der LDAP Service erreichbar ist | nein |
| ldap_adminUID | Benutzerkennung des Benutzers, welcher die Anfragen an den LDAP-Server sendet | nein |
| ldap_password | Passwort des Benutzers, der die Anfragen an den LDAP-Server sendet | nein |
| ldap_method | Methode der LDAP Anfragen (plain) | nein |
| ldap_activedirectory | true / false, ob ein LDAP ActiveDirectory verwendet wird | nein |
| ldap_bind_dn | ActiveDirectory-Verzeichnisangaben, in denen Benutzer gesucht werden sollen | nein |
| ldap_allow_username_or_email_login | true/false, ob Anmeldung per E-Mail und Benutzername erlaubt ist | nein |
| ldap_base | Basisangabe für LDAP | nein |
| ldap_user_filter | Filter-Ausdruck zum Finden eines Benutzers | nein |
Hinweis:
- Der ldap_user_filter darf den Platzhalter $u enthalten, welcher mit dem eingegebenen Benutzernamen des Anmelders ersetzt wird.
Das mit SmartUser Emails an angemeldete oder sich anmeldende Benutzer senden kann, müssen die folgenden Einstellungen ausgefüllt werden:
| Name | Beschreibung | optional |
|---|---|---|
| email_smtp_host | Adresse des SMTP-Servers der die Emails versendet | nein |
| email_smtp_port | Port des SMTP-Servers. Normalerweise 587 | nein |
| email_smtp_auth | Angabe ob eine Authentifizierung notwendig ist | nein |
| email_smtp_user | Benutzername des Nutzers, der die Emails versendet | nein |
| email_smtp_password | Passwort des Nutzers, der die Emails versendet | nein |
| email_smtp_tls | Angabe ob tls verwendet werden soll | nein |
| email_smtp_sender | Email-Adresse von der gesendet werden soll | nein |
SmartUser kann so eingestellt werden, dass es Bestätigungs Emails versendet. Erst nach der Bestätigung durch den Benutzer kann dieser den angelegten Account verwenden.
| Name | Beschreibung | optional |
|---|---|---|
| confirm_mail | Aktiviert das Versenden der Bestätigungsmails | nein |
| confirmsalt | Token mit dem die Bestätigungszahl verschlüsselt wird | nein |
| confirm_subject | Betreff der Bestätigungs-Email | nein |
| confirm_subject_xx | Betreff in der Sprache, mit dem Sprachkürzel (xx) | ja |
| confirm_content | Inhalt der Bestätigungs-Email | nein |
| confirm_content_xx | Inhalt in der Sprache, mit dem Sprachkürzel (xx) | ja |
| confirm_link | Link der zur Bestätigung aufgerufen werden soll. Das Token wird angehängt | nein |
Mit dem Maillogin kann der Benutzer eine Email zum einmaligen Login anfordern, dies dient auch als Passwort-Vergessen-Funktion. Dem Nutzer wird eine Email mit einem Login-Token zugesendet.
| Name | Beschreibung | optional |
|---|---|---|
| maillogin_subject | Betreff der Email | nein |
| maillogin_subject_xx | Betreff der Email in der Sprache, mit dem Sprachkürzel (xx) | ja |
| maillogin_content | Inhalt der Email | nein |
| maillogin_content_xx | Inhalt der Email, in der Sprache, mit dem Sprachkürzel (xx) | ja |
| maillogin_link | Link der zur Bestätigung aufgerufen werden soll | nein |