Skip to content

Latest commit

 

History

History
130 lines (89 loc) · 3.72 KB

INSTALLATION.md

File metadata and controls

130 lines (89 loc) · 3.72 KB

Installation

All necessary logic for security is located in AxOpen.Security library.

1. Install AxOpen.Security NuGet package or add reference to this project

2. Add reference to AxOpen.Security assembly.

Go to App.razor and add AdditionalAssemblies as parameter of Router component. The following line must be added to Router component:

AdditionalAssemblies="new[] { typeof(BlazorSecurity).Assembly}">

Also, make sure, that Router component is wrapped inside CascadingAuthenticationState component. At the end, the Router component should look like this:

<CascadingAuthenticationState>
    <Router AppAssembly="@typeof(App).Assembly" 
            AdditionalAssemblies="new[] { typeof(BlazorSecurity).Assembly}">
            ...
    </Router>
</CascadingAuthenticationState>

3. Configure Ax Blazor security services in dependency injection container of Blazor application located in Program.cs file.

To correctly configure security services you must:

  • configure repository
  • create in-app roles
  • configure AxBlazorSecurity in DI container

Configuring repository

The security requires 2 instances of repositories:

  • for persistence of user data
  • for persistence of groups of roles

Within AXOpen 4 different types of repositories are available:

  • InMemory
  • Json
  • MongoDB
  • RavenDB

For example, the Json repository can be configured as follows:

[!code-csharp]

Add SetUpJson method in Program.cs file.

Creating in-app roles

In your Blazor application create new static class Roles and specify the roles, that will be used in your application. You can add as many roles as you want. The Roles class can be defined like this:

public static class Roles
{
    public static List<Role> CreateRoles()
    {
        var roles = new List<Role>
        {
            new Role(process_settings_access),
            new Role(process_traceability_access),
        };

        return roles;
    }

    public const string process_settings_access = nameof(process_settings_access);
    public const string process_traceability_access = nameof(process_traceability_access);
}

Configure AxBlazorSecurity services

Finally, the AxBlazorSecurity security can be configured in DI container of Blazor application. Go to Program.cs file and add following line to builder:

[!code-csharp]

The first parameter is set up repository and the second parameter are created roles.

4. Add security views to application

Go to MainLayout.razor located in Shared folder and add LoginDisplay view inside top bar.

<main>
    <div class="top-row px-4 auth">
        <AxOpen.Security.Views.LoginDisplay/>
    </div>

    <article class="content px-4">
        @Body
    </article>
</main>

Within Pages of the Blazor application, create new Security.razor page and add there SecurityManagementView.

@page "/Security"

<h3>Security</h3>

<AxOpen.Security.Views.SecurityManagementView />

Add you security view inside the navigation menu in NavMenu.razor:

<div class="nav-item px-3">
    <NavLink class="nav-link" href="security">
        <span class="oi oi-list-rich" aria-hidden="true"></span> Security
    </NavLink>
</div>

Default login

If everything done correctly, now security should be available in Blazor application. Now it should be possible to log-in with default user. The default user is created on application startup with following credentials:

  • Username: admin
  • Password: admin

The user has default Administrator role and is in default AdminGroup.