diff --git a/admin_manual/configuration_files/external_storage/images/externalStorages_variables.png b/admin_manual/configuration_files/external_storage/images/externalStorages_variables.png new file mode 100644 index 000000000..713601262 Binary files /dev/null and b/admin_manual/configuration_files/external_storage/images/externalStorages_variables.png differ diff --git a/admin_manual/configuration_files/external_storage_configuration_gui.rst b/admin_manual/configuration_files/external_storage_configuration_gui.rst index ccf066d3d..2596e0c2c 100644 --- a/admin_manual/configuration_files/external_storage_configuration_gui.rst +++ b/admin_manual/configuration_files/external_storage_configuration_gui.rst @@ -48,6 +48,23 @@ re-check your configuration and network availability. If there is an error on the storage, it will be marked as unavailable for ten minutes. To re-check it, click the colored icon or reload your Admin page. +Usage of variables for mount paths +---------------------------------- + +The external storage mounting mechanism accepts variables in the mount path. + +Use ``$user`` for automatic substitution with the logged in user's username. + +Use ``$home`` for automatic substitution with a configurable home directory variable +(requires LDAP, see :ref:`LDAP_Special_Attributes` in the LDAP configuration documentation for details) + +In the following example, the mount point for a logged in user "alice" would substitute +to ``/opt/userDirectories/alice/myPictures``. + +.. figure:: external_storage/images/externalStorages_variables.png + :alt: External storage user variable substitution + + User and group permissions -------------------------- diff --git a/admin_manual/configuration_user/user_auth_ldap.rst b/admin_manual/configuration_user/user_auth_ldap.rst index 82b9c0817..6527696fd 100644 --- a/admin_manual/configuration_user/user_auth_ldap.rst +++ b/admin_manual/configuration_user/user_auth_ldap.rst @@ -424,6 +424,7 @@ Default password policy DN: | *cn=default,ou=policies,dc=my-company,dc=com* +.. _LDAP_Special_Attributes: Special attributes ^^^^^^^^^^^^^^^^^^