Passwordless.AspNetCore 0.0.12

Passwordless ASP.NET Core Integration

The official Bitwarden Passwordless.dev ASP.NET Identity integration. Automatically adds endpoints to verify passwordless signin and sign the user in using the existing ASP.NET Identity code.

Installation

Nuget Package

Using the .NET Core command-line interface (CLI) tools:

dotnet add package Passwordless.AspNetCore

Using the NuGet Command Line Interface (CLI):

nuget install Passwordless.AspNetCore

Using the Package Manager Console:

Install-Package Passwordless.AspNetCore

From within Visual Studio:

1. Open the Solution Explorer.
2. Right-click on a project within your solution.
3. Click on Manage NuGet Packages...
4. Click on the Browse tab and search for "Passwordless.AspNetCore".
5. Click on the Passwordless package, select the appropriate version in the right-tab and click Install.

Usage

In Minimal APIs

var builder = WebApplication.CreateBuilder(args);

services.AddIdentity<MyUser, MyRole>()
      .AddEntityFrameworkStores<MyDbContext>()
      .AddPasswordless(Configuration.GetRequiredSection("Passwordless"));

var app = builder.Build();

app.MapPasswordless();

app.Run();

In MVC

// In Startup.cs
public void ConfigureServices(IServiceCollection services)
{
    services.AddIdentity<MyUser, MyRole>()
      .AddEntityFrameworkStores<MyDbContext>()
      .AddPasswordless(Configuration.GetRequiredSection("Passwordless"));

    services.AddControllers();
}

public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
{
    app.UseRouting();

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

    app.UseEndpoints(endpoints =>
    {
        endpoints.MapPasswordless();
        endpoints.MapControllers();
    });
}

Documentation

For a comprehensive list of examples, check out the API documentation.