Setup procedure

Overview

The following article describes how to setup Sitefinity CMS to work with a standalone ASP.NET Core application as renderer.

You first install Sitefinity NuGet packages in an ASP.NET Core application. This enables the application to render ASP.NET Core pages and to serve as a Sitefinity CMS proxy for all other types of pages, created with Sitefinity.

PREREQUISITES: To setup and run the Renderer application:
  • You must have installed ASP.NET Core SDK 5.0
  • You must have upgraded your Sitefinity CMS to version 13.3 or above.
  • Your Sitefinity license must include both your Renderer application domain (the frontend) and your Sitefinity CMS domain (the backend).

The following procedure describes how to setup Sitefinity CMS to work with the .NET Core Renderer application locally – when both applications are hosted locally. After you have ran and tested this scenario and you can move to a cloud hosting or a mixed hosting configuration. For more information see Hosting configurations.

Create the ASP.NET Core web application

You install the Renderer in a separate ASP.NET Core application. If you do not have one, create it in the following way:

  1. In Visual Studio, navigate to File » New » Project…
  2. Click ASP.NET Core Web Application » Next.
  3. In Project name, enter Renderer and click Create.
  4. Make sure ASP.NET Core 5.0 is selected and click Create.

Install the NuGet packages

In your Renderer application, you must install the provided NuGet packages:

  • Progress.Sitefinity.AspNetCore.nupkg
  • Progress.Sitefinity.AspNetCore.Widgets.nupkg
  • Progress.Sitefinity.Renderer.nupkg
    You need this package, if you want to customize the widget designers.

Perform the following:

  1. Save the provided NuGet packages in a folder on your computer.
  2. In Visual Studio, navigate to Tools » NuGet Package Manager » Package Manager Settings.
  3. Under NuGet Package Manager, click Package Sources.
  4. Add a new source, name it Sitefinity NuGet Repository, and, in Source field, enter https://nuget.sitefinity.com/nuget
  5. Click OK.
  6. Navigate to Tools » NuGet Package Manager » Manage NuGet Packages for Solution…
  7. In Package source dropdown, select Sitefinity NuGet Repository.
  8. Open the Browse tab, select Progress.Sitefinity.AspNetCore, and install it in project Renderer.
  9. Select Progress.Sitefinity.AspNetCore.Widgets and install it in project Renderer.

Configure the .NET Core Renderer

After you have created the project and installed the NuGet packages, you must configure it to connect it to Sitefinity CMS. In Visual Studio, perform the following:

  1. In the Solution Explorer on the right, select appSettings.json.
    Edit the file to add the Sitefinity-related configurations.

    The file should look in the following way:

  2. Select the Startup.cs file.
    Edit the file to add the Sitefinity-related configurations.

    The file should look in the following way:

  3. In the Solution Explorer on the right, expand Properties and select launchSettings.json.
  4. Find the object with property "commandName": "Project" and edit this object’s applicationUrl property.

    The property should look in the following way:
    "applicationUrl": "https://localhost:5001;http://localhost:5000"

  5. In Visual Studio toolbar, expand the run button dropdown, and select the launch profile you just edited.
    In your case, it is named Renderer.
  6. Build your solution.

Configure Sitefinity CMS

After creating and configuring your ASP.NET Core application, you have to configure your Sitefinity CMS. Perform the following:

  1. In Sitefinity CMS backend, navigate to Administration » Web services.
  2. Open the Default web service.
  3. Under Who can access the content by this service?, select Everyone.
  4. Save your changes.
  5. Navigate to Administration » Settings » Advanced.
  6. In tree on the left, expand Authentication » SecurityTokenService » IdentityServer » Clients » sitefinity.
  7. Click RedirectUris » Create new.
  8. In the input field, enter http://localhost:5000/signin-oidc
  9. Click Save and click Create new again.
  10. In the input field, enter https://localhost:5001/signin-oidc
  11. Save your changes.

Run the Renderer

To run the renderer, navigate to https://localhost:5001/Sitefinity or http://localhost:5000/Sitefinity

NOTE: You use these URLs to run the Renderer locally for development purposes. To setup the Renderer for production, you can use on of the hosting scenarios, described in Hosting configurations.

Quick setup procedure

Sitefinity comes with a .NET Core Sitefinity template which allows you to quickly setup your renderer and start experimenting with it. To do this, you use the .NET CLI that comes with the .NET Core SDK.

  1. Setup Sitefinity CMS, using the procedure above.
  2. Run the .NET CLI.
  3. Add Sitefinity NuGet source with the following command:
    dotnet nuget add source http://nuget.sitefinity.com/nuget
  4. Install the template with the folloing command:
    dotnet new -i Sitefinity.AspNetCoreMvc.Templates::*
  5. Create a new renderer app with the following command:
    dotnet new sitefinity --name YourProjectName --SfUrl "http://your.sitefinity.url"
  6. Add a widget to your project with the following command:
    dotnet new sitefinity-widget --name YourWidgetName
  7. Start the renderer using the following command:
    dotnet run

Related videos

To setup the .NET Core application, use the following video:

For Sitefinity CMS setup, use the following video:

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

Hosting configurations