You are visiting the High Monkey blog archive. Posts prior to 2016 may not meet accessibility standards. Please visit our current blog area at https://www.highmonkey.com/blog to view accessibility compliant blog posts published since January 1, 2016.

Getting Kentico REST Services working on Windows 8

Written By: Virgil Carroll
Posted: 1/29/2014

1/30/2014 Update: After talking back-n-forth with Kentico Support it ends up these instructions are in the documentation online but not in the version that gets installed with Kentico.  They are going to update that, but good rule of thumb to make sure you check both locations when you are stuck.

So for a recent project I am working on, I had a requirement to start using the Kentico RESTFUL services API to do some jQuery data connections.  To accomplish this I needed to install a copy of Kentico on my local Windows 8 machine to create the appropriate Visual Studio web parts and code.  After installing Kentico on my local machine I followed the instructions in the Kentico CMS 7 Developer’s Guide.

The first step was to set-up all the Prerequisites to make REST services work on my computer.  Instructions to complete this are here: http://devnet.kentico.com/docs/devguide/index.html?rest_pre-requisites.htm

The second step was to configure the REST settings in my Kentico installation.  Instructions to complete this step are here: http://devnet.kentico.com/docs/devguide/index.html?rest_settings.htm

After doing all this, my next step was to test to make sure the REST API is working by visiting the URL: http://localhost/KenticoCMS7/rest/cms.user/currentsite which should return a list of users set up for my current site.  Unfortunately, instead of the expected list, I received a 404 Not Found Error as shown below.  This error was stating that it could not find the RestService.svc file in my Kentico directory, though it was clearly there every time I checked (which were many)



After doing some research myself and going over my settings (according to the instructions given) numerous times, I decided I was stumped and needed to reach out to Kentico support to see if they had any additional ideas.  I have always liked Kentico support because they are very responsive to inquiries and they responded very quickly to any request.  After a few back and forths, we tried a lot of different pieces and verified a lot of different settings, even going as far as to replace the web.config file in my Kentico application with one they sent me.  Still we could not get the system to find the RestService.svc.

Though Kentico has good support, I have been dealing with software companies for long enough to know sometime documentation does not always keep up with the constant updates and changes that happen to the typical server or computer on a regular basis.  With this thought in mind, I set out on another google adventure to see if I could find anything else that could be causing this issue.  After looking through a lot of different articles, posts, etc on getting a 404 error with REST (evidently not as uncommon as I thought) most of the answers were solutions we had already tried and been unsuccessful.  So I dug a little further and happened to find an obscure posting about some changes in the .NET Framework 4.5 which has its own HTTP Activation feature which needed to activated for REST to work on this newer version of the Framework.  So I gave this a try through Control Panel > Programs > Turn Windows features on and off (see screenshot below)



Once I did this and re-tried my REST call, the service asked me to log in with my credentials (you cannot do a Kentico REST call anonymously) and it now returns the results as expected.



So with over 3 days worth of effort the issue comes down to the documentation being somewhat out of date (which I happily sent on to Kentico) and new things needing to be done in newer environments.  I hope in sharing this you will be able to avoid this problem, but also remember the tip that we cannot always take software documentation at face value.  Like anything, it is written at a specific point and time which may not reflect how surrounding technologies have changed since it was written.  So always use documentation with a grain a salt and make sure you are trying to understand any process you try to implement, which when you run into issues, will help you know how to troubleshoot the issues yourself.

Want to know more on how we can help with your next Kentico project? LEARN MORE
 

Chad's Bio Coming Soon!

More About Virgil

Virgil Carroll is the owner and president of High Monkey – based in Minneapolis Minnesota. Virgil also wears the multiple ‘hats’ of Principle Human Solutions Architect and SharePoint Architect.

Virgil is one of those rare individuals who can dive deep into technical topics while speaking clearly to the business owners of a project and never forgetting that the end user experience has the highest priority. He calls it using both sides of his brain. Virgil is passionate about leveraging technologies ‘out of the box’ as much as possible with a focus on the strategic use of content to create websites that deliver the right content to the right audience on the right device at the right time. Virgil brings high energy, an ironic wit, and a sense of grounded perspective whenever he speaks to an audience. Virgil regularly speaks at conferences and user groups throughout the United States and occasionally in Europe.

Posted: 1/29/2014 12:00:00 AM by Brian Haukos | with 0 comments