From 0bef515783bc12df49de988f71ec28f761792ed7 Mon Sep 17 00:00:00 2001 From: Arthur Schiwon Date: Wed, 4 Jul 2018 12:44:16 +0200 Subject: [PATCH] add information about configurable LDAP Avatar behaviour ref https://github.com/nextcloud/server/pull/10098 --- .../configuration_user/user_auth_ldap.rst | 25 +++++++++++++++++++ .../configuration_user/user_auth_ldap_api.rst | 2 ++ 2 files changed, 27 insertions(+) diff --git a/admin_manual/configuration_user/user_auth_ldap.rst b/admin_manual/configuration_user/user_auth_ldap.rst index e003203ac..eda1ca1a0 100644 --- a/admin_manual/configuration_user/user_auth_ldap.rst +++ b/admin_manual/configuration_user/user_auth_ldap.rst @@ -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 -------------------------------- diff --git a/admin_manual/configuration_user/user_auth_ldap_api.rst b/admin_manual/configuration_user/user_auth_ldap_api.rst index f880756f0..6dfd8712d 100644 --- a/admin_manual/configuration_user/user_auth_ldap_api.rst +++ b/admin_manual/configuration_user/user_auth_ldap_api.rst @@ -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) |