== Installing {{UBIK}} Authentication Web Service ==
== Configuration of the Web Server ==
The web server can be configured using the ''Internet Information Services (IIS) Manager'' console, which gets installed automatically. The console provides a graphical user interface to manage and configure the web server accordingly to the {{UBIK}} web service.
<gallery widths="400" heights="400" >
File:UI_10_IIS_Manager.png|1 - IIS Manager
</gallery>
=== Add Application Pool ===
An application pool is a group of one or more URLs that are served by a worker process or a set of worker processes. Application pools set boundaries for the applications they contain, which means that any applications that are running outside a given application pool cannot affect the applications in the application pool.
<gallery widths="400" heights="400" >
File:UI Application Pool.01.png|1 - Application Pool
File:UI Application Pool.02.png|2 - Application Pool
File:UI Application Pool.03.png|3 - Application Pool
</gallery>
=== Certificate ===
The web service communicates with the {{UBIK}} client via an secured connection, which requires a SSL certificate on the server and client side. Use a public key certificate from a certificate authority or a self-signed certificate, both will work for {{UBIK}}. A new self-signed certificate can be created in the ''Internet Information Server (IIS) Manager'', exported using the export function and sent to the development team. As already mentioned, the client has to know this certificate as well, hence it need to be integrated it into the mobile application.
{{Attention|{{UBIK}} requires a valid certificate for SSL encryption!}}
<gallery widths="400" heights="400" >
File:UI Certificate.01.png|1 - IIS Configuration
File:UI Certificate.02.png|2 - Installed certificates
File:UI Certificate.03.png|3 - Create self-signed certificate
File:UI Certificate.05.png|4 - Import certificate
File:UI Certificate.04.png|5 - Installed certificates
</gallery>
=== Bindings ===
Web sites and services have something called ''Server Bindings'' which represent the underlying address, port, and potentially a host header that the website is accessed using. The {{UBIK}} client accesses the web service via a secured port (https), where it is necessary to configure the appropriate certificate.
====For Android Clients====
<gallery widths="400" heights="400" >
File:UI Binding.01.png|1 - Binding
File:UI Binding.02.png|2 - Binding
File:UI Binding.03.png|3 - Binding
File:UI Binding.04.png|4 - Binding
</gallery>
====For Windows 8.1 Clients====
<gallery widths="400" heights="400" >
File:UI Binding.01.png|1 - Binding
File:UI_Binding_Win8.02.png|2 - Binding
File:UI_Binding_Win8.01.png|3 - Binding
File:UI_Binding_Win8.02.png|4 - Binding
</gallery>
=== Create new Web Application ===
In the ''IIS Manager'' expand the ''Default Web Site'' node and navigate through the folder structure to the folder containing the {{UBIK}} web service components.
<gallery widths="400" heights="400" >
File:UI New Service.01.png|1 - New Service
File:UI_New Service.02.png|2 - New Service
File:UI_New Service.03.png|3 - New Service
File:UI_New Service.04.png|4 - New Service
File:UI_New Service.05.png|5 - New Service
File:UI_New Service.06.png|6 - New Service
File:UI_New Service.07.png|7 - New Service
File:UI_New Service.08.png|8 - New Service
File:UI_New Service.09.png|9 - New Service
</gallery>
=== Optional: Local IIS User ===
Create and use a local user on the web server if no appropriate domain-user is available.
<gallery widths="400" heights="400" >
File:UI_Local_IIS_user.01.png|1 - Local IIS-user
File:UI_Local_IIS_user.02.png|2 - Local IIS-user
File:UI_Local_IIS_user.03.png|3 - Local IIS-user
File:UI_Local_IIS_user.04.png|4 - Local IIS-user
File:UI_Local_IIS_user.05.png|5 - Local IIS-user
File:UI_Local_IIS_user.06.png|6 - Local IIS-user
File:UI_Local_IIS_user.07.png|7 - Local IIS-user
File:UI_Local_IIS_user.08.png|8 - Local IIS-user
File:UI_Local_IIS_user.09.png|9 - Local IIS-user
</gallery>
== Additional prerequisites ==
* Ensure that the service ports are not blocked by a firewall.
* Ensure that port forwarding is established if needed (e.g. for Microsoft Azure Virtual Computers or servers behind a gateway)
== Testing the Web Service ==
Test the web service by entering the following URL in a browser:
<code>
https://<SERVER-IP>/<PATH-TO-UBIK-WEBSERVICE>/UBIKContent.svc/GetVersion
</code>
== See also ==
* [[Install_UBIK_Web_Service|Install {{UBIK}} Web Service]]
* [[UBIK_Web_Service_Configuration|{{UBIK}} Web Service Configuration]]
* [[Install_UBIK_Web_Service|Install {{UBIK}} Web Service]]
* [[Install_Microsoft_IIS]]
* [[Configure_Microsoft_IIS_for_UBIK]]
[[Category:UBIK Web Service]]
[[Category:Installing]]
