=====================
Managing Your Account
=====================

.. 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/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/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/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 class="std std-ref">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>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>
    <p>SEE ALSO: Separate permissions per package, notebook
    or environment may also be managed by creating
    <a class="reference internal" href="using.html#repo-creating-orgs"><span class="std std-ref">Organizations</span></a> or <a class="reference internal" href="using.html#repo-org-groups"><span class="std std-ref">Groups</span></a>.</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-default"><div class="highlight"><pre><span></span><span class="n">https</span><span class="p">:</span><span class="o">//&lt;</span><span class="n">your</span><span class="o">-</span><span class="n">anaconda</span><span class="o">-</span><span class="n">repo</span><span class="o">&gt;/&lt;</span><span class="n">channel</span><span class="o">&gt;/</span><span class="n">settings</span><span class="o">/</span><span class="n">access</span>
    </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/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-default"><div class="highlight"><pre><span></span><span class="n">anaconda</span> <span class="n">auth</span> <span class="o">--</span><span class="n">create</span> <span class="o">--</span><span class="n">name</span> <span class="n">YOUR</span><span class="o">-</span><span class="n">TOKEN</span><span class="o">-</span><span class="n">NAME</span> <span class="o">--</span><span class="n">scopes</span> <span class="s1">&#39;repos conda:download&#39;</span>
    </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-default"><div class="highlight"><pre><span></span><span class="n">conda</span> <span class="n">config</span> <span class="o">--</span><span class="n">add</span> <span class="n">channels</span> <span class="n">https</span><span class="p">:</span><span class="o">//</span><span class="n">conda</span><span class="o">.</span><span class="n">anaconda</span><span class="o">.</span><span class="n">org</span><span class="o">/</span><span class="n">t</span><span class="o">/&lt;</span><span class="n">token</span><span class="o">&gt;/&lt;</span><span class="n">channel</span><span class="o">&gt;</span>
    </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-default"><div class="highlight"><pre><span></span><span class="n">https</span><span class="p">:</span><span class="o">//&lt;</span><span class="n">your</span><span class="o">-</span><span class="n">anaconda</span><span class="o">-</span><span class="n">repo</span><span class="o">&gt;/&lt;</span><span class="n">channel</span><span class="o">&gt;/</span><span class="n">settings</span><span class="o">/</span><span class="n">access</span>
    </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-default"><div class="highlight"><pre><span></span><span class="n">anaconda</span> <span class="n">auth</span> <span class="o">-</span><span class="n">r</span> <span class="n">YOUR</span><span class="o">-</span><span class="n">TOKEN</span><span class="o">-</span><span class="n">NAME</span>
    </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 class="std std-ref">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>
