Scott Reed
Nov 17, 2021
  2174
(3 votes)

Restore Root CMS episerver Login Path In .NET 5

Introduction

With the release of CMS 12 there was the removal of dashboards which has caused the base login path to not work when created in a new project via the steps documented here https://world.optimizely.com/documentation/developer-guides/CMS/getting-started/creating-a-starter-project/ 

Now with the out of the box code you have to navigate to /episerver/cms to access the CMS Editing area.

Although you can change the path to the CMS editing experience with the documented approach https://world.optimizely.com/documentation/developer-guides/CMS/configuration/changing-edit-and-admin-view-urls/ it does not work to change this to just /episerver as there needs to be a subpath for the CMS experience.

Solution

Using the ASP.NET Rewriting Middleware https://docs.microsoft.com/en-us/aspnet/core/fundamentals/url-rewriting?view=aspnetcore-5.0 we can add a redirect to reirect /episerver to /episerver/cms

First add the nuget package

dotnet add package Microsoft.AspNetCore.Rewrite --version 2.2.0

Then add in the redirect to the Startup.cs configure code

var options = new RewriteOptions().AddRedirect("episerver$", "episerver/cms");
app.UseRewriter(options);

Conclusion

This is something simple but I've seen people confused https://world.optimizely.com/forum/developer-forum/CMS/Thread-Container/2021/11/cms12-emptystarter-project-not-working/ therefore I wanted to post about it and propose an easy solution to remedy the problem. Ideally when you go to the root /episerver as everyone is used to doing you want to go to the CMS which this will do.

Also as a note now that Episerver is no longer the company name it strikes me odd to preserve it so I would follow the approach in https://world.optimizely.com/documentation/developer-guides/CMS/configuration/changing-edit-and-admin-view-urls/ anyhow and consider changing the default URL path to remove the old brand. Such as /cms/cms with a redirect from /cms &  /episerver to /cms/cms or any name of your choice :-) 

Happy coding!! Add any thoughts, errors or suggestions in the comments below!!

Nov 17, 2021

Comments

Please login to comment.
Latest blogs
Recraft's image generation with AI-Assistant for Optimizely

Recraft V3 model is outperforming all other models in the image generation space and we are happy to share: Recraft's new model is now available fo...

Luc Gosso (MVP) | Nov 8, 2024 | Syndicated blog

ExcludeDeleted(): Prevent Trashed Content from Appearing in Search Results

Introduction In Optimizely CMS, content that is moved to the trash can still appear in search results if it’s not explicitly excluded using the...

Ashish Rasal | Nov 7, 2024

CMS + CMP + Graph integration

We have just released a new package https://nuget.optimizely.com/package/?id=EPiServer.Cms.WelcomeIntegration.Graph which changes the way CMS fetch...

Bartosz Sekula | Nov 5, 2024

Block type selection doesn't work

Imagine you're trying to create a new block in a specific content area. You click the "Create" link, expecting to see a CMS modal with a list of...

Damian Smutek | Nov 4, 2024 | Syndicated blog