Page Comparison

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

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

• Configure the Appliance manager to use HTTPS

  • See Configure Abiquo Tomcat with HTTPS for Remote RS

For

integration and events requirements, see below.

To configure 2FA, customize properties and files, and enable it on the platform:

1. Log in to the Abiquo API Server

2. Go to /opt/abiquo/config and edit the abiquo.properties file. For full details about any Abiquo property see Abiquo configuration properties

3. For Google Authenticator

   1. set the property with the name of the issuer of authentication codes.

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

   Configure email authentication properties:

   1. Set the email server configuration

      Code Block
      abiquo.2fa.issuer=Abiquo

4. For email:

   1. 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 You can also set custom properties by replacing {javax mail property}with a property name.

      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}=

   2. Optionally, change the length of time in seconds that the email codes will be valid for. See Abiquo configuration properties and search for “2fa”.

5. For email authentication, you can edit 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.

Enable 2FA for the platform

1. 1. Code Block
      abiquo.2fa.email.timestep=60

   2. To customize the email message, see Customize emails for two factor authentication

2. In Abiquo, enable two-factor authentication for the platform:

   1. Go to Configuration → Security

   2. Edit the options and select Enable two factor authentication

Image Removed

Image Added

Requirements for integrations:

• For each enterprise that uses 2FA, migrate automation and integrations to OAuth. See Authentication#OAuthv1.0VersionAAuthentication.

• To implement two-factor authentication for a portal, see Authentication

Requirements for events and event streaming:

• if the M-user belongs to a tenant that must use 2FA, configure the M-user to use OAuth.

• Enter the OAuth credentials in the Abiquo properties file. See Abiquo configuration properties and search for .m. See Authentication#OAuthv1.0VersionAAuthentication. 

Require 2FA for a tenant

To require 2fa for configure a tenant so that all the users must work with two-factor authentication:

1. Go to Users → edit Enterprise →

2. Edit an enterprise and go to General

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

Image Removed

1. Click Save

Image Added

2FA for users

When a user’s enterprise requires two-factor authentication is required, the user must enable it from the user icon menu.

If Even if the enterprise does not require two-factor authentication is not required, the user may optionally can enable it for their own account from the user icon menu.

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.

Image Added

Remove the option for users to enable 2fa

By default, the option to enable 2fa appears in the user icon menu. To remove the Two factor authentication option, edit the client-config-custom.

Image Removed

json file, and set the following property:

client.2fa.activated=false

For more details, see Configure Abiquo UI.

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.