Before following this article, you must read through this article on how to set up API access via Windows Authentication.

Once you have confirmed you can return sites through your browser, please follow on the steps below.

On your development machine

• Unzip the APIWebSiteWindows solution and open this in Visual Studio.
• Edit the APIClientFactory.cs class (this is in the Infrastructure folder)
• In the CreateNew method, change the BaseUrl to match your machine name and port of the web service
  
  
  
  
• Go to Build then Build Solution. This will be created in your output folder.
• You will need to then copy the APIWebSiteWindows folder (containing the bin folder and web.config file) to the C:\ of the target machine.

On your target machine

You will need to open up IIS Manager. You can do this by searching for inetmgr from the Search bar at the bottom of your screen.

• You will need to create a new website:
  • Right click on Sites in the tree node, and choose Add Website
  • Enter a Site Name of WebSiteWindows
  • Set the physical path to C:\inetpub (this is not really used and can be set to another folder if required)
  • Set the port to 88
  • Click OK
• You will need to now enable Windows Authentication
  • Click on the new website in the tree node
  • Double click on Authentication
  • Right click on Windows Authentication and choose Enable
• You will need to set up the application pool
  • Click on Application Pools in the tree view
  • Right click on the new application pool in the main window and choose Advanced Settings
  • Ensure the .NET CLR Version is 4.0
  • Make sure the Managed Pipeline Mode is Integrated
  • Click OK
• You now need to apply the self signed certificate to the website
  • Right click on the new website in the tree view and choose Edit Bindings
  • Click Add
  • The type should be https
  • The port should be 288
  • Set the SSL Certificate to the certificate you created for the web service
  • Click OK
  • Close the Site Bindings window
• Add the Web Application
  • Right click on the new website in the tree view and choose Add Application
  • The Alias should be WebSiteWindows
  • The physical path should be C:\APIWebSiteWindows
  • Click OK

You should now be able to test the website by browsing to https://yourservername:288/WebSiteWindows. There are buttons to GET sites and departments.

You should be your companies when you click Sites

Next Steps

To make use of the APIWindowsClient solution, please follow the steps in this article.

To make use of the APIWebSiteAnon solution, please follow the steps in this article.