Skip to content

How to Configure Login Methods in Encvoy ID#

In this guide, you will learn how to configure login methods in Encvoy ID, including standard OAuth providers and enhanced authentication methods (WebAuthn, mTLS, TOTP). We will also cover how to properly set up and design the authorization widget to make the login process secure and user-friendly.

Table of Contents:

Login Methods Overview#

A login method is an authentication method that allows users to authorize in their personal account or connected applications. It is a key element of the Single Sign-On (SSO) system, providing flexible and secure identification.

Types of Authentication Providers in Encvoy ID#

Encvoy ID supports the following types of login methods:

  • Basic methods: login and password, email,
  • External identity providers: social networks and other services,
  • Enhanced and passwordless methods: cryptographic authentication via mTLS (client certificates) and WebAuthn (biometrics, hardware keys), as well as TOTP/HOTP one-time passwords.

Management Levels and Publicity of Login Methods#

Login methods can be created in different types of Encvoy ID dashboards:

  • Organization Dashboard — company level;
  • Application Dashboard (ADM) — individual application level.

For login methods created at the organization level, you can configure publicity — determining exactly where they will be available.

Login Method Type Publicity Setting Where Available Management
Created in Organization Dashboard ✔ Yes All applications of this organization Managed only from the Organization Dashboard
Created in Application (Small Dashboard) ✘ No Only in this application Managed in Application Settings

Managing Login Methods#

Creating a New Login Method#

For most popular services, Encvoy ID provides ready-made templates with settings. They simplify the connection process as they contain pre-filled parameters specific to each provider.

The configuration process involves three steps:

  1. Preparation: obtain a Client ID and Client Secret from the provider service.

  2. Configuration in Encvoy ID: create a provider of the corresponding type.

    Refer to the specific instruction for configuring the selected provider:

Editing an Existing Login Method#

If you need to update the settings of an existing login method:

  1. Go to the Organization Dashboard or the settings of the corresponding application → Settings section.
  2. Click Configure in the Login Methods block.
  3. A window with a list of created login methods will open.

  4. Click the Configure button on the panel of the login method you want to edit.

    Editing a login method in Encvoy ID

  5. The editing form will open.

  6. Make the necessary changes.
  7. Click Save.

Deleting a Login Method#

  1. Go to the Organization Dashboard or the settings of the corresponding application → Settings section.
  2. Expand the Login Methods block.
  3. Click Configure.
  4. A window with a list of created login methods will open.

  5. Click the Delete button Delete Button located on the panel of the login method you want to delete.

    Deleting a login method in Encvoy ID

  6. Confirm the action in the modal window.

    Confirming login method deletion in Encvoy ID

After successful deletion, the login method will disappear from the widgets of all linked applications.

Copying Login Method Settings#

Copying settings allows you to create a new method based on a previously created one.

  1. Copy the login method settings using the Copy button Copy Button located on the login method panel.

    Copying login method settings in Encvoy ID

  2. Next, open the form for creating a new login method from a template of the same type and click Paste Paste Button.

⚠️ Note: If the types do not match, the new provider may not function correctly.

Configuring a Required Identifier in the User Profile#

Identifiers are external services that the user has added to their profile or through which they have previously logged into the system.

The list of identifiers available for addition is formed from the login methods in the Encvoy ID dashboard with an active publicity setting.

  • If a login method is configured as public, it will appear in the list of identifiers available for addition in the user profile.
  • Placing this login method on the application widget is optional — it can be available in the profile even without a button on the main login screen.
  • The user can also add an identifier during login via the widget if such a login method is available.

In Encvoy ID, you can configure a requirement for mandatory linking of an external account identifier to the user profile. In this case, when logging into the application, a user who does not have a linked identifier will be prompted to add one to their profile.

How to Make an Identifier Mandatory#

  1. Go to the Organization Dashboard or the settings of the corresponding application → Settings section.
  2. Expand the Login Methods block and click Configure.
  3. A window with a list of created login methods will open.

  4. Click the Make required button Make Mandatory Button on the panel of the login method you want to make mandatory.

    Mandatory login method in Encvoy ID user profile

The setting is applied without additional confirmation.

💡 Tip: Clicking the Make required button again will make the identifier optional in the profile.

Login Widget Settings#

What is the Login Widget?#

The login widget is the authorization form displayed to the user when they attempt to log into an application or the Encvoy ID system if they are not yet authenticated.

The widget supports:

  • classic login via username and password,
  • login via various providers,
  • flexible configuration of appearance and structure,
  • grouping of login methods.

In the widget, login methods are divided into:

  • Primary methods — displayed as separate buttons under the Log in button and are used most frequently.
  • Additional methods — placed in the Other providers block as compact buttons to avoid cluttering the interface.

Widget example:

Example of Encvoy ID login widget

💡 The login widget is the first thing a user sees during authorization, so it is important that it matches the company's visual style and is as clear as possible.

Configuring the Login Widget: Appearance and Buttons#

To configure the appearance of the widget:

  1. Go to the Organization Dashboard or the settings of the corresponding application → Settings section.
  2. Find the Login Methods block and click Configure.
  3. The Configure Widget Appearance window will open.

  4. In the first block, key visual elements are defined:

    • Widget Title — Displayed at the top of the form. To display the application name in the widget header, use the value APP_NAME.
    • Widget Cover — Background image of the authorization form.

    • Cover auto-substitution mode on application widgets:

      • Disabled — The application's cover is used,
      • Default — Only for applications without a cover,
      • Enforced — Applied to all applications.

  5. In the second block, configure the visibility of login form elements:

    • Show application logo on the widget — When enabled, displays the logo next to the application name.
    • Hide create account button — When enabled, hides the account creation button from the widget.
    • Hide footer — When enabled, hides the widget footer with the text "© 2015-2025".
    • Hide logos of main login methods — When enabled, hides the logos of login methods from the Primary group.

    Configuring Encvoy ID login widget appearance

  6. In the third block, configure button design:

    • Button background color — Color scheme for the button background (hex code).
    • Button font color — Color scheme for the button text (hex code).

    Configuring Encvoy ID widget button design

  7. If necessary, specify text:

    • Additional information field inside the form — Additional text that will be displayed at the bottom of the widget,
    • Additional field outside the widget — Additional text that will be displayed below the widget.

    Configuring additional text in Encvoy ID login widget

    The fields support HTML5 code insertion with full semantic markup, including embedded and inline CSS styles. The use of the script tag is prohibited. Upon saving, any script tag (including its content and attributes) will be automatically removed from the field at the database level.

  8. Click Save to apply the changes.

    💡 You can view the results of the changes in the Preview section.

Adding and Disabling Login Methods on the Widget#

To configure the display of a login method in the widget:

  1. Go to the Organization Dashboard or the settings of the corresponding application → Settings section.
  2. Find the Login Methods block and click Configure.
  3. Enable or disable the toggles for the desired login methods.
  4. If necessary, configure login method groups.

⚠️ Note:

  1. It is impossible to disable the Login/password method. If all login methods are disabled, the Login/password method is automatically enabled, as the widget must have at least one method for logging in.
  2. Disabling a login method from the widget does not delete the login method from the system.

See Also#