215 lines
6.7 KiB
ReStructuredText
215 lines
6.7 KiB
ReStructuredText
cdist-type__nextcloud_user(7)
|
|
=============================
|
|
|
|
NAME
|
|
----
|
|
cdist-type__nextcloud_user - Setup a Nextcloud user
|
|
|
|
|
|
DESCRIPTION
|
|
-----------
|
|
It manages a single Nextcloud user given by the object id or parameter `--user`.
|
|
This type can create and manage most properties of the Nextcloud user. If you
|
|
only want to setup the user, but want that the user will take full control over
|
|
all settings (so cdist will not touch the user anymore), use the parameter
|
|
`--only-setup` or `--keep-*` for special parameters.
|
|
|
|
|
|
REQUIRED PARAMETERS
|
|
-------------------
|
|
cloud
|
|
The absolute path of the Nextcloud installation.
|
|
|
|
|
|
OPTIONAL PARAMETERS
|
|
-------------------
|
|
state
|
|
The state the user should be in. Can be the following:
|
|
|
|
present *(default)*
|
|
The user exists.
|
|
|
|
enabled
|
|
The user exists and is enabled.
|
|
|
|
disabled
|
|
The user exists and is disabled.
|
|
|
|
absent
|
|
The user does not exist.
|
|
|
|
user
|
|
Takes the uid of the Nextcloud user which will be handled by this type. If
|
|
this is not set, the object id will be taken instead.
|
|
|
|
www-user
|
|
The unix user which will be used to execute Nextcloud related stuff. You
|
|
should always use the same user for all Nextcloud interactions, for the
|
|
webserver and cli execution. As default, `www-data` will be used.
|
|
|
|
displayname
|
|
The display name the user should have. As the display name can not be unset
|
|
or set to empty, this type will ignore the display name if this parameter
|
|
is not set. Setting the parameter to an empty string leads to an error from
|
|
the Nextcloud side.
|
|
|
|
email
|
|
The email address of the Nextcloud user. Will be unset if no parameter
|
|
given.
|
|
|
|
password
|
|
The password of the Nextcloud user. If the password not match, the new
|
|
password will be set to the user. If no password is given, it will not
|
|
touch the current password. **A password is required for the user setup!**
|
|
If you do not want to modify the user password, set a password via this
|
|
parameter and set the parameter `--keep-password`.
|
|
|
|
Note that Nextcloud will check for the security of passwords. The type
|
|
will abort if Nextcloud refuses that password!
|
|
|
|
quota
|
|
The quota the Nextcloud user have to store it data. Defaults to `default`.
|
|
Following values are accepted by Nextcloud:
|
|
|
|
default
|
|
Uses the quota set as default in Nextcloud.
|
|
|
|
none
|
|
No quota limit set; unlimited.
|
|
|
|
$size
|
|
The quota that should be used. Same values as set over the user
|
|
interface. First the number, then a space and then the unit like `GB`.
|
|
|
|
group
|
|
Multiple group names which the Nextcloud user belongs to. If not set, the
|
|
user will be removed from every group he is in.
|
|
|
|
|
|
BOOLEAN PARAMETERS
|
|
------------------
|
|
only-setup
|
|
Only provisioning the user if he does not exist. Do not touch the user if
|
|
he already exists (except to enforce the given state).
|
|
|
|
keep-displayname
|
|
Do not touch the display name of the user if he is already set up. This
|
|
will avoid to delete the user-set value because it does not match with the
|
|
predefined state. If the parameter `--displayname` is set despite of this
|
|
parameter, it will only be used in the user setup if he does not already
|
|
exist.
|
|
|
|
keep-email
|
|
Do not touch the email attributes of the user if he is already set up. This
|
|
will avoid to delete the user-set value because it does not match with the
|
|
predefined state. If the parameter `--email` is set despite of this
|
|
parameter, it will only be used in the user setup if he does not already
|
|
exist.
|
|
|
|
keep-password
|
|
Do not touch the password if the user is already set up. This will avoid to
|
|
delete user-set passwords because they do not match with the predefined
|
|
state. If the parameter `--password` is set despite of this parameter, it
|
|
will only be used in the user setup if he does not already exists.
|
|
|
|
keep-quota
|
|
Do not touch the user quota if he is already set up. This will avoid to
|
|
delete the configuration set by an administrator. If the parameter `--quota`
|
|
is set despite of this parameter, it will only be used in the user setup if
|
|
he does not already exist.
|
|
|
|
keep-groups
|
|
Do not touch the user groups if the user is already set up. This will avoid
|
|
to delete group assosiactions not defined via cdist. If the parameter
|
|
`--group` is set despite of this parameter, it will only be used in the user
|
|
setup if he does not already exists.
|
|
|
|
|
|
MESSAGES
|
|
--------
|
|
created
|
|
The user as created.
|
|
|
|
enabled
|
|
The user already exists and was enabled.
|
|
|
|
disabled
|
|
The user already exists and was disabled.
|
|
|
|
removed
|
|
The user was removed.
|
|
|
|
|
|
EXAMPLES
|
|
--------
|
|
|
|
.. code-block:: sh
|
|
|
|
# Nextcloud base installation
|
|
__nextcloud /var/www/html/cloud $args
|
|
|
|
# setups an user, but do not touch it after it was created
|
|
require="__nextcloud/var/www/html/cloud" __nextcloud_user foo \
|
|
--cloud /var/www/html/cloud/ \
|
|
--displayname "Big Fooo" \
|
|
--email "foo@bar.tld" \
|
|
--password "do-not-use-this-password" \
|
|
--group "team_a" --group "xxxx" \
|
|
--quota "2 GB"
|
|
--only-setup
|
|
|
|
# manages an admin user fully controlled by cdist
|
|
require="__nextcloud/var/www/html/cloud" __nextcloud_user bar \
|
|
--cloud /var/www/html/cloud/ \
|
|
--displayname "Bar" \
|
|
--email "bar@bar.tld" \
|
|
--password "nope_insecure" \
|
|
--group "admin"
|
|
|
|
# disables an user
|
|
require="__nextcloud/var/www/html/cloud" __nextcloud_user bb \
|
|
--state disabled \
|
|
--cloud /var/www/html/cloud/ \
|
|
--displayname "byebye" \
|
|
--password "do_not_copy" \
|
|
--keep-email --keep-password --keep-quota --keep-groups
|
|
|
|
# removes an user
|
|
require="__nextcloud/var/www/html/cloud" __nextcloud_user foobar \
|
|
--state absent \
|
|
--cloud /var/www/html/cloud/
|
|
|
|
|
|
# Different cloud
|
|
__nextcloud /var/www/html/nextcloud $args
|
|
# but same user name
|
|
require="__nextcloud/var/www/html/nextcloud" __nextcloud_user next_foobar \
|
|
--cloud /var/www/html/nextcloud/ --user foobar
|
|
|
|
|
|
NOTES
|
|
-----
|
|
This type may be extended by more user settings. If you think some
|
|
configuration is missing, you are welcome to contribute!
|
|
|
|
Sometimes, this type uses custom php code to hack into Nextcloud to gather some
|
|
information not possible to get via the `occ` command or even set a value.
|
|
|
|
|
|
SEE ALSO
|
|
--------
|
|
:strong:`cdist-type__nextcloud`\ (7)
|
|
:strong:`cdist-type__nextcloud_app`\ (7)
|
|
|
|
|
|
AUTHORS
|
|
-------
|
|
Matthias Stecher <matthiasstecher at gmx.de>
|
|
|
|
|
|
COPYING
|
|
-------
|
|
Copyright \(C) 2020 Matthias Stecher.
|
|
You can redistribute it and/or modify it under the terms of the GNU
|
|
General Public License as published by the Free Software Foundation,
|
|
either version 3 of the License, or (at your option) any later version.
|