IdentityServer .NET (Geliştiriciler İçin Nasıl Çalışır)

IdentityServer4 C# Nedir?

IdentityServer4 adı verilen popüler bir açık kaynaklı çerçeve, .NET ve C# uygulamalarında kimlik yönetimi, yetkilendirme ve kimlik doğrulama yapmak için kullanılır. Modern güvenlik protokollerine uygunluk sağladığı için web uygulamaları, API'ler ve mikro hizmetleri güvence altına almak için esnek bir çözümdür.

IdentityServer4 temel olarak merkezi bir kimlik doğrulama sunucusu olarak işlev görür, kullanıcı kimlik doğrulama ve izin yönetimi, geçerli erişim tokeni verme ve kimlik bilgisi doğrulama gibi işlemleri ele alır. Bu, programcılara federated kimlik doğrulama ve tek oturum açma (SSO) sistemlerini çeşitli uygulama ve hizmetlere entegre etme yeteneği verir ve güvenli ve kesintisiz bir uç kullanıcı deneyimi sağlar.

IdentityServer4 Özellikleri

Oluşturma ve Yapılandırma

Visual Studio'da bir C# projesinde IdentityServer4 kurmak için şu adımları izlemeniz gerekir:

Install-Package 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

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

IronPDF ile IdentityServer4'e Başlangıç

Bu talimatlar sizi, güvenli kimlik doğrulama ve yetkilendirme için IdentityServer4'ü yapılandırmak ve C# projesinde PDF belgeleri oluşturmada IronPDF'ü kullanmak konusunda yönlendirecektir. Bu adımları izleyerek, temel ayara dayalı bir proje nasıl oluşturulacağını öğreneceksiniz.

Install-Package IronPdf

IronPDF'yi IdentityServer4 C# ile Entegre Etme

Yukarıdaki koddaki gibi, Startup.cs dosyanızda IdentityServer4 için gerekli servis ve middlewareleri kurun. Ardından PDF oluşturmayı IronPDF kullanarak ele almak için PdfController.cs adlı yeni bir MVC Kontrolcüsü oluşturun.

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

IronPDF ile IdentityServer4'ü entegre etmek, güvenli kullanıcı kimlik doğrulama ve yetkilendirmeyi önce IdentityServer4 ile kurmayı ve ardından yalnızca kimlik doğrulaması yapılmış kullanıcılar tarafından erişilebilen PDF belgeleri oluşturmak için IronPDF kullanmayı içerir. Verilen kod örneğinde, kullanıcı kimliği yönetimini bellek içi yapılandırmalar ve istemci kimlik bilgileri aracılığıyla ele almak için IdentityServer4, Startup.cs dosyasında yapılandırılmıştır.

PdfController, yalnızca yetkili kullanıcıların işlemlerine erişmesini sağlayan [Authorize] özniteliği ile korunmuştur. Bu denetleyici, IronPDF kütüphanesini kullanarak HTML içeriğini PDF formatına dönüştürmek için bir eş zamansız yöntem kullanır. Bu PDF oluşturma süreci, bir ChromePdfRenderer renderleyici oluşturmayı, HTML içeriğini bir PDF belgesine dönüştürmeyi ve PDF'yi bir dosya yanıtı olarak geri döndürmeyi içerir.

PDF oluşturma mantığını güvenli bir uç noktaya gömerek, yalnızca IdentityServer4 tarafından kimliği doğrulanan kullanıcılar PDF üretimini başlatabilir, dolayısıyla güçlü güvenlik ile dinamik belge oluşturma yeteneklerini birleştirir. Bu kurulum, kimlik doğrulaması yapılmış kullanıcı bilgilerine dayalı olarak özel içerik oluşturmak gibi, fatura oluşturma, raporlar veya kullanıcıya özel bilgileri içeren belgeleri güvenli bir şekilde işlemek gerektiren uygulamalar için özellikle avantajlıdır.

Sonuç

Özetle, C# projesinde IdentityServer4 ile IronPDF entegrasyonu, güçlü güvenliği dinamik PDF oluşturma kapasiteleriyle etkili bir şekilde birleştirir. IdentityServer4, kullanıcı kimliklerini ve erişim kontrolünü birden çok uygulama ve hizmette yönetmek için birleşik ve standartlaştırılmış bir yaklaşım sunar, güvenli kullanıcı kimlik doğrulaması ve yetkilendirme sağlar. IronPDF kullanarak, geliştiriciler yalnızca kimlik doğrulaması yapılmış kullanıcılar için erişilebilir olan yüksek kaliteli PDF belgeleri üretebilir, her şey doğrulanmış kullanıcı verileri temelindedir.

Bu entegrasyon, güvenli belge işleme gerektiren senaryolar için uygulama güvenliğini ve işlevselliğini artırır, fatura, rapor ve kişiye özel içerik üretimi gibi. Genel olarak, IdentityServer4 ve IronPDF kombinasyonu, .NET çerçevesi dahilinde güvenli, verimli ve kullanıcı odaklı uygulamalar geliştirmek için çekici bir çözüm sunar.

Kuruluş uygulama geliştirme yığınıza IronPDF ve Iron Software teknolojileri entegre edildiğinde, IronPDF müşteriler ve son kullanıcılar için zengin özellik setine sahip geliştirici dökümantasyonu ve premium yazılım çözümleri sağlayabilir. Bu sağlam temel, proje, arka uç sistem ve süreç geliştirmesini de kolaylaştıracaktır.

Iron Suite, 9 farklı .NET API ürününün bir kombinasyonu olarak rekabetçi lisans fiyatıyla sunulmaktadır! Bu teknolojiler kapsamlı dökümantasyonları, aktif çevrimiçi geliştirici toplulukları ve düzenli güncellemeleri ile modern yazılım geliştirme projeleri için mükemmel seçeneklerdir.