Brinkster Knowledge Base

KB Home   /  Support  /  Brinkster Cloud Services  /  Reference Articles - Using BCS  /  Creating and Managing Resources  /  SSH Keys  /   Managing an SSH Key
Managing an SSH Key Articles
To manage an SSH key:

  1. Show the Resources page by clicking the Resources link in the top right hand corner of the screen.
     
  2. Click on the Security tab.

     
  3. On the SSH Keys widget, click the Manage button next to the SSH key you want to manage.


    The Manage SSH Key dialog box is displayed.

     

  4. Do one or more of the following:

    To
    Do this
    Change the name, username, or public key of the SSH keyEdit the details as required and click the Save button.

    Change whether the SSH key is automatically added to the metadata of all new virtual machines created in your customer account

    To use an SSH key to access a virtual machine, the SSH key must be extracted from the virtual machine's metadata. The easiest way to ensure that this happens is to add the SSH key to the server's metadata before the virtual machine is first booted. The firstboot script should then extract the SSH key from the virtual machine's metadata.

    1. Do one of the following:
      • To automatically assign the public key to the metadata of all new virtual machines created in your customer account, select Yes from the Global? drop down menu. All virtual machines that you create after creating the SSH key have the public key added to their metadata. 
      • To require the public key to be manually added to to the metadata of newly created virtual machines, selectNo from the Global? drop down menu. To add an SSH key to the metadata of a virtual machine, manage the appropriate virtual machine.

      Whether or not your SSH key is automatically added to the metadata of newly created virtual machines, it must still be added manually to the metadata of existing virtual machines.

    2. Click the Save button.
    Delete the SSH keyClick the Delete button.
    Duplicate the SSH keyClick the Duplicate button.
    Add the SSH key to a new or existing deployment instance
    1. Click on the Deployment Instance section.
    2. Do one of the following:
      • To add the SSH key to an existing deployment instance: 
        1. Select Existing Deployment Instance from the Add todrop down menu.
        2. Select the name of the required deployment instance from the Instance drop down menu.
      • To add the SSH key to a new deployment instance:
        1. Select New Deployment Instance from the Add to drop down menu.
        2. Enter the name to give the new deployment instance in the Name text box.
    3. Click the Save button.
    View and manage jobs associated with the SSH keyClick on the Jobs section. To manage a job, click the Manage button next to it.
    View and manage the related resources and UUIDs for the SSH key
    1. Click on the Related Resources and UUIDs section. 
    2. To manage a related resource or UUID, click the Manage button next to it.
    View any customer keys associated with the SSH key and add more if required
    1. Click on the Customer Keys section. 
    2. To add a customer key, enter the required details and click the Add button.
      For more information about keys, see Keys. (edit link)
    Edit the permissions for the SSH keyClick on the Permissions section. 

    Permissions are set using the following fields:
    • Permission - Whether to allow or deny the user or group the ability to perform the action specified using the Capability drop down menu.
    • Type - Whether the permission applies to a group, or an individual user.
    • User/Group - The user or group to which the permission applies.
    • Capability - The action that the user or group is specifically allowed or denied the ability to perform.
    • Resource - The type of resource that the Capability pertains to, for example server, disk, or user.
  5. Once you have finished managing the SSH key, close the Manage SSH Key dialog box by clicking the Done button.