Chat now with support
Chat with Support

Toad Intelligence Central 3.3 - Deployment Guide

Add New Users and Groups

You are here: Users and Groups

New users and groups can be added to Toad Intelligence Central. Which user role is required before adding new users is dependent on how Intelligence Central is configured.

To enable/disable self-registration, specify who can add new users, and configure other registration parameters, see Configure New User Registration.

Use the following icons to identify the type of user or group wherever users/groups are displayed, for example the Users or Groups pages. Review the following descriptions.

Types of Users

Icon Description

Active Directory® Users

To self register from a web browser, click Register as a new user at the login prompt. The computer you use to login to Toad Intelligence Central must be accessible to your Windows® domain. This option is visible only if your local configuration allows self registration via a web browser.

To register new users post login, see Add Active Directory Users and Groups. Your local configuration may require login with an Administrator role to add Active Directory users. See Configure New User Registration.

Intelligence Central Users

To self register from a web browser, click Register as a new user at the login prompt. Deselect the option to Use my Active Directory details. Fill in your user details. The options in this procedure may not be visible or selectable, depending on your local configuration. Your local configuration may not allow self registration from a web browser or registration of new Intelligence Central users.

Following login to Intelligence Central from a web browser, to add users, select Administration | Users | Add User | Create Intelligence Central user. The availability of these steps depends on your Intelligence Central configuration.

Types of Groups

Icon Description

Active Directory Groups

Following login to Intelligence Central from a web browser, to add a group from Active Directory, select Administration | Groups | Add Group | Add Active Directory Group. See Add Active Directory Users and Groups.

Your Intelligence Central configuration may require login with an Administrator role to add Active Directory groups. See Configure New User Registration.

Intelligence Central Groups

Any logged in user can create an Intelligence Central group. For more information, see Create Intelligence Central Groups.

Add Active Directory Users/Groups

You are here: Add New Users and Groups > Add Active Directory Users and Groups

Users with certain privileges can add new users and groups to Toad Intelligence Central by importing users/groups from Active Directory®. Which type of user (role) is allowed to add new users is dependent on how Intelligence Central is configured. See Configure New User Registration for more information.

To add Active Directory User or Group using the Web interface

  1. Use a web browser to log in to Intelligence Central. For more information, see Log In From a Web Browser.
  2. Click Administration and then select either Users or Groups.
  3. Then select Add User | Add Active Directory User or Add Group | Add Active Directory Group.
    • If the Authenticate to Active Directory dialog opens, enter the credentials for your Active Directory account (including the domain name) in order to access a list of domains and users. See Authenticate to Active Directory for more information.
  4. In the Add Users and Groups from Active Directory dialog, select the users/groups to add to Intelligence Central. See Add from Active Directory for more information.

 

Requirements

  1. The Toad Intelligence Central server host must be in a valid Windows® domain.
  2. If the Windows domain of the Toad Intelligence Central host and the Windows domain of the user are different then a two-way trust relationship must exist between the Windows domains.

Known issues and Limitations

Users and groups imported from Active Directory are given the same name in Intelligence Central.

Review the following known issues and limitations.

Issue More information

Duplicate names

If an Active Directory name already exists on Toad Intelligence Central then that Active Directory name is not imported. You will be notified of any users and groups who cannot be imported.

Long Active Directory usernames

For Active Directory usernames longer than 16 characters, the Intelligence Central username will be a truncated form of the Active Directory name.

If the Active Directory username has a numeric suffix then up to three digits of that numeric suffix is preserved. For example, Active Directory username very_long_username12 transforms to Intelligence Central username very_long_user12.

Active Directory names containing characters not allowed by Toad Intelligence Central

Active Directory names containing the following characters cannot be imported to Intelligence Central. You will be notified of any users and groups who cannot be imported.

  • Forward slash (/)
  • Backward slash (\)
  • Left square bracket ([)
  • Right square bracket (])
  • Colon (:)
  • Semicolon (;)
  • Vertical bar (|)
  • Equal sign (=)
  • Plus sign (+)
  • Asterisk (*)
  • Question mark (?)
  • Left angle bracket (<)
  • Right angle bracket (>)
  • Double quote (")
  • At symbol (@)
  • Comma (,)

Active Directory supports sub groups (groups within groups). Intelligence Central does not.

When importing an Active Directory group with sub groups the sub groups and users in sub groups are not imported to Intelligence Central.

Authenticate to Active Directory

You are here: Add New Users and Groups > Add Active Directory Users/Groups > Authenticate to Active Directory

Use the Authenticate to Active Directory dialog to enter your Active Directory credentials in order to access a list of domains and users when attempting to add Active Directory users (or groups) to Intelligence Central.

To authenticate to Active Directory

  • In the Authenticate dialog, enter the following information:

    Field Description
    Domain A domain in the Active Directory forest.
    Username Your username to that domain.
    Password Your password to that domain.

    Remember these credentials on server for future Active Directory access and synchronization—Select this option to instruct Intelligence Central to do the following:

    • Automatically and regularly synchronize imported Active Directory users and groups. For more information, see Synchronize Active Directory.

    • Cache Active Directory user and group data on Toad Intelligence Central. This has the potential to improve performance of Toad Intelligence Central when looking up Active Directory users and groups.

    If you do not select this option, the list of imported users and groups might not be kept in sync with Active Directory.

    To view a list of domains configured for Active Directory synchronization, in the Web interface go to Administration | Server | Users. Log in with Administrator role is required to view this information. You can also change the credentials used for synchronization from this page. See Synchronize Active Directory for more information.

Add from Active Directory

You are here: Add New Users and Groups > Add Active Directory Users/Groups > Add from Active Directory

This dialog is used to add users and groups from Active Directory® to Toad Intelligence Central.

To add users/groups from Active Directory

  1. In the Add Users/Groups from Active Directory dialog, select a domain from the drop-down list. Intelligence Central retrieves the list of users in that domain.
  2. You can filter the list by entering a partial text string in the text box.
  3. To refresh the list, click Refresh. The refresh option is available only for domains that are selected for synchronization in Intelligence Central. See Synchronize Active Directory for more information.

    Note: This process could take several minutes, depending on the size of the domain.

  4. If the domain you want to view is not listed, click Add Domain.
    • Enter the name of the domain to add. Then enter credentials for an account in that domain. Click Authenticate. See Authenticate to Active Directory for more information.
  5. Select available Active Directory users/groups and move them to the users/groups to be added list.

    TIPs:

    • Use SHIFT to select multiple users/groups in sequence. Use CTRL to select multiple users/groups not in sequence.
    • The number of Active Directory users displayed is limited to 10,000. For domains containing more than 10,000 users, a message informs the user that the list is not displayed in full. To find users not displayed, use the search box.
    • Enter a name or partial text string in the search box to filter the list of users and groups. Intelligence Central returns users that contain matching text in the username or full name fields. Clear the search box to clear this filter.
  6. Click Add Users to add the users/groups to Intelligence Central.

    When a group is added, an Active Directory user account is created on Toad Intelligence Central for anyone in the group who does not already have an account on Toad Intelligence Central (in addition to the group account).

  7. A Success message displays if the users were successfully added.

Related Documents