MaksIT.IdentityHub.Client 1.1.0

There is a newer version of this package available.
See the version list below for details.

dotnet add package MaksIT.IdentityHub.Client --version 1.1.0

NuGet\Install-Package MaksIT.IdentityHub.Client -Version 1.1.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="MaksIT.IdentityHub.Client" Version="1.1.0" />

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

<PackageVersion Include="MaksIT.IdentityHub.Client" Version="1.1.0" />
                    

                            Directory.Packages.props

<PackageReference Include="MaksIT.IdentityHub.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 MaksIT.IdentityHub.Client --version 1.1.0

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

#r "nuget: MaksIT.IdentityHub.Client, 1.1.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.

#:package MaksIT.IdentityHub.Client@1.1.0

#: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=MaksIT.IdentityHub.Client&version=1.1.0
                    

                            Install as a Cake Addin

#tool nuget:?package=MaksIT.IdentityHub.Client&version=1.1.0
                    

                            Install as a Cake Tool

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

MaksIT.IdentityHub.Client

HTTP client for the MAKS-IT Identity Hub API.

Health (/health/*): liveness, readiness, and startup phase.
Login external (/login-external/*): OAuth challenge URL, OTC redeem, mailbox access-token refresh.
IP allow-list: set ClientIpForAuthorization (sent as X-Forwarded-For) for redeem and refresh-mailbox.

Shared wire types (MaksIT.IdentityHub.Contracts) are bundled in this NuGet package.

Features

IIdentityHubClient / IdentityHubClient for health and login-external flows.
DI registration via AddIdentityHubClient (Microsoft.Extensions.Http, auto-redirect disabled for OAuth challenge).
IdentityHubApiException when the API returns a non-success status code.

Installation

dotnet add package MaksIT.IdentityHub.Client

Target Framework

.NET 10 (net10.0)

Quick Start

Dependency injection

using MaksIT.IdentityHub.Client;

builder.Services.AddIdentityHubClient(
    "https://identity.example.com",
    clientIpForAuthorization: "10.0.0.5");

Or with options:

builder.Services.AddIdentityHubClient(opts => {
  opts.BaseAddress = "https://identity.example.com";
  opts.ClientIpForAuthorization = "10.0.0.5";
});

Manual construction

var httpClient = new HttpClient();
var client = new IdentityHubClient(httpClient, "https://identity.example.com", clientIpForAuthorization: "10.0.0.5");

Typical flow

var challengeUrl = await client.GetLoginExternalChallengeAsync(
    provider: "Google",
    postLogin: "https://app.example.com/oauth/callback");

var exchange = await client.RedeemLoginExternalAsync(oneTimeCode);

API surface

Area	Methods
Health	`CheckHealthLiveAsync`, `CheckHealthReadyAsync`, `GetStartupHealthAsync`
Login external	`GetLoginExternalChallengeAsync`, `RedeemLoginExternalAsync`, `RefreshMailboxAccessTokenAsync`

PowerShell

See MaksIT.IdentityHub.Client.PowerShell (Connect-IdentityHub, health and login-external cmdlets).

Contributing

See CONTRIBUTING.md.

License

See LICENSE.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
- MaksIT.Core (>= 1.6.7)
- Microsoft.Extensions.Http (>= 10.0.9)
- Microsoft.Extensions.Options (>= 10.0.9)

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
1.4.0	54	8/1/2026
1.3.0	51	7/30/2026
1.1.0	91	7/27/2026

See https://github.com/MAKS-IT-COM/maksit-identity-hub/releases