Skip to main content

Authentication

Fill in the information in the required fields.

Note

Fields marked with * are mandatory.

Two-factor authentication

company-2fa-july2022.PNG

Enforce two-factor authentication (Recommended)

Two-factor authentication (2FA) adds an extra layer of security to GravityZone accounts, by requiring an authentication code in addition to Control Center credentials.

2FA requires downloading and installing the Google Authenticator, Microsoft Authenticator, or any two-factor TOTP (Time-Based One-Time Password Algorithm) authenticator app - compatible with the standard RFC6238 - on the user's device. The device can be a smartphone or a computer.

  • Learn how to download and install Google Authenticator here.

  • Learn how to download and install Microsoft Authenticator here.

  • Learn how to configure an authenticator on your computer here.

The authentication app generates a six-digit code each 30 seconds. To complete the Control Center login, after entering the password, the user will have to provide also the six-digit authentication code.

Two-factor authentication is enabled by default when creating a company and this setting cannot be changed. At login, a configuration window prompts users to enable this feature. Users have the option to skip enabling 2FA for five times only. At the sixth login attempt, skipping the 2FA configuration is no longer possible and users are not allowed to log in.

Users trust their browsers. This option allows you to specify the period during which GravityZone remembers the browsers used for logging in to Control Center:

  • Select Never for users to enter the six-digit code from their authenticator every time they log in.

  • Select 1 to 90 days to allow users to skip entering the six-digit code for that specific period and log in directly to Control Center. To enable this option, users must also to select the Trust this browser check box on the GravityZone login screen.

    GZ-login-credentials.PNG

By default, one browsers corresponds to one device such as a computer. If users log in from another browser than the one remembered, they have to enter the six-digit code from authenticator. For details on scenarios where the Trust this browser option does not work, refer to this topic.

Note

  • You can view the 2FA status for a user account in the Accounts page.

  • If users cannot log in to GravityZone because of they a new device (phone or computer) or lost secret key, you can reset its two-factor authentication activation from the user account page, under Two-factor authentication section. For more details, refer to User Accounts.

  • Changing the period for remembering device reflects in user activity section of Control Center.

  • Regarding the public API, skip2FA is the parameter corresponding to Trust this browser option, used with createCompany and updateCompanyDetails methods. For details on how to use it, refer to createCompany and updateCompanyDetails.

Password expiry options

Set maximum password age to 90 days

This option enables the password expiration policy. Users need to change their passwords sooner than the specified age. Otherwise, they will not be able to log in to GravityZone anymore.

Lock out account after 5 login attempts with invalid passwords

This option limits the number of consecutive invalid passwords to prevent attacks. When the counter reaches the threshold, the account is locked out and the user needs to reset their password.

The policy applies to the accounts created in GravityZone.

A notification will be sent out to all company’s users when the account lockout option is being enabled on a certain company.

Configure single sign-on using SAML

GravityZone supports service provider (SP) initiated single sign-on (SSO) using SAML 2.0 as authentication standard. This method requires integration with a third-party identity provider (IdP) to authenticate GravityZone users. Tested identity providers include AD FS (2016 or later), Okta, and Microsoft Entra ID (formerly Azure AD).

The Authentication page provides two SSO configurations:

  • GravityZone Control Center single sign-on - Enables users to log in to GravityZone Control Center using their corporate identity provider credentials. Enter the identity provider metadata URL in the corresponding field.

    The GravityZone SAML metadata URL (read-only) value is used to configure GravityZone as a relying party in your identity provider.

  • Bitdefender services single sign-on - Enables users to log in to Bitdefender services outside Control Center (such as MDR portal) through the GravityZone IdP Proxy. Enter the identity provider metadata URL in the Identity provider metadata URL (IdP Proxy) field.

    The GravityZone IdP Proxy SAML metadata URL (read-only) value is used to configure the IdP Proxy as a relying party in your identity provider. This requires a separate SAML application in your identity provider.

gz_sso_authencation_page_cp_69938_en.png

For step-by-step configuration instructions, refer to Configuring single sign-on using a 3rd party identity provider.

To disable SSO, delete the identity provider metadata URL from the corresponding field. After disabling GravityZone Control Center SSO, users will automatically switch to logging in with GravityZone credentials. Users can obtain new passwords by clicking the Forgot password? link on the Control Center login page. After re-enabling SSO, you need to manually configure each account to use SSO again.

Important

You cannot use single sign-on (SSO) and two-factor authentication (2FA) at the same time in GravityZone.