Advanced Configuration of Platform Common Services

Note: Configure Platform Common Services to limit the number of unsuccessful login attempts before locking the user account.

By default, Platform Common Services uses the server's host name, protocol and port to generate the origin of the server instance, for example, https://mycomputer.mydomain.com. For most deployments this URL is accurate; however, in a reverse proxy or load-balancing scenario where the public URL differs from the server's internal URL, you must configure Platform Common Services to use a custom public origin.

For example, suppose your web server's host name is web01 on the mydomain.com domain, so the default URL is https://web01.mydomain.com. However, through DNS redirection the host name is aliased as ASOWEB so that requests to https://asoweb.mydomain.com are served by your web server. In this case, Platform Common Services' public origin URL needs to be changed to https://asoweb.mydomain.com.

To configure Platform Common Services to use a custom public origin URL

1. Stop the Platform Common Services AVEVA Identity Manager service.

2. Launch a text editor of your choice, such as Notepad, with administrative privileges.

3. Open <drive>:\Program Files (x86)\AVEVA\Platform Common Services\Management Server\appsettings.json in your text editor.

4. Locate the "AppSetting" section of the file which looks similar to the following:

   "AppSetting": {

   "PersistSessionCookie": false,

   "AllowGroups": [

   "aaAdministrators"

   ],

   "UserGroupFilters": [

   ],

   "SelfSignedCertificate": "",

   "BaseURL": "http://+:80/IdentityManager",

   "ServiceSource": "Token Host"

   },

5. Add a "PublicOrigin" setting containing your custom URL. For example, if your custom URL is https://avantisweb.mydomain.com, update the section as:

   "AppSetting": {

   "PersistSessionCookie": false,

   "AllowGroups": [

   "aaAdministrators"

   ],

   "UserGroupFilters": [

   ],

   "SelfSignedCertificate": "",

   "BaseURL": "http://+:80/IdentityManager",

   "ServiceSource": "Token Host",

   "PublicOrigin": "https://asoweb.mydomain.com"

   },

   Note: Ensure you add a comma after "Token Host" to avoid errors restarting Platform Common Services.

6. Save the appsettings.json file.

7. Restart the Platform Common Services AVEVA Identity Manager service.