Skip to main content

Setting Up Access Control and Login Procedure

In the user management dialogs, you define the login, logout, changing of the user password, and editing of the user management in the visualization at runtime.

Editing and Selecting User Management Dialogs

Important

If you create your own dialog as a user management dialog, then you should use the visualizations from the included library project VisuUserMgmtDialogs as the basis, because it uses the required interfaces. Your own user management dialog is listed then in Visualization Manager → Settings, Settings for User Management Dialogs.

Note

0_Sample_ProjectSource library VisuUserMgmtDialogs as a basis for dialog customization

Tip

For information about the login visualization in runtime-based user management, see: Runtime-Based User Management

Procedure. Creating Login Pages

  1. If you do not want to configure your own login page, then a preconfigured login page from a library is automatically used when logging in to the visualization. This visualization is automatically entered in the editor of the WebVisu as the Login visualization when the user administration is created, but it can be changed if necessary.

  2. If you want to create your own login page, then follow the steps below:

  3. Add a Visualization object (for example, named "Login_Visu") to the application.

  4. In the context menu of this object, click Properties. In the properties dialog, open the Visualization tab.

  5. In the context menu of this object, click Properties. In the properties dialog, open the Visualization tab.

  6. Open the "Login_Visu" visualization and design your login page with the input fields for user name, password, and buttons for logging in and canceling the dialog.

  7. To do this, only certain visualization elements are available to you. In these visualization elements, you can use placeholders to configure the input fields for the user name and password, as well as the buttons for logging in and canceling the dialog. All available placeholders with descriptions can be found in the chapter Placeholders for User Management.

  8. Compile the application and perform a download to the controller.

    When you open the web visualization, the login page which you created for the visualization opens. Type in your user name and the password for the controller which you have stored in the device user management and click the LOGINbutton.

Editing user management dialogs

Requirement: The library project VisuUserMgmtDialogs.library exists in the installation directory.

  1. Click File → Open Project.

  2. Select the project VisuUserMgmtDialogs.library from the Projects folder of the installation directory.

  3. Click View → POUs.

    In the POUs view, the project is displayed with the visualizations UserMgmtChangePassword, UserMgmtConfig, and UserMgmtChangePassword.

  4. Double-click a visualization (example: UserMgmtLogin).

  5. Change the visualization as you like and save the project.

  6. Then, reinstall the library and add it to the Library Manager of your application.

Selecting user management dialogs

A user management already exists in your application in the Visualization Manager object on the User Management tab.

The VisuUserManagement library is in the Library Manager.

  1. In the device tree, click the Visualization Manager object.

  2. Select the Dialog Settings tab.

  3. In Settings for User Management Dialogs, select the dialogs for Login dialog, Change password dialog, and Change configuration dialog.

    Tip

    If no entries can be seen in Settings for User Management Dialogs in the dialog lists, then close the Visualization Manager and reopen it.

Customizing the dialogs of the user management

You configure the visualization buttons for the login, logout, change password, and user management dialogs as follows:

Requirement: A visualization is open.

  1. Drag a Button element from the Visualization Toolbox view (Common Controls category) to the visualization.

  2. In the Properties view, click the Input configuration node.

  3. In the Input configuration → OnMouseClick property, click Configure.

  4. In the Input Configuration dialog, click User management and _visu_img_add_selected_alarm_group.png.

    The following Dialogs and actions are listed on the right: Login, Logout, Change User Password, and Open User Configuration.

  5. Select the dialog or action to assign to the button and click OK.

    When the button is clicked at runtime, the selected dialog opens or the selected action is executed.

Tip

If you want to open and edit the user management in the visualization at runtime, you need to be a member of a group that has Permission to Change User Data.

: