.NET 帮助

IdentityServer .NET（开发人员如何工作）

发布 2024年八月13日

介绍

在当今的软件架构中，安全性至关重要，尤其是在涉及用户权限和身份验证时。作为将开放ID连接和OAuth 2.0 实践应用，IdentityServer4在分散的网络中为集中授权和身份验证提供了可靠的选择。当开发人员将IronPDF在.NET、Java、Python 或 Node js 中，开发人员可以使用强大的 C# 库生成 PDF，并进行安全身份管理，他们可以轻松地将两者结合起来，创建满足各种应用要求的 PDF 文档。

IdentityServer4 提供了一个模块化、基于标准的解决方案，使身份管理安装变得更容易。在它的帮助下，开发人员可以创建一个集中式身份供应商，为各种服务和应用程序处理用户身份验证、访问、令牌验证和签发以及权限验证。IdentityServer4通过支持多种身份验证方法，如用户名/密码、社交登录和多因素身份验证，使开发者能够创建安全、直观的身份验证体验。

本教程将介绍 C# 集成的IdentityServer4与IronPDFIronPDF.NET》将介绍如何使用IdentityServer4创建授权和身份验证的安全流程，以及如何使用创建的用户身份定制IronPDF的PDF文档创建。我们将介绍如何提高 C# 应用程序的安全性和功能性，从配置 IdentityServer4 作为集中式身份和认证提供商，到集成 IronPDF 用于动态 PDF 生产。

什么是 IdentityServer4 C#?

一个名为IdentityServer4身份管理工具用于 .NET 和 C# 应用程序，以执行身份管理、授权和验证。它是保护网络应用程序、API 和微服务安全的灵活解决方案，因为它符合 OpenID Connect 和 OAuth 2.0 等现代安全协议。

IdentityServer4 的功能主要是作为集中式身份验证服务器，处理用户身份验证和权限管理核心身份、有效访问令牌签发和凭证验证。它使程序员能够集成联合身份验证和单点登录(单点登录)在翻译过程中，译员必须将.NET、Java、Python 或 Node js 融入多个应用程序和服务中，从而为最终用户带来安全、流畅的使用体验。

IdentityServer .NET（开发人员使用方式）：图1 - IdentityServer4：使用ASP.NET Core Identity

IdentityServer4的特性

单点登录

用户无需重新输入凭据，只需一次身份验证即可访问不同的应用程序或服务。

支持 OpenID Connect 和 OAuth 2.0

为了兼容和支持广泛的客户端应用程序和平台，IdentityServer4 为安全认证和授权提供了行业标准协议。

适应性强的设置

开发人员可以自定义安全设置，以满足某些应用程序的要求，因为他们可以精细控制身份验证和权限策略的配置方式。

与 ASP.NET Core 的连接性

由于IdentityServer4与框架的平滑集成，ASP.NET Core网络应用程序和API的身份验证很容易实现。

个性化和适应性

由于该框架具有高度的可扩展性和定制性，开发人员可以根据需要添加新的用户存储空间、身份供应商、测试用户和身份验证工作流。

用户验证

IdentityServer4 允许开发人员灵活选择最适合其网络应用要求的认证机制配置。这些机制包括用户名/密码、社交登录(如谷歌、脸书等。)和外部身份提供商(如Active Directory, Azure AD等。).

授权政策

为了保证只有经过授权的用户才能访问特定资源或在应用程序中执行特定操作，开发人员可以根据用户角色、权利要求或其他标准建立细粒度的授权策略。

代币管理

访问令牌、令牌刷新令牌和身份令牌都由 IdentityServer4 管理，它提供了一种安全的用户身份验证方法，允许用户访问受身份服务器保护的资源。

创建和配置

为了在 Visual Studio 的 C# 项目中设置 IdentityServer4，您必须执行以下步骤：

在 Visual Studio 中创建新项目

启动 Visual Studio 应用程序后，您可以选择 "创建新项目 "选项，也可以选择文件菜单 > 添加 >"新建项目"。接下来，选择 "Asp.NET Core Web App(模型-视图-控制器)选择 "新项目 "后，点击 "翻译"。在本教程中，我们将使用此应用程序制作 PDF 文档。

related to 在 Visual Studio 中创建新项目新建项目选项。然后选择 ASP.NET Core Web 应用程序。" />

选择文件路径并在相应文本框中输入项目名称。接下来，点击创建按钮，选择必要的 Dot .NET Framework，如下图所示。

IdentityServer .NET(如何为开发人员服务):图 3 - 接下来，通过指定项目名称和位置来配置您的项目。单击下一步。

接下来，决定需要哪个框架，然后按下创建按钮。

IdentityServer .NET(如何为开发人员服务):图 4 - 指定其他信息，如框架、身份验证类型，选择是否要为 HTTP 配置并启用 Docker。然后点击创建。

现在，所选应用程序的结构将由 Visual Studio 项目生成。本例中我们使用的是 ASP.NET MVC。为了编写代码，我们既可以创建一个新的控制器，也可以利用已有的控制器，这样您就可以输入代码并构建/运行程序。

IdentityServer .NET(如何为开发人员服务):图 5 - ASP.NET Core Web 应用程序(模型-视图-控制器 (MVC))项目已成功创建。

为了测试代码，我们可以添加库。

安装IdentityServer4软件包

使用 Visual Studio 中的 .NET CLI 或 NuGet 软件包管理器，将 IdentityServer4 软件包添加到您的项目中。使用软件包管理器控制台或终端，键入以下命令安装最新版本的软件包：

Install-Package IdentityServer4

Install-Package IdentityServer4

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

在 .NET Core 项目中配置 IdentityServer4

在您的 ASP.NET Core 应用程序中，通过在 Startup.cs 文件中添加所需的身份验证中间件和服务来配置 IdentityServer4。这里提供了一个配置IdentityServer4的介绍性代码示例：

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddIdentityServer()
            .AddInMemoryClients(Config.Clients)
            .AddInMemoryIdentityResources(Config.IdentityResources)
            .AddInMemoryApiScopes(Config.ApiScopes)
            .AddInMemoryApiResources(Config.ApiResources)
            .AddTestUsers(Config.Users);
    }
    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        app.UseIdentityServer();
    }
}

using Microsoft.AspNetCore.Builder;
using Microsoft.AspNetCore.Hosting;
using Microsoft.Extensions.DependencyInjection;
using Microsoft.Extensions.Hosting;
public class Startup
{
    public void ConfigureServices(IServiceCollection services)
    {
        services.AddIdentityServer()
            .AddInMemoryClients(Config.Clients)
            .AddInMemoryIdentityResources(Config.IdentityResources)
            .AddInMemoryApiScopes(Config.ApiScopes)
            .AddInMemoryApiResources(Config.ApiResources)
            .AddTestUsers(Config.Users);
    }
    public void Configure(IApplicationBuilder app, IWebHostEnvironment env)
    {
        if (env.IsDevelopment())
        {
            app.UseDeveloperExceptionPage();
        }
        app.UseIdentityServer();
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

配置客户端、身份资源和 API 资源

配置客户端、身份资源(范围)对于IdentityServer4来说，配置、数据库和API资源是必要的。这些配置可以在一个不同的类中定义，如Config.cs:

public class Config
{
    public static IEnumerable<Client> Clients { get; set; }
    public static IEnumerable<IdentityResource> IdentityResources { get; set; }
    public static IEnumerable<ApiScope> ApiScopes { get; set; }
    public static IEnumerable<ApiResource> ApiResources { get; set; }
    public static List<TestUser> Users { get; set; }
}

public class Config
{
    public static IEnumerable<Client> Clients { get; set; }
    public static IEnumerable<IdentityResource> IdentityResources { get; set; }
    public static IEnumerable<ApiScope> ApiScopes { get; set; }
    public static IEnumerable<ApiResource> ApiResources { get; set; }
    public static List<TestUser> Users { get; set; }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

按照这些说明，通过在C#项目中创建和配置IdentityServer4，您可以在ASP.NET Core应用程序中启用安全认证和授权。

使用 IronPdf 开始使用 IdentityServer4

这些说明将指导您配置IdentityServer4用于安全身份验证和授权代码并使用IronPDF以在 C# 项目中创建 PDF 文档。您将根据本说明学习如何在基本设置的基础上创建一个项目。

什么是IronPDF？

适用于 .NET 应用程序、IronPDF是一个功能丰富的库，用于与 PDF 文档交互。凭借其广泛的功能集，用户可以从零开始或根据 HTML 内容创建 PDF，还可以添加、删除或重新排列已存在的 PDF 文档的部分。 IronPDF 为开发人员提供了用于生成、修改和转换 PDF 文件的强大 API，从而简化了在 .NET 应用程序中处理 PDF 的工作。

IdentityServer .NET（开发人员如何工作）：图6 - IronPDF for .NET：C# PDF 库

IronPDF 的主要功能

HTML 转换为 PDF

使用 IronPDF，您可以通过以下方式制作出质量上乘的 PDF 文档使用HTML内容此外，翻译还必须包括 JavaScript 和 CSS。该功能在根据网站或动态信息创建 PDF 时非常有用。

更改和改进 PDF

通过 IronPDF，您可以修改PDF文档已经存在的内容。可以将多个PDF合并为一个文档，从PDF中提取页面，并添加文本、照片、水印或注释。

立即制作 PDF

利用 IronPDF 的 API，您可以通过编程将文本、照片、形状和其他对象添加到新创建的 PDF 文档中。这使得动态生成 PDF 发票、报告和其他基于文档的输出成为可能。

PDF 的安全性

您可以通过以下方式管理访问权限并保护关键数据加密PDF文档使用 IronPDF 和添加密码安全性.

PDF 格式

有了 IronPdf，用户可以通过创建、填写和编辑 PDF 文档来使用它。提交PDF表单, 以及输入数据到表单字段中。

文本收获

IronPdf 是一种通过以下方式帮助进行文本数据处理、分析和搜索的工具提取文本信息从PDF文档。

转换为图片格式

IronPDF 在需要照片而不是 PDF 的情况下非常有用，因为它可以将 PDF 文档转换为常见的图片格式，包括 PNG、JPEG 和 BMP。

安装 IronPDF

使用 .NET CLI 或 NuGet 包管理器添加最新版本的IronPDF添加到您的项目中。

dotnet add package IronPdf

dotnet add package IronPdf

'INSTANT VB TODO TASK: The following line uses invalid syntax:
'dotnet add package IronPdf

VB C#

将 IronPdf 与 IdentityServer4 整合 C&num；

在Startup.cs文件中为IdentityServer4设置所需的服务和中间件。然后创建一个名为 PdfController.cs 的新 MVC 控制器，使用 IronPdf 处理 PDF 生成。

using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;
using IronPdf;
using System.Threading.Tasks;
[Authorize]
public class PdfController : Controller
{
    public async Task<IActionResult> GeneratePdf()
    {
        // Create IronPDF Renderer
        var Renderer = new IronPdf.ChromePdfRenderer();
        // HTML content to be converted to PDF
        string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a generated PDF document.</p>";
        // Convert HTML to PDF asynchronously
        var pdfDocument = await Task.Run(() => Renderer.RenderHtmlAsPdf(htmlContent));
        // Return the PDF as a file
        return File(pdfDocument.BinaryData, "application/pdf", "example.pdf");
    }
}

using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;
using IronPdf;
using System.Threading.Tasks;
[Authorize]
public class PdfController : Controller
{
    public async Task<IActionResult> GeneratePdf()
    {
        // Create IronPDF Renderer
        var Renderer = new IronPdf.ChromePdfRenderer();
        // HTML content to be converted to PDF
        string htmlContent = "<h1>Hello, IronPDF!</h1><p>This is a generated PDF document.</p>";
        // Convert HTML to PDF asynchronously
        var pdfDocument = await Task.Run(() => Renderer.RenderHtmlAsPdf(htmlContent));
        // Return the PDF as a file
        return File(pdfDocument.BinaryData, "application/pdf", "example.pdf");
    }
}

IRON VB CONVERTER ERROR developers@ironsoftware.com

VB C#

使用IdentityServer4设置安全的用户身份验证和授权，然后使用IronPDF创建只有通过身份验证的用户才能访问的PDF文档，这就是在C#应用程序中将IronPDF与IdentityServer4集成的过程。所提供的代码示例在Startup.cs文件中配置了IdentityServer4，通过内存配置来处理用户身份管理，并处理客户端凭证。

只有经授权的用户才能访问 PdfController 的操作，因为它受[授权]属性。该控制器使用异步方法，使用 IronPDF 库将 HTML 信息渲染为 PDF 格式。 PDF 生成过程的步骤是构建一个 ChromePdfRenderer 渲染器；转换HTML 文本翻译成 PDF 文档；并将 PDF 作为文件回复发回。

为了将强大的安全性与动态文档生成功能结合起来，集成将 PDF 生成逻辑嵌入到一个安全端点中，保证只有经过 IdentityServer4 验证的用户才能启动 PDF 创建。这种方法尤其适用于需要安全处理文档的应用程序，包括创建发票、报告或基于用户特定信息的定制内容，同时通过 IdentityServer4 实施严格的访问控制。

IdentityServer .NET（开发人员如何使用）：图7 - 使用 IronPDF 生成的输出 PDF，提供由 IdentityServer4 提供的安全用户认证和授权。

结论

总之，整合IdentityServer4与IronPDF在 C# 项目中，成功地将强大的安全性与创建动态 PDF 的能力融合在一起。 IdentityServer4提供了一种单一的标准化方法来管理多个应用程序和服务中的用户身份和访问控制，从而保证了用户身份验证和授权的安全性。通过使用 IronPDF，开发人员可以根据经过验证的用户数据，制作出只有授权用户才能访问的高质量 PDF 文档。

这种集成提高了应用程序的安全性和功能性，非常适合创建发票、报告和个性化内容等需要安全文档处理的场景。考虑到所有因素，将IdentityServer4和IronPDF在 .NET Framework 中创建安全、有效和以用户为中心的应用程序时，《.NET.NET》提供了一个强有力的选择。

当IronPDF和IronSoftware集成到企业应用程序开发堆栈中的技术，IronPDF可以为开发者提供丰富的功能文献资料为客户和最终用户提供优质软件解决方案。这一坚实的基础还将使项目、后端系统和流程改进变得更加容易。

IronPDF 套装该译本由 9 种不同的 .NET API 产品组合而成，可用于以下用途有竞争力的许可价格!

这些技术因其丰富的文档、活跃的在线开发者社区和定期升级而成为现代软件开发项目的绝佳选择。

< 前一页
OData C#（对开发人员如何工作）

下一步 >
Flurl C#（它如何为开发人员工作）