Devinux.TokenManager 1.0.1

Devinux TokenManager (with Authorization)

an easy use library for Create Token Manager Service With Custom Inline Data and Integrated Authorization

Join with us

• Integrated Token Repository.
• Custom Category Grouping.
• Custom Token Generator.
• Action Filtering.
• Custom Authorize Attribute.
• Multi Authorize Attribute.
• Custom Request Header Keys.
• Check Unique Constraint for any Token Data's (Dynamic).
• Multi Request Header Keys.
• Ready for Custom Role Attributes.
• Ready for Create Role Enum.
• 😉

Join with us

Please Contact with our team : info@webinux.ir

Contributing

Pull requests are welcome. For major changes, please open an issue first to discuss what you would like to change.

Please make sure to update tests as appropriate.

License

MIT

Usage

► program.cs
    using Devinux.TokenManager; /* #1. add refrances */

    // var builder = WebApplication.CreateBuilder(args);
    .
    .
    .
    /* #2. Create Main Service */
    // only Token manager
    builder.Services.AddDevinuxTokenManager();
    // with authorize manager
    builder.Services.AddDevinuxTokenManager(c=>
        // create token life time
        c.TokenExpireMinute = 20;
        
        // create log listener
        c.OnLog += (s) => Console.WriteLine(s);
        
        // attach custom attribute types for check on action filtering
        c.AuthorizeAttributeTypes.Add(typeof(CustomAuthorizeAttribute));
        
        // custom check body method
        c.OnCheckToken += (FoundedToken, Context, AuthorizeAttributeList) => { };
    );
    
    /* 
        #2.1 
        if u want create token manager with authorization section on your project,
        u must add Actionfilter on mvc Service
        Create Action Filter For Authorization 
    */
    builder.Services.AddMvc(o => {
        o.Filters.Add(typeof(Devinux.TokenManager.DevinuxTokenManagerActionFilter)); 
    });
    .
    .
    .
    
    /* done , enjoy ;)  */ 
...

Authorization Samples

[HttpPut]
[DevinuxAuthorize]
[DevinuxAllowAnonymous] // <-- override for Authorize = method is allow for anyone
public IActionResult Action()
// ----- ----- ----- ----- ----- ----- ----- ----- ----- -----
[Authorize]
public IActionResult Action()
// ----- ----- ----- ----- ----- ----- ----- ----- ----- -----
[Authorize] or [DevinuxAuthorize] or [any attribute on program.cs]
public class Controller : ControllerBase 
{
    [DevinuxAllowAnonymous] // except method on all action in controller
    public IActionResult Action()
}

Token Management Samples

private readonly IDevinuxTokenManager _tm;
constructor (IDevinuxTokenManager tm)
{
    _tm = tm;
}

public void Login(string username, string password)
{
    var signedUSerObject = new { username = "signed-user", id = 1 /* ... any data */ };

    // add genrated token
    _tm.Add(new DevinuxToken()
    {
        Data = signedUSerObject,
        ExpireDate = DateTime.Now.AddMinutes(_tm.Config.TokenExpireMinute),
        Category = "login",
        Key = "Generate Key"
    });

    // get default active with category
    _tm.GetTokenByCategory("proxy-tokens");

    // clear all tokens
    _tm.DeleteTokens();

    // delete token by key
    _tm.Delete("token key");

    // revoke time
    _tm.Revoke("token key");

    // get token by key
    _tm.GetTokenByKey("token key");
    
    // check token is valid
    if (_tm.Validate("token key")) { }
}