================================
Managing Your Account (AER 2.28)
================================

.. raw:: html

    <div class="section" id="personal-accounts">
    <h2>Personal accounts<a class="headerlink" href="#personal-accounts" title="Permalink to this headline">¶</a></h2>
    <div class="section" id="overview">
    <h3>Overview<a class="headerlink" href="#overview" title="Permalink to this headline">¶</a></h3>
    <p>This section explains how to create a new account, log in
    and out, and access the settings and features of different types of
    accounts.</p>
    </div>
    <div class="section" id="create-new-account">
    <h3>Create new account<a class="headerlink" href="#create-new-account" title="Permalink to this headline">¶</a></h3>
    <p>All Anaconda Repository users can find, download and use packages without logging in.</p>
    <p>You&#8217;ll need an Anaconda Repository account to:</p>
    <ul class="simple">
    <li>access private packages that are shared with you, or</li>
    <li>author packages (optional).</li>
    </ul>
    <p>To sign up for a new Anaconda Repository user account:</p>
    <p>If your administrator sent you an email with a login address, username
    and password, use that. Otherwise,</p>
    <ul class="simple">
    <li>In a browser, go to the address your administrator gave you.</li>
    <li>Make sure the Sign Up tab is active.</li>
    </ul>
    <p>NOTE: There&#8217;s also a Sign In tab for existing users to sign in.</p>
    <p><img alt="Anaconda Repo home page" src="../../../_images/anaconda-repository/2.28/repo-home.png" /></p>
    <ul class="simple">
    <li>Select a username.</li>
    <li>Enter your email address.</li>
    <li>Create a password. NOTE: The password must be at least 7 characters
    long.</li>
    <li>Enter the password again to confirm it.</li>
    <li>Read and accept the Terms and Conditions.</li>
    <li>Click the Sign up button. The system creates your user account, logs
    you in, and brings you to your personal Dashboard.</li>
    </ul>
    <p>TIP: Anaconda Repository can display a profile photo if you are connected to
    the internet and the email address you used to register is associated
    with a Gravatar account. Go to <a class="reference external" href="http://gravatar.com">gravatar.com</a>
    to associate your email address or to change your Gravatar profile photo.</p>
    <p>While you&#8217;re logged into Anaconda Repository, the Profile pull-down menu will
    appear at the top right of every page. This indicates the name of the currently
    active user or organization.</p>
    <p><img alt="Anaconda Repo user toolbar" src="../../../_images/anaconda-repository/2.28/repo-managing-toolbar-bar.png" /></p>
    <p>The far left button is the Tools pull-down menu. The Tools menu contains the following options:</p>
    <ol class="arabic simple">
    <li>Landscape - Your home page.</li>
    <li>View All - All packages, notebooks and environments you have created.</li>
    <li>Packages - Only packages you have created.</li>
    <li>Notebooks - Only notebooks you have created.</li>
    <li>Environments - Only environments you have created.</li>
    <li>Favorites - Packages from other users you have starred</li>
    <li>Organizations - Link to create a new organization</li>
    <li>Group Membership - If you are part of an organization, the groups you can access.</li>
    <li>Labels - Labels you have created, for example test or development. See
    documentation for additional information.</li>
    </ol>
    <p><img alt="Anaconda Repo toolbar menu" src="../../../_images/anaconda-repository/2.28/repo-managing-toolbar-menu.png" /></p>
    <p>Packages, notebooks and environments that you have created with this account
    appear on this Dashboard.</p>
    <p>See Also: <a class="reference internal" href="using.html#repo-using-packages"><span>Working with Packages</span></a></p>
    </div>
    <div class="section" id="reset-password">
    <h3>Reset password<a class="headerlink" href="#reset-password" title="Permalink to this headline">¶</a></h3>
    <p>The Sign In screen offers two links to help regain access to your
    account:</p>
    <ul class="simple">
    <li><strong>I forgot my username.</strong> Click this link to have the username
    emailed to the email address of record.</li>
    <li><strong>I forgot my password.</strong> Click this link to have a reset password
    link sent to the email address of record. NOTE: The reset password
    link expires within 24 hours. If you no longer have access to the
    email account, ask your administrator for assistance.</li>
    </ul>
    </div>
    <div class="section" id="control-access">
    <span id="repo-using-tokens"></span><h3>Control access<a class="headerlink" href="#control-access" title="Permalink to this headline">¶</a></h3>
    <p>The best way to manage access is to create
    <a class="reference internal" href="using.html#repo-creating-orgs"><span>Organizations</span></a> or <a class="reference internal" href="using.html#repo-org-groups"><span>Groups</span></a>,
    which allow you to set separate permissions per package, notebook or
    environment.</p>
    <p>You can also control access with the token system.</p>
    <p>An access control token is a random alphanumeric token string
    that is inserted into a URL that you give to another
    Anaconda Repository user. The token allows them to download a
    package that you have marked private. Only those users with the
    correct access token can access the private file.</p>
    <p>You can use tokens to control access to private repositories,
    collections, or packages on Anaconda Repository. The degree of
    access a token grants is completely configurable when you
    generate it.</p>
    <p>Multiple tokens can be generated to control which groups
    of users have access to certain features if they have the
    appropriate token.</p>
    <p>NOTE: Tokens provide access to ALL packages in a
    specified channel.</p>
    <div class="section" id="generating-tokens">
    <h4>Generating tokens<a class="headerlink" href="#generating-tokens" title="Permalink to this headline">¶</a></h4>
    <p>Tokens may be generated using the user interface, or from
    the command line using Anaconda client.</p>
    <p><strong>Method 1.</strong> Use the Web User Interface. Go to:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span>https://&lt;your-anaconda-repo&gt;/&lt;channel&gt;/settings/access
    </pre></div>
    </div>
    <p>NOTE: Substitute the address your administrator gave you for
    &lt;your-anaconda-repo&gt;.</p>
    <p>Select a name for the access token and set the required scope:</p>
    <p><img alt="Anaconda Repo tokens" src="../../../_images/anaconda-repository/2.28/repo-tokens.png" /></p>
    <p>By default, tokens will expire after one year.</p>
    <p><strong>Method 2.</strong> Generate a token using Anaconda client. Open your
    terminal window and enter:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span>anaconda auth --create --name YOUR-TOKEN-NAME --scopes &#39;repos conda:download&#39;
    </pre></div>
    </div>
    <p>The token in this example provides access to download any of
    your private conda repositories. It can be enabled with the
    <code class="docutils literal"><span class="pre">conda</span> <span class="pre">config</span></code> command:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span>conda config --add channels https://conda.anaconda.org/t/&lt;token&gt;/&lt;channel&gt;
    </pre></div>
    </div>
    <p>Scopes may be provided as a space separated quoted list. The available scopes are</p>
    <ul class="simple">
    <li><code class="docutils literal"><span class="pre">all</span></code>: Allow all operations</li>
    <li><code class="docutils literal"><span class="pre">api</span></code>: Allow all API operations</li>
    <li><code class="docutils literal"><span class="pre">api:modify-group</span></code>: Allow addition and modification of groups</li>
    <li><code class="docutils literal"><span class="pre">api:read</span></code>: Allow read access to the API site</li>
    <li><code class="docutils literal"><span class="pre">api:write</span></code>: Allow write access to the API site</li>
    <li><code class="docutils literal"><span class="pre">conda</span></code>: Allow all operations on Conda repositories</li>
    <li><code class="docutils literal"><span class="pre">conda:download</span></code>: Allow private downloads from Conda repositories</li>
    <li><code class="docutils literal"><span class="pre">pypi</span></code>: Allow all operations on PyPI repositories</li>
    <li><code class="docutils literal"><span class="pre">pypi:download</span></code>: Allow private downloads from PyPI repositories</li>
    <li><code class="docutils literal"><span class="pre">pypi:upload</span></code>: Allow uploads to PyPI repositories</li>
    <li><code class="docutils literal"><span class="pre">repos</span></code>: Allow access to all package repositories</li>
    </ul>
    <p>NOTE: A pre-existing token cannot be changed. You must revoke the token,
    then create a new one.</p>
    </div>
    <div class="section" id="revoking-tokens">
    <h4>Revoking tokens<a class="headerlink" href="#revoking-tokens" title="Permalink to this headline">¶</a></h4>
    <p>Tokens can be revoked from the user interface as follows:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span>https://&lt;your-anaconda-repo&gt;/&lt;channel&gt;/settings/access
    </pre></div>
    </div>
    <p>NOTE: Substitute the address your administrator gave you for
    &lt;your-anaconda-repo&gt;.</p>
    <p>or by using Anaconda client:</p>
    <div class="highlight-python"><div class="highlight"><pre><span></span>anaconda auth -r YOUR-TOKEN-NAME
    </pre></div>
    </div>
    </div>
    </div>
    </div>
    <div class="section" id="organization-accounts">
    <h2>Organization Accounts<a class="headerlink" href="#organization-accounts" title="Permalink to this headline">¶</a></h2>
    <p>Users can create <a class="reference internal" href="using.html#repo-organizations"><span>Anaconda Repository organizations</span></a>.
    Create an organization to:</p>
    <ul class="simple">
    <li>Share packages, environments or notebooks under an organization&#8217;s
    account rather than your personal account</li>
    <li>Assign multiple account administrators</li>
    <li>Assign different access permissions to groups of users and customize
    per-package access by group</li>
    </ul>
    </div>
