Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.


Table of Contents
indent1rem
stylesquare

Warning
titleIf you have v2.3 or lower installed, consider upgrading to the current version of NMS Prime.

There were some changes in the Authentication and Authorization system. Please look into the Upgrade Guide v2.4 for more Information

This section covers Authentication and Authorization of NMS Prime with v2.4 and newer.

You can find more information on how to create, edit and delete Users (Authentication), as well as Roles, and Abilities (Authorization).

...

To manage Users, you need to have the ability to update the User model. If you have this permission, the option "Global User Settings" should be available when you click on your name in the top right corner.

Options for editing user settings and rolesImage Modified

In this View, an overview over all Users is displayed and creating, updating and deleting Users is possible like anywhere else in the NMS Prime system.

...

To manage Roles and Abilities, you need to have the ability to update the Role model. If you have this permission, the option "User Roles" should be available when you click on your name in the top right corner.

Button for editing userroles in nms primeImage Modified      List of existing rolesImage Modified


You will be redirected to the standard Interface for managing, where you can create, edit and delete Roles (see Base MVC). The 3 columns will show the name, the rank and the description of the role. The rank is an indicator of how much "power" a role has

...

If you click on a Role inside the table of the index page, you will be redirected to the edit page. Like with every other entity, you will see 3 sections - the Role  Role properties, the Logging information and the abilities side panel.

...

Clicking onto save, will save only the changes you made to the role properties. If you have unsaved changes inside the ability panel, they will be reset.


Interface for rolesImage ModifiedInterface for assigning abilities to rolesImage Modified     

Assigning the Admin Role to an existing User without the GUI

...

These Abilities extend the respective Model permissions.

List of extended abilities for role managementImage ModifiedAnother list of extended abilitiesImage Modified

Model Abilities

...

If you want more granularity, you can expand the groups to make changes to individual entities.

Interface for defining model abilitiesImage ModifiedModel abilities and groupsImage ModifiedEven more options for the model abilitiesImage Modified


Warning
titleTroubleshooting Authorization



Expand
titleIf you get an Error 404, while saving abilities...
Please refresh the Page and check which Roles were applied. If the Error keeps coming, please open a Ticket. (Report a Bug)


Expand
titleIf you changed the admin role or locked yourself out of the system....

To solve this, execute these two console commands from the command line inside the NMS Prime directory:


Code Block
languagebash
themeRDark
firstline1
titleMake an existing User Admin
php artisan auth:nms
php artisan auth:admin [ your login name ]



...