Using CitectSCADA > Securing Projects > Configuring Security > Adding users

Adding users

For each person you want to have access to your project you need to add their user information into the system.

To add a user:

  1. Choose System | Users. The Users dialog box appears.
  2. Complete the Users dialog box.
  3. Click Add to append a new record, or Replace to modify an existing record.

Use the Users dialog box to define properties for your users.

User Name

The user's name. Enter a value of 16 characters or less. You can assign a user record for a single user, for example:

User Name


User Name


Each operator needs to enter the User Name and Password to use the system.

User Names are restricted to using the same syntax as Tag names. See Tag name syntax.

Full Name

The full name of the user or class of user. Enter a value of 32 characters or less. This name is used as a comment and for display in alarm logs and command logs.


The user's password. Enter a value of 36 characters or less. When you enter the password, an asterisk (*) will display for each character entered. When you save the user record, the password will be encrypted before it is saved to the Users.dbf.

Each operator needs to enter the User Name and Password to use the system.

Use the [General]PasswordExpiry parameter to specify when the password will expire.

Confirm Password

Re-enter the user's password to confirm the text entered in the Password field. Enter a value of 36 characters or less. If the contents of the Password and Confirm Password fields are different when the record is saved, a message will be displayed that indicates a mismatch and invites you to try again.


The generic type of user. Enter a value of 16 characters or less. For example:







The Type field is used in configuration only to specify a class of user that can then be used as the basis for creating new users in runtime via the UserCreate() cicode function. When this function is run it displays a form where you can select the user Type. When you do this, your new user will inherit the properties of the chosen user class record that you have already created. In doing this it uses the first user record with a matching Type value.

In configuration, decide what user classes you need. Each class (or Type) would contain any specific Global Privilege, Viewable Areas and Areas for Privilige and Entry and Exit Commands values . Maintain just one user record for each class and then base other individual users on this. If you create new users in configuration in the usual way by using Add, Replace technique, then you will get multiple user records with the same Type field value. Whilst this will not directly cause a problem for indiviual records it could confuse development or provide scope for inconsistencies and unexpected behaviour if other field values are changed. When adding records in configuration, it is therefore recommended that you remove duplicate Type values from additional user records.


Each user is assigned roles. The Roles field will accept zero or more comma-separated role names. If zero roles are specified for the user, this is the same as configuring the user with no privileges.

Note: When a Windows or CitectSCADA user who is linked to multiple roles logs onto runtime the privileges and areas that the user will be assigned are the combined privileges of the linked roles.


Any useful comment. Enter a value of 48 characters or less.

Notes:To login a user, you need to use the Login() or LoginForm() Cicode functions.