DriveWorks Pro 22

Login

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.

  See Next Page after Logon setting below for more information.

• 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).

  See Default Username and Password setting below for more information.

• 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).

  See Default Username and Password setting below for more information.

• Authentication
  • Standard DriveWorks Authentication (Default)

    Uses the authentication as administered in Security Settings.

  • Mapped Active Directory Authentication

    Uses Active Directory authentication.

    See Mapped Active Directory Authentication setting below for more information.

To access settings for the Login module:

Default Web Pages

The Web Theme contains the following pages by default. Expand each section to learn more about that page and how it can be modified.

Integration Page

URL: http://localhost:8020/Integration

The Integration page supports integrating DriveWorks Live into external web sites.

Login Page

URL: http://localhost:8020/Login

The login page contains the Login Module.

Home Page

URL: http://localhost:8020/

The Home page contains the following modules:

• Menu Module - Positioned in the sidebar
• Markup Control Module - Positioned at the top of the main content area
• Projects Module - Positioned in the main content area

Specify Page

URL: http://localhost:8020/Apps/ProjectName

Spaces in Projects Names will be replaced with %20

The Specify page contains the following modules:

• Specification Navigation module - Positioned in the sidebar
• Specification Form Module - Positioned in the main content area
• Specification Tasks Module - Positioned at the bottom of the main content area

History Page

URL: http://localhost:8020/History

The History page contains the following modules:

• Menu module - Positioned in the sidebar
• Specification History Module - Positioned in the main content area

History (Specification) Page

URL: http://localhost:8020/History/Specification Name

At least one Specification must exist in the Group to access this page

Spaces in Specification Names will be replaced with %20

The History (Specification) page contains the following modules:

• Menu module - Positioned in the sidebar
• Specification Details Module - Positioned in the main content area

Logout URL

Typing bye in the address bar of the current URL will force a log out from the DriveWorks Live session.

Example

Current URL	URL to logout
http://www.MyDriveWorksLiveURL/	http://www.MyDriveWorksLiveURL/bye
http://www.MyDriveWorksLiveURL/Apps/MyProject/	http://www.MyDriveWorksLiveURL/Apps/MyProject/bye

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:

There are three possible redirect outcomes for the login module:

1. Redirected to the URL specified in the Next Page after Logon setting.

   When a URL has been applied to the Next Page after Logon setting it is considered trusted. Additional configuration is not required in the DriveWorks.config file.

   When the Next Page after Logon setting is left blank the redirect falls into either 2 or 3 below:

2. Redirected to the URL given in a query string.

   An example of a query string to logout can be found in the topic Logging Out of a Browser Session under Redirect the Logout URL.

   When a user has visited a page prior to logging in, DriveWorks can redirect to the login page and then back to the original page being viewed once authenticated.

   This can only be done from a query string. Since query strings can be changed in the browser (or sent via email etc.) it may not be trusted.

   If your site requires redirection to a trusted third party domain, this must be specified in the DriveWorks.config file.

   See Applying Trusted Redirect Domains to the DriveWorks.config file below.

3. Redirected to the site root.

   When the Next Page after Logon setting is left blank or no ReturnUrl is given in a query string, then DriveWorks will check the session status.

   The user will either go to the site root (/) or the Admin URL (/setup) depending on whether the session is in admin mode or not.

Default Username and Password setting:

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.