Elvia.Elvid.TokenClient 1.5.0

Elvia.Elvid.TokenClient

OAuth2 Client Credentials bibliotek for Elvid med automatisk token-håndtering og caching.

Erstatter IdentityModel avhengigheter og duplikat ElvidAccessTokenService kode.

Kom i gang

1. Installer

dotnet add package Elvia.Elvid.TokenClient

2. Konfigurer

// Forutsetter eksisterende Vault-konfigurasjon (AddHashiVaultSecrets)
builder.Services.AddElvidTokenProvider(options =>
{
    options.TokenEndpoint = builder.Configuration.EnsureHasValue("system:kv:elvid:tokenendpoint");
    options.ClientId = builder.Configuration.EnsureHasValue("system:kv:elvid:clientid");
    options.ClientSecret = builder.Configuration.EnsureHasValue("system:kv:elvid:clientsecret");
});

💡 Tip: TokenEndpoint er anbefalt over Authority (discovery) - enklere, raskere og mer robust.

3. Bruk

HttpClient (anbefalt):

// Default provider
builder.Services.AddHttpClient("ExternalApi", client =>
{
    client.BaseAddress = new Uri("https://api.elvia.no/");
})
.AddElvidAuthHandler(); // Automatisk Bearer token fra default provider

// Named provider (for multiple clients)
builder.Services.AddHttpClient("KumaApi", client =>
{
    client.BaseAddress = new Uri("https://kuma.elvia.io/");
})
.AddElvidAuthHandler("kuma"); // Bruker navngitt "kuma" provider

// I service:
var client = _httpClientFactory.CreateClient("ExternalApi");
var response = await client.GetAsync("endpoint"); // Token legges til automatisk

Direkte (Client Credentials):

public class MyService
{
    private readonly IElvidTokenProvider _tokenProvider;
    
    public async Task<string> GetTokenAsync()
    {
        return await _tokenProvider.GetAccessTokenAsync([]);
    }
}

Password Grant (for testing/smoketests):

public class MySmokeTestService
{
    private readonly IElvidTokenProvider _tokenProvider;
    
    public async Task<string> GetUserTokenAsync()
    {
        return await _tokenProvider.GetAccessTokenAsync("testuser", "testpass", []);
    }
}

Standalone bruk (uten Dependency Injection):

// Perfect for smoketests og enkle skript
var tokenProvider = ElvidTokenClientFactory.Create(
    "https://elvid.test-elvia.io/connect/token",
    "your-client-id",
    "your-client-secret");

// Client credentials
var token = await tokenProvider.GetAccessTokenAsync([]);

// Password grant
var userToken = await tokenProvider.GetAccessTokenAsync("testuser", "testpass", []);

Multiple API clients (anbefalt for større systemer):

// Registrer flere navngitte clients
builder.Services.AddElvidTokenProvider("convey", options =>
{
    options.TokenEndpoint = builder.Configuration.EnsureHasValue("elvid:kv:elvid:elvid-convey:tokenendpoint");
    options.ClientId = builder.Configuration.EnsureHasValue("elvid:kv:elvid:elvid-convey:clientid");
    options.ClientSecret = builder.Configuration.EnsureHasValue("elvid:kv:elvid:elvid-convey:clientsecret");
});

builder.Services.AddElvidTokenProvider("kuma", options =>
{
    options.TokenEndpoint = builder.Configuration.EnsureHasValue("elvid:kv:elvid:elvid-kuma:tokenendpoint");
    options.ClientId = builder.Configuration.EnsureHasValue("elvid:kv:elvid:elvid-kuma:clientid");
    options.ClientSecret = builder.Configuration.EnsureHasValue("elvid:kv:elvid:elvid-kuma:clientsecret");
});

// I service - bruk factory til å få riktig client
public class MyService
{
    private readonly IElvidTokenProviderFactory _tokenProviderFactory;

    public async Task CallConveyAsync()
    {
        var conveyProvider = _tokenProviderFactory.GetProvider("convey");
        var token = await conveyProvider.GetAccessTokenAsync([]);
        // Use token for Convey API calls
    }
    
    public async Task CallKumaAsync()
    {
        var kumaProvider = _tokenProviderFactory.GetProvider("kuma");
        var token = await kumaProvider.GetAccessTokenAsync([]);
        // Use token for Kuma API calls
    }
}

Migration fra IdentityModel

Problem: KubernetesClient vulnerability krever oppgradering av Elvia.Configuration, som fjerner IdentityModel avhengigheter.

Løsning: Erstatt IdentityModel med TokenClient.

SetBearerToken Extension Method

TokenClient inkluderer SetBearerToken extension method for enkel migrering:

using Elvia.Elvid.TokenClient.Http;

// Fungerer akkurat som IdentityModel sin SetBearerToken
var token = await _tokenProvider.GetAccessTokenAsync([]);
httpClient.SetBearerToken(token);

Før (IdentityModel - fungerer ikke lenger):

// Krever IdentityModel pakke som ikke lenger er inkludert
var tokenResponse = await client.RequestClientCredentialsTokenAsync(new ClientCredentialsTokenRequest
{
    Address = "https://elvid.test-elvia.io/connect/token",
    ClientId = "client-id",
    ClientSecret = "secret"
});
var token = tokenResponse.AccessToken;

Etter (TokenClient - fungerer uten eksterne avhengigheter):

Med Dependency Injection:

// I Program.cs - kun én gang
builder.Services.AddElvidTokenProvider(options =>
{
    options.TokenEndpoint = builder.Configuration.EnsureHasValue("system:kv:elvid:tokenendpoint");
    options.ClientId = builder.Configuration.EnsureHasValue("system:kv:elvid:clientid");
    options.ClientSecret = builder.Configuration.EnsureHasValue("system:kv:elvid:clientsecret");
});

// Client credentials - caches automatisk
var token = await _tokenProvider.GetAccessTokenAsync([]);

// Password grant (for smoketests)
var userToken = await _tokenProvider.GetAccessTokenAsync("testuser", "testpass", []);

Uten Dependency Injection (smoketests):

// Direkte opprettelse - perfect for smoketests
var tokenProvider = ElvidTokenClientFactory.Create(
    "https://elvid.test-elvia.io/connect/token",
    "client-id",
    "client-secret");

var token = await tokenProvider.GetAccessTokenAsync("testuser", "testpass", []);

Fordeler

• ✅ Løser IdentityModel-problem - Ingen avhengighet til IdentityModel eller Duende pakker
• ✅ Client Credentials + Password Grant - Støtter både machine-to-machine og user authentication
• ✅ Automatisk caching - Thread-safe med per-scope og per-user caching
• ✅ Multiple named clients - Factory pattern for separate API konfigurasjoner (Convey, Kuma etc.)
• ✅ HttpClient-integrasjon - Automatisk Bearer token påføring (også uten scopes)
• ✅ Retry-logikk - Automatisk retry ved 5xx feil
• ✅ Ingen scopes påkrevd - Client credentials flow uten scopes
• ✅ Fjerner duplikat kode - Erstatter alle ElvidAccessTokenService kopier
• ✅ Perfect for smoketests - Password grant støtte og standalone factory
• ✅ Standalone support - ElvidTokenClientFactory.Create() for bruk uten DI

Publisering

Tag en versjon for å publisere til NuGet:

git tag tokenclient-v1.0.0
git push origin tokenclient-v1.0.0