Skip to content

Installation

Aufy is built on top of ASP.NET Core Identity framework, which is database agnostic. Currently only Entity Framework Core implementation is available, but you can use any other database provider.

Install nuget package

dotnet add package Aufy.EntityFrameworkCore

Create DbContext

Add a new DbContext class that inherits from AufyDbContext.

public class MyAuthDbContext : AufyDbContext<AufyUser>
{
    public MyAuthDbContext(DbContextOptions<MyAuthDbContext> options) : base(options)
    {
    }
}

Register your DbContext in DI container

Sample registration with SQLite database:

{
  "ConnectionStrings": {
    "DefaultConnection": "Data Source=auth.db"
  }
}

var connectionString = builder.Configuration.GetConnectionString("DefaultConnection")

builder.Services.AddDbContext<MyAuthDbContext>(options => options.UseSqlite(connectionString));

Register Aufy services in DI container

builder.Services
    .AddAufy<AufyUser>(builder.Configuration, opts => { /* configure options here */ })
    .AddEntityFrameworkStore<MyAuthDbContext, AufyUser>()

Add JWT Bearer configuration

{
  "Aufy": {
    "JwtBearer": {
      "SigningKey": "super secret key",
      "Issuer": "MY_ISSUER",
      "Audience": "MY_AUDIENCE"
    }
  }
}

Add authentication and authorization middleware and Aufy endpoints

app.UseAuthentication();
app.UseAuthorization();

app.MapAufyEndpoints();

Add migrations and update database

dotnet ef migrations add MIGRATION_NAME
dotnet ef database update

Congratulations! You have successfully installed Aufy!