Deploy the WSUS Web service

SA communicates with Windows Server Update Services through a Web service installed on the WSUS server. The Web service sends the requested patches and patch metadata to the SA core which then distributes them to the appropriate SA managed severs.

Prerequisite: Before deploying the WSUS Web service, install OpenSSL (on any other machine) if you want to allow HTTPS requests.

To install the WSUS Web service on the WSUS upstream server and enable SA client connections:

1. Deploy the Web Service into IIS

   1. In the SA  Client, go to Library > By Folder > Opsware > Tools > Patching.
   2. Right-click on archived Web service file, hpsa_wsus_ws_versionnumber.zip file and select Export Software.
   3. Unpack the Web service ZIP file on the machine that holds the WSUS server, in a new folder under C:\inetpub\wwwroot.

   4. Click the Windows Start button, type IIS and open Internet Information Services.

   5. Under the Default Web Site, right-click on the folder you have created in step c and select Convert to Application.

2. Add a Web Service Manager user to the WSUS Administrators group

   Skip the first three steps if you are using Windows Small Business Server 2008.

   1. Click the Windows Start button and type Computer Management.

   2. Go to Local Users and Groups > Users and create a new user that will manage the Web service.

   3. Add the new user to the WSUS Administrators group under the Groups folder.

   4. In IIS, right-click Application Pools above the Sites section and select Add Application Pool.

   5. If .NET 4.0 is not already installed on your system, install it and run the following command as Administrator: c:\WINDOWS\Microsoft.NET\Framework\v4.0.30319\aspnet_regiis.exe -iru

   6. Enter a name for your application pool, select .NET 4 or above and click OK.
3. Configure IIS to use the new Web Service Manager user for running the Web service

   Skip the first two steps if you are using Windows Small Business Server 2008.

   1. Right-click the newly created application pool and select Advanced Settings.

   2. Under Process Model, change the identity configuration to use a custom account and provide the credentials for your newly created Web Server Manager account.

   3. In IIS, select the Web service under the Default Web Site and click Basic Settings.

   4. Select your newly created application pool as the default one and click OK. The Web service will now use your new application pool.

4. Configure IIS to accept HTTP and HTTPS requests for WCF

   By default, IIS does not accept HTTP and HTTPS requests for a .NET WCF Web Service. To enable this option manually:

   1. Click the Windows Start button and type Turn Windows features on or off.

   2. Expand Features >  .NET Framework 4.5 Features > WCF Services and enable HTTP Activation.
   3. Click Install then click Next until you reach the end of the wizard.
5. Setting up SSL certificates for IIS and the Web service clients (SA core and SA client)

   1. Cmd to the OpenSSL installation directory. By default OpenSSL installs under Program Files (x86)\GnuWin32\bin
   2. Type the following command to create a new system variable pointing to the openssl.cnf . Edit the command if you installed OpenSSL at a different location than the default one: 

      Set OPENSSL_CONF=C:\Program Files (x86)\GnuWin32\share\openssl.cnf

   3. Create a private and a public key using the following command:

      openssl req -x509 -newkey rsa:2048 -keyout your_private_key.pem -out your_public_key.pem -days XXX. Change XXX to the number of days you want the certificate to be valid for and give a custom name to the two .pem files.

   4. Type the following command in the OpenSSL installation directory to convert the two .pem files into a single .pfx file: openssl pkcs12 -inkey your_private_key.pem -in your_public_key.pem -export -out your_pkcs12_cert.pfx.
   5. Copy the .pfx file on WSUS Web service machine to import the server certificate into IIS:
   1. Go to IIS and select your server from the Connections pane.
   2. Double-click Server Certificates select your certificate and click Import.
   3. Browse to your .pfx file and type in the password you created for your public and private keys.
   6. Create a new binding for the Web service, to use HTTPS with this certificate.
   1. In the IIS, select Default Web Site from the Connections pane.

   2. Click Bindings from the Actions pane. This displays the Site Bindings dialog box.

   3. Click Add and select https from the Type drop-down menu.
   4. Pick your IP address and/or hostname from the SSL certificate drop-down menu.
   5. Click Apply to save your changes.

   7. Configure the Web service to require SSL.
   1. Select your Web service from the IIS Connections menu, under Default Web Site.
   2. Click SSL Settings.
   3. Check Require SSL checkbox and click Apply.
   8. Paste the content of your_public_key.pem at the bottom of the following file: /opt/opsware/openssl/certs/ca-bundle.crt. This copies the public certificate into the KnownCertification Authorities file on your SA core.

   Do not delete any existing certificates from the bundle.crt file.
6. Setting up SSL certificates for securing the Web service-WSUS communication

   1. Edit the WsusConfig.config file to set secureConnection to True and change the port to WSUS's HTTPS port. For Windows Server 2012, the default port is 8531.
   2. Use a self-signed certificate generated and import it into IIS as described in step 5. When OpenSSL prompts you for the Common Name, type the FQDN or IP of your machine that holds WSUS and the Web service.

   3. In the IIS Connections pane, expand your host server > Sites and select the WSUS Administration node. Depending on your operating system, this is displayed either under Default Web Site or on the same level.

   4. Click Bindings from the Actions pane. This displays the Site Bindings dialog box.
   5. Select the https binding and click Edit.
   6. Pick your IP address and/or hostname from the SSL certificate drop-down menu.
   7. Choose your imported certificate and click OK to close the Edit Site Bindings dialog box.
   8. In the WSUS Administration node, enable the Require SSL option for the following subnodes: APIRemoting30, ClientWebService, DssAuthWebServicee, ServerSyncWebService and SimpleAuthWebService.
   9. Open the Content node and make sure the Require SSL option is disabled. The Web service does not require SSL to secure content coming from the WSUS server. WSUS updates are signed by Microsoft by default, thus they are already secure.
   10. Click Apply to save your changes.
   11. Install your generated public key on the computer that holds WSUS and the Web service.
7. Configuring connection and import settings for the WSUS Web service

   The Web service archive that you unpacked under C:\inetpub\wwwroot\[your folder] contains two configuration files: WsusConfig.config and Web.config. Edit these XML files to configure the connection and metadata import settings for patches for the WSUS Web service.

   1. WsusConfig.config

      Attribute	Description
      serverName	IP or hostname of the WSUS server. This is included in the URL of the WSUS Web service. The WSUS Web service supports both IPv6 and IPv4 hosts.
      port	The port where WSUS is located on the server. Default HTTP port is 8530.
      secureConnection	Set to True if you want the connection between Web Service and the WSUS server to be secure.
      ignoredProperties	Specify which metadata properties to ignore when the Web service retrieves WSUS patches and associated metadata.
      includeApprovedUpdatesOnly	Specify which type of patch metadata SA retrieves from the WSUS server: True - Web service imports only metadata for the patches marked as Approved in WSUS. False - Web service imports metadata for all patches available in WSUS: Approved Declined Not Approved

   2. Web.config

   The following lines in this XML file define the two endpoints available for connecting the Web service to WSUS:

   • <endpoint address="" binding="webHttpBinding" bindingConfiguration="secureHttpBinding" contract="WsusREST.IWsusREST" behaviorConfiguration="web"></endpoint>
   • <endpoint address="" binding="webHttpBinding" contract="WsusREST.IWsusREST" behaviorConfiguration="web"></endpoint>

   Make sure these endpoints mirror the IIS binding settings that you have configured in step 5.

   HTTP connection:

   If your IIS configuration specifies an HTTP binding, remove the bindingConfiguration="secureHttpBinding line from this file, otherwise the Web service call fails.

   HTTPS connections:

   If your IIS configuration specifies an HTTPS binding, keep the bindingConfiguration="secureHttpBinding line

   HTTTP and HTTPS connections:

   If your IIS configuration specifies both HTTP and HTTPS bindings, keep both lines.

8. Hide IIS version information

   For security reasons, HPE recommends limiting the information that the WSUS Web service provides to remote clients. To hide the IIS version that the WSUS Web service is using:

   1. Install UrlScan from the Microsoft website. This security extension enables you to filter IIS connection requests.

   2. Navigate to %WINDIR%/System32/inetsrv/urlscan and open the UrlScan.ini file.

   3. Search for the RemoveServerHeader attribute and change it from 0 to 1. This stops sending the HTTP server header to remote clients.

   4. Save the UrlScan.ini file and close it.
9. Access the deployed Web service

   1. Enter the following URL in your browser to test the WSUS-Web service connection. This downloads a JSON file containing all the languages enabled on your WSUS Server.

      • secure binding: https://<hostNameOrIP>/<your_folder_name>/WsusREST/Locales
      • non-secure binding: http://<hostNameOrIP>/<your_folder_name>/WsusREST/Locales

   2. Check that each Windows managed server is able to access this WSUS Web service URL. SA cannot patch servers that do not have direct access to WSUS as these connections are not routed through the SA gateway mesh.