Authyo.AspNetCore.Auth 1.1.0

Authyo.AspNetCore.Authentication

SDK for integrating Authyo passwordless authentication in ASP.NET Core applications.

Features

• Multi-channel Authentication: Support for Email, SMS, WhatsApp, QR Code, OAuth, and Passkey
• Easy Integration: Simple configuration and setup
• Type-safe API: Strongly typed models and responses
• ASP.NET Core Integration: Built on top of Microsoft.AspNetCore.Authentication

Installation

dotnet add package Authyo.AspNetCore.Auth

Or via Package Manager Console:

Install-Package Authyo.AspNetCore.Auth

Quick Start

1. Configure Authyo in appsettings.json

{
  "Authyo": {
    "BaseUrl": "https://app.authyo.io",
    "ClientId": "YOUR_CLIENT_ID",
    "ClientSecret": "YOUR_CLIENT_SECRET"
  }
}

2. Register Services in Program.cs (or Startup.cs)

using Authyo.AspNetCore.Authentication;

var builder = WebApplication.CreateBuilder(args);

// Add Authyo services
builder.Services.AddAuthyoPasswordless(options =>
{
    options.BaseUrl = builder.Configuration["Authyo:BaseUrl"];
    options.ClientId = builder.Configuration["Authyo:ClientId"];
    options.ClientSecret = builder.Configuration["Authyo:ClientSecret"];
    options.DefaultMethod = AuthyoAuthMethod.Sms;
});

var app = builder.Build();

3. Use the Client

public class AuthController : ControllerBase
{
    private readonly IAuthyoPasswordlessClient _authyoClient;

    public AuthController(IAuthyoPasswordlessClient authyoClient)
    {
        _authyoClient = authyoClient;
    }

    [HttpPost("send-otp")]
    public async Task<IActionResult> SendOtp(string identity)
    {
        var result = await _authyoClient.SendOtpAsync(identity, AuthyoAuthMethod.Sms);
        return Ok(result);
    }

    [HttpGet("verify-otp")]
    public async Task<IActionResult> VerifyOtp(string otp, string maskId)
    {
        var result = await _authyoClient.VerifyOtpAsync(otp, maskId);
        return Ok(result);
    }
}

API Methods

• GetConfigurationAsync() - Get application customization configuration
• SendOtpAsync(identity, method, deviceInfo) - Send OTP to user
• VerifyOtpAsync(otp, maskId) - Verify OTP code
• VerifyTokenAsync(token) - Verify authentication token
• RevokeSessionAsync(token) - Revoke user session

Documentation

For more information, visit https://authyo.io/docs

License

MIT License - see LICENSE file for details