ManiaAPI.ManiaPlanetAPI.Extensions.Hosting 2.2.0

.NET 8.0 This package targets .NET 8.0. The package is compatible with this framework or higher. 
dotnet add package ManiaAPI.ManiaPlanetAPI.Extensions.Hosting --version 2.2.0
                    


                    

                
NuGet\Install-Package ManiaAPI.ManiaPlanetAPI.Extensions.Hosting -Version 2.2.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package. 
<PackageReference Include="ManiaAPI.ManiaPlanetAPI.Extensions.Hosting" Version="2.2.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="ManiaAPI.ManiaPlanetAPI.Extensions.Hosting" Version="2.2.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="ManiaAPI.ManiaPlanetAPI.Extensions.Hosting" />
                    


                            Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package. 
paket add ManiaAPI.ManiaPlanetAPI.Extensions.Hosting --version 2.2.0
                    


                    

                
#r "nuget: ManiaAPI.ManiaPlanetAPI.Extensions.Hosting, 2.2.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package. 
#addin nuget:?package=ManiaAPI.ManiaPlanetAPI.Extensions.Hosting&version=2.2.0
                    


                            Install ManiaAPI.ManiaPlanetAPI.Extensions.Hosting as a Cake Addin
                        

                    

                
#tool nuget:?package=ManiaAPI.ManiaPlanetAPI.Extensions.Hosting&version=2.2.0
                    


                            Install ManiaAPI.ManiaPlanetAPI.Extensions.Hosting as a Cake Tool

ManiaAPI.ManiaPlanetAPI.Extensions.Hosting

NuGet

Provides ManiaPlanet OAuth2 authorization for ASP.NET Core applications and an efficient way to inject ManiaPlanetAPI into your application.

Setup ManiaPlanetAPI injection

ManiaPlanetAPI will be available as a transient, with a singleton handling of credentials. This will make sure the HttpClient beneath is handled properly.

Providing options.Credentials is optional, but setting it will automatically authorize on the first request and maintain that connection, so you don't have to call AuthorizeAsync.

using ManiaAPI.ManiaPlanetAPI.Extensions.Hosting;

builder.Services.AddManiaPlanetAPI(options =>
{
    options.Credentials = new ManiaPlanetAPICredentials(
        builder.Configuration["ManiaPlanet:ClientId"]!,
        builder.Configuration["ManiaPlanet:ClientSecret"]!);
});

Setup OAuth2

For the list of scopes, see here at the bottom. Generate your credentials here. The redirect URL is the /signin-maniaplanet relative to the web root, for example: https://localhost:7864/signin-maniaplanet.

using ManiaAPI.ManiaPlanetAPI.Extensions.Hosting;
using ManiaAPI.ManiaPlanetAPI.Extensions.Hosting.Authentication;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddAuthentication(CookieAuthenticationDefaults.AuthenticationScheme)
    .AddCookie()
    .AddManiaPlanet(options =>
    {
        options.ClientId = builder.Configuration["OAuth2:ManiaPlanet:ClientId"]!;
        options.ClientSecret = builder.Configuration["OAuth2:ManiaPlanet:ClientSecret"]!;

        Array.ForEach(["basic", "dedicated", "titles"], options.Scope.Add);
    });

var app = builder.Build();

app.MapGet("/login", () =>
{
    return TypedResults.Challenge(new() { RedirectUri = "/" }, [ManiaPlanetAuthenticationDefaults.AuthenticationScheme]);
});

app.Run();

You can inject ManiaPlanetAPI if you create a special HTTP client handler to provide the token from HttpContext.GetTokenAsync("access_token") and use that to get more information from the authorized user. Don't forget to set SaveTokens = true in options.

Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.2.0 149 4/6/2025
2.1.0 452 3/24/2025
2.0.0 147 3/23/2025