Search

Accounts

Notes and considerations

  • Users must be created in the Active Directory by an AD administrator. Login Enterprise does not create users automatically.
  • You need account groups for all types of tests (Continuous, Load, and Application test environments). See below for instructions on creating account groups.

User creation guidelines

All the Login Enterprise users need to exist in Active Directory (AD) before configuring Virtual Users in Login Enterprise. We recommend creating users with a name followed by four digits, such as:

  • LoginEnt0001
  • LoginEnt0002
  • LoginEnt0003
  • LoginEnt0004
  • etc.

Users should be created using the principle of least privilege. Test accounts should be given the minimum access and permissions required to perform their tasks.

Creating Virtual Users and Groups

This section explains how to create Virtual Users and Groups that Login Enterprise will use to measure the various activities configured in the Manage Tests section.

Frame 293.png

To create a Virtual User account:

1. In the Login Enterprise sidebar menu, navigate to Configuration > Accounts.

Frame 286.png

2. In Accounts, click the green "+" on the top right to add a new account.

Frame 287.png

3. Enter the username of your choice.

4. Enter the password of your choice.

5. Specify the domain of the user account.

6. Optionally, enter the email address of the user account.

7. Optionally, specify any required custom fields.

8. Click Save.

Frame 288.png

Email field

You can save email addresses related to your accounts and use them later with custom connectors.

When filling out individual account information in the account configuration form, you can enter the email address in a dedicated additional field. This field is optional, so you can choose to leave it empty.

You can view and edit email information directly in the Accounts table:

Frame 607.png

Syntax

If you fill in the email incorrectly, an error message will inform you about the invalid input.

The following are valid examples of email entries:

The following are invalid examples of email entries:

Usage with Custom Connectors

You can add an email as an argument that will be passed when starting a new custom connector process during a Test. The email placeholder in the script will be replaced with the actual email value from the accounts added to the Accounts Group used in the Test.

For example:

CustomConnector.exe --email "{email}"

The email value can also be used in the place of username:

CustomConnector.exe --username "{email}"

Frame 608.png

You can also add email addresses when creating accounts in Swagger. Since this is optional, you can choose to omit the property.

To learn more about types of Connectors and connection options, see Connectors and connection configuration.

Custom fields (Optional)

Custom fields can enhance account configuration and are used with custom connectors similar to email, username, domain, and password fields. Here are key points to consider:

  • You can add up to five custom fields with editable values during account creation. These fields have immutable names.
  • Once added, custom fields cannot be edited directly in the table view. Instead, click the "pencil" icon in each row to open the account editing form with pre-populated fields, including any existing custom fields.
  • Custom fields can store various types of information, such as single digits, random text, or authentication tokens, but they are limited to 256 characters.

For more information on using custom fields with custom connectors, see the Custom fields.

Handling account credentials on the Launcher

For information on handling account credentials on the Launcher, see the Launchers: Overview and best practices.

Creating multiple accounts

You can create multiple accounts at once using the "Bulk Accounts" option. Here's how:

  1. Number of digits: Specify the incremental number format (e.g., 01, 001).
  2. Number of accounts: Indicate how many accounts you want to create.

When using this option, an example username and, if specified, an email will be generated based on your input. You can preview this information in the bottom left corner of the configuration screen.

The "Email" field is optional. If left empty, all generated accounts will have no email associated.

  • We do not verify the existence or accessibility of email templates or generated emails.
  • The system does not attempt to create actual emails in any form.
  • Email uniqueness is not enforced, so multiple accounts can have the same email address associated.

Bulk account creation

You can bulk-generate accounts with auto-generated emails using a specific email template. This template must be provided in the Email field on the Create Bulk Accounts screen.

Frame 609.png

Email template format

Each account will be created with an email based on the specified template. The logic mirrors username generation, where a number is added to the local part. An example email appears in the bottom-left corner of the screen next to the example username.

Frame 610.png

Email field

The Email field is optional for bulk account creation. If you leave it empty, all generated accounts will have no associated email.

Important notes

  • We do not verify the existence or accessibility of email templates or generated emails.
  • We do not create actual emails and do not enforce email uniqueness. Therefore, two accounts can share the same email address.
  • These actions are outside the system’s scope.

Creating Account Groups

Account groups allow you to grant specific users access to particular environments. You have two options for defining groups:

  • Selection: Choose individual accounts to include in the group.
  • Filter: Automatically include all accounts that match specific criteria.

The selection option requires you to manually pick accounts, while the filter option automatically includes accounts based on predefined criteria.

Frame 289.png

To create a Group: 

1. In Groups, click the green "+" to add a new group.

2. Choose either the filter or selection option.

3. Enter a group name of your choice.

4. Enter an optional description.

5. Click Add user account.

6. Select the user accounts to add to the user group.

7. Click Add.

8. Click Save.

Using Wildcards in Filter Groups

When using a filter group, you can utilize two wildcards:

  • ? (Question mark): Represents a single character wildcard.
  • * (Asterisk): Represents a multi-character wildcard.

See the screenshot below for an example.

Frame 292.png

Adding a Group to an Environment

1. In the Login Enterprise sidebar menu, navigate to Configuration > Environments.

2. In Environments, edit the environment where you want to attach the user group.

3. Click on "Account" to view the groups you've created.

4. Select the desired group.

5. Click Save.

Frame 291.png

Logon components

The Logon Components are crucial to the functionality of Login Enterprise. This part makes sure the software starts as soon as the user logs in.

To learn more about the logon components, see the Logon Components.

Account status

By default, Login Enterprise accounts are enabled. If an account experiences three consecutive errors, it will be automatically disabled.

You can manage account statuses in bulk starting from the accounts table. Follow these steps:

  • Select multiple accounts by ticking their checkboxes.
  • At the top of the table, the action panel will appear.
  • Use the buttons in the action panel to enable or disable the selected accounts.
    • Enable will be disabled (grayed out) if all selected accounts are already enabled.
    • Disable will be disabled if all selected accounts are already disabled. 

Frame 290.png

You can also enable/disable accounts via the API. For more information, see Accessing Public API.