Harmony Server > WebCC > User Guide > Users > Restricting Environment Access

Restricting Access to Environments for WebCC Users

It is possible to define which users can access each environment in the Harmony Server database via WebCC. It is also possible to make certain environments inaccessible to any users in WebCC. To do this, a .json configuration file which defines a list of users who have access rights to each environment must be created at the following location:

/USA_DB/environments/environment-filter.json

Create this file and open it in a text editor. In this file, define each environment that should be accessible in WebCC, followed by the list of users who should have access to the environment, in the following format: 

{ "EnvironmentName1" : ["_all_"], "EnvironmentName2" : ["username1", "username2", "username3"], "EnvironmentName3" : ["username2", "username4"] }

If you want an environment to be accessible by all users, define it as accessible by "_all_". This is critical as, if the environment filter file exists, environments that are not listed in this file will be inaccessible by anyone on WebCC. Likewise, if you don't want an environment to be accessible in WebCC, simply omit to list it in the configuration file.

After you are done writing the environment filter list, save it, then log in to WebCC to see if it works. If there is a syntax error in the configuration file, WebCC will not apply the restrictions and will add the following message to the log:

Failed to parse C:/USA_DB/environments/environment-filter.json

To see the log, select Help > View Log from the top menu.

You can also create a dummy user, give it access to only a few environments and log in as this user to make sure it works.

NOTE: Users with administrative privileges (ie:  R & D, Coordinator, Supervisor, TD or Executive type users) are not affected by the environment filters and always have access to all environments via WebCC.