Redakt Back Office application

The back office application is the user interface for Redakt CMS, where your users manage the website's content. The back office is an optional feature, although all websites will require the back office in one application or another. The back office aqpplication is installed as an optional NuGet package.

Installation

Install the package with the NuGet package manager or the Package Manager Console.

PM> Install-Package Redakt.BackOffice

Register back office services in the ConfigureServices method in your project's Startup.cs file.

public void ConfigureServices(IServiceCollection services)
{
    // ... framework and other services here

    services.AddRedakt(this.Configuration, builder =>
    {
        // ... other Redakt services
        builder.AddBackOffice();
    });
}

Add the back office application to the HTTP request pipeline in the Configure method your project's Startup.cs file. If you're also including the web rendering engine in this project, add the back office middleware before the main Redakt middleware.

public void Configure(IApplicationBuilder app, IHostingEnvironment env, ILoggerFactory loggerFactory)
{
    // ... other pipeline configuration here

    // Add back office before the main Redakt middleware
    app.UseRedaktBackOffice();
    app.UseRedakt();
}

Configuration

The back office application can be configured through the appsettings.json file. Following are the default settings. Any configuration that you do not include in your appsettings.json file will be set to its default.

{
    "Redakt": {
        "BackOffice": {
            "RootUrl": "/redakt",
            "RequireHttps": false,
            "Authentication": { ... }
        }
    }
}

Root URL

This is the absolute url that the back office application is served from. You can change this if the back office url would conflict with your own website content, or if you wish to minimize the information your website is exposing about the underlying host system (hackers could scan for a /redakt page response to know which CMS you are using).

If you are hosting the back office on a separate website and hostname, you could also set this to the website root (/), in which case the back office application will be available on the hostname root url (e.g. https://redakt.mywebsite.com).

Require HTTPS

If set to true, the back office application will be available via a secure SSL connection only. Requests to unsecure urls will not be handled and return a 404 not found result.

We strongly recommend to enable this setting and access the back office through a secure connection only! Insecure connections are vulnerable to man-in-the-middle attacks. Some external identity providers will only accept secure callback urls.

Authentication

This sets and configures the back office authentication method(s). Redakt username/password based authentication is default. A number of external identity providers are available from a separate NuGet package. See back office authentication for more information and configuration options.