Note: This guide describes Kentico CMS version 7. Unfortunately, we cannot support this guide from version 8 forward. Go to latest documentation

Skip to end of metadata
Go to start of metadata

Kentico offers two services which provide communication and synchronization of content and objects between servers. Both services are disabled by default. You should turn the services on only if you know you will be needing them.

  • You can enable Staging at Site Manager -> Settings -> Versioning & Synchronization -> Staging.
  • You can enable REST at Site Manager -> Settings -> Integration -> REST.

Staging

The weakest spot of the Staging service is in the authentication process. If potential attackers obtained the user name and password for the service, they could stage the administrator and gain absolute power over the system.

You can secure the staging service using two authentication options:

  • User name and password
  • X.509 certificate

The recommended option is to use the X.509 certificates for authentication, as certificates generally provide better security. See Using X.509 authentication for more details.

On this page

REST

The REST service provides access to the objects in Kentico, so a potential attacker could obtain any data from the system or modify them.

You can secure the REST service using these authentication options:

  • Basic authentication - it is strongly recommended to use SSL with this type of authentication. See Configuring SSL for more details.
  • Forms authentication - this is the standard ASP.NET authentication.

The recommended option here is to use the basic authentication with SSL.

You can also use the Hash parameter authentication for authenticating individual REST requests. You only need to generate the hash in the administration interface and add the hash to URL. This URL then serves a particular REST request without the need of further authentication. See Authenticating REST requests for more details.

The REST service should optimally check the correct authentication with every request. However, because of other services in Kentico (e.g., chat), which need some HTTP context within WCF, the checks are not performed every time. You can change this behavior by changing the aspNetCompatibilityEnabled key to false in the <system.serviceModel> section of the web.config file:

<serviceHostingEnvironment aspNetCompatibilityEnabled="false" />

Note that setting this key also disables the chat functionality.

Best practice

The best practice with REST is to assign a dedicated user to the service, grant the user permissions only for the desired objects, configure access through SSL and disable the aspNetCompatibilityEnabled mode.