Tgstation.Auth 1.0.0

Tgstation.Auth

A non-generic OAuth provider to be used with ASP.NET Core 5.0 and the /tg/station forums.

This adds all available user data as claims. Groups are added as roles with the group name as the role name. Default .NET ClaimTypes constants are used where possible, otherwise see TgClaimTypes.cs for all additional constants.

Example usage:

services.AddAuthentication(options =>
    {
        options.DefaultAuthenticateScheme = CookieAuthenticationDefaults.AuthenticationScheme;
        options.DefaultSignInScheme = CookieAuthenticationDefaults.AuthenticationScheme;
        options.DefaultChallengeScheme = TgDefaults.AuthenticationScheme;
    })
    .AddCookie()
    .AddTgstation(options =>
    {
        var tgAuthSection = Configuration.GetSection("Authentication:Tgstation");
        options.ClientId = tgAuthSection["ClientId"];
        options.ClientSecret = tgAuthSection["ClientSecret"];
        options.Scope.Add("user.details");
        options.Scope.Add("user.groups");
    });

Note that you will need a client ID and secret as provided by MSO, as there is currently no self-serve portal for application creation. See this post for more details on the /tg/station OAuth implementation.