Skip to content

Commit

Permalink
Updated user management.
Browse files Browse the repository at this point in the history
  • Loading branch information
@lvicoun
lvicoun committed Sep 27, 2023
1 parent ff51bd4 commit 5e77db4
Show file tree
Hide file tree
Showing 5 changed files with 85 additions and 25 deletions.
16 changes: 13 additions & 3 deletions articles/cockpit-slemicro.asm.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -105,7 +105,7 @@ type="application/relax-ng-compact-syntax"?>
<description>Managing network VLANs</description>
</resource>
<resource href="../tasks/cockpit-getting-container-images.xml" xml:id="_cockpit-getting-container-images">
<description>Managing Podman containers</description>
<description>Getting container images</description>
</resource>
<resource href="../tasks/cockpit-managing-containers.xml" xml:id="_cockpit-managing-containers">
<description>Managing Podman containers</description>
Expand All @@ -118,11 +118,14 @@ type="application/relax-ng-compact-syntax"?>
<description>Adding containers to pods</description>
</resource>
<resource href="../tasks/cockpit-creating-users.xml" xml:id="_cockpit-creating-users">
<description>Adding containers to pods</description>
<description>Creating users</description>
</resource>
<resource href="../tasks/cockpit-modifying-accounts.xml" xml:id="_cockpit-modifying-accounts">
<description>Modifying user accounts</description>
</resource>
<resource href="../tasks/cockpit-creating-groups.xml" xml:id="_cockpit-creating-groups">
<description>Creating user groups</description>
</resource>
<resource href="../tasks/cockpit-managing-systemd-units.xml" xml:id="_cockpit-managing-systemd-units">
<description>Managing systemd units</description>
</resource>
Expand Down Expand Up @@ -419,13 +422,20 @@ type="application/relax-ng-compact-syntax"?>
</module>
</module>
<module renderas="section" resourceref="_cockpit-user-management">
<module renderas="section" resourceref="_cockpit-modifying-accounts">
<merge>
<abstract>
<para/>
</abstract>
</merge>
</module>
<module renderas="section" resourceref="_cockpit-creating-users"/>
<merge>
<abstract>
<para/>
</abstract>
</merge>
<module renderas="section" resourceref="_cockpit-modifying-accounts"/>
<module renderas="section" resourceref="_cockpit-creating-groups"/>
</module>
<module renderas="section" resourceref="_cockpit-managing-services">
<merge>
Expand Down
9 changes: 7 additions & 2 deletions glues/cockpit-user-management.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -21,14 +21,14 @@
<abstract>
<para>
The <guimenu>Accounts</guimenu> &cockpit; screen enables you to
administer user accounts.
administer user accounts and groups.
</para>
</abstract>
</info>
<note>
<title>Users administration only for server administrators</title>
<para>
Only users with the <guimenu>Server administrator</guimenu> role can edit
Only users with the <guimenu>Administrative access</guimenu> can edit
other users.
</para>
</note>
Expand All @@ -43,6 +43,11 @@
<xref linkend="task-creating-users-cockpit"/>
</para>
</listitem>
<listitem>
<para>
Creating new user groups as described in <xref linkend="cockpit-creating-groups"/>.
</para>
</listitem>
<listitem>
<para>
Assigning <command>sudo</command> privileges to user accounts as described in
Expand Down
54 changes: 54 additions & 0 deletions tasks/cockpit-creating-groups.xml
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,54 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE topic
[
<!ENTITY % entities SYSTEM "../common/generic-entities.ent">
%entities;
]>
<!-- refers to legacy doc: <add github link to legacy doc piece, if applicable> -->
<!-- point back to this document with a similar comment added to your legacy doc piece -->
<!-- refer to README.md for file and id naming conventions -->
<!-- metadata is dealt with on the assembly level -->
<topic xml:id="cockpit-creating-groups"
role="task" xml:lang="en"
xmlns="http://docbook.org/ns/docbook" version="5.2"
xmlns:its="http://www.w3.org/2005/11/its"
xmlns:xi="http://www.w3.org/2001/XInclude"
xmlns:xlink="http://www.w3.org/1999/xlink"
xmlns:trans="http://docbook.org/ns/transclusion">
<info>
<title>Creating user groups</title><!-- can be changed via merge
in the assembly -->
<!-- add author's e-mail -->
<meta name="maintainer" content="[email protected]" its:translate="no"/>
<abstract><!-- can be changed via merge in the assembly -->
<para>
The topic covers creating of user groups.
</para>
</abstract>
</info>
<para>
To create a user group, proceed as follows:
</para>
<procedure>
<step>
<para>
Navigate to the <guimenu>Accounts</guimenu> page.
</para>
</step>
<step>
<para>
Click <guimenu>Create new group</guimenu>.
</para>
</step>
<step>
<para>
Enter a unique name of the group and specify or left the default one.
</para>
<note>
<para>
The already existing group ID cannot be overwritten. Group IDs under 1000 are usually reserved for system accounts, services, and so on. If you create a group with ID less than 1000, the group cannot be later deleted using &cockpit;.
</para>
</note>
</step>
</procedure>
</topic>
5 changes: 4 additions & 1 deletion tasks/cockpit-creating-users.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -42,7 +42,10 @@
</step>
<step>
<para>
Fill in the user account details.
Fill in the user account details. You can assign a different home directory to the user in the drop-down <guimenu>Home directory</guimenu> menu. If you do not specify a directory, the standard <filename>/home<replaceable>USERNAME</replaceable></filename> path is used.
</para>
<para>
If you select <guimenu>Disallow password authentication</guimenu>, the user will have to use other authentication method than filling in password, for example, SSH login.
</para>
</step>
<step>
Expand Down
26 changes: 7 additions & 19 deletions tasks/cockpit-modifying-accounts.xml
View file
Original file line number Diff line number Diff line change
Expand Up @@ -39,19 +39,6 @@
<para>
Click the account you want to modify.
</para>
<!--
<figure>
<title>User details</title>
<mediaobject>
<imageobject role="fo">
<imagedata fileref="cockpit_user_details.png" width="100%"/>
</imageobject>
<imageobject role="html">
<imagedata fileref="cockpit_user_details.png" width="100%"/>
</imageobject>
</mediaobject>
</figure>
-->
</step>
<step>
<para>
Expand All @@ -77,22 +64,23 @@
</listitem>
</varlistentry>
<varlistentry>
<term>Change user's role</term>
<term>Assign groups to the user</term>
<listitem>
<para>
By checking/unchecking the <guimenu>Server
administrator</guimenu> check box, you can assign or remove the
administrator role from the user.
In the <guimenu>Groups</guimenu> drop-down menu, you can assing groups to the user.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term>Manage access to the account</term>
<listitem>
<para>
You can lock the account, or you can set a date when the account
will expire.
You can set a date when the account
will expire. The default is to never exprire.
</para>
<para>
You can disallow the user to use they password to login. The user then must use a different method of authentication.
</para>
</listitem>
</varlistentry>
<varlistentry>
Expand Down

0 comments on commit 5e77db4

Please sign in to comment.