Add deployment for Microsoft Account, deprecate Site Owner permission and retain Administrator Role as a System Role - This week in Orchard (01/11/2024)
Add deployment for Microsoft Account, deprecate Site Owner permission, and retain Administrator Role as a System Role, and our Open-Source Orchard Core Extensions solution is updated to Orchard Core 2.0! Check out our post for the details!
Orchard Core updates
Add deployment for Microsoft Account
The Microsoft Authentication module configures Orchard to support Microsoft Account and/or Microsoft Entra ID (Azure Active Directory) accounts. This change is about adding deployment support for the Microsoft Account.
First, we need to enable the Microsoft Account Authentication feature under Configuration -> Features to be able to try out this new addition. If you want to authenticate users with the Microsoft Account, you should create an app in the Application Registration Portal and add the web platform. We will not cover here how to do these steps but you can read more about the process in the documentation.
To configure the Microsoft Account setting in the admin dashboard, you need to navigate to Security -> Authentication -> Microsoft and fill out the form. Available settings are:
- AppId: Application ID in the Application Registration Portal.
- Secret Key: The application secret that will be used by Orchard.
- CallbackPath: The request path within the application's base path where the user-agent will be returned. The middleware will process this request when it arrives. If no value is provided, setup the Microsoft Account app to use the default path /signin-microsoft.
Now let's navigate to Configuration -> Import/Export -> Deployment Plans and create a new deployment plan. If you add a new deployment step to your plan, you will see a new plan, called Microsoft Account Settings. Choose this one and execute the plan by downloading the given zip file to the computer. If you check out the Recipe.json file inside the zip, you will see a step called MicrosoftAccountSettings which contains the Microsoft account settings that we have just set up a few minutes ago.
Deprecate Site Owner permission and retain the Administrator Role as a System Role
The Site Owner permission has been deprecated and is scheduled for removal in future releases. To streamline performance, the Administrator role has been retained as a system role, much like the Authenticated and Anonymous roles. This update enhances efficiency by assigning permissions at the role level, eliminating reliance on a single super-permission. Users previously granted the Site Owner permission will automatically receive the Administrator role through a fast-track migration process. Additionally, the Manage Recipes permission has been introduced, replacing the deprecated Site Owner permission for the Recipes feature. Here, you can see the new Manage Recipes permission which allows you to grant recipe management capabilities to any role, providing greater flexibility in permission assignment.
A new Apply Theme permission has also been introduced. This permission lets users list and apply themes, enhancing theme management capabilities. Previously, only users with the Site Owner permission could list themes.
Check out the release notes of the upcoming Orchard Core release to read more about this change, including how to customize the Administrator Role Name, and the new methods added to IRoleService.
News from the community
Updated Lombiq's Open-Source Orchard Core Extensions
This Orchard Core Visual Studio solution contains most of Lombiq's open-source Orchard modules and themes, as well as, related utilities and libraries. Please keep in mind that only those extensions included that use the latest released version of Orchard (i.e., the very cutting-edge ones depending on a nightly build are not yet here). Now, this solution has been updated to the latest and greatest 2.0 Orchard Core version.
Check them out here, and install them from NuGet or from the source! Bug reports, feature requests, comments, questions, and code contributions are warmly welcome, please do so via GitHub issues and pull requests. Please adhere to our open-source guidelines while doing so.
Orchard Dojo Newsletter
Lombiq's Orchard Dojo Newsletter has 468 subscribers! We have started this newsletter to inform the community around Orchard of the latest news about the platform. By subscribing to this newsletter, you will get an e-mail whenever a new post is published to Orchard Dojo, including This week in Orchard of course.
Do you know of other Orchard enthusiasts who would like to read our weekly articles? Tell them to subscribe here!