Güvenlik, özellikle kullanıcı izinleri ve kimlik doğrulama söz konusu olduğunda, günümüz yazılım mimarisi için kritik öneme sahiptir. OpenID Connect ve OAuth 2.0 uygulamaları için en iyi çerçevelerden biri olan IdentityServer4, dağıtılmış ağlarda merkezi yetkilendirme ve kimlik doğrulama için güvenilir bir seçenek sunar. Geliştiriciler IronPDF, C# için güçlü PDF üretim kütüphanemizi güvenli kimlik yönetimi ile birlikte kullandıklarında, çeşitli uygulama gereksinimlerini karşılayan PDF belgeleri oluşturmak için kolayca iki teknolojiyi birleştirebilirler.

IdentityServer4, kimlik yönetimi kurulumunu basitleştiren modüler, standartlara dayalı bir çözüm sunar. Çeşitli hizmetler ve uygulamalar için kullanıcı kimlik doğrulama, erişim tanımı, jeton doğrulama ve verme, ve izin doğrulama işlemlerini yöneten merkezi bir kimlik sağlayıcısı oluşturmalarına yardımcı olur. IdentityServer4, kullanıcı adı/şifre, sosyal oturumlar ve çok faktörlü kimlik doğrulama gibi birçok kimlik doğrulama yöntemini destekleyerek geliştiricilere güvenli ve sezgisel kimlik doğrulama deneyimleri oluşturma imkanı sağlar.

Bu eğitim, IdentityServer4'ün C# entegrasyonunu ve IronPDF'i kapsayacak, IdentityServer4'ü kullanarak yetkilendirme ve kimlik doğrulama için güvenli işlemler nasıl oluşturulacağını ve oluşturulan kullanıcı kimliklerini kullanarak IronPDF'in PDF belge Oluşturma özelleştirilmesi nasıl yapılacağını gösterecektir. Kimlik doğrulama ve yetkilendirme için güvenliği ve C# uygulamalarınızın işlevselliğini artırmak için, IdentityServer4'ü merkezi bir kimlik ve kimlik doğrulama sağlayıcısı olarak yapılandırmaktan dinamik PDF üretimi için IronPDF'i entegre etmeye kadar her şeyden bahsedeceğiz.

IdentityServer4 C# nedir?

IdentityServer4 adlı popüler bir açık kaynak çerçevesi, .NET ve C# uygulamalarında kimlik yönetimi, yetkilendirme ve kimlik doğrulama işlemleri gerçekleştirmek için kullanılır. Opsiyonel kimlik doğrulama ve yetkilendirme açısından geniş bir müşteri uygulaması ve platform yelpazesiyle uyumlu ve destek sağlayan IdentityServer4, güvenlik açısından endüstri standardı protokoller sunar.

IdentityServer4 esasen merkezi bir kimlik doğrulama sunucusu olarak işlev yapar, kullanıcı tanımlaması ve izin yönetimi temel kimliğini, geçerli erişim jetonu vermeyi ve kimlik bilgileri doğrulamasını yönetir. Geliştiricilerin birçok uygulama ve hizmete federasyon kimlik doğrulama ve tek oturum açma (SSO) işlemi eklemesine olanak tanıyarak son kullanıcılara güvenli ve kesintisiz bir deneyim sunar.

IdentityServer4 Özellikleri

SSO, ya da tek oturum açma

Kullanıcılar, kimlik bilgilerini yeniden girmeye gerek kalmadan yalnızca bir kimlik doğrulama ile farklı uygulamalara veya hizmetlere erişebilirler.

OpenID Connect ve OAuth 2.0 Desteği

IdentityServer4, güvenli kimlik doğrulama ve yetkilendirme için endüstri standardı protokoller sunarak geniş bir müşteri uygulaması ve platform yelpazesiyle uyumluluk sağlar.

Uyarlanabilir Ayarlama

Geliştiriciler, belirli uygulama gerekliliklerine uygun şekilde güvenlik ayarlarını özelleştirebilir ve kimlik doğrulama ve izin politikalarının nasıl yapılandırılacağını detaylı bir şekilde kontrol edebilirler.

ASP.NET Core ile Bağlantı

ASP.NET Core web uygulamaları ve API'leri için kimlik doğrulamasını uygulamak, IdentityServer4'ün çerçeve ile kesintisiz entegrasyonu sayesinde basittir.

Özelleştirme ve Uyarlanabilirlik

Çerçevenin yüksek derecede genişletilebilirliği ve özelleştirilebilirliği sayesinde geliştiriciler gerekirse yeni kullanıcı depoları, kimlik sağlayıcılar, test kullanıcıları ve kimlik doğrulama iş akışları ekleyebilirler.

Kullanıcı Doğrulama

IdentityServer4, geliştiricilere web uygulamalarının gereksinimlerine en uygun kimlik doğrulama mekanizması yapılandırmasını seçme esnekliği tanır. Bu mekanizmalara kullanıcı adı/şifre, sosyal oturumlar (Google, Facebook gibi) ve dış kimlik sağlayıcılar (Active Directory, Azure AD gibi) dahildir.

Yetkilendirme Politikaları

Geliştiriciler, yalnızca yetkili kullanıcıların belirli kaynaklara erişebileceği veya uygulama içindeki belirli eylemleri gerçekleştirebileceği şekilde kullanıcı rolleri, talepler veya diğer kriterler temelinde ince tahminli yetkilendirme politikaları oluşturabilirler.

Jeton Yönetimi

IdentityServer4 erişim jetonlarını, jeton yenileme jetonlarını ve kimlik jetonlarını yönetir, kimlik sunucusunun koruduğu kaynaklara kullanıcı kimliği doğrulaması ve izin sağlamak için güvenli bir yöntem sağlar.

Oluşturma ve Konfigürasyon

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

Visual Studio'da Yeni Proje Oluşturma

Visual Studio uygulamasını başlattıktan sonra, "Yeni bir proje oluştur" seçeneğini seçin veya Dosya menüsünden > Ekle > "Yeni proje" seçeneğini seçin. Ardından "Yeni proje"yi seçtikten sonra "Asp.NET Core Web Uygulaması (Model-Görünüm-Kontrolör)" seçeneğini seçin. Bu uygulama, bu eğitimi için PDF belge oluşturma amacıyla kullanılacaktır.

Dosya yolunu seçin ve proje adını ilgili metin kutusuna girin. Ardından, aşağıdaki ekran görüntüsünde gösterildiği gibi Oluştur düğmesine tıklayarak gerekli .NET Framework'ü seçin.

Hangi çerçevenin gerekli olduğunu karar verin ve Oluştur düğmesine tıklayın.

Seçilen uygulama için yapı, Visual Studio projesi tarafından oluşturulacaktır. Bu örnekte ASP.NET MVC kullanmaktayız. Kodları yazmak için ya yeni bir kontroller oluşturabilir ya da mevcut bir tane kullanarak kodu girip programı oluşturup/çalıştırabiliriz.

Kodu test etmek için gerekli kütüphaneyi ekleyin.

IdentityServer4 Paketini Yükleyin

.NET CLI veya Visual Studio'daki NuGet Paket Yöneticisi'ni kullanarak projenize IdentityServer4 paketini ekleyin. Paket Yöneticisi Konsolu veya bir terminal kullanarak paketin en son sürümünü yüklemek için aşağıdaki komutu yazın:

Install-Package IdentityServer4

IdentityServer4'ü .NET Core Projesinde Yapılandırın

ASP.NET Core uygulamanızda, gerekli kimlik doğrulama ara yazılımı ve hizmetleri Startup.cs dosyasına ekleyerek IdentityServer4'ü yapılandırın. IdentityServer4'ü yapılandırmanın bir başlangıç kod örneği burada sağlanmıştır:

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

İstemcileri Yapılandırın, Kimlik Kaynaklarını ve API Kaynaklarını Yapılandırın

IdentityServer4 için istemcilerin, kimlik kaynaklarının (kapsamların) ve API kaynaklarının yapılandırılması gereklidir. Bu yapılandırmalar Config.cs gibi ayrı bir sınıfta tanımlanabilir:

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

Bu talimatları izleyerek, C# projesinde IdentityServer4 oluşturarak ve yapılandırarak ASP.NET Core uygulamalarınızda güvenli kimlik doğrulama ve yetkilendirme etkinleştirebilirsiniz.

IronPDF ile IdentityServer4'e Giriş

Bu talimatlar, güvenli kimlik doğrulama ve yetkilendirme için IdentityServer4'ü yapılandırmanızı ve IronPDF kullanarak C# projenizde PDF belgeleri oluşturmanızı sağlayacaktır. Bu adımları izleyerek, temel bir yapı temelinde bir proje oluşturmayı öğreneceksiniz.

IronPDF Nedir?

IronPDF, .NET uygulamalarında PDF belgeleriyle etkileşim kurmak için zengin özelliklere sahip bir kütüphanedir. Kapsamlı özellik seti sayesinde kullanıcılar, ister sıfırdan isterse HTML içeriğinden PDF oluşturabilir; ayrıca mevcut PDF belgelerinin bölümlerini ekleyebilir, kaldırabilir veya yeniden düzenleyebilirler. IronPDF, .NET uygulamalarındaki PDF işlemlerini basitleştirerek PDF dosyalarını üretmek, değiştirmek ve dönüştürmek için geliştiricilere güçlü bir API sunar.

IronPDF'nin Ana Özellikleri

HTML'den PDF'ye Çeviri

IronPDF ile HTML içeriği kullanarak, JavaScript ve CSS dahil olmak üzere yüksek kaliteli PDF belgeleri üretebilirsiniz. Bu özellik, web sitelerinden veya dinamik içerikten PDF oluştururken kullanışlıdır.

PDF'leri Değiştirme ve Geliştirme

IronPDF, mevcut PDF belgelerini değiştirmenize olanak tanır. Birden çok PDF'yi tek bir dokümanda birleştirebilir, bir PDF'den sayfalar ayıklayabilir ve metin, resim, filigran veya açıklamalar ekleyebilirsiniz.

Anında PDF Oluşturma

IronPDF'in API'sini kullanarak, yeni oluşturulan PDF belgelerine programatik olarak metin, resimler, şekiller ve diğer nesneler ekleyebilirsiniz. Bu, fatura, rapor ve diğer belge tabanlı çıktılar için dinamik PDF üretimini sağlar.

PDF Güvenliği

IronPDF ile PDF belgelerini şifreleyerek ve parola koruması ekleyerek erişimi yönetebilir ve hassas verileri koruyabilirsiniz.

PDF Formları

IronPDF, kullanıcıların PDF formları oluşturmasını, doldurmasını ve göndermesini, ayrıca form alanlarına veri doldurmasını sağlar.

Metin Çıkarma

IronPDF, PDF belgelerinden metin bilgileri çıkararak, metin verilerini manipüle etme, analiz etme ve arama konularında yardımcı olur.

Görüntü Formatlarına Dönüştürme

IronPDF, PDF belgelerini ihtiyaç duyulduğunda PNG, JPEG ve BMP gibi yaygın görüntü formatlarına dönüştürebilir.

IronPDF Kurulumu

IronPDF'in en son sürümünü projenize eklemek için .NET CLI veya NuGet Package Manager'ı kullanın.

Install-Package IronPdf

Integrate IronPDF With IdentityServer4 C#

Yukarıdaki koda gösterildiği gibi Startup.cs dosyanızda IdentityServer4 için gerekli hizmetleri ve ara yazılımı kurun. PDF oluşturma işlemini IronPDF kullanarak yönetmek için PdfController.cs adlı yeni bir MVC Denetleyicisi 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

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 entegrasyonu, önce IdentityServer4 ile güvenli kimlik doğrulama ve yetkilendirme kurulumunu, ardından sadece kimliği doğrulanmış kullanıcılar tarafından erişilebilen PDF belgelerinin oluşturulmasını kapsamaktadır. Verilen kod örneğinde, kullanıcı kimliği yönetimini bellek içi yapılandırmalar ve istemci kimlik bilgileri aracılığıyla gerçekleştirmek için IdentityServer4, Startup.cs dosyasında yapılandırılmıştır.

[Authorize] özelliği ile korunan PdfController, sadece yetkili kullanıcıların operasyonlarına erişmesini sağlar. Bu kontrolör, IronPDF kütüphanesini kullanarak HTML içeriğini PDF formatına dönüştürmek için asenkron bir yöntem kullanır. Bu PDF oluşturma süreci, bir ChromePdfRenderer oluşturmayı, HTML içeriğini bir PDF belgesine dönüştürmeyi ve PDF'i bir dosya yanıtı olarak döndürmeyi içerir.

PDF oluşturma mantığı güvenli bir uç noktada yerleştirilerek, yalnızca IdentityServer4 tarafından kimliği doğrulanan kullanıcılar PDF üretimini başlatabilir, dolayısıyla güçlü güvenlik ve dinamik belge üretim yeteneklerini birleştirir. Bu yapılandırma, kullanıcıya özgü bilgiler temelinde güvenli belge işleme gerektiren uygulamalar için, fatura, rapor veya özelleştirilmiş içerik oluşturmak gibi katı erişim kontrolünü uygulayan uygulamalar için özellikle avantajlıdır.

Sonuç

Sonuç olarak, C# projesinde IdentityServer4 ile IronPDF'in entegrasyonu, güçlü güvenlikle dinamik PDF oluşturma yeteneklerini etkili bir şekilde birleştirir. IdentityServer4, birden fazla uygulama ve hizmet arasında kullanıcı kimlikleri ve erişim kontrolü yönetimi için birleşik ve standart bir yaklaşım sunarak güvenli kullanıcı kimlik doğrulama ve yetkilendirme sağlar. IronPDF kullanarak, geliştiriciler yalnızca kimliği doğrulanmış kullanıcılara erişilebilir olan ve hepsi doğrulanmış kullanıcı verileri temelinde olan yüksek kaliteli PDF belgeleri üretebilir.

Bu entegrasyon, uygulama güvenliğini ve işlevselliğini artırarak, güvenli belge işleme gerektiren, fatura, rapor ve kişiselleştirilmiş içerik oluşturma gibi durumlar için ideal hale getirir. Genel olarak, IdentityServer4 ve IronPDF birleşimi, .NET çerçevesinde güvenli, verimli ve kullanıcılara yönelik uygulamalar geliştirmek için etkileyici bir çözüm sağlar.

Kurumsal uygulama geliştirme yığınınıza IronPDF ve Iron Software teknolojileri entegre edildiğinde, IronPDF müşteriler ve son kullanıcılar için özellik açısından zengin geliştirici belgelendirme ve premium yazılım çözümleri sunabilir. Bu sağlam temel, proje, arka uç sistemi ve süreçlerin gelişimini de kolaylaştıracaktır.

Iron Suite, 9 farklı .NET API ürünü kombinasyonu, rekabetçi lisans fiyatı ile mevcut! Bu teknolojiler, kapsamlı belgeleri, aktif çevrimiçi geliştirici topluluğu ve düzenli güncellemeleri nedeniyle modern yazılım geliştirme projeleri için mükemmel bir seçimdir.