#!/bin/bash # Check if a YunoHost user exists # # example: ynh_user_exists 'toto' || exit 1 # # usage: ynh_user_exists --username=username # | arg: -u, --username - the username to check # # Requires YunoHost version 2.2.4 or higher. ynh_user_exists() { # Declare an array to define the options of this helper. local legacy_args=u declare -Ar args_array=( [u]=username= ) local username # Manage arguments with getopts ynh_handle_getopts_args "$@" yunohost user list --output-as json | grep -q "\"username\": \"${username}\"" } # Retrieve a YunoHost user information # # example: mail=$(ynh_user_get_info 'toto' 'mail') # # usage: ynh_user_get_info --username=username --key=key # | arg: -u, --username - the username to retrieve info from # | arg: -k, --key - the key to retrieve # | ret: string - the key's value # # Requires YunoHost version 2.2.4 or higher. ynh_user_get_info() { # Declare an array to define the options of this helper. local legacy_args=uk declare -Ar args_array=( [u]=username= [k]=key= ) local username local key # Manage arguments with getopts ynh_handle_getopts_args "$@" yunohost user info "$username" --output-as plain | ynh_get_plain_key "$key" } # Get the list of YunoHost users # # example: for u in $(ynh_user_list); do ... # # usage: ynh_user_list # | ret: string - one username per line # # Requires YunoHost version 2.4.0 or higher. ynh_user_list() { yunohost user list --output-as plain --quiet \ | awk '/^##username$/{getline; print}' } # Check if a user exists on the system # # usage: ynh_system_user_exists --username=username # | arg: -u, --username - the username to check # # Requires YunoHost version 2.2.4 or higher. ynh_system_user_exists() { # Declare an array to define the options of this helper. local legacy_args=u declare -Ar args_array=( [u]=username= ) local username # Manage arguments with getopts ynh_handle_getopts_args "$@" getent passwd "$username" &>/dev/null } # Check if a group exists on the system # # usage: ynh_system_group_exists --group=group # | arg: -g, --group - the group to check ynh_system_group_exists() { # Declare an array to define the options of this helper. local legacy_args=g declare -Ar args_array=( [g]=group= ) local group # Manage arguments with getopts ynh_handle_getopts_args "$@" getent group "$group" &>/dev/null } # Create a system user # # examples: # # Create a nextcloud user with no home directory and /usr/sbin/nologin login shell (hence no login capability) # ynh_system_user_create --username=nextcloud # # Create a discourse user using /var/www/discourse as home directory and the default login shell # ynh_system_user_create --username=discourse --home_dir=/var/www/discourse --use_shell # # usage: ynh_system_user_create --username=user_name [--home_dir=home_dir] [--use_shell] # | arg: -u, --username - Name of the system user that will be create # | arg: -h, --home_dir - Path of the home dir for the user. Usually the final path of the app. If this argument is omitted, the user will be created without home # | arg: -s, --use_shell - Create a user using the default login shell if present. If this argument is omitted, the user will be created with /usr/sbin/nologin shell # # Requires YunoHost version 2.6.4 or higher. ynh_system_user_create () { # Declare an array to define the options of this helper. local legacy_args=uhs declare -Ar args_array=( [u]=username= [h]=home_dir= [s]=use_shell ) local username local home_dir local use_shell # Manage arguments with getopts ynh_handle_getopts_args "$@" use_shell="${use_shell:-0}" home_dir="${home_dir:-}" if ! ynh_system_user_exists "$username" # Check if the user exists on the system then # If the user doesn't exist if [ -n "$home_dir" ]; then # If a home dir is mentioned local user_home_dir="-d $home_dir" else local user_home_dir="--no-create-home" fi if [ $use_shell -eq 1 ]; then # If we want a shell for the user local shell="" # Use default shell else local shell="--shell /usr/sbin/nologin" fi useradd $user_home_dir --system --user-group $username $shell || ynh_die "Unable to create $username system account" fi } # Delete a system user # # usage: ynh_system_user_delete --username=user_name # | arg: -u, --username - Name of the system user that will be create # # Requires YunoHost version 2.6.4 or higher. ynh_system_user_delete () { # Declare an array to define the options of this helper. local legacy_args=u declare -Ar args_array=( [u]=username= ) local username # Manage arguments with getopts ynh_handle_getopts_args "$@" # Check if the user exists on the system if ynh_system_user_exists "$username" then deluser $username else ynh_print_warn --message="The user $username was not found" fi # Check if the group exists on the system if ynh_system_group_exists "$username" then delgroup $username fi }