ActiveLogin.Authentication

ActiveLogin.Authentication enables an application to support Swedish BankID (svenskt BankID) authentication in .NET.

Active Login is licensed is provided under the very permissive MIT license for you to be able to use it in commercial or non-commercial applications without many restrictions. Active Login is provided "as is", without any warrany of any kind. If you need support, commercial support and training is available.

Active Login is not a product created by BankID. It is an unofficial project that was developed by Active Solution. All trademarks are the property of their respective owners.

Features

• :id: Supports BankID Auth (API, Flow and UI)
• :pencil: Supports BankID Sign (API, Flow and UI)
• :phone::id: Supports BankID Phone Auth (API)
• :phone::pencil: Supports BankID Phone Sign (API)
• :relaxed: Supports BankID Verify digital ID card (API)
• :penguin: Cross platform: Targets .NET Standard 2.0 and .NET 8
• :six: Built on V6.0 (the latest) BankID JSON API
• :checkered_flag: Supports BankID animated QR code (Secure start)
• :cloud: Designed with Microsoft Azure in mind (KeyVault, Monitor, Application Insights, AD B2C etc.)
• :earth_americas: Multi language support with English and Swedish out of the box
• :wrench: Customizable and extensible
• :diamond_shape_with_a_dot_inside: Can be used as a Custom Identity Provider for Azure AD B2C

Screenshots

Screenshots on how the default UI for Native BankID looks on different devices.

Screenshot on monitoring dashboard.

Table of contents

Note: This Readme reflects the state of our main branch and the code documented here might not be released as packages on NuGet.org yet. For early access, see our CI builds.

• ActiveLogin.Authentication
  • Features
  • Screenshots
  • Table of contents
  • Projects & Packages overview
  • Usage & Docs
  • Samples
  • Tests
  • FAQ
    • What version of .NET is supported?
    • How do I build the solution locally?
      • Devcontainer and GitHub Codespaces
    • How do I run the samples locally?
    • How do I use Active Login to get support for BankID in Azure AD (Active Directory) B2C?
  • Active Login
    • Security
    • Contribute
      • Contributors
    • Stay updated and join the discussion
    • License
    • Acknowledgements
    • Sponsors
    • Support & Training

Projects & Packages overview

CI-builds from main of all packages are available in our GitHub Packages feed.

| Project | Description | NuGet | Downloads | | ------- | ----------- | ---- | --------- | | BankId.Api | API client for the Swedish BankID REST API. | | | | BankId.Core | Core functionality for the BankID flow. | | | | BankId.AspNetCore | ASP.NET authentication module for Swedish BankID. | | | | BankId.AzureKeyVault | Azure KeyVault integrations for the AspNetCore package. | | | | BankId.AzureMonitor | Azure Monitor (Application Insights) integrations for the AspNetCore package. | | | | BankId.QRCoder | QR code generation using QRCoder the AspNetCore package. | | | | BankId.UAParser | Device and browser detection using UAParser. | | |

Usage & Docs

Full documentation with step by step instructions, samples, customization and details on how to configure the options is available here:

Documentation for ActiveLogin.Authentication.BankID

Active Login is designed to make it easy to get started with BankID in .NET. The most basic setup looks like this:

// Common
services
    .AddBankId(bankId =>
    {
        bankId.UseTestEnvironment();
    });

// Auth
services
    .AddAuthentication()
    .AddBankIdAuth(bankId =>
    {
        bankId.AddSameDevice();
    });

// Sign
services
    .AddBankIdSign(bankId =>
    {
        bankId.AddSameDevice();
    });

---

Samples

For more use cases, samples and inspiration; feel free to browse our unit tests and samples.

Note: These are samples on how to use Active Login in different situations and might not represent optimal way of setting up ASP.NET MVC, IdentityServer or other components. Please see them as inspiration.

| Project | Description | | ------- | ----------- | | IdentityServer.ClientSample | ASP.NET MVC site using the IdentityServer.ServerSample as auth provider. | | IdentityServer.ServerSample | IdentityServer with Active Login as auth provider for BankID. | | Standalone.MvcSample |