TSLSpain.QualifiedTrustList 1.0.0

TSLSpain.QualifiedTrustList

Access and parse the official Trusted Service List (TSL) of Spain (Ministerio de Transformación Digital)

Overview

This library provides a simple and robust way to access the official Trusted Service List (TSL) for Spain, compliant with EU Regulation (eIDAS).
It downloads, parses, and exposes the list of qualified trust service providers as strongly typed C# objects.

Core abstraction

Consumers mainly interact with the ITSLProvider interface:

public interface ITSLProvider
{
    /// <summary>
    /// Asynchronously retrieves the Trusted Service Status List from the official Spanish source.
    /// </summary>
    /// <param name="cancellationToken">Cancellation token.</param>
    /// <returns>A <see cref="TrustServiceStatusList"/> representing the parsed TSL data.</returns>
    Task<TrustServiceStatusList> GetTrustServiceStatusListAsync(CancellationToken cancellationToken = default);
}

Installation

Install the package via NuGet:

Install-Package TSLSpain.QualifiedTrustList

Or using .NET CLI:

dotnet add package TSLSpain.QualifiedTrustList

Usage

Register the required services in your dependency injection container (e.g., in ASP.NET Core):

services.AddTSLSpainServices();

Or if you want to provide your own configured HttpClient and optional logger factory:

services.AddTSLSpainServices(httpClient, loggerFactory);

Inject ITSLProvider wherever needed:

public class MyService
{
    private readonly ITSLProvider _tslProvider;

    public MyService(ITSLProvider tslProvider)
    {
        _tslProvider = tslProvider;
    }

    public async Task UseTSLAsync()
    {
        var tsl = await _tslProvider.GetTrustServiceStatusListAsync();
        // Use the TSL data here
    }
}

Features

• Downloads the official Spanish TSL XML file from the Ministry for Digital Transformation.
• Parses the XML into strongly typed C# objects (TrustServiceStatusList).
• Supports dependency injection and flexible HttpClient configuration.
• Optional logging support via Microsoft.Extensions.Logging.

License

Specify your license here (e.g., MIT, Apache 2.0).

Contributing

Contributions, issues and feature requests are welcome!
Feel free to open a GitHub issue or submit a pull request.