Skip to content

Admin Actions: System Settings

Owen Stephens edited this page Jun 22, 2015 · 3 revisions

This Admin Actions menu option opens a screen where system wide settings can be changed. The currently available settings, and their current values, are displayed on the System Settings page:

Illustration of System Settings screen in KB+

##AutoApproveMemberships When a user logs into KB+ for the first time if possible KB+ will detect the most likely ‘home’ institution for the user based on their login.

The ‘AutoApproveMemberships’ option can be set to ‘true’ or ‘false’. To change the setting, click the current value ('true' or 'false') in the settings table, and it will be changed from the current value, to the opposite value. So if the current value is 'true', clicking on 'true' will switch the setting to 'false' and vice versa.

Illustration of AutoApproveMemberships setting in KB+ In this illustration the current value for AutoApproveMemberships is 'true'. Clicking the circled value 'true' will change it to 'false' - this change will take affect without any further action by the administrator.

The behaviour of the AutoApproveMemberships setting is:

  • If set to ‘true’, where KB+ successfully detects a ‘home’ institution for the user based on the login it will automatically create and approve a 'read only' (role 'ROLE_USER') affiliation to this institution for the user. Where Shibboleth authentication is being used, any user roles stated by the Shibboleth IdP will also be added and approved (these do not currently have any direct bearing on user permissions on KB+)
  • If set to ‘false’, KB+ will not create and approve 'read only' (or other) affiliations to an institution for a new user

The ‘AutoApproveMemberships’ setting does not affect any manually created affiliation requests create by the user explicitly requesting affiliation via the Profile page.

Changing the AutoApproveMemberships setting will only affect logins to KB+ that occur after the change is made. Any existing user accounts will be unaffected by the change.

The 'AutoApproveMemberships' should be set to 'true' where the KB+ administrator is happy that new users should be automatically approved as read only users for their institution, where this can be detected. It should be noted this could include non-library staff and students for the organisation if they are permitted to login using Shibboleth based authentication. If the KB+ administrators wishes all affiliation requests to be approved by a person, the 'AutoApproveMemberships' setting should be 'false'.

The following screenshot shows a user details page (with personal details pixelated to maintain privacy) for a user who has logged in while the 'AutoApproveMemberships' setting is 'true'.

Illustration of User Details page with auto approved affiliations

Those lines marked 'Auto Approved' are affiliations created automatically because the AutoApproveMemberships setting was set to 'true' when the user logged in for the first time.

Clone this wiki locally