La seguridad es crucial en la arquitectura de software actual, particularmente cuando se trata de permisos de usuario y autenticación. Como uno de los principales frameworks para implementar OpenID Connect y OAuth 2.0, IdentityServer4 ofrece una opción confiable para la autorización y autenticación centralizada en redes distribuidas. Cuando los desarrolladores utilizan IronPDF, una poderosa biblioteca de C# para generación de PDF, junto con una gestión de identidad segura, pueden fácilmente combinar ambos para crear documentos PDF que cumplan con una variedad de requisitos de aplicación.

IdentityServer4 proporciona una solución modular basada en estándares que simplifica la instalación de gestión de identidades. Ayuda a los desarrolladores a crear un proveedor de identidad centralizado que maneja la autenticación de usuarios, acceso, validación y emisión de tokens, y validación de permisos para una variedad de servicios y aplicaciones. IdentityServer4 permite a los desarrolladores crear experiencias de autenticación seguras e intuitivas al soportar muchos métodos de autenticación, como nombre de usuario/contraseña, inicios de sesión sociales y autenticación multifactor.

Este tutorial cubrirá la integración de C# de IdentityServer4 con IronPDF, mostrando cómo usar IdentityServer4 para crear procesos seguros para autorización y autenticación y cómo usar las identidades de usuario creadas para personalizar la creación de documentos PDF de IronPDF. Revisaremos cómo mejorar la seguridad y funcionalidad de tus aplicaciones C#, desde configurar IdentityServer4 como un proveedor de identidad y autenticación centralizada hasta integrar IronPDF para la producción dinámica de PDF.

¿Qué es IdentityServer4 C#?

Un framework de código abierto bien reconocido llamado IdentityServer4 se usa en aplicaciones .NET y C# para realizar gestión de identidades, autorización y autenticación. Es una solución flexible para asegurar aplicaciones web, API y microservicios porque cumple con protocolos de seguridad modernos como OpenID Connect y OAuth 2.0.

IdentityServer4 funciona esencialmente como un servidor de autenticación centralizado, manejando la identificación de usuarios y la gestión de permisos dentro de la identidad central, emisión de tokens de acceso válidos y validación de credenciales. Otorga a los programadores la capacidad de integrar autenticación federada e inicio de sesión único (SSO) en varias aplicaciones y servicios, resultando en una experiencia segura y fluida para el usuario final.

Características de IdentityServer4

SSO, o inicio de sesión único

Sin tener que volver a ingresar sus credenciales, los usuarios pueden acceder a diferentes aplicaciones o servicios con solo una autenticación.

Soporte para OpenID Connect y OAuth 2.0

IdentityServer4 ofrece protocolos estándar de la industria para autenticación y autorización seguras, proporcionando compatibilidad con y soporte para una amplia gama de aplicaciones cliente y plataformas.

Configuración adaptable

Los desarrolladores pueden personalizar las configuraciones de seguridad para cumplir con requisitos específicos de la aplicación, ya que tienen un control detallado sobre cómo se configuran las políticas de autenticación y permiso.

Conectividad con ASP.NET Core

La autenticación para aplicaciones web y API de ASP.NET Core es simple de implementar gracias a la integración fluida de IdentityServer4 con el framework.

Personalización y adaptabilidad

Debido al alto grado de extensibilidad y personalización del framework, los desarrolladores pueden agregar nuevos almacenes de usuarios, proveedores de identidad, usuarios de prueba, y flujos de trabajo de autenticación según sea necesario.

Verificación de usuarios

IdentityServer4 brinda a los desarrolladores la flexibilidad de elegir la configuración del mecanismo de autenticación que mejor se ajuste a los requisitos de la aplicación web. Estos mecanismos incluyen nombre de usuario/contraseña, inicios de sesión sociales (como Google, Facebook, etc.), y proveedores de identidad externos (como Active Directory, Azure AD, etc.).

Políticas de autorización

Los desarrolladores pueden crear políticas de autorización detalladas basadas en roles de usuario, afirmaciones u otros criterios para garantizar que solo usuarios autorizados puedan acceder a recursos particulares o realizar acciones específicas dentro de la aplicación.

Gestión de tokens

IdentityServer4 gestiona tokens de acceso, tokens de actualización de tokens y tokens de identidad, proporcionando un método seguro de autenticación de usuarios y permiso para acceder a recursos protegidos por el servidor de identidad.

Crear y configurar

Para configurar IdentityServer4 en un proyecto C# en Visual Studio, debes seguir estos pasos:

Crear un nuevo proyecto en Visual Studio

Después de iniciar la aplicación Visual Studio, selecciona la opción "Crear un nuevo proyecto", o elige el menú Archivo > Agregar > "Nuevo proyecto". A continuación, selecciona "Asp.NET Core Web App (Model-View-Controller)" después de elegir "nuevo proyecto". Esta aplicación será utilizada para la generación de documentos PDF en este tutorial.

Selecciona la ruta de archivo e ingresa el nombre del proyecto en el cuadro de texto correspondiente. A continuación, selecciona el .NET Framework necesario haciendo clic en el botón Crear, como se muestra en la captura de pantalla a continuación.

Decide qué framework es necesario y haz clic en el botón Crear.

La estructura para la aplicación elegida será generada por el proyecto de Visual Studio. Estamos usando ASP.NET MVC en este ejemplo. Para escribir el código, podemos ya sea crear un nuevo controlador o utilizar el existente para ingresar el código y compilar/ejecutar el programa.

Para probar el código, agrega la biblioteca necesaria.

Instalar el paquete IdentityServer4

Utilizando la CLI de .NET o el Gestor de Paquetes NuGet en Visual Studio, agrega el paquete IdentityServer4 a tu proyecto. Utilizando la Consola de Administrador de Paquetes o un terminal, escribe el siguiente comando para instalar la última versión del paquete:

Install-Package IdentityServer4

Configurar IdentityServer4 en un proyecto .NET Core

En su aplicación ASP.NET Core, configure IdentityServer4 añadiendo el middleware y los servicios de autenticación requeridos al archivo Startup.cs. Se proporciona aquí un ejemplo de código introductorio para configurar 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();
    }
}

Imports Microsoft.AspNetCore.Builder
Imports Microsoft.AspNetCore.Hosting
Imports Microsoft.Extensions.DependencyInjection
Imports Microsoft.Extensions.Hosting

Public Class Startup
	Public Sub ConfigureServices(ByVal services As IServiceCollection)
		services.AddIdentityServer().AddInMemoryClients(Config.Clients).AddInMemoryIdentityResources(Config.IdentityResources).AddInMemoryApiScopes(Config.ApiScopes).AddInMemoryApiResources(Config.ApiResources).AddTestUsers(Config.Users)
	End Sub

	Public Sub Configure(ByVal app As IApplicationBuilder, ByVal env As IWebHostEnvironment)
		If env.IsDevelopment() Then
			app.UseDeveloperExceptionPage()
		End If
		app.UseIdentityServer()
	End Sub
End Class

Imports Microsoft.AspNetCore.Builder
Imports Microsoft.AspNetCore.Hosting
Imports Microsoft.Extensions.DependencyInjection
Imports Microsoft.Extensions.Hosting

Public Class Startup
	Public Sub ConfigureServices(ByVal services As IServiceCollection)
		services.AddIdentityServer().AddInMemoryClients(Config.Clients).AddInMemoryIdentityResources(Config.IdentityResources).AddInMemoryApiScopes(Config.ApiScopes).AddInMemoryApiResources(Config.ApiResources).AddTestUsers(Config.Users)
	End Sub

	Public Sub Configure(ByVal app As IApplicationBuilder, ByVal env As IWebHostEnvironment)
		If env.IsDevelopment() Then
			app.UseDeveloperExceptionPage()
		End If
		app.UseIdentityServer()
	End Sub
End Class

Configurar clientes, recursos de identidad y recursos de API

Es necesario configurar clientes, recursos de identidad (ámbitos) y recursos API para IdentityServer4. Estas configuraciones pueden definirse en una clase separada, como 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; }
}

Public Class Config
    Public Shared Property Clients As IEnumerable(Of Client)
    Public Shared Property IdentityResources As IEnumerable(Of IdentityResource)
    Public Shared Property ApiScopes As IEnumerable(Of ApiScope)
    Public Shared Property ApiResources As IEnumerable(Of ApiResource)
    Public Shared Property Users As List(Of TestUser)
End Class

Public Class Config
    Public Shared Property Clients As IEnumerable(Of Client)
    Public Shared Property IdentityResources As IEnumerable(Of IdentityResource)
    Public Shared Property ApiScopes As IEnumerable(Of ApiScope)
    Public Shared Property ApiResources As IEnumerable(Of ApiResource)
    Public Shared Property Users As List(Of TestUser)
End Class

Siguiendo estas instrucciones, puedes habilitar la autenticación y autorización seguras en tus aplicaciones ASP.NET Core creando y configurando IdentityServer4 en un proyecto C#.

Cómo empezar con IdentityServer4 con IronPDF

Estas instrucciones te guiarán a través de la configuración de IdentityServer4 para la autenticación y autorización seguras y el uso de IronPDF para crear documentos PDF en un proyecto C#. Aprenderás cómo crear un proyecto basado en una configuración básica siguiendo estos pasos.

¿Qué es IronPDF?

IronPDF es una biblioteca rica en funciones para interactuar con documentos PDF en aplicaciones .NET. Con su extenso conjunto de características, los usuarios pueden crear PDFs desde cero o desde contenido HTML, así como añadir, eliminar o reorganizar secciones de documentos PDF existentes. IronPDF brinda a los desarrolladores una robusta API para producir, modificar y convertir archivos PDF, simplificando el manejo de PDFs en aplicaciones .NET.

Características principales de IronPDF

Conversión de HTML a PDF

Con IronPDF, puedes producir documentos PDF de alta calidad utilizando contenido HTML, incluyendo JavaScript y CSS. Esta funcionalidad es útil al crear PDFs a partir de sitios web o contenido dinámico.

Modificación y mejora de PDF

IronPDF te permite alterar documentos PDF que ya existen. Puedes combinar múltiples PDFs en un solo documento, extraer páginas de un PDF y agregar texto, imágenes, marcas de agua o anotaciones.

Creación de PDF sobre la marcha

Con la API de IronPDF, puedes añadir programáticamente texto, imágenes, formas y otros objetos a documentos PDF recién creados. Esto permite la generación dinámica de PDFs para facturas, informes y otros resultados basados en documentos.

Seguridad en PDF

Puedes gestionar el acceso y proteger datos sensibles cifrando documentos PDF con IronPDF y añadiendo protección con contraseña.

Formularios PDF

IronPDF permite a los usuarios crear, llenar y enviar formularios PDF, así como llenar datos en los campos del formulario.

Extracción de texto

IronPDF ayuda con la manipulación, análisis y búsqueda de datos de texto extrayendo información textual de documentos PDF.

Conversión a formatos de imagen

IronPDF puede convertir documentos PDF a formatos de imagen comunes, como PNG, JPEG y BMP, lo cual es útil cuando se necesitan imágenes en lugar de PDFs.

Instalar IronPDF

Utiliza la CLI de .NET o el Gestor de Paquetes NuGet para agregar la última versión de IronPDF a tu proyecto.

Install-Package IronPdf

Integrate IronPDF With IdentityServer4 C#

Configure los servicios y el middleware necesarios para IdentityServer4 en su archivo Startup.cs, como se muestra en el código anterior. Luego cree un nuevo Controlador MVC llamado PdfController.cs para gestionar la generación de PDF utilizando IronPDF.

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");
    }
}

Imports Microsoft.AspNetCore.Authorization
Imports Microsoft.AspNetCore.Mvc
Imports IronPdf
Imports System.Threading.Tasks

<Authorize>
Public Class PdfController
    Inherits Controller

    Public Async Function GeneratePdf() As Task(Of IActionResult)
        ' Create IronPDF Renderer
        Dim renderer = New IronPdf.ChromePdfRenderer()

        ' HTML content to be converted to PDF
        Dim htmlContent As String = "<h1>Hello, IronPDF!</h1><p>This is a generated PDF document.</p>"

        ' Convert HTML to PDF asynchronously
        Dim pdfDocument = Await Task.Run(Function() renderer.RenderHtmlAsPdf(htmlContent))

        ' Return the PDF as a file
        Return File(pdfDocument.BinaryData, "application/pdf", "example.pdf")
    End Function
End Class

Imports Microsoft.AspNetCore.Authorization
Imports Microsoft.AspNetCore.Mvc
Imports IronPdf
Imports System.Threading.Tasks

<Authorize>
Public Class PdfController
    Inherits Controller

    Public Async Function GeneratePdf() As Task(Of IActionResult)
        ' Create IronPDF Renderer
        Dim renderer = New IronPdf.ChromePdfRenderer()

        ' HTML content to be converted to PDF
        Dim htmlContent As String = "<h1>Hello, IronPDF!</h1><p>This is a generated PDF document.</p>"

        ' Convert HTML to PDF asynchronously
        Dim pdfDocument = Await Task.Run(Function() renderer.RenderHtmlAsPdf(htmlContent))

        ' Return the PDF as a file
        Return File(pdfDocument.BinaryData, "application/pdf", "example.pdf")
    End Function
End Class

Integrar IronPDF con IdentityServer4 implica configurar primero una autenticación y autorización segura de usuarios con IdentityServer4, seguido de usar IronPDF para crear documentos PDF accesibles solo por usuarios autenticados. En el ejemplo de código proporcionado, IdentityServer4 está configurado en el archivo Startup.cs para manejar la gestión de identidades de usuario a través de configuraciones en memoria y credenciales de cliente.

El PdfController está protegido con el atributo [Authorize], asegurando que solo los usuarios autorizados pueden acceder a sus operaciones. Este controlador usa un método asincrónico para renderizar contenido HTML en formato PDF utilizando la biblioteca IronPDF. Este proceso de generación de PDF implica crear un renderizador ChromePdfRenderer, convertir contenido HTML en un documento PDF y devolver el PDF como una respuesta de archivo.

Al integrar la lógica de generación de PDF dentro de un punto final seguro, solo los usuarios autenticados por IdentityServer4 pueden iniciar la generación de PDFs, combinando consecuentemente una fuerte seguridad con capacidades de generación dinámica de documentos. Esta configuración es particularmente ventajosa para aplicaciones que requieren manejo seguro de documentos, como generar facturas, informes o contenido personalizado basado en información específica de usuario, al tiempo que se aplica un estricto control de acceso con IdentityServer4.

Conclusión

En resumen, la integración de IdentityServer4 con IronPDF en un proyecto C# efectivamente fusiona seguridad robusta con capacidades de generación dinámica de PDFs. IdentityServer4 ofrece un enfoque unificado y estandarizado para gestionar identidades de usuarios y control de acceso en múltiples aplicaciones y servicios, asegurando una autenticación y autorización de usuarios seguras. Usando IronPDF, los desarrolladores pueden producir documentos PDF de alta calidad que solo son accesibles para usuarios autenticados, todo basado en datos de usuario verificados.

Esta integración mejora la seguridad y funcionalidad de la aplicación, haciéndola ideal para escenarios como la generación de facturas, informes y contenido personalizado que requiere un procesamiento seguro de documentos. En general, la combinación de IdentityServer4 y IronPDF proporciona una solución convincente para desarrollar aplicaciones seguras, eficientes y orientadas al usuario dentro del framework .NET.

Cuando IronPDF y las tecnologías de Iron Software se integran en tu pila de desarrollo de aplicaciones empresariales, IronPDF puede proporcionar una documentación rica en características para desarrolladores y soluciones de software premium para clientes y usuarios finales. Esta base sólida también facilitará la mejora de proyectos, sistemas de backend y procesos.

Iron Suite, una combinación de 9 productos API .NET diferentes, está disponible a un competitivo precio de licencia Estas tecnologías son excelentes opciones para proyectos de desarrollo de software moderno debido a su documentación completa, comunidad de desarrolladores activa en línea y actualizaciones regulares.