<?xml version="1.0" encoding="utf-8"?><!DOCTYPE article  PUBLIC '-//OASIS//DTD DocBook XML V4.4//EN'  'http://www.docbook.org/xml/4.4/docbookx.dtd'><article><articleinfo><title>AddingNewAdmins</title><revhistory><revision><revnumber>14</revnumber><date>2026-03-31 21:48:44</date><authorinitials>ClintonEbadi</authorinitials><revremark>bugzilla admin user creation procedure</revremark></revision><revision><revnumber>13</revnumber><date>2026-03-31 21:41:30</date><authorinitials>ClintonEbadi</authorinitials></revision><revision><revnumber>12</revnumber><date>2026-03-31 21:41:15</date><authorinitials>ClintonEbadi</authorinitials><revremark>basic notes on digital ocean admin role</revremark></revision><revision><revnumber>11</revnumber><date>2022-03-05 20:22:28</date><authorinitials>ClintonEbadi</authorinitials><revremark>remove top level heading</revremark></revision><revision><revnumber>10</revnumber><date>2022-03-05 20:20:20</date><authorinitials>ClintonEbadi</authorinitials><revremark>update instructions for creating new admin user for the modern era</revremark></revision><revision><revnumber>9</revnumber><date>2022-02-17 01:17:50</date><authorinitials>StephenMichel</authorinitials><revremark>Add notes based on ClintonEbadi's irc comments</revremark></revision><revision><revnumber>8</revnumber><date>2012-09-06 06:56:34</date><authorinitials>ClintonEbadi</authorinitials><revremark>local users are deprecated for the time being</revremark></revision><revision><revnumber>7</revnumber><date>2012-03-22 07:17:16</date><authorinitials>ClintonEbadi</authorinitials><revremark>oops, last despam for this page reverted to the wrong version</revremark></revision><revision><revnumber>6</revnumber><date>2011-04-22 22:50:18</date><authorinitials>ClintonEbadi</authorinitials><revremark>Revert to revision 4.</revremark></revision><revision><revnumber>5</revnumber><date>2011-04-21 17:09:42</date><authorinitials>softbank126125063166.bbtec.net</authorinitials><revremark>nAkOw0  &lt;a href=&quot;http://qwfonhwtzxkl.com/&quot;&gt;qwfonhwtzxkl&lt;/a&gt;</revremark></revision><revision><revnumber>4</revnumber><date>2011-04-21 09:30:17</date><authorinitials>118.67.78.136</authorinitials><revremark>Kudos to you! I hadn't tuhoght of that!</revremark></revision><revision><revnumber>3</revnumber><date>2011-02-25 09:13:07</date><authorinitials>ClintonEbadi</authorinitials><revremark>remember to make admin users domtool admins as well</revremark></revision><revision><revnumber>2</revnumber><date>2010-12-24 21:46:46</date><authorinitials>DavorOcelic</authorinitials></revision><revision><revnumber>1</revnumber><date>2010-12-24 21:46:17</date><authorinitials>DavorOcelic</authorinitials></revision></revhistory></articleinfo><para>Guide to creating a new administrative user with admin privileges for various services. </para><para>TODO: Write a create-admin-user script that does this all automatically (add it to the scripts git repo) </para><para><code>NAME</code> = Member's non-administrative username. All commands should be run from <ulink url="https://wiki.hcoop.net/AddingNewAdmins/ServerGibran#">ServerGibran</ulink> (or the current administrative server). </para><section><title>Basic Setup</title><para>Steps required to create a minimally functional admin user. </para><section><title>Creating the user</title><screen><![CDATA[/afs/hcoop.net/common/etc/scripts/create-user-new NAME_admin
sudo kadmin.local cpw NAME_admin # set randomly generated initial pw]]></screen><para>The user will now exist in Kerberos, AFS, and <ulink url="https://wiki.hcoop.net/AddingNewAdmins/DomTool#">DomTool</ulink> but have no administrative permissions. </para></section><section><title>Administrative Email Lists</title><para>In <code>~hcoop/.domtool/hcoop.net</code> add the new admin users to the <code>admin_emails</code> list which will add them to the needed mail aliases to receive admin mail. </para><para>Also add <code>emailAlias &quot;NAME_admin&quot; &quot;NAME&quot;;</code> so administrative emails are forward to the admin's normal mail account. </para><para>TODO: update <ulink url="https://wiki.hcoop.net/AddingNewAdmins/AdminArea#">AdminArea</ulink> with list of lists that admins are expected to not ignore. </para></section><section><title>SSH Access, Sudo On Administrator-Only Servers, and Kerberos Admin</title><para>In Puppet, modify <code>modules/hcoop/manifests/init.pp</code> and add the new admin user to the <code>$admins</code> list. This will allow them to connect to all servers and have sudo which will also grant access to locally administered services like Postgres and MySQL. </para><para>This also grants them kerberos administrator privileges. <emphasis>FIXME</emphasis>: do we make that optional? <ulink url="https://wiki.hcoop.net/AddingNewAdmins/MitKerberos#">MitKerberos</ulink> admin powers are very broad, and perhaps not all admins will need them. </para></section><section><title>Puppet Environment</title><para>Create a puppet environment for the new admin as described in <ulink url="https://wiki.hcoop.net/AddingNewAdmins/ConfigurationManagement#Personal_Environments">ConfigurationManagement#Personal_Environments</ulink> which allows them to actually make changes to system configuration. <emphasis role="strong">All system changes are made through Puppet.</emphasis> </para></section><section><title>Portal Admin</title><para>On the <ulink url="https://members.hcoop.net/portal/groups">Portal Groups Management Page</ulink> add the admin's member account to the <code>root</code> group. This enables full access to portal administrative features and allows the admin to view support requests. </para></section></section><section><title>Services</title><para>Although not strictly needed, the admin will not be able to handle all support requests without these. </para><section><title>DomTool Administrator</title><para>To grant full admin permissions: <code>domtool-admin grant NAME_admin priv all</code> </para><para><ulink url="https://wiki.hcoop.net/AddingNewAdmins/DomTool/ArchitectureOverview#Standard_ACL_classes">DomTool/ArchitectureOverview#Standard_ACL_classes</ulink> has a list of all valid values for <code>priv</code> which can be used instead of <code>all</code> if more limited administrative permissions are desired. </para></section><section><title>AFS Administrator</title><para>AFS administrative permissions are controlled by membership in the <code>system:administrators</code> group, so if a user is intended to have AFS admin privileges: <code>pts adduser NAME_admin system:administrators</code>. </para></section><section><title>BugZilla administrator</title><para><ulink url="https://wiki.hcoop.net/AddingNewAdmins/WebServicesAdmin/BugZilla#">WebServicesAdmin/BugZilla</ulink> </para><para>Admin access is required to edit groups, components, etc. The only common administrative option is likely to be changing group membership and the default assignee for various components (e.g. modifying board and financial default assignee after an election). </para><para>Use the [edit users panel](<ulink url="https://bugzilla.hcoop.net/editusers.cgi"/>), find the admin user account (they must login to bugzilla at least once for their account to exist), and add the admin flag. If the admin should be allowed to create further admin accounts then the &quot;Can turn these bits on for other users&quot; flag should also be set. </para></section><section><title>Wiki administrator</title><para>Add new admin's wiki account to the list on <ulink url="https://wiki.hcoop.net/AddingNewAdmins/AdminGroup#">AdminGroup</ulink> </para></section><section><title>Digital Ocean Administrator</title><para>If the admin requires access to the Digital Ocean hcoop project (e.g. for remote console access), they must first register directly with Digital Ocean as <code>USER@hcoop.net</code>. Then the board administrative account should be used to add the new admin at level &quot;Modifier&quot; or &quot;Resource Viewer&quot; to our project at Digital Ocean. This will allow them to view and interact with the project, use the remote console to access servers, provision new resources, and create/modify monitoring rules (at the &quot;Modifier&quot; level). The &quot;Owner&quot; level should only be assigned to the board account, and the &quot;Member&quot; level should be given only to very trusted admins since it allows destructive actions like deleting entire servers. </para><!--rule (<hr>) is not applicable to DocBook--><para> <ulink url="https://wiki.hcoop.net/AddingNewAdmins/CategorySystemAdministration#">CategorySystemAdministration</ulink> </para></section></section></article>