add information about configurable LDAP Avatar behaviour

ref https://github.com/nextcloud/server/pull/10098
This commit is contained in:
Arthur Schiwon
2018-07-04 12:44:16 +02:00
parent 234f55629e
commit 0bef515783
2 changed files with 27 additions and 0 deletions

View File

@@ -580,6 +580,31 @@ Nextcloud avatar replaces it.
Photos served from LDAP are automatically cropped and resized in Nextcloud. This
affects only the presentation, and the original image is not changed.
Use a specific attribute or turn of loading of images
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
It is possible to turn off the avatar integration or specify a single,
different attribute to read the image from. It is expected to contain image
data just like *jpegPhoto* or *thumbnailPhoto* do.
The behaviour can be changed using the occ command line tool only. Essentially
those options are available:
* The default behaviour as described above should be used
``occ ldap:set-config "s01" "ldapUserAvatarRule" "default"``
* User images shall not be fetched from LDAP
``occ ldap:set-config "s01" "ldapUserAvatarRule" "none"``
* The image should be read from the attribute "selfiePhoto"
``occ ldap:set-config "s01" "ldapUserAvatarRule" "data:selfiePhoto"``
The "s01" refers to the configuration ID as can be retrieved per
``occ ldap:show-config``.
Troubleshooting, tips and tricks
--------------------------------

View File

@@ -223,6 +223,8 @@ Configuration keys
+-------------------------------+------+----------+-----------------------------------------------------------------------------------------------------------------------+
| ldapUserDisplayName2 | rw | no | Additional attribute, if set show on brackets next to the main attribute |
+-------------------------------+------+----------+-----------------------------------------------------------------------------------------------------------------------+
| ldapUserAvatarRule | rw | no | Specify the avatar integration behavior, possible values: "default", "none", "data:$ATTRIBUTENAME" |
+-------------------------------+------+----------+-----------------------------------------------------------------------------------------------------------------------+
| ldapGidNumber | rw | no | group ID attribute, needed for primary groups on OpenLDAP (and compatible) |
+-------------------------------+------+----------+-----------------------------------------------------------------------------------------------------------------------+
| ldapUserFilterObjectclass | rw | no | set by the Settings Wizard (web UI) |