******************************
User administration (AER 2.28)
******************************

.. raw:: html

    <p>As of Anaconda Repository version 2.28, administrators can use the Administration menu to promote users to Staff or Superuser status.</p>
    <p>The Staff user and Superuser can view the following sections of the Administration:</p>
    <ul class="simple">
    <li>Reports</li>
    <li>User administration</li>
    <li>License downloads</li>
    <li>Trial licenses</li>
    <li>Current LDAP configuration</li>
    <li>Current server configuration</li>
    <li>Downloads summary</li>
    <li>Downloads from a specific address</li>
    <li>Security feed and security feed details</li>
    <li>Storage administration</li>
    </ul>
    <p>The Staff user and Superuser have the following privileges:</p>
    <ul class="simple">
    <li>Create licenses</li>
    <li>Download a CSV of the user database</li>
    <li>Search for a package in the Administration panel</li>
    <li>Re-send confirmation emails to users</li>
    <li>Re-send password reset emails to users</li>
    <li>Download a CSV with the users emails</li>
    </ul>
    <p>In addition to all of the above, a Superuser can also view the following from the Administration:</p>
    <ul class="simple">
    <li>Plans</li>
    <li>User details</li>
    </ul>
    <p>To promote an existing user to a superuser or staff user, from the Admin&#8217;s left navigation, select Accounts, then select the username you wish to promote. This brings up the user information page:</p>
    <img alt="../../../_images/anaconda-repository/2.28/repo-admin-superuser-staff.png" src="../../../_images/anaconda-repository/2.28/repo-admin-superuser-staff.png" />
    <div class="line-block">
    <div class="line"><br /></div>
    </div>
    <p>Click the <strong>Set Staff</strong> button to give the user staff privileges.</p>
    <p>Click the <strong>Set Superuser</strong> button to give the user superuser privileges.</p>
    <p>In the dialog box that appears, confirm by re-typing the user&#8217;s name, then click the Set button.</p>
    <div class="section" id="add-a-user">
    <h2>Add a user<a class="headerlink" href="#add-a-user" title="Permalink to this headline">¶</a></h2>
    <p>New users can navigate to your local Anaconda Repository web page and sign themselves up for an
    account, or the administrator can add them using the command line:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span>anaconda-server-create-user --username &quot;jsmith&quot; --password &quot;abc123DEF&quot;  --email &quot;jsmith@acme.com&quot;
    </pre></div>
    </div>
    <p>NOTE: Replace jsmith, abc123DEF, and <a class="reference external" href="mailto:jsmith&#37;&#52;&#48;acme&#46;com">jsmith<span>&#64;</span>acme<span>&#46;</span>com</a> with the actual username, password, and email address of the new user.</p>
    </div>
    <div class="section" id="remove-a-user">
    <h2>Remove a user<a class="headerlink" href="#remove-a-user" title="Permalink to this headline">¶</a></h2>
    <ol class="arabic simple">
    <li>Log into your Anaconda repository administrative account.</li>
    <li>Navigate to the following url: <code class="docutils literal"><span class="pre">http://your.anaconda.repository:&lt;port&gt;/admin/report</span></code></li>
    <li>Choose &#8220;Accounts&#8221;.</li>
    <li>Select the username of the user you wish to remove.</li>
    <li>Choose &#8220;Delete user&#8221;.</li>
    </ol>
    </div>
    <div class="section" id="resending-welcome-emails-to-new-users">
    <h2>Resending welcome emails to new users<a class="headerlink" href="#resending-welcome-emails-to-new-users" title="Permalink to this headline">¶</a></h2>
    <p>To send emails Anaconda Repository must have the <a class="reference internal" href="reference.html#repo-admin-reference-emails"><span>email settings</span></a> configured.</p>
    <p>If a user reports that they did not receive their welcome email after registering on your local Anaconda Repository web page, it may have been caught in a spam filter. An administrator can regenerate and manually send this email.</p>
    <p>Resend welcome email:</p>
    <ol class="arabic simple">
    <li>Log into your Anaconda repository administrative account.</li>
    <li>Navigate to the following url: <code class="docutils literal"><span class="pre">http://your.anaconda.repository:&lt;port&gt;/admin/resend_email/password_reset</span></code></li>
    <li>Click the &#8220;Confirmation&#8221; tab.</li>
    <li>Enter the user&#8217;s email address and re-generate the email template.</li>
    <li>Send the email to the user.</li>
    </ol>
    </div>
    <div class="section" id="resetting-user-passwords">
    <h2>Resetting user passwords<a class="headerlink" href="#resetting-user-passwords" title="Permalink to this headline">¶</a></h2>
    <p>If a user forgets their password, an administrator can request a reset link to provide to the user.</p>
    <p>To send emails Anaconda Repository must have the <a class="reference internal" href="reference.html#repo-admin-reference-emails"><span>email settings</span></a> configured.</p>
    <ol class="arabic simple">
    <li>Go to the following url: <code class="docutils literal"><span class="pre">http://your.anaconda.repository:&lt;port&gt;/admin/resend_email/password_reset</span></code></li>
    <li>Select the &#8220;Password Reset&#8221; tab.</li>
    <li>Enter the user&#8217;s email address.</li>
    <li>The graphical user interface will generate a password reset link.</li>
    <li>Email the link to the user.</li>
    </ol>
    <p>Administrators can also reset passwords without sending emails:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span>anaconda-server-admin reset-password jsmith
    </pre></div>
    </div>
    <p>NOTE: Replace &#8220;jsmith&#8221; with the username whose password you want to reset.</p>
    </div>
    <div class="section" id="changing-a-user-s-storage-size-or-changing-their-plan-to-free-unlimited">
    <h2>Changing a user&#8217;s storage size or changing their plan to free unlimited<a class="headerlink" href="#changing-a-user-s-storage-size-or-changing-their-plan-to-free-unlimited" title="Permalink to this headline">¶</a></h2>
    <p>At [your repo]/admin/report choose &#8220;Accounts&#8221;, then the username, then &#8220;Update Storage&#8221; or &#8220;Set free unlimited plan&#8221;</p>
    <ol class="arabic simple">
    <li>Log into your Anaconda repository administrative account.</li>
    <li>Navigate to the following url: <code class="docutils literal"><span class="pre">http://your.anaconda.repository:&lt;port&gt;/admin/report</span></code></li>
    <li>Choose &#8220;Accounts&#8221;.</li>
    <li>Select the username of the user whose account you wish to change.</li>
    <li>To update the storage limits choose &#8220;Update Storage&#8221;.</li>
    <li>To set the user&#8217;s plan to free and unlimited choose &#8220;Set free unlimited plan&#8221;.</li>
    </ol>
    </div>
