Abiquo Documentation Cookies Policy

Our Documentation website uses cookies to improve your experience. Please visit our Cookie Policy page for more information about cookies and how we use them.


Abiquo 4.7

Skip to end of metadata
Go to start of metadata





You can configure your user account from the Username menu. The menu options will depend on the platform configuration.

To access the Username menu, click on your User name or the User icon in the top right-hand corner of the screen.

Username menu to configure your user account


Tip: To disable this menu for all users, go to ConfigurationSecurity, and clear the Allow user to change their password checkbox




Edit your user account details

To edit your user account, click on the User name or User icon in the top right-hand corner of the screen, and select Edit user from the pull-down menu.

Abiquo recommends that you change your Password and update your user details, especially your E-mail address and Phone number, which can be used for notifications and authentication.

You can also add your Public key for access to deployed virtual machines.



Enable two factor authentication

Your platform may offer or require two-factor authentication (2fa) to improve user login security with an additional authentication code. For platform configuration instructions, see Configure two factor authentication.

Before you begin:

  • To use Google Authenticator to obtain the codes, install the Google Authenticator app on your cell phone. 
  • To use email authentication to obtain the codes, check that you have a valid email address in your user account on the platform.

To enable two-factor authentication for your user account, do these steps:

  1. Click on the User name or User icon in the top right-hand corner of the screen, and select Two-factor authentication from the pull-down Username menu.
    From the username menu, select enable two-factor authentication
  2. Select the authentication method and click Enable
  3. Copy the Backup codes from the bottom left-hand corner of the configuration window to a secure place. You can use these codes to log in to the platform if the authentication cycle fails

    The platform will display backup codes ONCE only

  4. Authenticate according to your selected method
    • For Google Authenticator, use the Google Authenticator app on your cell phone to scan the QR code. Google will supply a verification code in the app. During login, the platform will request the Authentication code from the app. 
    • For email, during login, every time you enter your user name and password to log in, a code will be sent to the E-mail address registered in your user account. Enter the Authentication code in the Login dialog
 Click here to show/hide the screenshots

Screenshot: Enabling two factor authentication

Two-factor authentication popup to select authentication method

Screenshot: Two factor authentication with backup codes (left) and QR code (middle)

Example of backup codes and QR code for two-factor authentication

Screenshot: Login with two-factor authenticationLogin with two-factor authentication



Edit public cloud credentials for your enterprise

To work with a public cloud region, each enterprise should have its own public cloud account for the cloud provider. All the users in the tenant will work with this same account. 

Before you begin:

  1. Check your provider's documentation and pricing. 
  2. Obtain credentials to access the cloud provider's API. We provide the following basic guides but you should always check with your provider. See Obtain public cloud credentials

    Privilege: Manage provider credentials

To add public cloud credentials:

  1. Go to Users → select and edit enterprise → Credentials → Public
  2. Enter the Credentials as described here

    AttributeDescription
    ProviderSelect public cloud provider or vCloud Director region. Some providers may require different credentials for groups of regions, for example, "Amazon (CHINA)". If a specific provider does not display, for example, a vCloud Director region, the cloud administrator may need to allow access for your enterprise.
    Access key ID

    Identity to access the cloud provider API. For example, a username, API access key ID, subscription ID and certificate, or another account identifier. For DigitalOcean v2, the platform does not use this field but you need to write something in to enable the button Add account after.

    For Azure, the format is subscription-id#app-id#tenant-id

    Secret access keyKey to access the cloud provider API. For example, an API key or other API credential.

    For DigitalOcean v2 enter the token.

    Also use for pricingUse this credential to access pricing data in the provider. For example, to get hardware profile prices from AWS. For Azure, add a separate pricing credential.
    Current credentialsProvider credentials that are already in the platform
  3. Click Add account. The platform will validate your credentials with the cloud provider and save them
  4. Finish editing the enterprise and click Save




Add an application for OAuth

For OAuth applications, users can add applications, display keys, inspect the privileges assigned to the application, and delete the application.

Privilege: Manage user applications

To add an OAuth application:

  1. Click on the User name or User icon in the top right-hand corner of the screen to open the Username menu 
  2. Select Manage applications
  3. Click the + button
  4. Enter the Name and Description of the application
    Popup to add application for OAuth authentication
  5. To set the privileges of the application, go to Privileges. By default, all of the user's privileges are selected for the application. We recommend that you go to Privileges and remove any unnecessary privileges
    Add privileges to OAuth applications
  6. Click Save

Abiquo will add the new application to the Applications list and display the API key and an API secret key. Copy the API key and API secret key to a secure storage area.

View keys and privileges assigned to OAuth application