Rask.Auth.Client 0.23.1-alpha.0.206

This is a prerelease version of Rask.Auth.Client.

dotnet add package Rask.Auth.Client --version 0.23.1-alpha.0.206

NuGet\Install-Package Rask.Auth.Client -Version 0.23.1-alpha.0.206

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="Rask.Auth.Client" Version="0.23.1-alpha.0.206" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Rask.Auth.Client" Version="0.23.1-alpha.0.206" />
                    

                            Directory.Packages.props

<PackageReference Include="Rask.Auth.Client" />
                    

                            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 Rask.Auth.Client --version 0.23.1-alpha.0.206

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Rask.Auth.Client, 0.23.1-alpha.0.206"

#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.

#:package Rask.Auth.Client@0.23.1-alpha.0.206

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Rask.Auth.Client&version=0.23.1-alpha.0.206&prerelease
                    

                            Install as a Cake Addin

#tool nuget:?package=Rask.Auth.Client&version=0.23.1-alpha.0.206&prerelease
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Rask.Auth.Client

The browser half of Rask.Auth. Register it and a WebAssembly app has the same three flows a server-rendered one has — written the same way.

var builder = WasmHostBuilder.CreateDefault();
builder.Services.AddRaskAuthClient();
await builder.Run<App>();

That is the whole of it. After that a component reads the current user and signs somebody in with exactly the code it would use on the Server host:

public sealed class LoginForm(IAuth auth) : Component
{
    private async Task SubmitAsync(Credentials c) =>
        await auth.SignIn(c.Email, c.Password, returnUrl: "/");
}

public sealed class Header(IUserProvider users) : Component
{
    protected override Component Render() =>
        Authorize
            .NotAuthorized(NavLink.Href("/login")["Sign in"])
            .Authorized(user => Span[$"Hi, {user.Identity?.Name}"]);
}

What it does

AddRaskAuthClient() replaces the browser host's anonymous IUserProvider with one that reads the app's own GET /api/auth/me, and registers an IAuth that posts to /api/auth/register, /login and /logout. Calls are same-origin, so the auth cookie rides along on its own — no token is ever held in JavaScript, and there is nothing for a script on the page to read.

The current user is loaded before the first render, so a page never paints anonymous and then flips.

What it deliberately does not carry

The accounts and Entity Framework. Those live in Rask.Auth, on the server, and have no business in a trimmed browser publish. The two halves agree through the AuthApi wire contract in Rask.Core rather than by referencing each other.

Full documentation: rask.sh · docs/authentication.md

Product	Compatible and additional computed target framework versions.
.NET	net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- Rask (>= 0.23.1-alpha.0.206)
- Rask.Wire (>= 0.23.1-alpha.0.206)

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Rask.Auth.Client:

Package	Downloads
Rask.Wasm The Rask browser host: runs a Rask app's C# components client-side on .NET WebAssembly, with the client halves of the batteries — the mediator and query cache, remote dispatch, accounts, validation and the component kit — on by default. Ships the JS boot scripts, the page shell, and the MSBuild integration that stages them into the published bundle — and, opted in, prerenders every route to static HTML with a sitemap.xml at publish, so a static host serves real pages to visitors and crawlers. Depends on Rask, the shared core.	53.1K

Package

Downloads

Rask.Wasm

The Rask browser host: runs a Rask app's C# components client-side on .NET WebAssembly, with the client halves of the batteries — the mediator and query cache, remote dispatch, accounts, validation and the component kit — on by default. Ships the JS boot scripts, the page shell, and the MSBuild integration that stages them into the published bundle — and, opted in, prerenders every route to static HTML with a sitemap.xml at publish, so a static host serves real pages to visitors and crawlers. Depends on Rask, the shared core.

53.1K

GitHub repositories

This package is not used by any popular GitHub repositories.