Editing your account
=====================

To edit your account settings, click your name or email address at the
top-right corner of any page, then click Account.

|image0|

This loads a page with three tabs:

 * Account
 * Groups & Permissions
 * SSH Keys

Account
--------

The Account tab has options for changing your account details, password,
and space.

Account fields
^^^^^^^^^^^^^^^

First name
+++++++++++

Your first name.

Last name
++++++++++

Your last name.

Email
++++++

Your email address.

Role
+++++

This value describes your role in the management application. It can
only be set by an administrator.

Notify on aggregator failover
++++++++++++++++++++++++++++++

If checked, you will be sent an email when an aggregator fails or
recovers, if the aggregator is in your home space or a descendant of
your home space. You do not receive notifications from aggregators
assigned a space above your home space.

Password
+++++++++

To change your password, provide your current password in the proper
field, type your new password twice, and click Change Password.

Space
++++++

The space control allows you to set your effective space. This allows
you to pretend as if your account is assigned to a child space of your
actual home space, using the child space's branding options and being
limited to only seeing objects within that space.

You can reset your current space to your home space at any time using
this control.

You are able to view and manage resources within your current space and
its descendant spaces.

Groups & Permissions
---------------------

The Groups & Permissions tab shows the names of the groups to which your
account is assigned, as well as the permissions granted to your account
due to your group membership.

Your permissions are the same within every space to which you have
access. For example, if you have permission to add and update
aggregators in your home space, you have that permission even if you set
your effective space to a child space.

SSH Keys
---------

The SSH Keys tab allows you to view and control the keys you can use to
access nodes.

Adding a New Key
^^^^^^^^^^^^^^^^^

1. Generate a new key using `ssh-keygen`
2. Copy your public key using `xclip -sel clip < ~/.ssh/id_rsa.pub`
3. Paste into the text area under the 'Add Key' header
4. Press the 'Save' button to add the key to your account

Account Keys
^^^^^^^^^^^^^

Your active keys are listed under the 'Account Keys' header. The first
column shows the set comment for each key. The second column is an MD5
hash representation of the key.

Clicking the trash icon on the far right will delete the key. If you
need to use a key that you previously deleted just re-add the key using
the 'Add Key' text area.

.. |image0| image:: /attachments/1639444/11667827.png
