C# Academy · Lekcja

Autoryzacja oparta na deklaracjach

Autoryzuj na podstawie deklaracji użytkownika.

Autoryzacja oparta na deklaracjach to bezpłatna lekcja C# Academy na CoddyKit. To lekcja 2 z 4. Możesz przeczytać całą lekcję poniżej za darmo — a potem ćwiczyć ją interaktywnie w przeglądarce z wbudowanym edytorem kodu i tutorem AI dostępnym 24/7. To część ścieżki edukacyjnej C# Academy, a Twój postęp synchronizuje się między webem a aplikacją CoddyKit. Kurs C# Academy zawiera 4 lekcji w sumie.

Poza rolami

Role są szczególnym przypadkiem claims. Autoryzacja oparta na claims sprawdza dowolny claim — adres e-mail, dział, poziom subskrypcji czy flagę uprawnienia — a nie tylko role.

Daje to większą kontrolę bez konieczności tworzenia dziesiątek ról.

// Claims a user might carry:
// department = sales
// subscription = pro
// email_verified = true

Dodawanie claims do tokenu

Należy wystawić wszystkie claims, które będą sprawdzane przez reguły autoryzacji. Claim jest parą typu i wartości.

var claims = new List<Claim>
{
    new Claim(ClaimTypes.NameIdentifier, user.Id.ToString()),
    new Claim("department", "sales"),
    new Claim("subscription", "pro"),
    new Claim("email_verified", "true")
};

Definiowanie polityki opartej na claims

Reguły oparte na claims wyraża się za pomocą nazwanych polityk rejestrowanych przez AddAuthorization. RequireClaim wymaga, aby użytkownik miał określony claim.

builder.Services.AddAuthorization(options =>
{
    options.AddPolicy("VerifiedEmail", policy =>
        policy.RequireClaim("email_verified", "true"));
});

RequireClaim bez wartości

Jeśli liczy się tylko to, że claim istnieje (niezależnie od wartości), należy wywołać RequireClaim, podając wyłącznie typ.

options.AddPolicy("HasDepartment", policy =>
    policy.RequireClaim("department"));

RequireClaim z dozwolonymi wartościami

Można podać listę dozwolonych wartości; polityka zostanie spełniona, jeśli claim będzie zgodny z dowolną z nich.

options.AddPolicy("PaidTier", policy =>
    policy.RequireClaim("subscription", "pro", "enterprise"));

Stosowanie polityki opartej na claims

Należy odwołać się do polityki po nazwie w [Authorize].

[Authorize(Policy = "PaidTier")]
[HttpGet("premium-reports")]
public IActionResult Reports() => Ok();

Użycie Minimal API

Minimal API odwołuje się do tej samej nazwy polityki za pomocą RequireAuthorization.

app.MapGet("/premium-reports", () => Results.Ok())
   .RequireAuthorization("PaidTier");

Łączenie wielu wymagań dotyczących claims

Polityka może łączyć wiele wywołań RequireClaim; wszystkie muszą zostać spełnione (AND).

options.AddPolicy("VerifiedSales", policy =>
    policy
        .RequireClaim("email_verified", "true")
        .RequireClaim("department", "sales"));

RequireAssertion dla niestandardowej logiki

Gdy sprawdzenie stałej wartości nie wystarcza, RequireAssertion uruchamia dowolny predykat dla obiektu ClaimsPrincipal.

options.AddPolicy("AdultUser", policy =>
    policy.RequireAssertion(ctx =>
    {
        var dob = ctx.User.FindFirst("birthdate")?.Value;
        return DateTime.TryParse(dob, out var d) &&
               d <= DateTime.UtcNow.AddYears(-18);
    }));

Odczytywanie claims w czasie działania

Wewnątrz akcji nadal można bezpośrednio sprawdzać claims, gdy potrzebna jest ich wartość, a nie tylko decyzja tak/nie.

var dept = User.FindFirst("department")?.Value;
var isPro = User.HasClaim("subscription", "pro");

Claims a role — kiedy używać których

Ról należy używać do opisywania ogólnych funkcji zawodowych. Claims służą do opisywania atrybutów i flag funkcji. Można je łączyć — polityka może jednocześnie wymagać roli oraz kilku claims.

options.AddPolicy("SalesManager", policy =>
    policy.RequireRole("manager")
          .RequireClaim("department", "sales"));

Szybki test

Sprawdź swoje rozumienie polityk opartych na claims.

Podsumowanie

Poznali Państwo autoryzację opartą na claims:

Dowolny claim, nie tylko role, może warunkować dostęp.
RequireClaim sprawdza istnienie claims lub konkretne dozwolone wartości.
RequireAssertion obsługuje niestandardową logikę predykatów.
Claims i role można łączyć w ramach jednej nazwanej polityki.

Następnie: pełny model oparty na politykach.

Często zadawane pytania

Czy lekcja „Autoryzacja oparta na deklaracjach” jest bezpłatna?

Tak — pełny tekst „Autoryzacja oparta na deklaracjach” jest dostępny za darmo tutaj w sieci. Aby ćwiczyć ją interaktywnie (wbudowany edytor kodu i tutor AI dostępny 24/7) i odblokować resztę kursu C# Academy, przejdź na CoddyKit PRO. Kurs C# Academy zawiera 4 lekcji w sumie.

Co nauczysz się w „Autoryzacja oparta na deklaracjach”?

Autoryzuj na podstawie deklaracji użytkownika. Ćwiczysz C# Academy z praktycznym kodem, który uruchamiasz bezpośrednio w przeglądarce, a tutor AI dostępny 24/7 odpowiada na Twoje pytania podczas pracy nad lekcją.

Czy potrzebuję doświadczenia, aby zacząć C# Academy?

Nie wymagamy żadnego doświadczenia. C# Academy w CoddyKit jest strukturyzowany dla początkujących i zaawansowanych użytkowników, więc możesz zacząć tutaj lub od początku i uczyć się w swoim tempie. To lekcja 2 z 4.

Ile czasu zajmuje lekcja „Autoryzacja oparta na deklaracjach”?

Większość lekcji CoddyKit trwa około 5–10 minut. Każda lekcja to mały, interaktywny krok, dzięki czemu robisz systematyczne postępy i zawsze wracasz dokładnie do tego samego miejsca — na webie i w aplikacji.

Czy mogę pisać i uruchamiać kod w tej lekcji C# Academy?

Tak. Każda lekcja C# Academy zawiera wbudowany edytor kodu, więc piszesz i uruchamiasz prawdziwy kod bezpośrednio w przeglądarce i od razu otrzymujesz sprzężenie zwrotne od AI — bez konfiguracji na komputerze.

Wszystkie lekcje w tym kursie

← Powrót do C# Academy