DriveWorks Pro 17: Login [send feedback...]

Login Module

The Login module provides a login box for access to the Projects within the loaded Group.

The credentials to login to the Group are taken from the Security Settings applied in DriveWorks Administrator

DriveWorks will always require a valid login to gain access to the Projects, however this module can be copied and modified to provide pre-population of the credentials fields, or to auto-login.

This module appears by default on the Specify Page (see Default Web pages section in the topic Modules)

Editing The Login Module

The module can have the following settings applied:

  • Next Page after Logon- Default value is blank this will navigate to the Home page when Cancel is selected from the Specification Navigation Module.
  • Default Username - Enter a Username that exists in Security Settings if the login module is to be pre-populated with credentials for unregistered users (for example a Guest account).
  • Default Password - Enter a valid Password for the Username above if the login module is to be pre-populated with credentials for unregistered users (for example a Guest account).
  • Authentication
    • Standard DriveWorks Authentication (Default) - Uses the authentication as administered in Security Settings.
    • Mapped Active Directory Authentication - Uses Active Directory authentication.

To access settings for the Login module:

1. Start Personal Web Edition or DriveWorks Live and Login when the Login page appears in your browser.2. Navigate to the Web page that contains the module to be edited.3. Switch to Editing Mode.4. Locate the module on the web page and click the Edit Link in the top right corner of the module

Once the Edit link is clicked the Edit Module dialog will display, where the available settings can be applied:

Example Settings

Next Page after Logon setting:

Next Page after Logon settingDescription
(Blank) Will navigate to the Home Page once Logged in.
/HistoryWill navigate to the History page once Logged in.
/Will navigate to the Home page once once Logged in.
/Apps/MyProjectWill auto launch into the Project called MyProject.

Default Username and Password setting:

Default UsernameDefault PasswordDescription
GuestDriveWorksGuestWill pre-populate the Login screen with the default username of Guest and the password DriveWorksGuest (the password will be masked).

Mapped Active Directory Authentication setting:

To allow Active Directory Authentication follow the steps below:

  1. Each Active Directory user that is required to have access to DriveWorks Live must also exist as a user in DriveWorks.

    The user names between Active Directory and DriveWorks must match exactly.

    Each user added to DriveWorks must share a common password.

    The password required when logging into DriveWorks Live will be the Active Directory password, NOT the shared common DriveWorks password.

    See To Create a New User for information on creating each user in DriveWorks.

  2. We recommend copying the Login module to create a custom module. See Create a Custom Module for information on how to do this.

    Once copied locate the file:

    %ProgramData%\DriveWorks\[version number]\Live\Themes\Web\content\custom\modules\[NewLoginModuleName]\view\controller.cshtml

    Open this file in an editor, such as notepad, and locate the line below:

    controller.cshtml file line 9
    const string SETTING_ACTIVE_DIRECTORY_SHARED_SECRET = "--[CHANGE THIS]--";

    Change the value --[CHANGE THIS]-- to your chosen shared common DriveWorks password.

  3. Start DriveWorks Live, login and navigate to the login page (type /login at the end of the URL in the address bar).
  4. Activate Edit Mode, see Modules for information on how to do this.
  5. Remove the existing Login module and add the module created in step 2 above, see Modules for information on how to do this.
  6. Click the Edit link at the top of the custom Login module.
  7. In the Edit Module window select the option to use Mapped Active Directory Authentication.
  8. In the field Required Active Directory Group Memberships enter the Active Directory Groups to which the required users belong. See the examples below.
Required Active Directory Group Memberships settingDescription
SalesActiveDirectoryGroupAllows the members of the SalesActiveDirectoryGroup to log into DriveWorks Live (providing the users in the Active Directory Group also exist as DriveWorks users).
SalesActiveDirectoryGroup|EngineersActiveDirectoryGroupAllows the members of the SalesActiveDirectoryGroup and EngineersActiveDirectoryGroup to log into DriveWorks Live (providing the users in the Active Directory Group also exist as DriveWorks users).

Table of Contents