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 user interface to improve login security. UI . 

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


and enable it in the UI, you can define if 2FA is mandatory for each tenant.

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.

...

Configure 2FA on the platform

Excerpt

To configure 2FA authentication system do these stepsBasic requirements of 2FA:

  • Synchronize system times because two-factor codes are dependent on the system time

For a multi-datacenter configuration, configure Appliance manager for template upload and download.
The Appliance manage

To adapt integrations and events:

  • For each enterprise that requires 2FA, migrate automation and integrations to OAuth

, see 

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 properties. Set with a property to set the name of the issuer of authentication codes. See Abiquo configuration properties and search for “2fa”.

    Configure email authentication properties:

    Set the email server configuration

    .

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

    "

    from

    " property. See Abiquo configuration properties and search for “server”.Set the length of time

    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

    . See Abiquo configuration properties and search for “2fa”.

    Code Block
     abiquo.2fa.email.timestep=60 
  4. For email authentication, you can edit customize the email message. See Configure custom platform messages

Troubleshooting two-factor authentication

Check server date and time synchronization as part of the user issue troubleshooting process.
  1. 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 may optionally can enable it for their own account from the user icon menu.

info

To

disable the display of the two factor authentication item in the 

remove the Two factor authentication option from the user icon menu,

the administrator can set the 

edit the client-config-custom.json file, and set the following property:

Code Block
client.2fa.activated
 property to false in the UI configuration.
See 
=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.

...