Security Levels

Reserved Security Levels

The reserved security levels are mostly created for you, and have special rules that determine when a user is granted that level. They can't be renamed or deleted.

Public

All users are always granted the Public security level, even if they are not authenticated (logged in). Public security level indicates open access and the least amount of security. A session that only has the Public security level is not authenticated. This is similar to being a guest or anonymous. Unless another security level is required, guest access will be allowed. The Public security level is the ancestor of all other security levels in the hierarchy.

Authenticated

The Authenticated Security Level is a child of the Public Security Level. If a session has authenticated against the configured IdP successfully, the Authenticated Security Level is granted. Users are required to be logged in in order to have access to this level.

Authenticated/Roles

The Roles level is a special level which itself has no special rules, but it acts as a parent placeholder for potential roles returned from the IdP. This particular level is not configurable; however there can be levels added underneath the Roles level as children. These levels should correspond to the names of roles that would be expected from the IdP. If the IdP provides role information, these roles are automatically mapped to the child security levels underneath Authenticated/Roles. The names of the roles must match exactly for them to be correctly mapped to. For example, if you authenticate against the Ignition IdP configured to delegate to the Internal user source, and your user was granted the roles “A”, and “B”, you would have (at a minimum) the following security levels granted to you:

• Public
  • Authenticated
    • Roles
      • A
      • B

SecurityZones

The SecurityZones level is another special placeholder level that itself has no rules but is a parent for all of the Security Zones on the Gateway. Security Zones are automatically pulled in from the Gateway. A Security Zone is a list of Gateways, Computers, or IP addresses that are defined and grouped together. This group is a zone on the Gateway Network, which can have additional policies and restrictions placed on it. Security Zones provide a way to bridge the IdP method of permissions with location-based permission modeling. You cannot add, edit, or remove the SecurityZones node or any node in the SecurityZones sub-tree.

Custom Security Levels

Custom Security Levels can be added to almost anywhere within the tree. When these levels are granted to a user is determined by the Security Level Rules, which can pull information from the IdP, Security Zones, and even Tags. The placement of custom Security Levels can affect when they may be potentially granted to a user. Any custom levels set under the Public level, but not within Authenticated, do not need to have a user authenticate against the IdP to be granted to a user. However, custom levels within Authenticated do need to have the user authenticate to be granted to the user, even if the rule for that level does not use any of the IdP attributes.

Add a New Security Level

1. From the Gateway Webpage Config tab, click on Security > Security Levels.
2. In the Security Level tree, select the level that will be a parent for the new level.
3. Click the Add Security Level button.
   
   
   

4. In the Security Level Details screen area, enter the Name for the level. 

   Note: Security Level names within the same parent must be unique.

5. The path for the parent is filled in automatically. Use the Parent dropdown list if you want to change the parent for this new level.
   
   
   
   

6. Add a Description for the new level (optional).
7. If you make changes to Security Levels, but decide not to save them, you can use the Reset button  to return the tree view to its currently saved configuration.
8. To save the changes, press Save.

Edit a Security Level

1. From the Gateway Webpage Config section, click on choose Security > Security Levels.

2. In the Security Level Tree, select the level that you want to edit.
   
   

3. Make the desired changes in the Security Levels Details screen area. 
4. If you make changes to Security Levels, but decide not to save them, you can use the Reset button  to return the tree view to its currently saved configuration.
5. To save the changes, click the Save button.

Delete a Security Level

1. From the Gateway Webpage Config tab, click on Security > Security Levels.
2. In the Security Level tree, select the level that you want to delete.
3. Click the Delete button on the Security Level Details screen.
   
   
   
   

4. In the confirmation box, click Delete to confirm the delete.
   
   

   The following feature is new in Ignition version 8.1.25
   Click here to check out the other new features
   Note: Deleted security levels will need to be unchecked in the Designer permissions configurations with new settings saved to avoid permission errors. Warning indicators for selected security levels that no longer exist will be visible on the Project Properties, Event Configuration, Edit Permissions, and Tag Editor windows when applicable. 

Import a Security Levels Configuration

1. From the Gateway webpage Config tab, click on Security > Security Levels.
2. Click the Import icon .

3. Choose Import on the confirmation screen.
   
   
   
   

4. Choose a security levels configuration file to import.

5. Click Open.

Export a Security Levels Configuration

1. From the Gateway Webpage Config tab, choose Security > Security Levels.
2. Click the Export icon .

3. The security levels configuration will be saved as a .json file with a unique number, for example: