The REST service provides a configuration file, SARESTWebService.exe.config, from which you can change the default port number, (8889) or the user authentication method (Windows user name and password). The user credentials are passed onto the System Architect REST Service, used to access the encyclopedia. If you add DBUser, DBPassword, and values to the configuration file, those values will be used to access the database, and the Windows credentials are ignored.
Note You must add DBUser and DBPassword in the rest config file when System Architectrepository and rest service are running on different computers.
Users who attempt to access encyclopedias without authorization are warned with appropriate error messages.
AddMachineName
If the encyclopedia that you are accessing resides on the local sql server default instance, then this keyword value should be set to false.
BasicAuthentication
By default System Architect REST Service runs with the NTLM authentication. If the user wants to enable the basic authentication instead of NTLM authentication then this keyword should be set to True. You must restart System Architect REST Service for the changes to take effect. Basic authentication is typically used for cross-domain scenarios where you have IBM Rational Publishing Engine installed in one domain and it is communicating with System Architect REST Service installed in another domain. Note that the Basic Authentication is not secure as the login credentials are passed over the network in plain text.
To change the port number and the user authentication
1 Use your text editor of choice to open the SARESTWebService.exe.config file, in the default installation path:
2 For the Port key, change the port number for the value property.
3 For the user authentication, in the connectionString tag, change the connectionStrings values for the DBUser and DBPassword properties. These values will override the default Windows authentication.
4 Save the SARESTWebService.exe.config and restart the System Architect REST Service.