在没有 ASP.NET Core 的情况下使用社交登录提供程序身份验证 Identity

作者:Kirk LarkinRick Anderson

ASP.NET Core 中的 Facebook 和 Google 身份验证 介绍了如何使用来自外部身份验证提供程序的凭据使用 OAuth 2.0 登录。 本文中所述的方法包括 ASP.NET Core Identity 作为身份验证提供程序。

此示例演示如何 在没有 ASP.NET Core Identity的情况下使用外部身份验证提供程序。 此方法对于不需要 ASP.NET Core Identity的所有功能的应用非常有用,但仍需要与受信任的外部身份验证提供程序集成。

此示例使用 Google 身份验证来对用户进行身份验证。 使用 Google 身份验证可将管理登录过程的许多复杂性转移到 Google。 若要与不同的外部身份验证提供程序集成,请参阅以下文章:

配置

在中Program.cs,使用AddAuthenticationAddCookieAddGoogle方法配置应用的身份验证方案:

using Microsoft.AspNetCore.Authentication.Cookies;
using Microsoft.AspNetCore.Authentication.Google;

var builder = WebApplication.CreateBuilder(args);

builder.Services
    .AddAuthentication(options =>
    {
        options.DefaultScheme = CookieAuthenticationDefaults.AuthenticationScheme;
        options.DefaultChallengeScheme = GoogleDefaults.AuthenticationScheme;
    })
    .AddCookie()
    .AddGoogle(options =>
    {
        options.ClientId = builder.Configuration["Authentication:Google:ClientId"];
        options.ClientSecret = builder.Configuration["Authentication:Google:ClientSecret"];
    });

builder.Services.AddRazorPages();

AddAuthentication 的调用将设置应用的 DefaultSchemeDefaultScheme 是以下 HttpContext 身份验证扩展方法使用的默认方案:

将应用DefaultScheme设置为 (“Cookie) 将应用配置为用作Cookie这些扩展CookieAuthenticationDefaults.AuthenticationScheme方法的默认方案。 将应用的 DefaultChallengeScheme 设置为 GoogleDefaults.AuthenticationScheme(“Google”)会将应用配置为将 Google 用作对 ChallengeAsync 的调用的默认方案。 DefaultChallengeScheme 会替代 DefaultScheme。 有关设置时替代 DefaultScheme 的更多属性,请参阅 AuthenticationOptions

Program.cs,调用 UseAuthenticationUseAuthorization。 此中间件组合设置 HttpContext.User 并针对请求运行授权中间件:

app.UseHttpsRedirection();
app.UseStaticFiles();

app.UseAuthentication();
app.UseAuthorization();

app.MapRazorPages();

若要详细了解身份验证方案,请参阅身份验证概念。 若要了解有关身份验证的详细信息cookie,请参阅在不使用 ASP.NET Core Identity的情况下使用cookie身份验证

应用授权

通过向控制器、操作或页面应用 [Authorize] 特性来测试应用的身份验证配置。 以下代码限制仅允许经过身份验证的用户访问 Privacy 页面:

[Authorize]
public class PrivacyModel : PageModel
{

}

保存访问令牌

SaveTokens 定义在授权成功后,是否应在 AuthenticationProperties 中存储访问令牌和刷新令牌。 SaveTokens 默认设置为 false,以减少最终身份验证 cookie 的大小。

若要在成功授权后保存访问和刷新令牌,请设置为 SaveTokenstrueProgram.cs

builder.Services
    .AddAuthentication(options =>
    {
        options.DefaultScheme = CookieAuthenticationDefaults.AuthenticationScheme;
        options.DefaultChallengeScheme = GoogleDefaults.AuthenticationScheme;
    })
    .AddCookie()
    .AddGoogle(options =>
    {
        options.ClientId = builder.Configuration["Authentication:Google:ClientId"];
        options.ClientSecret = builder.Configuration["Authentication:Google:ClientSecret"];
        options.SaveTokens = true;
    });

若要检索已保存的令牌,请使用 GetTokenAsync。 以下示例检索名为 access_token

public async Task OnGetAsync()
{
    var accessToken = await HttpContext.GetTokenAsync(
        GoogleDefaults.AuthenticationScheme, "access_token");

    // ...
}

注销

若要注销当前用户并删除他们的 cookie,请调用 SignOutAsync。 以下代码将 Logout 页面处理程序添加到 索引 页:

public class IndexModel : PageModel
{
    public async Task<IActionResult> OnPostLogoutAsync()
    {
        // using Microsoft.AspNetCore.Authentication;
        await HttpContext.SignOutAsync();
        return RedirectToPage();
    }
}

请注意,对 SignOutAsync 的调用不会指定身份验证方案。 应用使用 DefaultSchemeCookieAuthenticationDefaults.AuthenticationScheme 作为回退。

其他资源

ASP.NET Core 中的 Facebook 和 Google 身份验证 介绍了如何使用来自外部身份验证提供程序的凭据使用 OAuth 2.0 登录。 本文中所述的方法包括 ASP.NET Core Identity 作为身份验证提供程序。

此示例演示如何 在没有 ASP.NET Core Identity的情况下使用外部身份验证提供程序。 此方法对于不需要 ASP.NET Core Identity的所有功能的应用非常有用,但仍需要与受信任的外部身份验证提供程序集成。

此示例使用 Google 身份验证来对用户进行身份验证。 使用 Google 身份验证可将管理登录过程的许多复杂性转移到 Google。 若要与不同的外部身份验证提供程序集成,请参阅以下文章:

配置

在方法中ConfigureServices,使用AddAuthenticationAddCookieAddGoogle方法配置应用的身份验证方案:

public void ConfigureServices(IServiceCollection services)
{
    // requires
    // using Microsoft.AspNetCore.Authentication.Cookies;
    // using Microsoft.AspNetCore.Authentication.Google;
    // NuGet package Microsoft.AspNetCore.Authentication.Google
    services
        .AddAuthentication(options =>
        {
            options.DefaultScheme = CookieAuthenticationDefaults.AuthenticationScheme;
            options.DefaultChallengeScheme = GoogleDefaults.AuthenticationScheme;
        })
        .AddCookie()
        .AddGoogle(options =>
        {
            options.ClientId = Configuration["Authentication:Google:ClientId"];
            options.ClientSecret = Configuration["Authentication:Google:ClientSecret"];
        });

    services.AddRazorPages();
}

AddAuthentication 的调用将设置应用的 DefaultSchemeDefaultScheme 是以下 HttpContext 身份验证扩展方法使用的默认方案:

将应用DefaultScheme设置为 (“Cookie) 将应用配置为用作Cookie这些扩展CookieAuthenticationDefaults.AuthenticationScheme方法的默认方案。 将应用的 DefaultChallengeScheme 设置为 GoogleDefaults.AuthenticationScheme(“Google”)会将应用配置为将 Google 用作对 ChallengeAsync 的调用的默认方案。 DefaultChallengeScheme 会替代 DefaultScheme。 有关设置时替代 DefaultScheme 的更多属性,请参阅 AuthenticationOptions

Startup.Configure 中,在调用 UseRoutingUseEndpoints 之间调用 UseAuthenticationUseAuthorization。 此中间件组合设置 HttpContext.User 并针对请求运行授权中间件:

app.UseRouting();

app.UseAuthentication();
app.UseAuthorization();

app.UseEndpoints(endpoints =>
{
    endpoints.MapRazorPages();
});

若要详细了解身份验证方案,请参阅身份验证概念。 若要了解有关身份验证的详细信息cookie,请参阅在不使用 ASP.NET Core Identity的情况下使用cookie身份验证

应用授权

通过向控制器、操作或页面应用 [Authorize] 特性来测试应用的身份验证配置。 以下代码限制仅允许经过身份验证的用户访问 Privacy 页面:

[Authorize]
public class PrivacyModel : PageModel
{

}

注销

若要注销当前用户并删除他们的 cookie,请调用 SignOutAsync。 以下代码将 Logout 页面处理程序添加到 索引 页:

public class IndexModel : PageModel
{
    public async Task<IActionResult> OnPostLogoutAsync()
    {
        await HttpContext.SignOutAsync();
        return RedirectToPage();
    }
}

请注意,对 SignOutAsync 的调用不会指定身份验证方案。 应用的 CookieAuthenticationDefaults.AuthenticationSchemeDefaultScheme 用作回退。

其他资源