admin:managing_users

Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
admin:managing_users [2026/09/30 12:40] – [Users and sync] Gary Willettsadmin:managing_users [2026/09/30 12:56] (current) – [Users and sync] Gary Willetts
Line 13: Line 13:
 A few points to remember if you are working with users on a [[synchronisation:introduction|synced system]] and with newer versions of mSupply: A few points to remember if you are working with users on a [[synchronisation:introduction|synced system]] and with newer versions of mSupply:
   * Users are //normally// created and configured on the Legacy mSupply Central server. These settings are then copied to remote sites when the store is transferred to the remote site.   * Users are //normally// created and configured on the Legacy mSupply Central server. These settings are then copied to remote sites when the store is transferred to the remote site.
-  * //Normally//, when these configuration settings are altered on the Legacy mSupply Central server after a store has been migrated, the settings do not get synced to the remote site.  It is now possible to sync user permission settings across all stores that they have permission to log in to, regardless of which site the store is on (on the Edit user > Login rights tab).  As mSupply is currently configured, this setting defaults to ‘off’, and needs to be turned on every time a user is edited.+  * //Normally//, when these configuration settings are altered on the Legacy mSupply Central server after a store has been migrated, the settings do not get synced to the remote site.  It is now possible to sync user permission settings across all stores that they have permission to log in to, regardless of which site the store is on (on the Edit user > Login rights tab). This setting defaults to ‘off’, and needs to be turned on every time a user is edited. See the [[admin:managing_users#sync_user_across_all_login_stores_checkbox|Sync user across all login stores checkbox]] section for more details.
   * Users can be created and edited on a Legacy mSupply remote site.  Name details of any newly created user on a remote site will sync back to the Legacy mSupply Central server.  This is primarily for the sake of reporting transactions.  Any permission edits made on the remote site will //not// sync back to the Legacy mSupply Central server.   * Users can be created and edited on a Legacy mSupply remote site.  Name details of any newly created user on a remote site will sync back to the Legacy mSupply Central server.  This is primarily for the sake of reporting transactions.  Any permission edits made on the remote site will //not// sync back to the Legacy mSupply Central server.
   * Users can not be created or permissions edited on [[https://docs.msupply.foundation/mobile/introduction/introduction/|mSupply Mobile (Deprecated)]] or [[https://docs.msupply.foundation/docs/introduction/introduction/|Open mSupply]] sites.   * Users can not be created or permissions edited on [[https://docs.msupply.foundation/mobile/introduction/introduction/|mSupply Mobile (Deprecated)]] or [[https://docs.msupply.foundation/docs/introduction/introduction/|Open mSupply]] sites.
Line 242: Line 242:
   * "Supervisor - All stores" stores is a special mode to allow users to view information in and run reports over multiple stores. See [[other_stuff:misc_topics#supervisor_mode_-_all_stores|here]] for more information.   * "Supervisor - All stores" stores is a special mode to allow users to view information in and run reports over multiple stores. See [[other_stuff:misc_topics#supervisor_mode_-_all_stores|here]] for more information.
  
-=== Sync user across all login stores ===+=== Sync user across all login stores checkbox === 
 +This checkbox is only displayed if the user is logged into the primary server in a synchronisation system.
  
-The **Sync user across all login stores** checkbox is only displayed if the user is logged into the primary server in a synchronisation system.  If this checkbox is checked, when the **OK** button is clicked the user's details are synchronised to all the stores that the user is allowed to login to, whichever sites those stores are Active on.  In this way, an administrator in a synchronisation system is able to edit user permissions and settings and have them automatically synchronised to all relevant sites, rather than having to log in remotely to those sites and configure permissions locally.  <WRAP center round tip 60%> +If this checkbox is checked, when the **OK** button is clicked then the user's details, including their permissions (or group membership and group permissions if they are part of a group) and their store login permissions, are synchronised to all the stores that the user is allowed to login to, whichever sites those stores are Active on.
-As you can imagine, **Sync user across all login stores** is a powerful feature, and can have unintended consequences.  Therefore as of 2025-11-04, there are restrictions on who can be configured as a '**special user**'.  Contact [[support@msupply.foundation]] for assistance. +
-</WRAP>+
  
 +In this way, an administrator in a synchronisation system is able to edit user permissions and settings centrally and have them automatically synchronised to all relevant sites, rather than having to log in remotely to those sites and configure permissions locally.
 +
 +As you can imagine, this is a powerful feature and can have unintended consequences so be careful when using it!
  
 <WRAP center round important 60%> <WRAP center round important 60%>
-**Sync user across all login stores** will propagate: +**Sync user across all login stores** will <wrap em>NOT</wrap> propagate user or group deletion to remote sites. 
-  * Group permissions +
-  * User group membership (which group the user is a member of)  +
-  * User permissions, if the user is not a member of a group +
-  * User store login permissions +
- +
-**Sync user across all login stores** will <wrap em>NOT</wrap> propagate: +
-  * User deletion +
-  * Group deletion+
  
-Deleting the user or group on remote sites must be carried out by either of: +Deleting a user or group on remote sites can only be done by manually logging in to those sites and editing the users or groups there (or, if really necessary, by execution of custom code on the central server that will propagate these changes.  Contact [[support@msupply.foundation]] for assistance with that). 
-  * Manually logging in to those sites and editing users, or +
-  * Development and execution of custom 'footrunner' code on the Central server that will propagate these changes.  Contact [[support@msupply.foundation]] for assistance. +
 </WRAP> </WRAP>
  
  • Last modified: 2026/09/30 12:40
  • by Gary Willetts