Authlink.Identity.Client.Http 2.3.0

Package Overview

Authlink.Identity.Client.Http provides a ready-to-use, production-grade implementation of the IIdentityClient abstraction defined in Authlink.Identity.Client.Core.

It handles:

• Token acquisition via client credentials and authorization code flows
• Refresh token lifecycle management
• Typed result models for easy integration
• Comprehensive error handling with detailed error information

Install

dotnet add package Authlink.Identity.Client.Http

Or via Package Manager:

PM> Install-Package Authlink.Identity.Client.Http

What's New in v2.3.0

Breaking Changes - Registration Link Flow:

• Removed ValidateInvitationCodeAsync - This endpoint no longer exists

New Features - Two-Step Registration Link Validation:

• VerifyRegistrationLinkAsync - Verify a registration link token and get recipient information (Step 1)
• ValidateRegistrationLinkAsync - Validate a registration link with invitation code and create registration session (Step 2)

Example - Two-Step Registration Link Flow:

// Step 1: Verify the registration link token
var verifyResult = await _client.VerifyRegistrationLinkAsync(new VerifyRegistrationLinkRequest
{
    Token = tokenFromUrl
});

if (verifyResult.IsError)
{
    // Handle error (invalid/expired token)
    return;
}

// Display recipient info to user
Console.WriteLine($"Welcome, {verifyResult.Value.RecipientName}!");

// Step 2: Validate with invitation code entered by user
var validateResult = await _client.ValidateRegistrationLinkAsync(new ValidateRegistrationLinkRequest
{
    Token = tokenFromUrl,
    InvitationCode = userEnteredCode
});

if (validateResult.IsError)
{
    // Handle error (invalid invitation code)
    return;
}

// Redirect to registration
var registrationUrl = validateResult.Value.RegistrationUrl;

See CHANGELOG.md for full version history.

Usage

Setup

builder.Services.AddIdentityHttpClient(options =>
{
    options.Authority = "https://identity.authlink.co.za";
});

Basic Usage with Error Handling

public class MyService
{
    private readonly IIdentityClient _client;

    public MyService(IIdentityClient client)
    {
        _client = client;
    }

    public async Task<string?> AuthenticateAsync()
    {
        var result = await _client.TokenAsync(new TokenRequest
        {
            GrantType = "client_credentials",
            ClientId = "your-client-id",
            ClientSecret = "your-secret",
            Scope = "openid profile"
        });

        if (result.IsError)
        {
            var error = result.FirstError;
            Console.WriteLine($"Authentication failed: {error.Code} - {error.Description}");
            return null;
        }

        return result.Value.AccessToken;
    }
}

Available Methods

// Token endpoint
ErrorOr<TokenResponse> result = await client.TokenAsync(tokenRequest);

// JWKS endpoint
ErrorOr<JsonWebKeySetResponse> jwks = await client.JwksAsync();

// OpenID Configuration
ErrorOr<OpenIdConfigurationResponse> config = await client.ConfigurationAsync();

// UserInfo endpoint
ErrorOr<UserInfoResponse> userInfo = await client.UserInfoAsync(accessToken);

// Registration Link Validation
ErrorOr<VerifyRegistrationLinkResponse> verify = await client.VerifyRegistrationLinkAsync(request);
ErrorOr<ValidateRegistrationLinkResponse> validate = await client.ValidateRegistrationLinkAsync(request);

Error Handling

The client returns specific error types for different failure scenarios:

Documentation

https://docs.authlink.co.za

License

MIT