/usr/share/doc/cipux-passwd/usage.mkd is in cipux-passwd 3.4.0.3-2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 | # Usage of cipuxpasswd
2009-04-23 by Christian Kuelker - v0.1
The command 'cipuxpasswd' is a XML-RPC client. Internally it uses the
CipUX::Task cipux_task_change_own_password_interactive to change once own
password.
However this task is disabled by default for this client. To enable this for
admins, so that they can change their own paswword, you have to give
cipuxpasswd the right to execute the task.
## Enabling 'admin' group
To enable the 'admin' group you can issue this command as root to enable the
access for all admins to cipuxpasswd.
cipux_task_client -t cipux_task_add_member_to_task -o cipux_task_change_own_password_interactive -x value=cipuxpasswd
After this you have to restart the CipUX XML-RPC server or flush its cache.
## Enabling other groups
The 'admin' group is already a member of cipuxpasswd, but other groups are
not. You have to add other groups, for example 'student' (or on other
systems 'students'!), to cipuxpasswd to be able to used this tool by members
of other groups. (Of course step 1 from above is a prerequisite.)
### Example (add group 'student' to cipuxpasswd):
cipux_task_client -t cipux_task_add_member_to_cat_module -o cipuxpasswd -x value=student
After this you have to restart the CipUX XML-RPC server of flush its cache.
## Using cipuxpasswd
To acctually use it, just type
cipuxpasswd
You will then be asked for a login and a password. Passwords are not printed.
If you successfully logged in you may change the password. You have to type
two times exactly the same word.
A typical session looks like this:
cipuxpasswd
cipuxpasswd: Server [http://localhost:8001/RPC2] is available.
cipuxpasswd: Enter login: frodo
cipuxpasswd: Enter password:
cipuxpasswd: Authentication sucessful.
cipuxpasswd: Please type two times an identical password.
cipuxpasswd: New password:
cipuxpasswd: Again new password:
cipuxpasswd: Set password sucessful.
cipuxpasswd: Logout sucessful.
|