Authentication

Overview

Sitefinity CMS uses claims authentication, implemented on top of IdentityServer3, certified by OpenID Foundation. It allows implementing single sign-on and access control for modern web applications and APIs. It uses OAuth2 and OpenID Connect protocols. This integration allows easy connection with clients such as mobile, web, SPAs ,and desktop applications. It is also extensible and allows integration in new and existing architectures. 

The authentication is designed and implemented as separate Microsoft OWIN / Katana component. It uses standard Microsoft.Owin.Security libraries and standard namespace System.Security. Additionally, there are some extensions to support external provider logins, such as Facebook or GitHub. 

Advantages

Authentication model in Sitefinity CMS has the following advantages: 

  • Improved security 
    Users do not have to deploy same passwords and accounts across multiple websites. Using OpenID Connect, passwords are never shared with any websites. 
  • Standardized authentication, based on OpenID Connect with JWT, certified IdentityServer3. 
  • Out-of-the-box support for logging in with your Windows, Facebook, Google, Microsoft, Twitter, LinkedIn, or GitHub account. 
  • Better extensibility. 
    Easy extension for any other OpenId Connect external providers. You can use some of already available OWIN implementations and plug it in Sitefinity CMS. 
  • Login with email
    Easier to remember, simplifying the management of collisions, better for email verification and password recovery. 
  • API improvements 
    Using standard Principal class, standard System.Security, and cleanups
  • Ability to configure your own STS certificate

Authentication flow 

Sitefinity CMS can serve both as Relying Party (RP) and Identity Provider (IP). Usually, these can be one web application on the same host, but with different URLs. However, in a Single-Sign-On (SSO) scenario, these can be on different servers (applications). In both cases the communication between IP and RP is via HTTP and goes trough the client. 

Authentication flow diagram

Auth-flow

Configure certificates for your site

To ensure security, you must configure the following two types of certificates for Sitefinity CMS:

  • SSL/TLS certificate for the site
    This certificate ensures the identity of the URL that is requested by the client (browser). It is used in all the steps from the above diagram.

    NOTE: Although Sitefinity works successfully on HTTP and HTTPS, we recommend to use SSL/TLS certificate for your site.

  • Identity server signing certificate

This certificate is used to verify the issuer of the authentication token – it is used by Sitefinity CMS Identity provider to sign the identity token (Step 4 in the diagram). It is also used by Sitefinity CMS Relying party to ensure that the authentication token has been issued by the correct Identity provider (Steps 6 in the diagram).

To configure this certificate:

  1. Navigate to Administration » Settings » Advanced » Authentication » SecurityTokenService » IdentityServer » SigningCertificate.
  2. Fill out the fields and make sure the SubjectName field matches the subject name of the certificate.
  3. Restart Sitefinity CMS after configuring the certificate. 

If you have not configured the certificate, a default certificate is used and the System status dashboard widget displays a warning informing you that this is a security risk. For more information, see System status.

You can also check the error logs for information related to the warning displayed in the System status dashboard widget.

NOTE: The certificate must have a private key and the application pool user that runs Sitefinity CMS identity provider must have rights to access it to use it for signing.

Increase your Sitefinity skills by signing up for our free trainings. Get Sitefinity-certified at Progress Education Community to boost your credentials.

Get started with Integration Hub | Sitefinity Cloud | Sitefinity SaaS

This free lesson teaches administrators, marketers, and other business professionals how to use the Integration hub service to create automated workflows between Sitefinity and other business systems.

Web Security for Sitefinity Administrators

This free lesson teaches administrators the basics about protecting yor Sitefinity instance and its sites from external threats. Configure HTTPS, SSL, allow lists for trusted sites, and cookie security, among others.

Foundations of Sitefinity ASP.NET Core Development

The free on-demand video course teaches developers how to use Sitefinity .NET Core and leverage its decoupled architecture and new way of coding against the platform.

Was this article helpful?

Next article

Users