FractalDataWorks.Services.Authentication.Abstractions 0.4.0-preview.6

FractalDataWorks.Services.Authentication.Abstractions

Authentication abstractions providing contracts for authentication services, token management, and security contexts.

Overview

This package defines the core contracts for authentication services:

• IAuthenticationProvider - Service resolution and factory management
• IAuthenticationService - Token validation, refresh, and revocation
• IAuthenticationConfiguration - Configuration for authentication instances
• IAuthenticationContext - User identity, roles, claims, and authentication state
• TypeCollections - AuthenticationMethods, AuthenticationProtocols, AuthenticationFlows, TokenTypes

Target Framework: .NET Standard 2.0

Key Interfaces

IAuthenticationProvider

From IAuthenticationProvider.cs:1-11:

/// <summary>
/// Interface for providers that create and manage authentication services.
/// Inherits Create methods from IFdwServiceProvider.
/// </summary>
public interface IAuthenticationProvider : IFdwServiceProvider<IAuthenticationService, IAuthenticationConfiguration>
{
    // Inherits from IFdwServiceProvider:
    // IGenericResult<IAuthenticationService> Create(IAuthenticationConfiguration configuration);
    // IGenericResult<IAuthenticationService> Create(string name);
    // IGenericResult<IAuthenticationService> Create(Guid id);
    // IGenericResult<T> Create<T>(IAuthenticationConfiguration configuration) where T : IAuthenticationService;
    // IGenericResult<T> Create<T>(string name) where T : IAuthenticationService;
    // IGenericResult<T> Create<T>(Guid id) where T : IAuthenticationService;
}

IAuthenticationService

From IAuthenticationService.cs:31-64:

public interface IAuthenticationService : IDisposable, IGenericService
{
    Task<IGenericResult<IAuthenticationContext>> Authenticate(string token, CancellationToken cancellationToken = default);

    Task<IGenericResult<bool>> ValidateToken(string token, CancellationToken cancellationToken = default);

    Task<IGenericResult<string>> RefreshToken(string refreshToken, CancellationToken cancellationToken = default);

    Task<IGenericResult> RevokeToken(string token, CancellationToken cancellationToken = default);
}

IAuthenticationContext

From IAuthenticationContext.cs:31-251:

public interface IAuthenticationContext
{
    string UserId { get; }
    string Username { get; }
    IDictionary<string, object> Claims { get; }
    IEnumerable<string> Roles { get; }
    bool IsAuthenticated { get; }
    SecurityMethodBase AuthenticationMethod { get; }
    DateTimeOffset? ExpiresAt { get; }
}

IAuthenticationConfiguration

From IAuthenticationConfiguration.cs:11-66:

public interface IAuthenticationConfiguration : IGenericConfiguration
{
    string AuthenticationType { get; }
    IServiceLifetime Lifetime { get; }
    string? SecretManagerName { get; init; }
    string? SecretKeyName { get; init; }
    string ClientId { get; }
    string Authority { get; }
    string RedirectUri { get; }
    string[] Scopes { get; }
    bool EnableTokenCaching { get; }
    int TokenCacheLifetimeMinutes { get; }
}

TypeCollections

This package defines several TypeCollections for authentication concepts:

AuthenticationMethods

From AuthenticationMethods.cs:13-15:

[TypeCollection(typeof(AuthenticationMethodBase), typeof(IAuthenticationMethod), typeof(AuthenticationMethods))]
public abstract partial class AuthenticationMethods : TypeCollectionBase<AuthenticationMethodBase, IAuthenticationMethod>
{
}

AuthenticationProtocols

From AuthenticationProtocols.cs:13-16:

[TypeCollection(typeof(AuthenticationProtocolBase), typeof(IAuthenticationProtocol), typeof(AuthenticationProtocols))]
public abstract partial class AuthenticationProtocols : TypeCollectionBase<AuthenticationProtocolBase, IAuthenticationProtocol>
{
}

TokenTypes

From TokenTypes.cs:13-16:

[TypeCollection(typeof(TokenTypeBase), typeof(ITokenType), typeof(TokenTypes))]
public abstract partial class TokenTypes : TypeCollectionBase<TokenTypeBase, ITokenType>
{
}

Related Packages

• FractalDataWorks.Services.Authentication - Concrete implementations including AuthenticationTypes ServiceTypeCollection
• FractalDataWorks.Services.Authentication.Jwt - JWT authentication implementation
• FractalDataWorks.Services.Abstractions - Base service interfaces

Next Steps

• See FractalDataWorks.Services.Authentication for the AuthenticationTypes ServiceTypeCollection and provider implementations
• See the wiki documentation for authentication patterns and usage examples