Какую зависимость добавляет метод AddAuthentication?

Обзор метода AddAuthentication и его зависимостей

Метод AddAuthentication() является ключевым методом в конфигурации системы аутентификации ASP.NET Core. Он добавляет необходимые службы (сервисы) в DI-контейнер (Dependency Injection Container), обеспечивая инфраструктуру для проверки идентичности пользователя. Этот метод принадлежит к пространству имен Microsoft.Extensions.DependencyInjection и используется в методе ConfigureServices() класса Startup или непосредственно в файле Program.cs при использовании минимальной модели API.

Основные зависимости, добавляемые методом AddAuthentication

Когда вызывается AddAuthentication(), в контейнер зависимостей регистрируются следующие ключевые компоненты:

1. Служба аутентификации (IAuthenticationService) - центральный сервис, который координирует процесс аутентификации, вызывая соответствующие обработчики.
2. Схемы аутентификации (AuthenticationSchemeProvider) - управляет регистрацией и поиском схем аутентификации (например, JWT, Cookie, OAuth).
3. Обработчики аутентификации (AuthenticationHandlerProvider) - предоставляет доступ к конкретным обработчикам для каждой схемы.
4. Параметры аутентификации (AuthenticationOptions) - конфигурационные параметры для всей системы аутентификации.
5. Система преобразования утверждений (IClaimsTransformation) - позволяет преобразовывать утверждения (claims) после успешной аутентификации.

Типичная конфигурация с AddAuthentication

// Пример в Program.cs для ASP.NET Core 6+
var builder = WebApplication.CreateBuilder(args);

builder.Services.AddAuthentication(options =>
{
    options.DefaultAuthenticateScheme = JwtBearerDefaults.AuthenticationScheme;
    options.DefaultChallengeScheme = JwtBearerDefaults.AuthenticationScheme;
})
.AddJwtBearer(options =>
{
    options.TokenValidationParameters = new TokenValidationParameters
    {
        ValidateIssuer = true,
        ValidateAudience = true,
        ValidateLifetime = true,
        ValidateIssuerSigningKey = true,
        IssuerSigningKey = new SymmetricSecurityKey(Encoding.UTF8.GetBytes(builder.Configuration["Jwt:Key"]))
    };
});

В этом примере:

• AddAuthentication() устанавливает JWT Bearer как основную схему аутентификации и вызова (challenge).
• Затем метод AddJwtBearer() добавляет конкретный обработчик для этой схемы с соответствующими параметрами валидации токена.

Практическое значение этих зависимостей

Регистрация этих служб позволяет:

• Middleware аутентификации (UseAuthentication()) корректно работать в pipeline обработки запроса.
• Контроллеры и действия использовать атрибуты [Authorize] для ограничения доступа.
• Система автоматически проверяет токены, куки или другие средства аутентификации в каждом запросе.
• Разработчики могут легко переключаться между различными схемами аутентификации или использовать несколько одновременно.

Внутренняя реализация зависимостей

За кулисами AddAuthentication() регистрирует абстракции и их реализации:

// Внутренняя логика примерно соответствует следующему коду
services.AddSingleton<IAuthenticationService, AuthenticationService>();
services.AddSingleton<IAuthenticationSchemeProvider, AuthenticationSchemeProvider>();
services.AddSingleton<IAuthenticationHandlerProvider, AuthenticationHandlerProvider>();
services.AddSingleton<IClaimsTransformation, NoopClaimsTransformation>();

NoopClaimsTransformation - это пустая реализация, которая ничего не преобразует, но предоставляет базовую инфраструктуру для замены, если необходимо кастомное преобразование утверждений.

Важные особенности

• Метод AddAuthentication() не добавляет конкретных обработчиков (handler) - для этого используются дополнительные методы: AddJwtBearer(), AddCookie(), AddOpenIdConnect() и т.д.
• Без вызова AddAuthentication() система не сможет выполнять аутентификацию, даже если будут добавлены обработчики.
• Порядок вызова имеет значение: сначала AddAuthentication(), затем добавление конкретных схем, и только после этого AddAuthorization() если используется.

Таким образом, метод AddAuthentication() добавляет фундаментальные инфраструктурные зависимости, которые делают возможным процесс проверки идентичности в ASP.NET Core, но требует дополнительной конфигурации конкретных механизмов аутентификации для полноценной работы системы безопасности приложения.