Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

To improve login security, Abiquo supports two-factor authentication for the UI . 

The first step is to configure the platform to use 2FA.

...

User

...

Configuration steps

...

Systems administrator

...

Configure 2FA on the platform, including Abiquo Configuration properties. See below

...

Cloud administrator

...

Enable 2FA and define if 2FA is mandatory for users. See below

...

User

...

Optionally, enable 2FA if it is available on the platform.
See https://abiquo.atlassian.net/wiki/spaces/doc/pages/311370224/Starting+Abiquo+for+the+first+time#Use-two-factor-authentication.

Tip

When you enable the Abiquo OpenID Connect integration, Abiquo disables two-factor authentication.

...

Excerpt

Basic requirements of 2FA:

To adapt integrations and events:

To configure 2fa, customize properties and files on the Abiquo API server as required.
For more details, see Abiquo configuration properties

  1. Configure Google Authenticator with a property to set the name of the issuer of authentication codes.

    Code Block
    abiquo.2fa.issuer=Abiquo
  2. Configure the mail server with server.mail properties, including the sender with the from property.

    Code Block
    abiquo.server.mail.from=  
    abiquo.server.mail.password=none  
    abiquo.server.mail.port=25
    abiquo.server.mail.server=127.0.0.1  
    abiquo.server.mail.ssl=false
    abiquo.server.mail.tls=false
    abiquo.server.mail.user=none@none.es
    abiquo.server.mail.extra.{javax mail property}=  
  3. Optionally, change the length of time in seconds that the email codes will be valid for

    Code Block
     abiquo.2fa.email.timestep=60 
  4. For email authentication, you can customize the email message. See Customize email and SMS messages


Enable 2FA for the platform

To enable 2fa for the platform:

  1. Go to Configuration → Security

  2. Edit the options and select Enable two factor authentication

Image RemovedImage Added

Require 2FA for a tenant

To require 2fa for a tenant:

  1. Go to Users → edit Enterprise → General

  2. Select the checkbox to Require two-factor authentication for all users in the enterprise

Image RemovedImage Added

2FA for users

When two factor authentication is required, the user must enable it from the user icon menu.

If two-factor authentication is not required, the user can enable it for their own account from the user icon menu.

To remove the Two factor authentication option from the user icon menu, edit the client-config-custom.json file, and set the following property:

Code Block
client.2fa.activated=false

For more details, see Configure Abiquo UI.

For details of how the user must enable 2FA, see https://abiquo.atlassian.net/wiki/spaces/doc/pages/311370224/Starting+Abiquo+for+the+first+time#Use-two-factor-authentication.


Manage two factor authentication via the API

To require 2fa mandatory for a tenant, edit the enterprise and set the value of the twoFactorAuthenticationMandatory attribute to true.

To enable or disable 2fa for a user, post the authentication method to the action link of the user.

...