ASP.NET Core: eksempel på OpenID Connect med PKCE
Innlogging med Dazr Identity: gratis OpenID Connect, driftet i EU, med passnøkler, e-postkoder og Google- eller Microsoft-kontoer bak én knapp.
Du trenger tre verdier fra utviklerkonsollen: klient-ID-en, klienthemmeligheten (bare apper med webserver) og omdirigerings-URI-en du registrerte. Resten står i discovery-dokumentet på https://identity.dazr.eu/.well-known/openid-configuration.
ASP.NET Core
Bruk den innebygde OpenID Connect-handleren (Microsoft.AspNetCore.Authentication.OpenIdConnect, .NET 8 eller nyere). Registrer en webserverapp med omdirigerings-URI-en https://app.example.eu/signin-oidc og for utlogging https://app.example.eu/signout-callback-oidc. Tre innstillinger teller: Dazr returnerer koden i spørrestrengen, så sett ResponseMode til query (handleren bruker som standard form_post); PKCE er påkrevd; og ID-tokener er signert med ES256.
// Program.cs
using Microsoft.AspNetCore.Authentication.Cookies;
using Microsoft.AspNetCore.Authentication.OpenIdConnect;
using Microsoft.IdentityModel.Protocols.OpenIdConnect;
var builder = WebApplication.CreateBuilder(args);
builder.Services.AddAuthentication(options =>
{
options.DefaultScheme = CookieAuthenticationDefaults.AuthenticationScheme;
options.DefaultChallengeScheme = OpenIdConnectDefaults.AuthenticationScheme;
})
.AddCookie()
.AddOpenIdConnect(options =>
{
options.Authority = "https://identity.dazr.eu";
options.ClientId = builder.Configuration["Dazr:ClientId"];
options.ClientSecret = builder.Configuration["Dazr:ClientSecret"];
options.ResponseType = OpenIdConnectResponseType.Code;
options.ResponseMode = OpenIdConnectResponseMode.Query;
options.UsePkce = true;
options.Scope.Clear();
options.Scope.Add("openid");
options.Scope.Add("profile");
options.Scope.Add("email");
options.GetClaimsFromUserInfoEndpoint = true;
options.SaveTokens = true; // keeps the ID token for sign-out (id_token_hint)
options.MapInboundClaims = false; // keep sub, email and name as they are
options.TokenValidationParameters.NameClaimType = "name";
options.TokenValidationParameters.ValidAlgorithms = new[] { "ES256" };
});
builder.Services.AddAuthorization();
var app = builder.Build();
app.UseAuthentication();
app.UseAuthorization();
app.MapGet("/signin", () => Results.Challenge(new() { RedirectUri = "/" }));
app.MapGet("/signout", () => Results.SignOut(new() { RedirectUri = "/" },
new[] { CookieAuthenticationDefaults.AuthenticationScheme, OpenIdConnectDefaults.AuthenticationScheme }));
app.Run();
Dazr-sub er User.FindFirst("sub")?.Value. Lagre den som kontonøkkel. Oppbevar client secret i user secrets eller et hvelv, aldri i appsettings.json.
sub er parvis: den samme for alle apper i organisasjonen din, forskjellig for alle andre organisasjoner. Den endres aldri for en person, mens en e-postadresse kan endres. Lagre sub som kontonøkkel og behandle email som kontaktopplysning.
Mer for utviklere
UtviklerdokumentasjonAlle integrasjonsveiledningerHvilket som helst OpenID Connect-bibliotekPriser