Applyze.Shared.Authentication.AspNetCore 1.0.6.2

Applyze.Shared.Authentication

This package includes AspNetCore 2.2 Authentication Attributes for Applyze Tenant.

Installation

NuGet Package

You can find NuGet Package and instructions from here

• Open Package Manager Console and run following command:

Install-Package Applyze.Shared.Authentication.AspNetCore

• Or just add following package reference to .csproj file:

    <PackageReference Include="Applyze.Shared.Authentication" Version="1.0.4" />
    <PackageReference Include="Applyze.Shared.Authentication.AspNetCore" Version="1.0.4" />

Set-Up

• Go to Startup.cs
• Add following code into ConfigureServices() method:

services.AddApplyzeAuthentication(builder => builder.SetTenantBaseUrl("test.com/v1"));

// or you can set it from your configuretion
services.AddApplyzeAuthentication(builder => builder.SetTenantBaseUrl(Configuration.GetSection("Applyze:TenantUrl").Value));

Usage

Authenticate with Attribute

There is an ApplyzeAuthenticateAttribute which is located at Applyze.Shared.Authentication.Filters namespace nad ready to use authenticate your Controllers or Actions.

Sample:

• Add following code into ConfigureServices() method:

//...
using Applyze.Shared.Authentication.Filters;
//...

[ApplyzeAuthenticate] // <-- Authenticates ApiKey from Tenant
public class YourController()
{
    [AllowAnonymous]  // <-- Authentication disabled for this action
    public IActionResult YourAction()
    {
        //...
    }

    [ApplyzeAuthenticate(AuthenticationType.ApplicationLevel)] // <-- Authenticates ApiKey, AppKey
    public IActionResult YourOtherAction()
    {
        //...
    }

    [ApplyzeAuthenticate(AuthenticationType.ApplicationOwnerLevel)] // <-- Authenticates ApiKey, UserApiKey and AppKey from Tenant
    public IActionResult YourAnotherAction()
    {
        //...
    }
}

Or you can combine your own requirements with bitwise OR like following sample:

    [ApplyzeAuthenticate(AuthenticationType.ApiKey | AuthenticationType.UserApiKey | AuthenticationType.AppKey)]

Getting Authenticated App

//...
using Applyze.Shared.Authentication.Helpers;
//...

[ApplyzeAuthenticate(AuthenticationType.ApplicationLevel)] 
public class YourController()
{
    public IActionResult YourAction()
    {
        var app = HttpContext.GetCachedApp();
        Console.WriteLine(app.Name);
        //...
    }
}