Jump to: navigation, search

Difference between revisions of "Web Service Configuration"


(Created page with "The Web Service must be configured by updating the ''Web.Config'' File. {| class="wikitable" | width = "88%" |- ! Area!! Setting!! Description |- | appSettings|| UBIK.DataBa...")
 
 
(54 intermediate revisions by 5 users not shown)
Line 1: Line 1:
The Web Service must be configured by updating the ''Web.Config'' File.
+
== Specific Configuration Files ==
 +
The specific configuration files are considered in the configuration via inclusion. For example, the tag ''<bindings configSource="Logging.config" />'' in the main configuration file adds all settings of ''Logging.config'' to the configuration.  
  
{| class="wikitable" | width = "88%"
+
Specific files are available for:
 +
* '''Bindings''': different configurations for data services and endpoints
 +
* '''Clients''': definitions used by the data service for connecting to the [[USAM|session management service]]
 +
* '''Logging''': configuration of destination paths, etc.
 +
* '''Services''': used by the data service and the session management service
 +
* '''Application Settings''': configuration of the data and session management service of the web service
 +
* '''Web Settings''': configuration of the web site.
  
|-
+
This table shows by which component the specific files are used.
! Area!! Setting!! Description
+
<table class="defaultTable sortable">
|-
+
{{Item/ConfigFileHeader}}
| appSettings|| UBIK.DataBase.ConnectionString ||Configuratoin of the SQL Connectstring to the UBIK Database
+
{{Item/ConfigFile|Application settings|[[Configuration_Files/AppSettings.config|AppSettings.config]]|1||}}
|-
+
{{Item/ConfigFile|Bindings|[[Configuration_Files/Bindings.config|Bindings.config]]|1|1|1}}
| appSettings|| UBIK.Service.MaxIdleMinutes ||Duration [in minutes] until a unused WebService shuts down automatically
+
{{Item/ConfigFile|Clients|[[Configuration_Files/Client.config|Client.config]]|1|1|1}}
|-
+
{{Item/ConfigFile|Logging|[[Configuration_Files/Logging.config|Logging.config]]|1|1|1}}
| appSettings|| UBIK.Service.ValityPeriode ||Duration [in seconds] until a cached record is marked as outdated in the UBIK Kernel
+
{{Item/ConfigFile|Services|[[Configuration_Files/Services.config|Services.config]]|1||}}
|-
+
{{Item/ConfigFile|Web|[[Configuration_Files/web.config|Web.config]]|1|1|1}}
| appSettings|| LogLevel ||LogLevel
+
</table>
|-
+
| appSettings|| LanguageID ||ID of the language that must be used by the Web Service. The Service will deliver the content of MultiLanguage Properties in this language.
+
|-
+
| appSettings|| UserRestrictive ||If this switch is "1", only known logins may connect to UBIK. If it is set to "0", every login may connect.
+
|-
+
| appSettings|| DeviceRestrictive ||If this switch is "1", only known and active devices may connect to UBIK. If it is set to "0", every device may connect.
+
|-
+
| appSettings|| TokenRestrictive ||If this switch is "1", data access is only possible after a successfull authentication. If it is set to "0", the token is not validated.
+
|-
+
| loggingConfiguration|| listeners ||Full configuration of the UBIK Logging
+
|-
+
|}
+
  
 +
The configuration file of the web service additionally needs to obey rules as given in [http://msdn.microsoft.com/en-us/library/ms733830%28v=vs.110%29.aspx Configuring Services].
  
 +
Common sections, existing in all main configuration files and should not be changed in general, are
 +
* '''<configSections>''': these settings include general logging and exception handling
 +
* '''<exceptionHandling>''': detailed configuration of exception handling
 +
* '''<loggingConfiguration>''': detailed configuration of logging
 +
* '''<system.serviceModel>''': behaviours for services and endpoints
  
Example:
+
[[Category:Installing|Web Service Configuration]]
<code>
+
[[Category:Web service|Web Service Configuration]]
  <appSettings>
+
    <add key="UBIK.DataBase.ConnectionString" value="Data Source=UBIK_SQL_SERVER;Initial Catalog=UBIK;Persist Security Info=True;User ID=ubik;Password=password" />
+
    <add key="UBIK.Service.MaxIdleMinutes" value="5" />
+
    <add key="UBIK.Service.ValityPeriode" value="30" />
+
    <add key="UBIK.Service.LogLevel" value="10" />
+
    <add key="UBIK.Service.LanguageID" value="1" />
+
    <add key="UBIK.Service.UserRestrictive" value="1" />
+
    <add key="UBIK.Service.DeviceRestrictive" value="0" />
+
    <add key="UBIK.Service.TokenRestrictive" value="1" />
+
  </appSettings>
+
</code>
+

Latest revision as of 10:35, 7 July 2023

Specific Configuration Files

The specific configuration files are considered in the configuration via inclusion. For example, the tag <bindings configSource="Logging.config" /> in the main configuration file adds all settings of Logging.config to the configuration.

Specific files are available for:

  • Bindings: different configurations for data services and endpoints
  • Clients: definitions used by the data service for connecting to the session management service
  • Logging: configuration of destination paths, etc.
  • Services: used by the data service and the session management service
  • Application Settings: configuration of the data and session management service of the web service
  • Web Settings: configuration of the web site.

This table shows by which component the specific files are used.

DescriptionExample fileWeb serviceStudioEnterprise Service
Application settingsAppSettings.configIC Bullet Full.png--
BindingsBindings.configIC Bullet Full.pngIC Bullet Full.pngIC Bullet Full.png
ClientsClient.configIC Bullet Full.pngIC Bullet Full.pngIC Bullet Full.png
LoggingLogging.configIC Bullet Full.pngIC Bullet Full.pngIC Bullet Full.png
ServicesServices.configIC Bullet Full.png--
WebWeb.configIC Bullet Full.pngIC Bullet Full.pngIC Bullet Full.png

The configuration file of the web service additionally needs to obey rules as given in Configuring Services.

Common sections, existing in all main configuration files and should not be changed in general, are

  • <configSections>: these settings include general logging and exception handling
  • <exceptionHandling>: detailed configuration of exception handling
  • <loggingConfiguration>: detailed configuration of logging
  • <system.serviceModel>: behaviours for services and endpoints